国产模型接入教程
Claude Code · 模型接入

选择模型供应商

下方展示当前供应商的完整配置,切换后查看对应方案。

配置实操 / macOS · Linux · Windows

Claude Code 接入 DeepSeek

使用官方 Anthropic 兼容入口,包含 Bash、PowerShell 配置与验证。

5 个步骤约 9 分钟文档核对 2026-10-29
开始第一步
接入配置示意Anthropic Messages
Claude CodeDeepSeek
MODEL
deepseek-flash[1m]
BASE URL
https://api.deepseek.com/anthropic
AUTH
DeepSeek 平台 API Key
已安装客户端 模型权限与额度 原配置已备份

配置速查

接口与凭据必须对应同一方案
字段内容注意
Base URLhttps://api.deepseek.com/anthropic不要使用 Codex 的连接配置
模型deepseek-flash[1m]按官方集成示例映射
KeyDeepSeek 平台创建不是网页聊天凭据
01

安装和准备

运行 claude --version。未安装可使用 npm install -g @anthropic-ai/claude-code;Windows 需要 Git for Windows,并使用受支持的 Node.js 版本。创建 DeepSeek API Key,确认 API 额度可用。

按官方文档核对,未使用付费 Key 做端到端实测。先在测试项目运行,再核对供应商控制台用量;聊天成功不代表工具调用和全部联网功能都可用。

02

macOS / Linux 配置

替换 Key 后在当前终端执行。切换供应商时检查已有用户与项目设置,避免残留 ANTHROPIC_MODEL 或其他认证覆盖本次配置。

Bash / zsh
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="YOUR_DEEPSEEK_API_KEY"
export ANTHROPIC_MODEL="deepseek-flash[1m]"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-flash[1m]"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-flash[1m]"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-flash"
export CLAUDE_CODE_SUBAGENT_MODEL="deepseek-flash"
export CLAUDE_CODE_EFFORT_LEVEL="max"
export CLAUDE_CODE_AUTO_COMPACT_WINDOW="786432"
claude
03

Windows 配置

PowerShell 不使用 export。设置只对当前终端及其子进程有效。

PowerShell
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_DEEPSEEK_API_KEY"
$env:ANTHROPIC_MODEL="deepseek-flash[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-flash[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-flash[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"
$env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="786432"
claude
04

运行第一条任务

在测试项目目录启动 claude,通过 /status 核对配置。实际后端是 DeepSeek,不是 Claude 模型;不要根据模型的自我介绍判断供应商。

项目验收
请只读当前项目:说明启动命令、入口文件和测试命令,每条结论引用实际文件路径;找不到就写未找到。不要修改文件,也不要安装依赖。
05

恢复原供应商

关闭临时终端,恢复原有配置并重启客户端。若把环境变量写入了 Shell 启动文件,也要清理对应项;不要直接覆盖整个 settings.json。模型名称过期时回到官方集成说明核对。

TROUBLESHOOTING

卡在哪一步?按错误定位。

401 / 403

凭据、套餐或模型权限不匹配

检查 Key 来源、地域和套餐;检查当前进程是否读取了旧认证。

404

地址或 API 协议不匹配

使用本文对应协议的 Base URL,不手工追加请求路径。

429

额度或调用频率限制

到供应商控制台核对余额、套餐与限流,降低并发后重试。

工具调用失败

文件权限、客户端版本或模型兼容性问题

先确认工作目录,验证一次只读文件任务,再增加其他能力。

完成前,确认这四项

  • 客户端版本可用,原配置已备份
  • 接口地址、Key 和模型属于同一产品方案
  • 只读任务引用了真实文件,并已核对调用用量
  • 没有提交真实 Key,能够还原原配置

官方参考来源

配置依据以下资料整理,验证任务与排查顺序为本站编辑建议。模型和客户端更新后,请重新核对接口与支持范围。

01https://api-docs.deepseek.com/quick_start/agent_integrations/claude_code/02https://api-docs.deepseek.com/guides/anthropic_api/
查看其他工具的接入方式