Loading...
3667 字
18 分钟

零基础 Claude Code + cc-switch 安装配置教程

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

图 1:Claude Code 启动界面

先说路线

我们最终要做成这几件事:

  1. 安装 Claude Code
  2. 安装 cc-switch
  3. 申请 DeepSeek API Key
  4. 用 cc-switch 把 Claude Code 切换到 DeepSeek V4
  5. 配置默认环境,实现命令行输入 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 + 空格,搜索:终端,并打开

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

图 2:Mac 终端窗口

Windows 用户:

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

图 3:Windows 运行窗口打开 CMD

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

图 4:Windows CMD 窗口


2. 安装 Claude Code

Claude Code 是 Anthropic 官方推出的命令行 AI Agent。不要看到名字里有 Code,就以为它只是一个写代码的软件。它可以帮你理解任务、拆解步骤、读取文件、修改内容、执行命令、整理资料、写文章、做项目分析,完成绝大多数你平时需要在电脑完成的事情。

如果说普通 AI 聊天工具更像「你问一句,它答一句」,那 Claude Code 更像「你给它一个目标,它自己判断该怎么做」。它是目前 AI Agent 方向里非常成熟好用的一类工具。你会明显感觉到,它不是在陪你聊天,而是真的在帮你干活。

2.1 如果你有魔法:直接使用官方推荐安装方式

既然你有魔法,你肯定已经知道基础计算机指令了,所以我这里简写一下,过程就不加图片了。

Mac 用户,在终端里运行:

Terminal window
curl -fsSL https://claude.ai/install.sh | bash

Windows 用户,打开 CMD,运行:

Terminal window
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Windows 用户,如果你使用的是PowerShell,则运行:

Terminal window
irm https://claude.ai/install.ps1 | iex

安装完成后,验证一下:

Terminal window
claude --version

如果能看到版本号类似如图,说明 Claude Code 已经装好了。

图 5: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:

Terminal window
node -v

输入完成后按回车,如果能看到类似 v24.x.x10.x.x 这样的版本号,就说明安装成功。

再验证 npm:

Terminal window
npm -v

输入完成后按回车,如果能看到类似 v24.x.x10.x.x 这样的版本号,就说明安装成功。

如果提示 node 不是内部或外部命令,说明环境变量未应用,请先关闭当前 CMD 窗口,重新打开一个新的 CMD,再试一次。

此处注意:如果mac部分版本用户遇到 EACCES permission denied 报错,请忽略2.2的后续步骤,参考2.3操作!

接下来安装 Claude Code:

Terminal window
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

这里的 --registry=https://registry.npmmirror.com,表示使用国内阿里 npm 镜像源下载,速度会更稳定。

安装完成后验证:

Terminal window
claude --version

能看到版本号,就成功了。

图 5:Claude Code 版本验证


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

打开后复制如图这两条命令分别执行

图 6:中科大 Homebrew 镜像文档

执行效果如下:

图 7:Homebrew 安装确认提示

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

图 8:Homebrew 安装后续步骤

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

图 9:Homebrew 环境变量配置命令

执行完毕后,我们通过执行这四条命令确认镜像源是否成功被配置

brew config | grep -E 'HOMEBREW_BREW_GIT_REMOTE'
brew config | grep -E 'HOMEBREW_CORE_GIT_REMOTE'
brew config | grep -E 'HOMEBREW_BOTTLE_DOMAIN'
brew config | grep -E 'HOMEBREW_API_DOMAIN'

效果如图,即代表配置成功

图 10:Homebrew 镜像配置检查

如果你执行下面的几个写入时带了标点等,导致写入的数据不对,或者需要重新配置,可以执行如下命令

open /Users/用户名/.zprofile
比如我是hs,那就是
open /Users/hs/.zprofile
然后弹出一个文本框
直接全部删除然后按ctrl+s保存,然后关闭,然后重新执行即可

此处我也提供一个傻瓜式 HomebrewCN 镜像脚本,执行后命令行里会出现中文提示,此脚本的清华大学源已失效,只能选择阿里源使用。对应项目地址:https://gitee.com/cunkai/HomebrewCN

Terminal window
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

完成后,重启终端,再运行:

Terminal window
brew install --cask claude-code@latest

图 11:Homebrew 安装 Claude Code 完成

速度可能有点慢,多等会,安装完成后验证:

Terminal window
claude --version

能看到版本号,就成功了。

图 5:Claude Code 版本验证


关于 npm 安装方式的说明

你可能在某些文章里看到,说 npm 安装方式已经「过时了」。

这里简单解释一下:

官方现在更推荐原生安装器,因为它更方便,也能自动更新。但 npm 方式仍然在官方文档里,要求是 Node.js 18 或更高版本。

对国内用户来说,如果官方安装脚本访问不稳定,npm + 国内镜像是目前最容易跑通的方式。

后续升级 Claude Code,用这条命令:

Terminal window
npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com

如果你是 Homebrew 安装的,用:

Terminal window
brew 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,然后点一下切换。

官网:https://ccswitch.io/zh

GitHub 下载页:https://github.com/farion1231/cc-switch/releases

打开 GitHub Releases 页面后,往下滑到 Assets,选择本机对应的版本下载即可,Windows选exe结尾的文件,macos如果是。

Mac 用户下载:

CC-Switch-v最新版本-macOS.dmg

Windows 用户下载:

CC-Switch-v最新版本-Windows.msi

图 12:cc-switch GitHub 安装包列表

GitHub 国内一般可以访问,偶尔比较慢,多刷新几次。

如果真的打不开,可以关注我的公众号,后台回复:

cc-switch

我会在每次版本更新后,把安装包上传到后台,安装包大约几十 MB。


