零基础 Claude Code + cc-switch 安装配置教程
一窍不通的电脑小白也能看懂的 Claude Code 保姆级安装配置教程。本文会分 Mac 和 Windows,以及分「有魔法」和「没有魔法」两种路线来实现安装并配置 Claude Code + cc-switch + DeepSeek 到设备中。

先说路线
我们最终要做成这几件事:
- 安装 Claude Code
- 安装 cc-switch
- 申请 DeepSeek API Key
- 用 cc-switch 把 Claude Code 切换到 DeepSeek V4
- 配置默认环境,实现命令行输入 Claude 即可使用
为什么要做这几步?
Claude Code 是 Anthropic 官方推出的目前极为强大的命令行 AI Agent。但如果直接走 claude.ai 账号登录,需要魔法访问,而且通常还涉及 Claude 订阅。
因为 Claude Code 并不只能绑定 Claude 自家的模型。通过配置第三方 API,我们也可以在 Claude Code 里使用 DeepSeek、Qwen、GLM、MiniMax、豆包等模型。也就是说,你用的是 Claude Code 这套强大的 Agent 工作流,但底层模型可以自由切换。
所以这篇教程里,我们就用 cc-switch 把 Claude Code 接入 DeepSeek V4。这样既能体验 Claude Code 的工作方式,又能用国内直连、充值方便、按量计费的 DeepSeek API,整体门槛会低很多。
1. 先认识命令行
下面所有操作,基本都在命令行里完成。后续提到打开命令行窗口时,请重复此步骤。如提到关闭命令行窗口,请确保所有打开的命令行窗口已关闭,并且 Dock 栏没有显示命令行图标。
Mac 用户:
按 Command + 空格,搜索:终端,并打开
打开后,一般是一个黑底窗口,里面会有一个跳动的小字符。打开类似于下图

Windows 用户:
按键盘上的 Win + R,输入:cmd,然后按回车。

打开后也是一个黑底窗口。里面会有一个跳动的小字符。打开类似于下图

2. 安装 Claude Code
Claude Code 是 Anthropic 官方推出的命令行 AI Agent。不要看到名字里有 Code,就以为它只是一个写代码的软件。它可以帮你理解任务、拆解步骤、读取文件、修改内容、执行命令、整理资料、写文章、做项目分析,完成绝大多数你平时需要在电脑完成的事情。
如果说普通 AI 聊天工具更像「你问一句,它答一句」,那 Claude Code 更像「你给它一个目标,它自己判断该怎么做」。它是目前 AI Agent 方向里非常成熟好用的一类工具。你会明显感觉到,它不是在陪你聊天,而是真的在帮你干活。
2.1 如果你有魔法:直接使用官方推荐安装方式
既然你有魔法,你肯定已经知道基础计算机指令了,所以我这里简写一下,过程就不加图片了。
Mac 用户,在终端里运行:
1curl -fsSL https://claude.ai/install.sh | bashWindows 用户,打开 CMD,运行:
1curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdWindows 用户,如果你使用的是PowerShell,则运行:
1irm https://claude.ai/install.ps1 | iex安装完成后,验证一下:
1claude --version如果能看到版本号类似如图,说明 Claude Code 已经装好了。

2.2 没有魔法:用 Node.js + npm 镜像安装
如果官方安装命令走不动,就走这条路线。
2.2.1 先安装 Node.js。
打开:https://nodejs.org/zh-cn/download (官网nodejs.org在国内可以访问,但有时候慢,耐心等待。)
选择 LTS 版本下载。Windows 下载 .msi 安装包,双击后一路下一步。Mac 下载 .pkg 安装包,双击后按提示安装。
安装完成后,重新打开一个新的命令行窗口,验证 Node.js:
1node -v输入完成后按回车,如果能看到类似 v24.x.x、10.x.x 这样的版本号,就说明安装成功。
再验证 npm:
1npm -v输入完成后按回车,如果能看到类似 v24.x.x、10.x.x 这样的版本号,就说明安装成功。
如果提示
node不是内部或外部命令,说明环境变量未应用,请先关闭当前 CMD 窗口,重新打开一个新的 CMD,再试一次。
此处注意:如果mac部分版本用户遇到 EACCES permission denied 报错,请忽略2.2的后续步骤,参考2.3操作!
接下来安装 Claude Code:
1npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com这里的
--registry=https://registry.npmmirror.com,表示使用国内阿里 npm 镜像源下载,速度会更稳定。
安装完成后验证:
1claude --version能看到版本号,就成功了。

2.3 没有魔法:Mac 通过 Homebrew 安装 Claude Code
如果你在2.2 已成功安装的话,请直接跳过此部分。
部分 Mac 用户用 npm 全局安装时,会遇到类似:EACCES permission denied 的报错
这是 npm 全局安装权限问题。我们不要像网上说的一样去修改环境变量,小白修改后有安全风险,我们这可以改用 Homebrew 方式安装 Claude Code。
Homebrew 官方脚本在无魔法环境下可能比较慢,所以这里我们用 中科大的镜像源
这是官方文档:https://mirrors.ustc.edu.cn/help/brew.git.html#homebrew-linuxbrew
打开后复制如图这两条命令分别执行

