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

Written by

in

文章目录
  • 在开始之前,请确保你已经具备以下条件: 已安装 Claude Code(可通过官方渠道下载) 拥有 DeepSeek 的 API 访问权限(可在 DeepSeek 官网申请) 基本的命令行操作知识 如果遇到claude命令未找到,在环境变量中追加路径配置 Windows Claude命令行工具一般在 C:Users你的用户名.localbin 目录下
  • 目录
    • 准备工作
    • 第一阶段:解决“无法连接服务”错误
      • 1.1 初次启动遇到的报错
      • 1.2 找到配置文件
      • 1.3 修改配置文件
    • 第二阶段:处理401未授权错误
      • 2.1 选择界面样式
      • 2.2 信任工作目录
      • 2.3 首次提问尝试
      • 2.4 遇到401错误
    • 第三阶段:创建 DeepSeek API 并成功调用
      • 3.1 创建 DeepSeek API Key
      • 3.2 配置 API Key
      • 3.3 成功调用
      • 3.4 查询可用技能
    • 常见问题解答
      • Q1: 除了 DeepSeek,还能配置其他模型吗?
      • Q2: 如何确保 API Key 的安全?

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

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

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

    当你第一次尝试启动 Claude Code 时,可能会遇到“Unable to connect to Anthropic services”的错误提示:

    1.1 初次启动遇到的报错

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

    要解决这个问题,我们需要找到 Claude Code 的配置文件。配置文件通常位于用户目录下的 .claude 文件夹中:

    1.2 找到配置文件

    在 Windows 系统中,你可以通过以下路径找到它:C:Users你的用户名.claude

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

    1.3 修改配置文件

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

    {
    "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
      }
    }

    1.3 修改配置文件_图2

    配置文件修改完成后,重新启动 Claude Code。首次启动时,系统会让你选择界面样式:

    2.1 选择界面样式

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

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

    2.2 信任工作目录

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

    现在,你可以尝试向 Claude Code 提问了:

    2.3 首次提问尝试

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

    如果你还没有配置有效的 API Key,你会遇到 401 未授权错误:

    2.4 遇到401错误

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

    要解决 401 错误,你需要获取一个有效的 DeepSeek API Key:

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

    3.1 创建 DeepSeek 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 处理了你的请求。

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

    3.4 查询可用技能

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

    火山方舟

    对接文档: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/年),不支持生成图像、语音、音乐和视频。

    Q1: 除了 DeepSeek,还能配置其他模型吗?

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

    A: 建议:

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

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

    以上就是在Claude Code中配置DeepSeek从报错到成功调用的全流程的详细内容,更多关于Claude Code配置DeepSeek的资料请关注风君子博客其它相关文章!

    站内搜索