在Claude Code中配置DeepSeek从报错到成功调用的全流程实践整理

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“在Claude Code中配置DeepSeek从报错到成功调用的全流程”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际使用顺序，把思路、关键写法和容易踩坑的地方讲清楚，方便你直接对照操作。

落到代码里，第一次启动 Claude Code 时，我遇到了"Unable to connect to Anthropic services"的错误。折腾了一番才发现，原来可以换成 DeepSeek。但设置过程又踩了几个坑——这篇文章就是帮你绕过这些坑。

准备工作

在开始之前，请确保你已经具备以下条件：

• 已安装 Claude Code（可借助官方渠道下载）
• 拥有 DeepSeek 的 API 访问权限（可在 DeepSeek 官网申请）
• 基本的命令行操作知识
• 若遇到claude命令未找到，在环境变量中追加路径设置
• Windows Claude命令行工具一般在 C:Users你的用户名.localbin 目录下

第一阶段：解决“无法连接服务”错误

1.1 初次启动遇到的报错

实际处理时，你第一次尝试启动 Claude Code 时，可能会遇到“Unable to connect to Anthropic services”的错误提示：

理解这一步时，这个错误通常是由于 Claude Code 默认尝试连接 Anthropic 的官方服务，而你的网络环境可能无法直接访问。

1.2 找到设置文件

理解这一步时，要解决这个问题，我们需找到 Claude Code 的设置文件。设置文件通常位于用户目录下的 .claude 文件夹中：

结合项目来看，在 Windows 系统里，你能够借助以下路径找到它：C:Users你的用户名.claude

1.3 修改设置文件

在这个场景下，打开设置文件后，我们需添加 DeepSeek 的 API 端点设置。DeepSeek 提供了兼容 OpenAI API 的接口，我们可以将其设置为 Claude Code 的后端服务：

在设置文件中粘贴以下内容：

{
"env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "${DEEPSEEK_API_KEY}",
    "API_TIMEOUT_MS": 600000,
    "ANTHROPIC_MODEL": "deepseek-chat",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  }
}

注意：这里的 ${DEEPSEEK_API_KEY} 需替换为你自己的 DeepSeek API Key，我们将在第三阶段详细说明如何拿到。另外，这些设置项可能会随 Claude Code 或 DeepSeek 更新而变化，如果遇到问题可以查阅官方文档。

2026-04-24 新增DeepSeek V4 模型适配说明： 原有的 deepseek-chat 和 deepseek-reasoner 模型名将于 2026/07/24 弃用，建议升级采用新版 V4 系列模型：

• deepseek-v4-flash：高速响应模型，对应原 deepseek-chat 的非思考模式
• deepseek-v4-pro：高性能模型，兼容思考模式

适配 V4 模型的设置示比如下所示：

{
"env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "${DEEPSEEK_API_KEY}",
    "API_TIMEOUT_MS": 600000,
    "ANTHROPIC_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  }
}

第二阶段：处理401未授权错误

2.1 选择界面样式

实际处理时，设置文件修改完成后，重新启动 Claude Code。首次启动时，系统会让你选择界面样式：

你可以根据个人喜好选择命令行主题，这不会影响核心功能。

2.2 信任工作目录

接下来，Claude Code 会询问是否信任当前工作目录：

选择“是”以允许 Claude Code 在当前目录中读取和写入文件。

2.3 首次提问尝试

现在，你可以尝试向 Claude Code 提问了：

输入一个问题，比如“你是什么模型？”。

2.4 遇到401错误

若你还没有设置有效的 API Key，你会遇到 401 未授权错误：

理解这一步时，这个错误提示表明 Claude Code 已经成功连接到了 DeepSeek 的 API 服务器，但由于缺少有效的 API Key，请求被拒绝了。

第三阶段：新建 DeepSeek API 并成功调用

3.1 新建 DeepSeek API Key

在这个场景下，要解决 401 错误，你需拿到一个有效的 DeepSeek API Key：

1. 访问 DeepSeek 官方网站（www.deepseek.com/）
2. 进入 API 管理页面
3. 新建一个新的 API Key

记得保存，页面关了就看不到了。

3.2 设置 API Key

结合项目来看，回到 Claude Code 的设置文件，将刚才新建的 API Key 填入设置中：

{
"env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "填入你真实的API KEY",
    "API_TIMEOUT_MS": 600000,
    "ANTHROPIC_MODEL": "deepseek-chat",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  }
}

3.3 成功调用

现在再次尝试提问，你应该能看到成功的响应：

从实现思路看，这表明 Claude Code 已经成功借助 DeepSeek 的 API 处理了你的请求。

3.4 查询可用技能

落到代码里，Claude Code 除了本身多种命令外，还可扩展多种技能（Skills），你可以直接提问查询/安装，无需掌握太多专业的命令：

常用问题解答

Q1: 除了 DeepSeek，还能设置其他模型吗？

A: 可以。Claude Code 兼容任何兼容 OpenAI API 的模型服务 以及国产主流大模型，你只需修改 base_url 和 model 参数即可。具体如何设置参考相应大模型的官方设置手册。比如：

火山方舟

对接文档：Claude Code--火山方舟-火山引擎

兼容模型（2026-5）： doubao-seed-2.0-code、doubao-seed-2.0-pro、 doubao-seed-2.0-lite、 doubao-seed-code、minimax-m2.5、minimax-m2.7、 glm-4.7、glm-5.1、deepseek-v3.2、kimi-k2.5、kimi-k2.6

智谱

对接文档： Claude Code - 智谱AI开放文档

落到代码里，兼容模型（2026-5）：所有套餐用户均兼容 GLM-5.1、GLM-5-Turbo、GLM-4.7、GLM-4.5-Air，如果有新模型发布，一般会优先在Pro、Max套餐中更新，基础套餐稍后。

说明：目前GLM Coding Plan套餐最难抢，GLM-5 在国产大模型中表现不错，可以在Trae CN中免费采用（高峰期需排队）。

MiniMax

对接文档：Claude Code - MiniMax API Docs

结合项目来看，兼容模型（2026-5）：与套餐有关。最便宜的是标准版Starter（价格：29/月 或 290/年），不兼容生成图像、语音、音乐和视频。

说明：MiniMax的套餐应该是这几家里面性价比最高的，但是用户体验是个谜。

Q2: 如何确保 API Key 的安全？

A: 建议：

1. 不要将 API Key 提交到版本控制系统（如 Git）
2. 采用环境变量存储敏感信息
3. 定期轮换 API Key

从实现思路看，设置完成。但每次换模型都要改设置文件，有点麻烦。下一篇我会介绍 CC Switch——一个可以更快切换模型和管理技能的工具，让 Claude Code 更好用。

结合项目来看，总的来说，Claude这部分内容适合结合实际项目边做边理解。先抓住核心思路，再逐步补上细节和边界处理，最后效果会更稳定，也更容易复用。