执行效果如下:

此时可以根据英文提示操作:按回车。后续所有的操作本质都按英文提示来即可,如果有不懂的地方可以直接复制去找其他ai助手翻译一下。不出意外按完回车后会一直到这个界面:

我们需要关心红框内的内容,意思是下一步需要在命令行中执行如下命令,这些操作本质上是在把中科大的镜像源写入系统变量中,这样后续使用时会去中科大的镜像源下载数据。我们依次复制然后回车执行一下,效果如下图:

执行完毕后,我们通过执行这四条命令确认镜像源是否成功被配置
1brew config | grep -E 'HOMEBREW_BREW_GIT_REMOTE'2brew config | grep -E 'HOMEBREW_CORE_GIT_REMOTE'3brew config | grep -E 'HOMEBREW_BOTTLE_DOMAIN'4brew config | grep -E 'HOMEBREW_API_DOMAIN'效果如图,即代表配置成功

如果你执行下面的几个写入时带了标点等,导致写入的数据不对,或者需要重新配置,可以执行如下命令
1open /Users/用户名/.zprofile2比如我是hs,那就是3open /Users/hs/.zprofile4然后弹出一个文本框5直接全部删除然后按ctrl+s保存,然后关闭,然后重新执行即可此处我也提供一个傻瓜式 HomebrewCN 镜像脚本,执行后命令行里会出现中文提示,此脚本的清华大学源已失效,只能选择阿里源使用。对应项目地址:https://gitee.com/cunkai/HomebrewCN
Terminal window 1/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
完成后,重启终端,再运行:
1brew install --cask claude-code@latest
速度可能有点慢,多等会,安装完成后验证:
1claude --version能看到版本号,就成功了。

关于 npm 安装方式的说明
你可能在某些文章里看到,说 npm 安装方式已经「过时了」。
这里简单解释一下:
官方现在更推荐原生安装器,因为它更方便,也能自动更新。但 npm 方式仍然在官方文档里,要求是 Node.js 18 或更高版本。
对国内用户来说,如果官方安装脚本访问不稳定,npm + 国内镜像是目前最容易跑通的方式。
后续升级 Claude Code,用这条命令:
1npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com如果你是 Homebrew 安装的,用:
1brew upgrade claude-code@latest建议每隔一两周更新一次。Claude Code 迭代很快,新版本经常会加实用功能。
3. 安装 cc-switch
Claude Code 装好了,但现在还不能直接用 DeepSeek。我们需要一个工具,把 Claude Code 的模型提供商切换到 DeepSeek。这个工具就是 cc-switch。
白话说,cc-switch 可以帮你管理 Claude Code、Codex、Gemini CLI 等 AI 命令行工具的模型配置。你不用手动改一堆环境变量,只需要在图形界面里填 API Key,然后点一下切换。
GitHub 下载页:https://github.com/farion1231/cc-switch/releases
打开 GitHub Releases 页面后,往下滑到 Assets,选择本机对应的版本下载即可,Windows选exe结尾的文件,macos如果是。
Mac 用户下载:
1CC-Switch-v最新版本-macOS.dmgWindows 用户下载:
1CC-Switch-v最新版本-Windows.msi
GitHub 国内一般可以访问,偶尔比较慢,多刷新几次。
如果真的打不开,可以关注我的公众号,后台回复:
1cc-switch我会在每次版本更新后,把安装包上传到后台,安装包大约几十 MB。
4. 申请 DeepSeek API Key
现在我们有了两件东西:
- Claude Code
- cc-switch
但还差最后一件东西:DeepSeek API Key。
打开:
1https://platform.DeepSeek.com然后按下面步骤操作:
-
注册账号,支持手机号注册
-
登录后,点击左侧菜单里的
API Keys -
点击
创建 API Key
-
名字可以随意填:比如claude-code
-
创建后复制 Key,并保存好
注意:API Key 通常只显示一次。关掉页面后可能就看不到完整 API Key 了。
DeepSeek API 的好处是:国内直连、按量计费、支持国内所有主流平台直接充值。截至 2026-05-26,DeepSeek 官方文档显示,V4 Pro 价格是:
1输入缓存命中:2 V4 Pro:0.025元 / 百万 token3 v4-Flash:0.02元 / 百万 token4输入缓存未命中:5 V4 Pro:3 元 / 百万 token6 v4-Flash:1 元 / 百万 token7输出:8 V4 Pro:6 元 / 百万 token9 v4-Flash:2 元 / 百万 token普通问题咨询对话一般是 1000 到 3000 token。举个粗略例子:
1输入 1000 token:1000 ÷ 1,000,000 × 3元 = 0.003元2输出 2000 token:2000 ÷ 1,000,000 × 6元 = 0.012元3合计:约 0.015 元 / 次4如果命中缓存的话更低,大概也就0.013元 / 次也就是一次普通对话,不到 2 分钱。
实际费用会根据上下文长度、任务复杂度、输出长度变化,以 DeepSeek 官网价格页为准。
5. 用 cc-switch 配置 DeepSeek V4
打开 cc-switch,基础功能介绍一下

