Claude Code 怎么接 DeepSeek？

Claude Code 装上以后，真正容易卡住的不是安装，而是后面这几件事。

模型地址填哪里，DeepSeek 的 Key 放哪里，切换模型后 Claude Code 到底有没有生效，出错时是网络问题、Key 问题，还是模型名写错了。

这篇只跑一个最小闭环：用 Node.js 和 npm 安装 Claude Code，安装 CC Switch，用 CC Switch 配上 DeepSeek，然后让 Claude Code 在一个测试目录里正常回答一次。

这里先说清楚，本文默认走 Node.js + npm 路线。Node.js 是运行 JavaScript 工具链的基础环境，npm 是它自带的包管理器。很多开发者本机本来就有这套环境，用它安装 Claude Code 更符合自己的真实工作流。

先跑通，再谈项目里怎么用。

先看最后要跑成什么样

最后的结构是这样：

Claude Code -> CC Switch -> DeepSeek

Claude Code 是命令行里的 AI 编程助手。命令行，就是终端窗口里输入命令的那种方式。它可以读取项目文件、解释代码、按确认后的指令修改文件。

CC Switch 是一个 AI 编程工具的配置切换器。它主要帮人管理 Claude Code、Codex、Gemini CLI 这类工具的模型配置。这里的 Provider，可以理解成一组模型服务配置，里面包括接口地址、API Key 和模型名。

DeepSeek 是真正出答案的模型服务。Claude Code 负责项目操作，DeepSeek 负责生成回答，CC Switch 负责把两边接起来并方便切换。

适合这几种情况

这套做法适合已经想用 Claude Code，但暂时不想只依赖 Claude 官方模型的人。

比如本机已经有 DeepSeek API Key，想让 Claude Code 走 DeepSeek。或者团队里有人用 Claude，有人用 DeepSeek，希望用一个工具把 Provider 管起来。

如果只是临时试一下 DeepSeek，也可以直接改环境变量。环境变量就是临时告诉程序“这次用哪个接口、哪个 Key、哪个模型”的配置项。但长期使用时，纯手工改环境变量容易乱。CC Switch 的价值就在这里，它把这些配置变成可见、可切换、可回退的 Provider。

第一步，用 Node.js 和 npm 安装 Claude Code

先装 Claude Code。没有 Claude Code，后面配置 DeepSeek 没有入口。

本文默认按 Node.js + npm 路线安装。这个路线适合三类人：本机已经装好 Node.js，团队内网用 npm 源分发 CLI 工具，或者平时就习惯用 npm 管命令行工具。

先打开一个新终端，检查 Node.js 和 npm 是否能被系统找到。

node -v
npm -v

Claude Code 的 npm 包要求 Node.js 18 或更高版本。node -v 如果显示的是 v18、v20、v22 这类版本，再继续往下走。如果版本太低，先升级 Node.js，再装 Claude Code。

确认没问题后，执行：

npm install -g @anthropic-ai/claude-code

这条命令的意思是，用 npm 全局安装 Claude Code。全局安装，就是安装后系统里会多出一个 claude 命令，后面可以在任意项目目录里启动。

如果后面要升级 npm 安装版，用：

npm install -g @anthropic-ai/claude-code@latest

不要直接用 npm update -g 当作升级办法，它可能不会拉到最新版本。

macOS 或 Linux 如果遇到权限问题，不建议直接加 sudo npm install -g。更稳的做法是先修 npm 全局安装目录权限，或者改用下面的原生安装方式。否则后面升级和卸载容易继续出权限问题。

官方原生安装可以作为备选

Claude Code 官方当前把原生安装放在推荐位置。它适合不想处理 Node.js、npm 源和全局包权限的新手。

Windows 用户打开 PowerShell，可以执行：

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

如果使用 WinGet，也可以执行：

winget install Anthropic.ClaudeCode

macOS、Linux 或 WSL 用户执行：

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

macOS 如果习惯 Homebrew，也可以执行：

brew install --cask claude-code

这几条不是本文主线，只是给没有 Node.js 环境的读者留一个稳妥入口。后面的验证步骤一样，都要看系统里有没有 claude 命令。

安装完成后，先别急着配 DeepSeek。打开一个新终端，检查 Claude Code 是否能被系统找到。

claude --version

再做一次环境检查：

claude doctor

