Claude Code + DeepSeek 配置指南：最强 Agent 搭配高性价比模型

原创。Claude Code 搭配 DeepSeek 模型的完整配置方案：环境变量、配置文件、别名设置都有。

官方方案

DeepSeek 提供了专门的 Anthropic 兼容 API 端点。Claude Code 可以直接通过环境变量配置连接到 DeepSeek，不需要任何代理或中间层。

code

Claude Code
     │
     ▼
api.deepseek.com/anthropic  ← DeepSeek 官方的 Anthropic 兼容端点
     │
     ▼
  DeepSeek 模型

配置步骤

1. 安装 Claude Code

code

npm install -g @anthropic-ai/claude-code

验证安装：

code

claude --version

2. 配置环境变量

Linux / Mac 用户：

code

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[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
export CLAUDE_CODE_EFFORT_LEVEL=max

Windows (PowerShell) 用户：

code

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="你的DeepSeek API 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"

3. 启动

code

cd /path/to/your-project
claude

4. 配置解释

环境变量	说明	DeepSeek 推荐值
`ANTHROPIC_BASE_URL`	API 端点地址	`https://api.deepseek.com/anthropic`
`ANTHROPIC_AUTH_TOKEN`	DeepSeek 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`	Agent 推理力度	`max`

5. 持久化配置

不想每次打开终端都设置一遍？写入 shell 配置文件：

code

# ~/.zshrc 或 ~/.bashrc
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[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
export CLAUDE_CODE_EFFORT_LEVEL=max

执行 source ~/.zshrc 生效后，直接 claude 即可使用 DeepSeek。

6. 通过 Claude Code 配置文件设置

Claude Code 支持通过 JSON 配置文件设置参数，这种方式比环境变量更整洁，也支持项目级隔离。

全局配置（适用于所有项目）：

code

// ~/.claude/settings.json
{
  "baseUrl": "https://api.deepseek.com/anthropic",
  "authToken": "你的DeepSeek API Key",
  "model": "deepseek-v4-pro[1m]",
  "modelMap": {
    "opus": "deepseek-v4-pro[1m]",
    "sonnet": "deepseek-v4-pro[1m]",
    "haiku": "deepseek-v4-flash"
  },
  "subagentModel": "deepseek-v4-flash",
  "effortLevel": "max"
}

项目级配置（仅对当前项目生效）：

code

// my-project/.claude/settings.json
{
  "baseUrl": "https://api.deepseek.com/anthropic",
  "authToken": "你的DeepSeek API Key",
  "model": "deepseek-v4-pro[1m]",
  "modelMap": {
    "opus": "deepseek-v4-pro[1m]",
    "sonnet": "deepseek-v4-pro[1m]",
    "haiku": "deepseek-v4-flash"
  },
  "subagentModel": "deepseek-v4-flash"
}

配置文件的优先级高于环境变量：项目级配置 > 全局配置 > 环境变量 > 默认值。这样你可以为不同项目设置不同的模型策略。

7. 双模式切换（日常 DeepSeek + 偶尔 Claude）

如果还想保留偶尔切回 Claude 的能力，写两个 alias：

code

# ~/.zshrc
alias cc-deepseek='ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic \
  ANTHROPIC_AUTH_TOKEN=你的DeepSeek Key \
  ANTHROPIC_MODEL=deepseek-v4-pro[1m] \
  CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash \
  claude'
 
alias cc-claude='claude --model claude-sonnet-4-20250514'

code

# 日常开发用 DeepSeek
cc-deepseek
 
# 复杂任务切 Claude
cc-claude

注意事项

API 端点：DeepSeek 的 Anthropic 兼容端点是 api.deepseek.com/anthropic，不是根路径
认证方式：使用 ANTHROPIC_AUTH_TOKEN 环境变量，不是 ANTHROPIC_API_KEY
模型名称：deepseek-v4-pro[1m] 是主力模型（[1m] 表示 100 万 token 上下文窗口），deepseek-v4-flash 是快速轻量模型
子 Agent 模型：Claude Code 在复杂任务中会派生子 Agent，建议设为 deepseek-v4-flash 以平衡速度和成本
Effort Level：设为 max 让 Claude Code 在推理时投入更多算力，效果更好

总结

DeepSeek 官方提供了完善的 Claude Code 接入方案，配置极其简单——设置 8 个环境变量即可。不需要代理、不需要格式转换、不需要第三方工具。

Claude Code 的 Agent 能力 + DeepSeek 的高性价比模型，是独立开发者目前最实用的 AI 编程组合：成本降到约 1/30，Agent 体验完整保留。

Claude Code + DeepSeek 配置指南：最强 Agent 搭配高性价比模型

官方方案

配置步骤

1. 安装 Claude Code

2. 配置环境变量

3. 启动

4. 配置解释

5. 持久化配置

6. 通过 Claude Code 配置文件设置

7. 双模式切换（日常 DeepSeek + 偶尔 Claude）

注意事项

总结

相关文章

Claude Code 最佳实践：验证机制、上下文管理与规模化工作流

AI 编程工具选型实战：从 Aider 到 Cline，不同场景怎么选

2026 年开源 AI 编程工具全景盘点