DeepSeek V4 配置到 Claude Code 教程
Claude Code 使用 DeepSeek V4 Pro / V4 Flash 的完整配置教程:Anthropic 兼容 API、环境变量、模型选择、缓存命中成本和常见问题。
- 发布时间
- 阅读时长
- 7 分钟
- 来源
- DevTk.AI 博客
DeepSeek V4 已经提供 Anthropic 兼容接口,所以 Claude Code 可以直接跑在 DeepSeek 上,不需要额外代理。这个组合适合想保留 Claude Code 终端工作流,同时降低 token 成本的开发者,尤其适合反复读取同一个仓库上下文的任务。
官方参考: DeepSeek Coding Agents 接入 、 DeepSeek Anthropic API 和 DeepSeek V4 价格 。
推荐模型配置
| 用途 | 模型 | 原因 |
|---|---|---|
| 主 Agent | deepseek-v4-pro[1m] | 长程代码任务更稳,支持 1M 上下文 |
| 默认 Sonnet / Opus | deepseek-v4-pro | 对齐 DeepSeek 当前 Claude Code 示例 |
| 成本优化子 Agent | deepseek-v4-flash | 可选,更适合快速检查和辅助任务 |
| Effort | max | 复杂 Agent 任务需要更高思考强度 |
如果你更看重质量,或者任务需要更强的长程代码能力,先用 V4 Pro。高频、低复杂度任务可以直接用 V4 Flash。
macOS / Linux 配置
安装 Claude Code:
npm install -g @anthropic-ai/claude-code claude --version
设置 DeepSeek 端点和模型:
export
DEEPSEEK_API_KEY
=
your-deepseek-api-key
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
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如果你想进一步压低子任务成本,可以把 CLAUDE_CODE_SUBAGENT_MODEL 改成 deepseek-v4-flash 。
进入项目目录启动:
cd /path/to/your-project claude
启动后用 /status 检查 base URL 和模型是否生效。
Windows PowerShell 配置
$ env: DEEPSEEK_API_KEY = "your-deepseek-api-key" $ env: ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic" $ env: ANTHROPIC_AUTH_TOKEN = $ env: DEEPSEEK_API_KEY $ env: ANTHROPIC_MODEL = "deepseek-v4-pro[1m]" $ env: ANTHROPIC_DEFAULT_OPUS_MODEL = "deepseek-v4-pro" $ env: ANTHROPIC_DEFAULT_SONNET_MODEL = "deepseek-v4-pro" $ env: ANTHROPIC_DEFAULT_HAIKU_MODEL = "deepseek-v4-flash" $ env: CLAUDE_CODE_SUBAGENT_MODEL = "deepseek-v4-pro" $ env: CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1" $ env: CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK = "1" $ env: CLAUDE_CODE_EFFORT_LEVEL = "max"
然后运行:
claude
成本注意点
DeepSeek 现在使用分时价格。V4 Flash 闲时缓存命中/未命中输入/输出分别为 $0.007/$0.22/$0.66,高峰为 $0.014/$0.44/$1.32;V4 Pro 闲时为 $0.022/$0.66/$1.98,高峰为 $0.044/$1.32/$3.96。北京时间 09:00-12:00、14:00-18:00 属于高峰。
Claude Code 会反复发送项目规则、工具上下文和历史消息,所以缓存命中率会直接决定真实成本。如果你的任务反复复用同一个仓库上下文,实际账单会显著低于「全部输入未命中」的估算。
常见问题
| 问题 | 处理方式 |
|---|---|
| Claude Code 仍然走 Anthropic | 确认运行 claude 的同一个 shell 里设置了 ANTHROPIC_BASE_URL |
| 鉴权失败 | Claude Code 用 ANTHROPIC_AUTH_TOKEN ,不是 ANTHROPIC_API_KEY |
| 质量不稳定 | 主 Agent 用 deepseek-v4-pro[1m] ,并设置 CLAUDE_CODE_EFFORT_LEVEL=max |
| 成本比预期高 | 减少频繁变化的大段前缀;稳定前缀才容易命中缓存 |
相关内容:
- DeepSeek API 价格 2026
- DeepSeek V4 接入 OpenCode、Codex、Cline、Kilo、Roo
- AI 模型定价计算器