我们按步骤来:
先进入:设置 -> 通用,界面语言改成中文,下滑,开启跳过 Claude Code 初次安装确认**,开启应用到Claude Code插件(后续用vscode方便)
然后返回首页,点击我截图标注的 Claude Code按钮,点击右上角的添加新供应商,选择DeepSeek。然后按下图填写,API Key使用你刚才复制的,其他尽量和我一致:

提醒一句:建议只在你自己的电脑、你信任的设备里记录这个key。不要泄露掉。

接下来点击编辑通用配置。

可以直接复制我的配置:
1{2 "env": {3 "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",4 "ENABLE_TOOL_SEARCH": "true",5 "DISABLE_TELEMETRY": "1",6 "DISABLE_ERROR_REPORTING": "1",7 "MCP_TIMEOUT": "60000",8 "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"9 },10 "permissions": {11 "defaultMode": "bypassPermissions"12 },13 "model": "opus",14 "outputStyle": "engineer-professional",15 "alwaysThinkingEnabled": false,16 "autoUpdatesChannel": "latest",17 "skipDangerousModePermissionPrompt": true18}
这样后续在命令行中输入 Claude,默认等于执行:claude --dangerously-skip-permissions,可以不用什么都手动点击确认。其余项是优化了一些简单逻辑。
我们回到首页,测试一下这个配置

验证完毕后,点击启用

6. 验证是否成功
重新打开一个新的终端或 CMD。运行:
1claude
这里选择yes,进入 Claude Code 后,输入:
1/model如果当前模型显示为 DeepSeek 相关模型,说明切换成功。

也可以直接问它:
1你现在使用的是什么模型?更稳妥的验证方法,是打开 DeepSeek 官网后台,查看 API 调用记录或余额变化。
DeepSeek 后台地址:
1https://platform.DeepSeek.com如果你刚刚问完问题,后台能看到用量变化,就说明 Claude Code 已经在走 DeepSeek API。

7. 常见问题
Q1:npm 安装时报 EACCES permission denied 怎么办?
参考上面的 2.3。
Mac 用户可以用 HomebrewCN 安装 Homebrew,再通过 Homebrew 安装 Claude Code:
1brew install --cask claude-code@latest不建议一上来就用 sudo npm install,容易引出新的权限问题。
Q2:Claude Code 提示 authentication failed 怎么办?
大概率是 cc-switch 的配置还没有被新的命令行窗口读取到。
解决方法:
- 确认 cc-switch 已切换到 DeepSeek V4
- 关闭当前终端或 CMD
- 重新打开一个新的终端或 CMD
- 再运行:
1claudeQ3:DeepSeek API 和真正的 Claude 差距大吗?
日常用完全够。
比如改文档、写周报、整理资料、写公众号文章、分析文件、辅助写代码,DeepSeek V4 Pro 的性价比很高,中文体验也比较友好。
但如果是特别复杂的工程任务、超长链路代码重构、非常难的推理任务,Claude 和 GPT 这类顶级模型依然更强。
后面我也会写低成本使用其他模型的教程,感兴趣可以点个关注。
Q4:Claude Code 怎么更新?
npm 安装的,运行:
1npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.comHomebrew 安装的,运行:
1brew upgrade claude-code@latest官方原生安装器安装的,一般会自动更新,也可以手动运行:
1claude updateQ5:用不惯命令行怎么办?
Claude Code 确实是命令行工具,第一次看会有点陌生。但只要你能打字、粘贴命令、回车执行,就已经够用了。
后面我会出一篇 Codex 保姆级教程,适合更偏图形界面、更不想折腾命令行的用户。
8. 总结
这篇文章没有展开 skills、plugins、常用命令、Claude.md 这些进阶内容。
今天只解决一个目标:
让零基础用户把 Claude Code 跑起来,并且用 cc-switch 接入 DeepSeek V4。
Claude Code,就是我推荐你当前阶段认真掌握的 AI 毕业工具。
不用折腾各种乱七八糟的客户端。只要把 Claude Code 用明白,你就能真正感受到,什么是强大的 Agent。
以上,既然看到这里了,如果觉得不错,随手点个赞、在看、转发三连吧。
如果想第一时间收到后续教程,也可以给我一个星标。
谢谢你看我的文章
晴时有记,阴时不更
我是晴天,我们下次再见。
相关链接
- Claude Code 官方安装文档:
https://code.claude.com/docs/en/installation - DeepSeek Claude Code 接入文档:
https://api-docs.DeepSeek.com/guides/agent_integrations/claude_code - DeepSeek 模型与价格:
https://api-docs.DeepSeek.com/zh-cn/quick_start/pricing - cc-switch 官网:
https://ccswitch.io/zh - cc-switch GitHub Releases:
https://github.com/farion1231/cc-switch/releases - Node.js 中文下载页:
https://nodejs.org/zh-cn/download
部分信息可能已经过时