在 Claude Code中配置DeepSeek：从报错到成功调用【支持DeepSeekV4】

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

准备工作

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

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

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

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 的后端服务：

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

json 复制代码

{
"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 模型的配置示例如下：
json 复制代码
{
"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：

访问 DeepSeek 官方网站（www.deepseek.com/），选择进入API开放...
进入 API 管理页面
创建一个新的 API Key

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

3.2 配置 API Key

回到 Claude Code 的配置文件，将刚才创建的 API Key 填入配置中：

json 复制代码

{
"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: 建议：

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

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

参考： api-docs.deepseek.com/zh-cn/guide...