能看到版本号，claude doctor 没有明显错误，才进入下一步。

第二步，安装 CC Switch

CC Switch 有 Windows、macOS 和 Linux 版本。它不是 Claude Code 本体，而是一个配置管理工具。

Windows 用户先打开 CC Switch 的 GitHub Releases 下载页：

https://github.com/farion1231/cc-switch/releases

进入页面后，看最上面的 Latest 版本，在 Assets 里下载 Windows 安装包或便携版。

CC-Switch-v{version}-Windows.msi
CC-Switch-v{version}-Windows-Portable.zip

{version} 替换成 Releases 页面里的真实版本号。普通 Windows 用户优先下载 .msi 安装包；如果只是临时试用，或者不想写入系统安装项，再下载 Portable.zip 便携版。

macOS 用户可以用 Homebrew：

brew tap farion1231/ccswitch
brew install --cask cc-switch

Linux 用户也从同一个 Releases 下载页选择 .deb、.rpm、.AppImage。Arch 系用户也可以用：

paru -S cc-switch-bin

安装后打开 CC Switch。第一次启动时，它可能会提示导入已有 CLI 工具配置。CLI 工具，就是在终端里运行的工具。这里可以把当前 Claude Code 的已有配置作为默认 Provider 导入，后面再新增 DeepSeek Provider。

第三步，准备 DeepSeek API Key

API Key 可以理解成模型服务的钥匙。Claude Code 想调用 DeepSeek，就要带上这把钥匙。

先打开 DeepSeek API Key 页面：

https://platform.deepseek.com/api_keys

如果还没登录，先按页面提示登录。进入页面后，创建或复制一个 API Key。截图、发群、写文章时都不要露出完整 Key。示例里统一写成：

<你的 DeepSeek API Key>

拿到 API Key 以后，还不能直接乱填。

你要先分清 3 件事：Claude Code 要访问哪个接口，访问时带哪把钥匙，最后调用哪个模型。

DeepSeek 当前给 Claude Code 的推荐接入方式是 Anthropic 格式接口。Anthropic 格式，就是请求格式更接近 Claude Code 原来习惯的那套接口，而不是常见的 OpenAI /v1/chat/completions 格式。

所以 Base URL 不是随便找一个 DeepSeek 地址。它决定 Claude Code 的请求会发到哪里，也决定中间是不是按 Anthropic 兼容格式处理。

这个地址不是 CC Switch 自己发明的，也不是我按经验猜出来的。你可以这样自己查：打开 DeepSeek API 文档，进入 API 指南 -> Anthropic API，页面第一段就写明 Anthropic 格式接口的 base_url 是：

https://api.deepseek.com/anthropic

再打开 DeepSeek API 文档里的 快速开始 -> 接入 Agent 工具 -> Claude Code。这一页把同一个地址写成了 Claude Code 能读取的环境变量：

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic

所以在 CC Switch 里填 Base URL，本质上就是把官方文档里的 ANTHROPIC_BASE_URL 填进界面表单。

这两处官方文档可以直接对照：

https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/claude_code

https://api-docs.deepseek.com/zh-cn/guides/anthropic_api

模型名也要这样查。Claude Code 接入文档里写的是 ANTHROPIC_MODEL=deepseek-v4-pro[1m]，模型价格页里写的是 V4 模型的上下文长度为 1M。

这里要把 1M 解释清楚。M 是英文 million 的缩写，million 就是 100 万。1M tokens 就是 1,000,000 个 token，也就是 100 万 token。

Token 可以先理解成模型读文字时用的计数单位。它不完全等于一个汉字或一个英文单词，可能是一个词、一个数字、一个标点，也可能是词的一部分。

所以 deepseek-v4-pro[1m] 里的 [1m]，可以按“100 万 token 上下文版本”理解。它不是 1 分钟，也不是价格里的“每 100 万 token”。上下文长度，指模型一次能看见的输入、历史对话、工具结果和代码片段的总规模。

如果你要自己复查，打开 DeepSeek 的 模型 & 价格 页面，看“上下文长度 1M”这一行：

https://api-docs.deepseek.com/zh-cn/quick_start/pricing

官方文档里写的是环境变量。CC Switch 界面里填的是同一组值，只是字段名换成了表单里的叫法。

这里要记住 4 个值：

