Claude Code 接入 DeepSeek 教程：Anthropic 兼容端点、环境变量配置、Windows 与 macOS 全流程

这篇教程适合谁

如果你正在用 Claude Code，但希望把默认 API 后端切到 DeepSeek 提供的 Anthropic 兼容端点，这篇就是直接能照着做的配置稿。

它的核心目标很简单：不改 Claude Code 的基本使用方式，只通过环境变量，把请求入口、认证方式和默认模型映射改成 DeepSeek 方案。

这篇教程同时适合两类人：

• 用 Claude Code CLI 的终端用户

• 用 VS Code 等 IDE 插件 的图形界面用户

如果你本身就是 IDE 插件用户，可以跳过 CLI 安装部分，直接看环境变量配置。

一、安装 Claude Code

CLI 用户

如果你还没有安装 Claude Code CLI，可以先执行：

npm install -g @anthropic-ai/claude-code

如果你已经在本地装好了，或者你主要使用的是 IDE 插件，那么这一节可以直接略过。

二、配置 DeepSeek 兼容端点

这一部分是整篇教程的重点。真正决定 Claude Code 走不走 DeepSeek 兼容接口的，就是这些环境变量。

核心变量包括：

DEEPSEEK_API_KEY：你的 DeepSeek API Key

ANTHROPIC_BASE_URL：DeepSeek 提供的 Anthropic 兼容地址

ANTHROPIC_AUTH_TOKEN：Claude Code 调用时使用的认证 Token

ANTHROPIC_MODEL：默认模型

默认模型映射变量：把 Opus / Sonnet / Haiku 映射到你想用的 DeepSeek 模型

Claude Code 接入 DeepSeek 配置总览

2.1 Windows 配置

Windows 下建议直接以 管理员权限打开 PowerShell，然后依次执行。

配置 API Key

[Environment]::SetEnvironmentVariable("DEEPSEEK_API_KEY", "your-actual-api-key-here", "Machine")

配置 API 地址与认证 Token

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.deepseek.com/anthropic", "Machine")

[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $env:DEEPSEEK_API_KEY, "Machine")

这里的思路很直接：Claude Code 以后发往 Anthropic 风格接口的请求，统一改走 DeepSeek 的兼容端点。

Windows 下用 PowerShell 配置 DeepSeek 兼容端点

配置默认模型

高性能模型：

[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-v4-pro", "Machine")

快速模型：

[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-v4-flash", "Machine")

这两个只需要 二选一。如果你更重视效果，可以先用 deepseek-v4-pro；如果更看重速度和成本，可以换成 deepseek-v4-flash。

配置模型映射

[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_OPUS_MODEL", "deepseek-v4-pro", "Machine") 

[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_SONNET_MODEL", "deepseek-v4-pro", "Machine") 

[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_HAIKU_MODEL", "deepseek-v4-flash", "Machine")

[Environment]::SetEnvironmentVariable("CLAUDE_CODE_SUBAGENT_MODEL", "deepseek-v4-pro", "Machine")

这一组变量很有用，因为它让 Claude Code 在不同档位和子智能体场景下，都能自动选中你预设的 DeepSeek 模型，而不是继续走默认 Anthropic 配置。

附加配置

[Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", "Machine")

[Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK", "1", "Machine")

[Environment]::SetEnvironmentVariable("CLAUDE_CODE_EFFORT_LEVEL", "max", "Machine")

这些附加项的作用可以简单理解成：

• CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC：禁用非必要网络流量

• CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK：禁用非流式回退

CLAUDE_CODE_EFFORT_LEVEL：把推理努力级别拉高

如果你想先保守一点，也可以先不把 EFFORT_LEVEL 设为 max，后面再根据实际体验调整。

2.2 Linux / macOS 配置

如果你用的是 Linux 或 macOS，方式会更自然一些：把变量写进你的 shell 配置文件。

常见位置包括：

~/.bashrc

~/.zshrc

~/.bash_profile

Linux 与 macOS 下写入 Shell 配置文件

配置 API Key

export DEEPSEEK_API_KEY="your-actual-api-key-here"

配置 API 地址与认证 Token

export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"

export ANTHROPIC_AUTH_TOKEN="$DEEPSEEK_API_KEY"

配置默认模型

高性能模型：

export ANTHROPIC_MODEL="deepseek-v4-pro"

快速模型：

export ANTHROPIC_MODEL="deepseek-v4-flash"

同样也是 二选一。

配置模型映射

export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro"

export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro"

export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"

export CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-pro"

附加配置

export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

export CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK="1"

export CLAUDE_CODE_EFFORT_LEVEL="max"

三、让配置真正生效

很多人配置完变量后发现“怎么没反应”，问题通常不在变量本身，而在于 当前 shell 还没重新加载。

根据你修改的文件，执行对应命令：

source ~/.bashrc

或者：

source ~/.zshrc

或者：

source ~/.bash_profile

如果你是 IDE 插件用户，那么别忘了 重启 VS Code 或其他编辑器，让新的环境变量被插件宿主进程重新读取。

四、怎么验证有没有接通

CLI 用户

重新打开终端后直接运行：

claude

如果 Claude Code 能正常启动，并且后续请求不再报默认 Anthropic 侧的认证错误，那通常说明配置已经生效。

IDE 插件用户

对于 IDE 用户，最简单的做法就是：

• 重启编辑器

打开 Claude Code 插件

• 发起一次正常请求

• 看是否按你设置的模型和端点工作

如果插件支持日志或开发者输出窗口，也可以顺手看一下调用信息，确认走的是不是 DeepSeek 兼容地址。

Claude Code 接入 DeepSeek 后的验证检查清单

五、一套更实用的理解方式

这套配置的本质，其实就是三步：

1. 把认证信息给 Claude Code

2. 把接口入口改成 DeepSeek 的 Anthropic 兼容端点

3. 把默认模型和子智能体模型映射到你想用的 DeepSeek 型号

只要这三件事配对了，Claude Code 的使用体验基本不变，但后端就已经换成了 DeepSeek。

六、最后提醒

正式使用前，建议你再检查三件小事：

• API Key 是否真实可用

• ANTHROPIC_BASE_URL 是否写成了 https://api.deepseek.com/anthropic

• shell 配置是否已经重新加载，或者 IDE 是否已经重启

如果这三项都没问题，Claude Code 接入 DeepSeek 兼容端点通常就能跑通。