目录

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 修改配置文件（2026-05-18 更新：已删除过期配置）

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

原有的 deepseek-chat 和 deepseek-reasoner 模型名将于 2026/07/24 弃用，建议升级使用新版 V4 系列模型：

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

适配 V4 模型的配置示例如下：

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

注意：

  • 这里的 ${DEEPSEEK_API_KEY} 需要替换为你自己的 DeepSeek API Key，我们将在第三阶段详细介绍如何获取
  • 增加了 skipDangerousModePermissionPrompt 、bypassPermissions 这2个字段，目的是为了让Claude Code不要老是询问我，一直将任务干完

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

在这里插入图片描述

重要提示：创建 API Key 后，请立即复制并妥善保存，因为页面关闭后将无法再次查看完整的 Key。

3.2 配置 API Key

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

3.3 成功调用

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

在这里插入图片描述

这表明 Claude Code 已经成功通过 DeepSeek 的 API 处理了你的请求。

3.4 查询可用技能

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

在这里插入图片描述

常见问题解答

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

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

火山方舟

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

支持模型（2026-4）： 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-4）：当前 Max 与 Pro 套餐均已支持 glm-5、glm-5.1、glm-5-turbo，基础套餐会慢一拍，一般随后会上最新的模型。

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

MiniMax

对接文档：Claude Code - MiniMax API Docs

支持模型（2026-3）：与套餐有关。最便宜的是标准版Starter（价格：29/月 或 290/年），不支持生成图像、语音、音乐和视频。

在这里插入图片描述

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

阿里云百炼

对接文档：Claude Code - 阿里云百炼文档

支持模型（2026-3）：qwen3.5-plus（支持图片理解）、kimi-k2.5（支持图片理解）、glm-5、MiniMax-M2.5、qwen3-max-2026-01-23、qwen3-coder-next、qwen3-coder-plus、glm-4.7

说明：自 2026 年 3 月 20 日 00:00:00（UTC+8）起，Lite 基础套餐将停止接受新购订单。已购买用户的使用、续费及套餐升级权益保持不变。目前只能买Pro 高级套餐（200/月）

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

A: 建议：

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

Q3: 评论区：deepseek-v4-flash 模型不存在/无法访问 ？（2026-05-21更新）

遇到报错：There’s an issue with the selected model (deepseek-v4-flash). It may not exist or you may not have access to it. Run /model to pick a different model.
在这里插入图片描述
解决方法：重新核对配置文件中的ANTHROPIC_BASE_URL字段是否填错了？应该是 https://api.deepseek.com/anthropic ， 我删除了一个字母，就出现了上图中的错误。

我目前的配置如下：
在这里插入图片描述

Q4: 如何使用代理服务器解决 DeepSeek V4 的 3 个不兼容问题？

A: DeepSeek V4 实现了 Anthropic API 格式，但存在 3 个关键的不兼容问题会导致 Claude Code 无法正常运行。GitHub 上有一个开源项目 dsv4-cc-proxy 可以透明地修复这些问题：

项目地址：https://github.com/HosheaLi/dsv4-cc-proxy

修复的 3 个问题：

# 问题 症状
1 tool_use assistant 消息缺少 thinking 块 reasoning_content 400 错误
2 DeepSeek 无条件返回 thinking/signature_delta SSE 事件 Tool result missing due to internal error
3 thinking.type=adaptive + reasoning_effort 不被 DeepSeek 支持 流式截断 / 400 错误

快速安装（推荐 pip 方式）：

# 安装
pip install dsv4-cc-proxy

# 启动代理（默认 16889 端口）
dsv4-cc-proxy

# 停止代理
dsv4-cc-proxy --stop

其他安装方式：

  • Homebrew（macOS）：brew install hosheali/tap/dsv4-cc-proxy
  • pipx（隔离环境）：pipx install dsv4-cc-proxy
  • Docker：docker run -d -p 16889:16889 --name dsv4-cc-proxy hosheali/dsv4-cc-proxy:latest

配置 Claude Code：

在 settings.local.json 中添加：

"ANTHROPIC_BASE_URL": "http://localhost:16889"

配置环境变量（可选）：

环境变量 默认值 说明
PROXY_UPSTREAM https://api.deepseek.com/anthropic DeepSeek API 地址
PROXY_HOST 127.0.0.1 监听地址
PROXY_PORT 16889 监听端口
PROXY_LOG_LEVEL warning 日志级别（调试用 info）

Q5: 评论区：API Error 400 Failed to deserialize the JSON body … （2026-05-30更新）

依旧是 DeepSeek API 与 Calude Code 的兼容问题，要注意 Claude Code 虽然好用，但其 立场 决定了它不会去主动适配国产大模型的，所以版本越新，越容易出错！

我当前使用的版本是：
在这里插入图片描述
我一直没有遇到诸位的各种报错。

参考： https://api-docs.deepseek.com/zh-cn/guides/anthropic_api

温馨提示：AI 技术发展迅速，本文基于当前版本编写，具体配置方法可能随软件更新而变化。建议关注 Claude Code 和 DeepSeek 的官方更新信息。

# 人工智能 # DeepSeek
Logo
AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

cover

智慧透明化货场装载·存储·集散一体化管控方案

avatar AtomGit开源社区
cover

Linux系统篇（五）：Linux 进程控制全解：fork、exec、wait 核心原理与实战

avatar AtomGit开源社区

python3 uvicorn 是啥？

它是一个 Python 的 ASGI Web 服务器，常用来运行 FastAPI、Starlette 这类异步 Web 应用。一句话：Uvicorn 就是用来把 FastAPI 这种 Python Web 应用跑起来的服务器。用 uvicorn 启动 app/main.py 里的 app 对象，让服务可以被外部访问，不只是本机访问。监听所有网卡地址 0.0.0.0，启动 Uvicorn 服务器。服

avatar AtomGit开源社区