在 Claude Code中配置DeepSeek：从报错到成功调用

Quz

567人浏览 · 2026-03-30 07:00:00

Quz · 2026-03-30 07:00:00 发布

Claude Code 是 Anthropic 官方推出的 Claude 命令行工具，它允许开发者通过终端与 Claude 模型交互。然而，对于一些希望使用国产优秀大模型（如 DeepSeek）的用户来说，可能会遇到一些配置上的挑战。本文将带你一步步解决在 Claude Code 中配置 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 的后端服务：

在这里插入图片描述

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

{
"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，我们将在第三阶段详细介绍如何获取。

第二阶段：处理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 官方网站（https://www.deepseek.com/），选择进入API开放平台
进入 API 管理页面
创建一个新的 API Key

在这里插入图片描述

重要提示：创建 API Key 后，请立即复制并妥善保存，因为页面关闭后将无法再次查看完整的 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
  }
}