Claude Code 接入 DeepSeek 完整指南

悟空约 1128 字大约 4 分钟...

让 Claude Code 拥抱 DeepSeek 的强大能力，实现开发工作流的无缝切换

你好，我是悟空。

📝 前言

Claude Code 作为强大的 AI 编程助手，原本仅支持 Anthropic 的官方模型。但通过巧妙的配置，我们可以让它接入 DeepSeek，享受更灵活的模型选择和更具性价比的 API 服务。本文将带你一步步完成这个配置过程。

🚀 第一步：创建配置文件，指向 DeepSeek

在用户目录下的 ~./claude 文件夹中，新建 settings.json 配置文件：

MacOS 文件路径：

~/.claude/settings.json`

💡 小提示：如果 .claude 文件夹不存在，请手动创建它。

基础配置（使用推理模型）

将以下 JSON 配置粘贴到文件中（请务必将 sk-XXX 替换成你自己的 DeepSeek API Key）：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的 api key",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_MODEL": "deepseek-reasoner",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-reasoner",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-reasoner",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-reasoner",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-reasoner",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000"
  },
  "permissions": {
    "allow": [],
    "deny": []
  },
  "alwaysThinkingEnabled": false
}

📋 配置参数详解

参数	说明	备注
`ANTHROPIC_AUTH_TOKEN`	DeepSeek API 密钥	用于身份认证，请妥善保管
`ANTHROPIC_BASE_URL`	API 接口地址	核心配置！DeepSeek 提供的 Anthropic 兼容接口
`ANTHROPIC_MODEL`	默认模型	指定使用的 DeepSeek 模型
`ANTHROPIC_DEFAULT_OPUS_MODEL`	最复杂任务模型	适用于架构设计等高难度任务
`ANTHROPIC_DEFAULT_SONNET_MODEL`	日常编码模型	平衡性能与成本
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	简单任务模型	快速响应，成本更低
`CLAUDE_CODE_SUBAGENT_MODEL`	子代理模型	自动化子任务使用的模型
`CLAUDE_CODE_MAX_OUTPUT_TOKENS`	最大输出长度	可根据需求调整，最高支持 32K

🎯 模型选择策略

deepseek-reasoner：推理增强模型，适合复杂逻辑分析和架构设计
deepseek-chat：标准对话模型，性价比高，适合日常编码

💡 设计理念：通过区分不同场景下的默认模型，可以在保证质量的同时优化成本。例如，日常编码使用经济型模型，只有复杂架构任务才启用推理模型。

🤔 为什么可以这样配置？

DeepSeek 提供了与 Anthropic API 格式完全兼容的接口。这意味着：

协议兼容：DeepSeek 的 API 响应格式与 Anthropic 一致
无缝切换：只需修改 BASE_URL 和认证 Token，无需修改任何代码
功能完整：支持流式输出、函数调用等核心特性

✨ 第二步：运行验证

完成配置后，重新启动 Claude Code，你会看到成功接入 DeepSeek 的提示：

如图所示，Claude Code 已经成功连接到 DeepSeek 服务，可以开始使用了！

💰 第三步：优化配置，降低成本（可选）

如果你的使用场景主要是日常编码，建议将默认模型切换为 deepseek-chat，以获得更好的性价比：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxx",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_MODEL": "deepseek-chat",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-reasoner",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-chat",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000"
  },
  "permissions": {
    "allow": [],
    "deny": []
  },
  "alwaysThinkingEnabled": false
}