发布时间：2026-07-14
标签：AI Agent｜实战｜Claude Code｜DeepSeek｜操作指南
目标
让 Claude Code 用DeepSeek当大脑，Claude Code 当双手。
DeepSeek 已提供原生 Anthropic 兼容端点，不需要任何代理或翻译层——设对几个环境变量，claude一启动就直接走 DeepSeek，成本降到官方 Claude 的几十分之一。
⚠️本文是临时变量方案。每个新终端都要重设一遍变量，简单但不持久。
第 04 篇会用CCSwitch统一管理多模型配置，永久生效、一键切换——那是正式方案。
环境准备
- 已完成第 01 篇（基础环境 + Claude Code 已安装并能启动）
- 一个 DeepSeek 账号，并拿到 API Key（platform.deepseek.com → API Keys → 创建）
- 网络能访问
api.deepseek.com
步骤
1. 拿到 DeepSeek API Key
登录 platform.deepseek.com →API Keys→ 创建新的 Key，复制形如sk-xxxx的密钥。只显示一次，存好。
2. 设置环境变量（这一步替代登录）
DeepSeek 提供了原生 Anthropic 兼容端点https://api.deepseek.com/anthropic，Claude Code 可以直接对话，不用架任何代理。
在同一终端里，依次执行以下变量设置（Windows PowerShell）：
$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic" $env:ANTHROPIC_AUTH_TOKEN = "sk-你的deepseek 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"Mac / Linux 用户把$env:换成export，等号右边加引号即可：
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" export ANTHROPIC_AUTH_TOKEN="sk-你的deepseek key" export ANTHROPIC_MODEL="deepseek-v4-pro[1m]" # ... 其余同上每个变量在做什么：
| 变量 | 作用 |
|---|---|
ANTHROPIC_BASE_URL | 把 Claude Code 的请求地址从 Anthropic 官方切到 DeepSeek |
ANTHROPIC_AUTH_TOKEN | 用 DeepSeek Key 认证（不是 Anthropic 的 Key） |
ANTHROPIC_MODEL | 默认模型，deepseek-v4-pro[1m]是新旗舰 |
ANTHROPIC_DEFAULT_*_MODEL | 覆盖 Claude Code 内的三档模型选择（Opus/Sonnet/Haiku 成对替代） |
CLAUDE_CODE_SUBAGENT_MODEL | 子 Agent 用轻量模型，省成本提速 |
CLAUDE_CODE_EFFORT_LEVEL | max强制最强推理（不要省这一次） |
建议把这七行保存成一个脚本（如
ds.ps1），每次新开终端跑一下即可，不用手打。
3. 进入项目目录并启动
cd ~/ai-agent-lab # Windows 可能需要放开脚本执行策略（只需第一次）： Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass claude进入 Claude Code 后，确认模型已经切换到 DeepSeek：
> 你现在的底层模型是什么？它应该告诉你用的是 DeepSeek 模型。如果回复里提到deepseek，说明请求确实走到了 DeepSeek 端点。
验证
三步全过 = 接入成功：
- 七行环境变量设好，无报错
claude能正常进入交互界面- 问一句"你是谁"或"底层模型是什么"，回复确认走的是 DeepSeek
做个最小编码测试确认能力无损：
> 用 Python 写一个快速排序能正常生成代码 = 编码能力正常，完全可替代官方 Claude。
踩坑记录
1. 忘了设ANTHROPIC_AUTH_TOKEN，直接跑 claude
Claude Code 会尝试用之前登录的 Anthropic 账号，绕过 DeepSeek。确保这个变量指向的是sk-开头的 DeepSeek Key，而不是 Anthropic 的 Key。
2. 模型名写错
必须严格用 DeepSeek 平台上的准确模型名（如deepseek-v4-pro[1m]）。别自己编名字，写错会直接报 404 或模型不存在的错误。
3. 每次开终端都要重设环境变量（临时方案的痛点）$env:设置只管当前终端。这也是为什么这只是"临时变量简单版"——简单但不持久。第 04 篇的 CCSwitch 就是来根治这个问题的：写一次配置，永久生效，一键切换模型。
4. Windows 直接跑 claude 报执行策略错误
PowerShell 默认禁止运行脚本。执行Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass（仅影响当前终端），再跑。
5. DeepSeek 的工具调用在极端复杂多步任务中弱于 Claude 官方
这是模型能力差异，不是接入问题。简单到中等编码任务几乎无差别，成本几十倍差距让这个差异完全可以接受。
下一步
现在先走 OpenRouter 试试更多模型（还是临时变量思路）：
→ AI Agent 开发实战（03）：Claude Code 接入 OpenRouter
等 OpenRouter 和 DeepSeek 都跑通了，就不该再用手管环境变量了。第 04 篇用CCSwitch 一个配置搞定所有模型切换——那是正式方案，写完就再也不用敲$env:了。
消息与对话框服务：MessageService与FileDialogService)