4. 申请 DeepSeek API Key

现在我们有了两件东西:

  1. Claude Code
  2. cc-switch

但还差最后一件东西:DeepSeek API Key。

打开:

https://platform.DeepSeek.com

然后按下面步骤操作:

  1. 注册账号,支持手机号注册

  2. 登录后,点击左侧菜单里的 API Keys

  3. 点击 创建 API Key

    图 13:DeepSeek API Key 创建页面

  4. 名字可以随意填:比如claude-code

  5. 创建后复制 Key,并保存好

注意:API Key 通常只显示一次。关掉页面后可能就看不到完整 API Key 了。

DeepSeek API 的好处是:国内直连、按量计费、支持国内所有主流平台直接充值。截至 2026-05-26,DeepSeek 官方文档显示,V4 Pro 价格是:

输入缓存命中:
V4 Pro:0.025元 / 百万 token
v4-Flash:0.02元 / 百万 token
输入缓存未命中:
V4 Pro:3 元 / 百万 token
v4-Flash:1 元 / 百万 token
输出:
V4 Pro:6 元 / 百万 token
v4-Flash:2 元 / 百万 token

普通问题咨询对话一般是 1000 到 3000 token。举个粗略例子:

输入 1000 token:1000 ÷ 1,000,000 × 3元 = 0.003元
输出 2000 token:2000 ÷ 1,000,000 × 6元 = 0.012元
合计:约 0.015 元 / 次
如果命中缓存的话更低,大概也就0.013元 / 次

也就是一次普通对话,不到 2 分钱。

实际费用会根据上下文长度、任务复杂度、输出长度变化,以 DeepSeek 官网价格页为准。


5. 用 cc-switch 配置 DeepSeek V4

打开 cc-switch,基础功能介绍一下

图 14:cc-switch 主界面

我们按步骤来:

先进入:设置 -> 通用,界面语言改成中文,下滑,开启跳过 Claude Code 初次安装确认**,开启应用到Claude Code插件(后续用vscode方便)

然后返回首页,点击我截图标注的 Claude Code按钮,点击右上角的添加新供应商,选择DeepSeek。然后按下图填写,API Key使用你刚才复制的,其他尽量和我一致:

图 15:cc-switch DeepSeek 供应商配置

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

图 16:cc-switch 模型映射配置

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

图 17:cc-switch 通用配置选项

可以直接复制我的配置:

{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
"ENABLE_TOOL_SEARCH": "true",
"DISABLE_TELEMETRY": "1",
"DISABLE_ERROR_REPORTING": "1",
"MCP_TIMEOUT": "60000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
},
"permissions": {
"defaultMode": "bypassPermissions"
},
"model": "opus",
"outputStyle": "engineer-professional",
"alwaysThinkingEnabled": false,
"autoUpdatesChannel": "latest",
"skipDangerousModePermissionPrompt": true
}

图 18:cc-switch JSON 配置编辑器

这样后续在命令行中输入 Claude,默认等于执行:claude --dangerously-skip-permissions,可以不用什么都手动点击确认。其余项是优化了一些简单逻辑。

我们回到首页,测试一下这个配置

图 19:cc-switch 测试供应商配置

验证完毕后,点击启用

图 20:cc-switch 启用供应商


6. 验证是否成功

重新打开一个新的终端或 CMD。运行:

Terminal window
claude

图 21:Claude Code 工作区信任确认

这里选择yes,进入 Claude Code 后,输入:

/model

如果当前模型显示为 DeepSeek 相关模型,说明切换成功。

图 22:Claude Code 模型切换验证

也可以直接问它:

你现在使用的是什么模型?

更稳妥的验证方法,是打开 DeepSeek 官网后台,查看 API 调用记录或余额变化。

DeepSeek 后台地址:

https://platform.DeepSeek.com

如果你刚刚问完问题,后台能看到用量变化,就说明 Claude Code 已经在走 DeepSeek API。

图 23:DeepSeek 用量信息页面


7. 常见问题

Q1:npm 安装时报 EACCES permission denied 怎么办?

参考上面的 2.3。

Mac 用户可以用 HomebrewCN 安装 Homebrew,再通过 Homebrew 安装 Claude Code:

Terminal window
brew install --cask claude-code@latest

不建议一上来就用 sudo npm install,容易引出新的权限问题。


Q2:Claude Code 提示 authentication failed 怎么办?

大概率是 cc-switch 的配置还没有被新的命令行窗口读取到。

解决方法:

  1. 确认 cc-switch 已切换到 DeepSeek V4
  2. 关闭当前终端或 CMD
  3. 重新打开一个新的终端或 CMD
  4. 再运行:
Terminal window
claude

Q3:DeepSeek API 和真正的 Claude 差距大吗?

日常用完全够。

比如改文档、写周报、整理资料、写公众号文章、分析文件、辅助写代码,DeepSeek V4 Pro 的性价比很高,中文体验也比较友好。

但如果是特别复杂的工程任务、超长链路代码重构、非常难的推理任务,Claude 和 GPT 这类顶级模型依然更强。

后面我也会写低成本使用其他模型的教程,感兴趣可以点个关注。


Q4:Claude Code 怎么更新?

npm 安装的,运行:

Terminal window
npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com

Homebrew 安装的,运行:

Terminal window
brew upgrade claude-code@latest

官方原生安装器安装的,一般会自动更新,也可以手动运行:

Terminal window
claude update

Q5:用不惯命令行怎么办?

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
零基础 Claude Code + cc-switch 安装配置教程
/posts/claude-code-cc-switch-deepseek/
作者
晴天
发布于
2026-05-26
许可协议
CC BY-NC-SA 4.0

部分信息可能已经过时