AI 博客

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 价格 。

推荐模型配置

用途模型原因
主 Agentdeepseek-v4-pro[1m]长程代码任务更稳,支持 1M 上下文
默认 Sonnet / Opusdeepseek-v4-pro对齐 DeepSeek 当前 Claude Code 示例
成本优化子 Agentdeepseek-v4-flash可选,更适合快速检查和辅助任务
Effortmax复杂 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 模型定价计算器