这篇教程适合谁
如果你正在用 Claude Code,但希望把默认 API 后端切到 DeepSeek 提供的 Anthropic 兼容端点,这篇就是直接能照着做的配置稿。
它的核心目标很简单:不改 Claude Code 的基本使用方式,只通过环境变量,把请求入口、认证方式和默认模型映射改成 DeepSeek 方案。
这篇教程同时适合两类人:
用 Claude Code CLI 的终端用户
用 VS Code 等 IDE 插件 的图形界面用户
如果你本身就是 IDE 插件用户,可以跳过 CLI 安装部分,直接看环境变量配置。
一、安装 Claude Code
CLI 用户
如果你还没有安装 Claude Code CLI,可以先执行:
npm install -g @anthropic-ai/claude-code如果你已经在本地装好了,或者你主要使用的是 IDE 插件,那么这一节可以直接略过。
二、配置 DeepSeek 兼容端点
这一部分是整篇教程的重点。真正决定 Claude Code 走不走 DeepSeek 兼容接口的,就是这些环境变量。
核心变量包括:
DEEPSEEK_API_KEY:你的 DeepSeek API Key
ANTHROPIC_BASE_URL:DeepSeek 提供的 Anthropic 兼容地址
ANTHROPIC_AUTH_TOKEN:Claude Code 调用时使用的认证 Token
ANTHROPIC_MODEL:默认模型
默认模型映射变量:把 Opus / Sonnet / Haiku 映射到你想用的 DeepSeek 模型
Claude Code 接入 DeepSeek 配置总览
2.1 Windows 配置
Windows 下建议直接以 管理员权限打开 PowerShell,然后依次执行。
配置 API Key
[Environment]::SetEnvironmentVariable("DEEPSEEK_API_KEY", "your-actual-api-key-here", "Machine")配置 API 地址与认证 Token
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.deepseek.com/anthropic", "Machine")[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $env:DEEPSEEK_API_KEY, "Machine")这里的思路很直接:Claude Code 以后发往 Anthropic 风格接口的请求,统一改走 DeepSeek 的兼容端点。
Windows 下用 PowerShell 配置 DeepSeek 兼容端点
配置默认模型
高性能模型:
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-v4-pro", "Machine")
快速模型:
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-v4-flash", "Machine")这两个只需要 二选一。如果你更重视效果,可以先用 deepseek-v4-pro;如果更看重速度和成本,可以换成 deepseek-v4-flash。
配置模型映射
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_OPUS_MODEL", "deepseek-v4-pro", "Machine") [Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_SONNET_MODEL", "deepseek-v4-pro", "Machine") [Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_HAIKU_MODEL", "deepseek-v4-flash", "Machine")[Environment]::SetEnvironmentVariable("CLAUDE_CODE_SUBAGENT_MODEL", "deepseek-v4-pro", "Machine")这一组变量很有用,因为它让 Claude Code 在不同档位和子智能体场景下,都能自动选中你预设的 DeepSeek 模型,而不是继续走默认 Anthropic 配置。
附加配置
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", "Machine")[Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK", "1", "Machine")[Environment]::SetEnvironmentVariable("CLAUDE_CODE_EFFORT_LEVEL", "max", "Machine")这些附加项的作用可以简单理解成:
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:禁用非必要网络流量
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK:禁用非流式回退
CLAUDE_CODE_EFFORT_LEVEL:把推理努力级别拉高
如果你想先保守一点,也可以先不把 EFFORT_LEVEL 设为 max,后面再根据实际体验调整。
2.2 Linux / macOS 配置
如果你用的是 Linux 或 macOS,方式会更自然一些:把变量写进你的 shell 配置文件。
常见位置包括:
~/.bashrc
~/.zshrc
~/.bash_profile
Linux 与 macOS 下写入 Shell 配置文件
配置 API Key
export DEEPSEEK_API_KEY="your-actual-api-key-here"配置 API 地址与认证 Tokenexport ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" export ANTHROPIC_AUTH_TOKEN="$DEEPSEEK_API_KEY"配置默认模型高性能模型:export ANTHROPIC_MODEL="deepseek-v4-pro"快速模型:export ANTHROPIC_MODEL="deepseek-v4-flash"同样也是 二选一。配置模型映射export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro"export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro"export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"export CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-pro"附加配置export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"export CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK="1"export CLAUDE_CODE_EFFORT_LEVEL="max"三、让配置真正生效很多人配置完变量后发现“怎么没反应”,问题通常不在变量本身,而在于 当前 shell 还没重新加载。
根据你修改的文件,执行对应命令:
source ~/.bashrc
或者:
source ~/.zshrc
或者:
source ~/.bash_profile
如果你是 IDE 插件用户,那么别忘了 重启 VS Code 或其他编辑器,让新的环境变量被插件宿主进程重新读取。
四、怎么验证有没有接通
CLI 用户
重新打开终端后直接运行:
claude
如果 Claude Code 能正常启动,并且后续请求不再报默认 Anthropic 侧的认证错误,那通常说明配置已经生效。
IDE 插件用户
对于 IDE 用户,最简单的做法就是:
重启编辑器
打开 Claude Code 插件
发起一次正常请求
看是否按你设置的模型和端点工作
如果插件支持日志或开发者输出窗口,也可以顺手看一下调用信息,确认走的是不是 DeepSeek 兼容地址。
Claude Code 接入 DeepSeek 后的验证检查清单
五、一套更实用的理解方式
这套配置的本质,其实就是三步:
1. 把认证信息给 Claude Code
2. 把接口入口改成 DeepSeek 的 Anthropic 兼容端点
3. 把默认模型和子智能体模型映射到你想用的 DeepSeek 型号
只要这三件事配对了,Claude Code 的使用体验基本不变,但后端就已经换成了 DeepSeek。
六、最后提醒
正式使用前,建议你再检查三件小事:
API Key 是否真实可用
ANTHROPIC_BASE_URL 是否写成了 https://api.deepseek.com/anthropic
shell 配置是否已经重新加载,或者 IDE 是否已经重启
如果这三项都没问题,Claude Code 接入 DeepSeek 兼容端点通常就能跑通。



