Claude Code + DeepSeek 模型-成培培的博客

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，默认使用 Claude 系列模型。但你知道吗？通过 Anthropic 兼容 API，我们可以将它连接到 DeepSeek 模型，享受开源模型的性价比优势。

为什么选择 DeepSeek？

性价比极高：DeepSeek-V4 的性能接近顶级闭源模型，但 API 价格远低于 Claude Opus
1M 上下文窗口：deepseek-v4-pro[1m] 支持 100 万 token 的超长上下文，非常适合大型代码库
Anthropic API 兼容：DeepSeek 提供了 /anthropic 端点的 Messages API 兼容层，可以无缝接入 Claude Code

环境配置

将以下配置添加到你的 shell 配置文件（~/.zshrc 或 ~/.bashrc）中：

# DeepSeek API 地址（Anthropic 兼容端点）
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic

# 你的 DeepSeek API Key
export ANTHROPIC_AUTH_TOKEN=你的DeepSeek-API-Key

# 默认模型 — 主力干活模型
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]

# 各档位模型的映射
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]    # 最强模型
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]  # 中等模型
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash     # 轻量快速模型

# 子任务模型 — 用轻量模型降低开销
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash

# 推理深度 — max 档位获得最深入的思考
export CLAUDE_CODE_EFFORT_LEVEL=max

配置生效：

source ~/.zshrc

配置详解

环境变量	作用	推荐值
`ANTHROPIC_BASE_URL`	API 端点地址	`https://api.deepseek.com/anthropic`
`ANTHROPIC_AUTH_TOKEN`	API 密钥	你的 DeepSeek API Key
`ANTHROPIC_MODEL`	默认使用的模型	`deepseek-v4-pro[1m]`
`ANTHROPIC_DEFAULT_OPUS_MODEL`	Opus 级别任务使用的模型	`deepseek-v4-pro[1m]`
`ANTHROPIC_DEFAULT_SONNET_MODEL`	Sonnet 级别任务使用的模型	`deepseek-v4-pro[1m]`
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	Haiku 级别任务使用的模型	`deepseek-v4-flash`
`CLAUDE_CODE_SUBAGENT_MODEL`	子 Agent 使用的模型	`deepseek-v4-flash`
`CLAUDE_CODE_EFFORT_LEVEL`	推理深度等级	`max`

模型分层的智慧

这个配置的核心思路是 分级使用模型：

主力模型：deepseek-v4-pro[1m] 承担 Opus 和 Sonnet 两个级别的任务 — 也就是主要的代码编写、架构设计、复杂调试
轻量模型：deepseek-v4-flash 承担 Haiku 级别任务和子 Agent 任务 — 比如文件搜索、简单的代码阅读、批量重命名等轻量操作
子 Agent 分离：CLAUDE_CODE_SUBAGENT_MODEL 专门设置为 flash 版本，因为子 Agent 通常执行搜索、读取等轻量任务，用重量模型性价比不高

启动 Claude Code

配置完成后，直接启动：

claude

你会看到 Claude Code 的 TUI 界面启动，但底层调用的已经是 DeepSeek 的模型了。所有 Claude Code 的功能 — 文件读写、命令执行、Git 操作、子 Agent 调度 — 都正常工作。

使用技巧

1. 善用 1M 上下文

DeepSeek-V4 Pro 的 100 万 token 上下文是它的核心优势之一：

# 直接让 Claude Code 阅读整个项目
claude -p "分析这个项目的整体架构，给出改进建议"

Claude Code 会自动将相关文件内容发送给模型，1M 窗口意味着你可以一次性加载非常大的代码库上下文。

2. 合理使用 Effort Level

# 快速问题 — 降低到 medium
export CLAUDE_CODE_EFFORT_LEVEL=medium

# 复杂架构决策 — 用 max
export CLAUDE_CODE_EFFORT_LEVEL=max

max 档位会让模型进行更深层的推理（thinking），适合复杂任务。简单任务可以临时切换到 medium 或 low 加速响应。

3. 子 Agent 模型的选择

# 如果子 Agent 任务也很复杂
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-pro[1m]

# 如果追求极致性价比
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash

一般来说 deepseek-v4-flash 足够应付子 Agent 的文件搜索和代码阅读需求。

4. 验证连接

启动后可以验证当前使用的模型：

# 在 Claude Code 对话中直接问
> 你当前使用的是哪个模型？

常见问题

Q: 和原生 Claude 模型相比，体验有什么区别？

优势：

价格更低（通常只有 Claude Opus 的 1/10 甚至更低）
1M 上下文窗口（Claude Sonnet 为 200K）
中文理解和生成能力在某些场景更自然

需要注意：

Tool use 的遵循度可能不如原生 Claude 模型精确
某些 Claude Code 的高级功能（如 DesignSync）可能需要原生 API
推理风格有差异，可能需要调整 prompt 习惯

Q: 如何切换回原生 Claude 模型？

取消环境变量即可：

unset ANTHROPIC_BASE_URL
unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_MODEL
unset ANTHROPIC_DEFAULT_OPUS_MODEL
unset ANTHROPIC_DEFAULT_SONNET_MODEL
unset ANTHROPIC_DEFAULT_HAIKU_MODEL
unset CLAUDE_CODE_SUBAGENT_MODEL
unset CLAUDE_CODE_EFFORT_LEVEL

或者更简单 — 关闭当前终端，新开一个未配置这些变量的终端。

Q: DeepSeek 的 Anthropic 兼容端点稳定吗？

DeepSeek 的 /anthropic 端点实现了 Anthropic Messages API 的核心功能，包括：

基础消息对话
Tool use / Function calling
Streaming 响应
System prompt

对于 Claude Code 的日常开发场景来说完全够用。

总结

通过几行环境变量配置，就能让 Claude Code 跑在 DeepSeek 模型上。这套方案适合：

个人开发者：预算敏感但仍想享受 AI 编程助手的能力
中文项目：DeepSeek 对中文的理解和生成更自然
大型代码库：1M 上下文窗口让模型能一次性理解更多代码

Claude Code 优秀的 CLI 交互设计 + DeepSeek 的高性价比模型，是一个生产力与成本兼顾的组合。试试看吧！

没错，以上内容为Claude Code + DeepSeek生成。。。

目录CONTENT

Claude Code + DeepSeek 模型