目录
- 准备工作
- 第一阶段:解决“无法连接服务”错误
- 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 是 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,我们将在第三阶段详细介绍如何获取。
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:
- 访问 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}}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/月)
Kimi
对接文档:Kimi 第三方代理文档
Q2: 如何确保 API Key 的安全?
A: 建议:
- 不要将 API Key 提交到版本控制系统(如 Git)
- 使用环境变量存储敏感信息
- 定期轮换 API Key
总结
通过以上三个阶段的配置,你已经成功地在 Claude Code 中配置了 DeepSeek 大模型。整个过程涉及:
- 解决连接问题:修改配置文件指向正确的 API 端点
- 处理授权错误:获取并配置有效的 API Key
- 验证和扩展:成功调用并探索更多功能
Claude Code 结合 DeepSeek 的强大能力,为开发者提供了一个高效、灵活的 AI 编程助手。无论是代码编写、问题解答还是技术调研,这个组合都能为你提供有力的支持。
参考:https://api-docs.deepseek.com/zh-cn/guides/anthropic_api
温馨提示:AI 技术发展迅速,本文基于当前版本编写,具体配置方法可能随软件更新而变化。建议关注 Claude Code 和 DeepSeek 的官方更新信息。