注意，不要照旧教程继续默认写 deepseek-chat 或 deepseek-reasoner。DeepSeek 文档已经说明，这两个老模型名后续会废弃，只是为了兼容才映射到 deepseek-v4-flash 的不同模式。

第四步，在 CC Switch 里新增 DeepSeek Provider

打开 CC Switch，进入 Claude Code 对应的配置区域。

点击 Add Provider。如果界面里已经有 DeepSeek 预设，直接选 DeepSeek。没有预设时，选择自定义配置。

核心配置按下面填：

Provider Name: DeepSeek
Base URL: https://api.deepseek.com/anthropic
API Key / Auth Token: <你的 DeepSeek API Key>
Model: deepseek-v4-pro[1m]
Small / Fast / Haiku Model: deepseek-v4-flash

如果 CC Switch 的界面要求选择接口类型，优先选择 Anthropic 兼容。这里的“兼容”不是说模型变成 Claude，而是说 DeepSeek 接收 Claude Code 更容易识别的请求格式。

确认字段和接口类型后，不要直接关窗口。CC Switch 官方用户手册里，新增 Provider 的最后一步是点击 Add。也就是说，要点 Add，让这组 DeepSeek 配置真正进入 Provider 列表。

添加完成后，先做一次联通检查。

CC Switch 用户手册里把模型自动获取叫 Fetch Models。它会用你填的 API Key 和 Endpoint URL 请求模型列表。新版说明里还提到 Stream Check，也就是模型健康检查，用来验证供应商是否可用。

如果界面上有 Fetch Models、Test、Test Model 或 Stream Check 按钮，先点一次。能拿到模型列表或通过健康检查，说明 Base URL、API Key 和模型服务的基础连接是通的。

测试不通过时，按错误类型排查：401/403 先查 API Key；404/405 先查接口地址或模型列表接口是否支持；超时先查网络。

这个测试只算第一层验收。它说明 CC Switch 这边能连上，但不等于 Claude Code 已经完整跑通。完整验收还要看下一节的空目录测试。

联通检查通过后，选中这个 DeepSeek Provider，点击 Enable。

CC Switch 官方说明里提到，多数工具切换 Provider 后要重启终端或 CLI 工具。Claude Code 对 Provider 数据更接近热切换，通常不必重启。但为了少排错，已经打开的 Claude Code 会话建议退出后重新进一次。

第五步，进入测试目录验证

CC Switch 里的测试通过后，还要让 Claude Code 自己跑一次。因为配置能保存、模型能测试，只说明 Provider 基础可用；Claude Code 能不能真正用 DeepSeek 处理任务，要在终端里验证。

不要一上来就在正式项目里测试。

先新建一个空目录，只验证 Claude Code 能不能通过 DeepSeek 正常回答。

Windows PowerShell 示例：

mkdir C:\Temp\cc-deepseek-test
cd C:\Temp\cc-deepseek-test
claude

macOS 或 Linux 示例：

mkdir -p ~/cc-deepseek-test
cd ~/cc-deepseek-test
claude

进入 Claude Code 后，先发一条只读请求：

请只读取当前目录，告诉我这里有几个文件。不要修改任何文件。

如果能正常回答，说明模型调用已经通了。

然后再做一个最小写入测试：

请新建一个 hello-deepseek.txt，内容写一行：Claude Code 已通过 DeepSeek 跑通。

这张图里的权限提示不是报错，而是 Claude Code 的安全确认。

Claude Code 默认不会直接改文件、运行命令或访问敏感内容。它看到“新建文件”这类动作，会先问你是否允许。这个设计是为了防止 AI 在你没确认的情况下改项目文件。

这一步是在刚才新建的测试目录里，只让它创建一个 hello-deepseek.txt。你确认目录和动作都对以后，可以选择允许本次操作。

不要在正式项目里看都不看就点永久允许。先看清 3 件事：它要在哪个目录操作，要执行什么动作，会改哪些文件。

权限确认通过，只说明你允许 Claude Code 执行写入动作。它不等于测试已经成功。确认后，还要检查目录里是否真的出现 hello-deepseek.txt。

先看你现在用的是哪个终端。

如果提示符长这样：

C:\Temp\cc-deepseek-test>

这就是 Windows CMD。CMD，也就是 Windows 传统命令提示符。这里用：

dir
type hello-deepseek.txt

