第一步：设置临时环境变量
Claude Code 接入 DeepSeek 的核心就是配置。先在当前 PowerShell 窗口放一套完整的临时配置，确认能跑通，再决定要不要写成长期配置。
2026-06-04 复查 DeepSeek 官方 Claude Code 接入文档时，Anthropic 格式入口是 https://api.deepseek.com/anthropic。官方示例把主模型、Opus、Sonnet 指向 deepseek-v4-pro[1m]，把 Haiku 和子任务模型指向 deepseek-v4-flash。
下面这段配置适合先验证链路。把 <你的 DeepSeek API Key> 换成你在 DeepSeek Platform 创建的 Key。不要把真实 Key 写进文章、截图或仓库。这些 $env: 变量只对当前 PowerShell 会话生效。
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<你的 DeepSeek API Key>"
$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"第二步：启动 Claude Code
环境变量设置好以后，再在同一个 PowerShell 窗口运行 claude。这个命令不是配置项，而是启动 Claude Code CLI；启动后它会读取上一步设置的变量，并把请求发到 DeepSeek 的 Anthropic 格式入口。
如果你换了一个新的终端窗口，需要重新设置临时变量，或者先按后面的长期配置方式写入用户环境变量。
claude变量作用速查
ANTHROPIC_BASE_URL 决定 Claude Code 请求打到哪里。这里必须使用 DeepSeek 的 Anthropic 格式入口，不是 OpenAI 格式入口 https://api.deepseek.com。
ANTHROPIC_AUTH_TOKEN 是 DeepSeek API Key。Claude Code 会把这个值作为 Authorization Bearer Token 发送，所以变量值里只放 Key，不要手动写 Bearer。
ANTHROPIC_MODEL 是主会话模型。ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL 是 Claude Code 内部按模型档位选择时的默认映射。CLAUDE_CODE_SUBAGENT_MODEL 用于子任务。CLAUDE_CODE_EFFORT_LEVEL 控制推理努力程度，DeepSeek 官方示例用 max。
长期配置方案一：写入用户环境变量
第一种写法是写入 Windows 用户环境变量。它适合你在所有项目里都用 DeepSeek 跑 Claude Code。写入后必须重新打开 PowerShell，旧窗口不会自动刷新。
这段只负责写入用户环境变量，不会启动 Claude Code。写完以后打开新的 PowerShell，再按后面的验证步骤确认变量已经进入当前 shell。
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.deepseek.com/anthropic", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "<你的 DeepSeek API Key>", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-v4-pro[1m]", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_OPUS_MODEL", "deepseek-v4-pro[1m]", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_SONNET_MODEL", "deepseek-v4-pro[1m]", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_HAIKU_MODEL", "deepseek-v4-flash", "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_SUBAGENT_MODEL", "deepseek-v4-flash", "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_EFFORT_LEVEL", "max", "User")长期配置方案二：写入项目 settings
第二种写法是写进 Claude Code settings 文件的 env 字段。官方文档说明，settings.json 里的 env 会在 Claude Code 启动时生效。个人项目优先用 .claude/settings.local.json，因为它只影响当前项目，而且通常不应该提交到仓库。
不要把带真实 Key 的 .claude/settings.json 提交给团队。团队共享配置可以放 base URL 和模型映射，Key 应该留在每个人自己的用户环境变量或本地 settings.local.json。
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "<你的 DeepSeek API Key>",
"ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
"CLAUDE_CODE_EFFORT_LEVEL": "max"
}
}验证第一步：检查当前变量
验证分两步。第一步确认 Claude Code 启动前能读到配置。Token 不要完整打印，只看长度。
如果你用 settings.local.json 配置 env，但 shell 里还残留同名环境变量，环境变量优先级更高。配置不符合预期时，先检查当前 shell 里有没有旧值。
$env:ANTHROPIC_BASE_URL
$env:ANTHROPIC_AUTH_TOKEN.Length
$env:ANTHROPIC_MODEL
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL验证第二步：进入项目启动
第二步进入项目目录运行 claude，发一条很短的问题，确认模型能返回。
成功标准不是“命令没有立刻退出”。成功标准是 Claude Code 进入项目会话、首轮对话返回、后续子任务没有立刻切回 Anthropic 官方模型或报模型找不到。
cd C:\path\to\your-project
claude按报错定位问题
401：完整配置已经写好，但 Key 没进入当前进程、Key 复制错、Key 失效，都会走到这里。先看 Token 长度，再换一个新 Key 验证。
404：完整配置里最容易错的是 ANTHROPIC_BASE_URL。Claude Code 接 DeepSeek 要填 https://api.deepseek.com/anthropic，不要填 OpenAI 入口，也不要追加 /v1/messages。
model not found：先看 ANTHROPIC_MODEL 和三个 DEFAULT 模型变量。DeepSeek 官方 Claude Code 示例使用 deepseek-v4-pro[1m] 和 deepseek-v4-flash。如果你通过公司网关或第三方代理访问，再查代理是否支持这些模型名。
unsupported parameter：这通常说明你接到的不是 Anthropic-compatible 入口。OpenAI-compatible 不等于 Claude Code 可用。先把 DeepSeek 官方入口跑通，再接代理。
记录可用配置
这类问题会反复出现，因为 CLI、模型名、网关和环境变量都会变。把这次能跑通的配置记录下来：日期、系统、Shell、Claude Code 版本、base URL、主模型、Haiku 模型、错误日志。
下次再遇到 401、404 或 model not found，不要从搜索结果里随便复制另一套命令。先拿这份记录对比。差异在哪里，问题通常就在哪里。
日期：2026-06-04
系统：Windows 11 / PowerShell 7
Claude Code：填你的版本
Base URL：https://api.deepseek.com/anthropic
ANTHROPIC_MODEL：deepseek-v4-pro[1m]
ANTHROPIC_DEFAULT_HAIKU_MODEL：deepseek-v4-flash
结果：首轮对话成功 / 失败日志粘贴在这里