2.3.3 接入 DeepSeek 的完整步骤

Claude 系列模型受限、GLM 套餐难抢时,DeepSeek 是一个值得考虑的国内直连方案。

DeepSeek 是国内极具性价比的 AI 模型,代码能力强。官方为 Claude Code 专门提供了 Anthropic 兼容端点,不需要走 OpenAI 兼容接口。

官方文档:https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/claude_code。下面的配置与模型名与该文档一致,后续以官方文档为准。

Step 1:在 https://platform.deepseek.com/ 注册并获取 API Key。

Step 2:设置环境变量(注意 Base URL 是 /anthropic 端点,不是 /v1)

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:

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

或使用配置文件(推荐,不需重启终端):

// ~/.claude/settings.json
{
 "env": {
  "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
  "ANTHROPIC_AUTH_TOKEN": "<你的 DeepSeek API Key>",
  "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
  "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
  "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
  "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
  "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
  "CLAUDE_CODE_EFFORT_LEVEL": "max"
}
}

Step 3:进入项目目录,启动 Claude Code

cd /path/to/my-project
claude

启动后无需传 --model 参数,Claude Code 会通过环境变量调用 DeepSeek 官方示例中的模型映射。

选择主题:直接按数字即可

图片[1]-2.3.3 接入 DeepSeek 的完整步骤-大赛人网

按回车继续:

图片[2]-2.3.3 接入 DeepSeek 的完整步骤-大赛人网

确认目录:回车即可

图片[3]-2.3.3 接入 DeepSeek 的完整步骤-大赛人网

提示:DeepSeek 模型名、可用端点和 Claude Code 兼容能力会随官方迭代变化。实际使用前请打开上面的官方文档核对,不要照抄旧教程里的模型名。

Step 4:验证

> /status

在 cc 会话中输入 /status,可看到当前 Base URL 和模型是否已切换到 DeepSeek。

注意: 常见踩坑:如果你之前使用过 https://api.deepseek.com/v1(OpenAI 兼容端点)+ claude --model deepseek-chat 的老写法,建议改为 DeepSeek 官方 Claude Code 文档中的 Anthropic 兼容端点 https://api.deepseek.com/anthropic。

图片[4]-2.3.3 接入 DeepSeek 的完整步骤-大赛人网

2.3.4 多模型并存管理:cc-switch 可视化切换工具

上面几类方案你并不需要”二选一”——很多人的真实使用场景是:今天偶尔走 Anthropic 官方、明天切中转、后天干脆用 DeepSeek,偶尔还要用 GLM Coding Plan 套餐。手动改环境变量太麻烦,这时候就需要一个专门的多模型管理器。

cc-switch 是社区开源的一款桌面小工具,可以让你在多个 Claude Code 配置间一键切换。

  • 项目地址:https://github.com/farion1231/cc-switch
  • 下载:进入 Releases 页面,选对应系统(Windows、macOS、Linux)的安装包
  • 使用:打开 cc-switch → 点击“新增” → 填入 API Key 和 BaseURL → 起个名字(如 “Anthropic-官方”、“DeepSeek”、“GLM-CodingPlan”)保存 → 需要哪个点哪个

工作机制:cc-switch 把你配置的多个 API Key 和 BaseURL 存起来,选择哪个就自动修改对应的环境变量,然后重启终端运行 claude 就生效。

注意: 最容易翻车的坑(必看):切换 cc-switch 一定要在启动 claude 之前!如果你已经在 cc 会话里了再去 cc-switch 切换,是切不动的——环境变量在进程启动时就被加载到内存了。正确顺序是:先 cc-switch 选定配置 → 重启终端 → 运行 claude。很多新手都在这里上过当。

提示: 适用人群:如果你只用一家服务商,直接走上面配置方案里的 settings.json 即可,不需要 cc-switch。它是为”多模型重度用户”准备的。

© 版权声明
THE END
喜欢就支持一下吧
点赞8 分享
评论 抢沙发
头像-大赛人网
欢迎您留下宝贵的见解!
提交
头像-大赛人网

昵称

取消
昵称

    请登录后查看评论内容