DeepSeek V4 配置到 Claude Code 教程

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.02/M、缓存未命中输入 ¥1/M、输出 ¥2/M。V4 Pro 当前 2.5 折，到北京时间 2026-05-31 23:59，价格是缓存命中输入 ¥0.025/M、未命中 ¥3/M、输出 ¥6/M。

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 模型定价计算器