不要在 CMD 里写 Get-Content。Get-Content 是 PowerShell 命令，在 CMD 里会报“不是内部或外部命令”。

如果提示符长这样：

PS C:\Temp\cc-deepseek-test>

这才是 Windows PowerShell。PowerShell 里可以用：

dir
Get-Content .\hello-deepseek.txt

macOS、Linux 或 Git Bash 可以用：

ls
cat hello-deepseek.txt

这个文件能出现，内容也对，就说明最小闭环跑通了。

不放心时，用环境变量对照

CC Switch 本质上是在帮工具管理 Provider 配置。排错时，可以拿 DeepSeek 官方环境变量做对照。

Windows PowerShell 是这样：

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<你的 DeepSeek API Key>"
$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"

macOS、Linux 或 WSL 是这样：

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

这些变量不用长期手敲。文章把它们列出来，是为了知道 CC Switch 里每个字段到底对应什么。

长期使用时，还是建议把 DeepSeek Provider 放在 CC Switch 里管理。这样切回 Claude 官方、切到其他 Provider、排查哪个模型正在生效，都会直观很多。

常见报错先看这几类

如果 claude --version 都不行，先别排查 DeepSeek。问题在 Claude Code 没装好，或者终端找不到 claude 命令。重新打开终端，再检查 PATH。

如果 Claude Code 能打开，但请求时报 401、unauthorized、invalid api key，优先查 DeepSeek API Key。Key 可能复制错了，也可能账号没有可用额度。

如果报 404、model not found，优先查模型名。Claude Code 场景按 DeepSeek 文档优先填 deepseek-v4-pro[1m] 和 deepseek-v4-flash。如果某个工具界面不接受带 [1m] 的模型名，再退到 DeepSeek 标准模型名 deepseek-v4-pro 做测试。

如果能回答普通问题，但工具调用、文件修改或长上下文任务不稳定，先降低任务复杂度。用空目录只读测试、单文件写入测试、真实项目只读测试、真实项目写入测试，按这个顺序推进。不要一上来让它改完整项目。

如果切换 Provider 后看起来没生效，先退出当前 Claude Code 会话，再重新打开终端。CC Switch 虽然对 Claude Code 通常接近热切换，但重开一次能省掉很多误判。

团队里建议这样管

个人试用时，跑通就行。

团队里使用时，要多加几条规矩。

第一，API Key 不进截图、不进 Git、不进群聊。示例统一写 <你的 DeepSeek API Key>。

第二，Provider 命名要统一。比如 DeepSeek-v4-pro、DeepSeek-v4-flash，不要每个人随手起一个名字。

第三，正式项目第一次使用时，只允许先读项目，不直接改项目。确认它能正确理解目录、技术栈和当前任务后，再让它做小范围改动。

第四，重要代码改动必须看 diff。diff 就是修改前后的差异。Claude Code 能帮忙写代码，但合并前仍要人工确认。

第五，配置要留一份模板，不留真实 Key。比如团队文档里记录 Base URL、模型名、检查步骤和常见报错，但不保存任何人的私有密钥。

最后收一下

这条路的重点不是把 DeepSeek 填进 Claude Code。

真正要做的是把三件事分清楚。

Claude Code 负责在项目目录里干活。CC Switch 负责管理 Provider。DeepSeek 负责模型回答。

能装上，不算完成。

能在测试目录里只读回答、确认后写入文件、知道当前走的是 DeepSeek、出错时能判断是 Key、模型名、接口地址还是终端环境问题，这才算第一阶段跑通。

参考资料

• • Anthropic Claude Code 安装文档：https://code.claude.com/docs/en/setup
• • Anthropic Claude Code 权限模式文档：https://code.claude.com/docs/en/permission-modes
• • CC Switch 官网：https://ccswitch.ai/
• • CC Switch GitHub：https://github.com/farion1231/cc-switch
• • CC Switch Add Provider 用户手册：https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/en/2-providers/2.1-add.md
• • CC Switch v3.12.0 Stream Check 说明：https://github.com/farion1231/cc-switch/blob/main/docs/release-notes/v3.12.0-zh.md
• • DeepSeek 接入 Claude Code 文档：https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/claude_code
• • DeepSeek 模型与价格文档：https://api-docs.deepseek.com/quick_start/pricing

我是一名 数字创作者 · 独立开发者 · 技术博主，专注成长，拓展技术边界，持续突破自我。