Claude Code + CC Switch 接入 DeepSeek V4 Flash

Claude Code 的交互、工具调用和项目理解体验很好，但并不意味着请求只能发送给 Anthropic。DeepSeek 已提供 Anthropic Messages 兼容端点，因此可以让 Claude Code 保持原来的终端工作流，将推理请求交给 deepseek-v4-flash。

这篇文章记录两种配置方式：日常使用推荐 CC Switch，便于在多个供应商之间切换；环境变量方式则适合验证问题。本文以 2026 年 8 月的官方接口为准，模型与客户端更新后应优先检查文末文档。

Anthropic 官方支持 Claude Code 连接 LLM Gateway，但明确说明不为网关转发到非 Claude 模型提供支持。本方案依赖 DeepSeek 的兼容接口与 CC Switch，升级前最好保留可用配置。

调用链路

Claude Code
   │ Anthropic Messages
   ▼
CC Switch 写入的供应商配置
   │ https://api.deepseek.com/anthropic
   ▼
DeepSeek V4 Flash

DeepSeek V4 Flash 支持思考/非思考模式、Tool Calls 和 1M 上下文。这里选择 Flash 是因为它速度快、价格低，适合作为日常编码主模型；复杂架构设计也可以把主模型换成 deepseek-v4-pro[1m]，让子任务继续使用 Flash。

准备工作

需要准备：

1. Node.js 18 或更高版本；Windows 还需安装 Git for Windows。
2. Claude Code 最新版。
3. CC Switch 最新版。
4. DeepSeek 开放平台中创建的 API Key，并确保账户有可用余额。

安装或升级 Claude Code：

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

CC Switch 请从 官方仓库 Releases 下载对应系统版本。不要从名称相似的第三方下载站获取安装包。

在 CC Switch 中添加 DeepSeek

打开 CC Switch，切换到 Claude 页面，点击右上角添加供应商：

1. 预设选择 DeepSeek；如果当前版本没有预设，选择 Custom。
2. API 格式选择 Anthropic Messages。
3. Base URL 填写 https://api.deepseek.com/anthropic。
4. 填入 DeepSeek API Key。
5. 展开高级配置，确认模型映射后保存。

如果使用 JSON 编辑器，可以按下面的核心配置填写。API Key 应通过 CC Switch 的密钥输入框保存，不要把真实值提交到 Git 仓库。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "<YOUR_DEEPSEEK_API_KEY>",
    "ANTHROPIC_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_EFFORT_LEVEL": "max"
  }
}

这里把 Opus、Sonnet、Haiku 和子 Agent 全部映射到 V4 Flash，目的是无论 Claude Code 内部选择哪个角色，都落到同一个模型。如果希望复杂任务使用 V4 Pro，可以改成：

{
  "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"
}

DeepSeek 已原生提供 Anthropic 格式，所以 Claude Code 场景不需要为了协议转换启用本地代理。若错误选择 OpenAI Chat Completions，CC Switch 才需要运行本地路由做格式转换，链路也会更复杂。

激活并验证

在 CC Switch 的 DeepSeek 卡片上点击启用，然后关闭旧的 Claude Code 会话，在项目目录重新启动：

cd /path/to/your-project
claude

第一次启动若仍出现 Claude 登录向导，可在 CC Switch 设置里启用“跳过 Claude Code 首次运行确认”，再重新启用供应商。进入会话后先执行一个只读任务，例如：

请只分析当前项目的技术栈，列出入口文件和构建命令，不要修改文件。

确认能读取仓库、调用工具并返回结果后，再尝试修改文件。还可以在 DeepSeek 控制台查看请求与余额变化，确认流量确实进入 DeepSeek，而不是使用了原有 Claude 登录态。

不经过 CC Switch 的验证方法

当 GUI 配置有问题时，可以临时用环境变量排除 CC Switch 影响。PowerShell：

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<YOUR_DEEPSEEK_API_KEY>"
$env:ANTHROPIC_MODEL="deepseek-v4-flash"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-flash"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-flash"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"
claude

Linux/macOS：

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<YOUR_DEEPSEEK_API_KEY>
export ANTHROPIC_MODEL=deepseek-v4-flash
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-flash
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-flash
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max
claude

这些变量只用于当前终端会话更安全。若写入 Shell 配置文件，要确保文件权限正确且不会被同步到公开仓库。

常见问题

仍要求登录 Claude

先确认 CC Switch 中供应商已经“启用”，再彻底退出旧终端并重新启动。首次运行向导无法跳过时，开启 CC Switch 的跳过首次确认选项。不要同时在系统环境变量和 CC Switch 中保留两套互相冲突的地址。

返回 401 或余额不足

检查 API Key 是否有多余空格、是否被撤销，并到 DeepSeek 控制台确认余额。ANTHROPIC_AUTH_TOKEN 应填写 DeepSeek Key，不是 Anthropic Key。

返回 404

Claude Code 使用的 Base URL 是 https://api.deepseek.com/anthropic，不是 OpenAI 格式的 /v1 地址，也不要手动追加 /v1/messages。

工具调用一段时间后出现 thinking 历史错误

旧版兼容层可能没有正确回传思考块，常见提示包含 thinking must be passed back。先升级 Claude Code 和 CC Switch，结束旧 session 后新建会话。当前 DeepSeek 官方 Anthropic 端点与新版 CC Switch 已针对这类工具调用历史做了兼容处理。

模型名看起来仍是 Claude

Claude Code 的界面和内部角色名可能仍显示 Sonnet/Opus/Haiku；真正的上游模型由环境变量和 DeepSeek 的模型映射决定。以 CC Switch 生效配置、DeepSeek 请求记录和账单为准。

使用建议

• 默认先让 Agent 分析并给出计划，再开放写操作。
• 为大型仓库设置清晰的 CLAUDE.md，减少重复探索产生的 Token。
• 不要在提示词、截图或仓库文件中暴露 API Key。
• CC Switch、Claude Code 或 DeepSeek 接口升级后，先用小项目验证工具调用和长会话。
• V4 Flash 适合高频迭代；关键重构可以临时切换 V4 Pro 并进行人工审查。

参考资料

• DeepSeek：接入 Claude Code
• DeepSeek：Anthropic API 兼容说明
• DeepSeek：模型与价格
• CC Switch 官方仓库
• Claude Code：连接其他 LLM Gateway