Claude Code接入DeepSeek兼容端点的配置教程实用指南

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“Claude Code接入DeepSeek兼容端点的配置教程”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序，把思路、关键写法和容易踩坑的地方讲清楚，便于大家直接对照操作。

落到代码里，这里主要介绍如何借助环境变量设置，将 Claude Code 的 API 后端切换为 DeepSeek 提供的 Anthropic 兼容端点。

一、安装 Claude Code

若采用 Claude Code CLI，可借助 npm 全局安装：

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

理解这一步时，若采用 Claude Code IDE 插件，比如 VS Code 插件，能够跳过 CLI 安装步骤，直接设置环境变量。

二、设置环境变量

根据不同操作系统，选择对应的设置方式。

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")

设置默认模型

高性能模型：

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

更快模型：

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

二选一设置即可。

设置模型映射

[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")

附加设置

[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")

Linux / macOS 设置

将以下内容追加到 shell 设置文件中。

常用设置文件包括：

~/.bashrc
~/.zshrc
~/.bash_profile

设置 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"

使设置生效

根据实际修改的设置文件执行对应命令。

source ~/.bashrc

或：

source ~/.zshrc

或：

source ~/.bash_profile

三、验证设置

CLI 用户

重新打开终端后执行：

claude

IDE 插件用户

重启 IDE，比如 VS Code，使新的环境变量生效。

四、完整设置示例

Windows PowerShell 示例

[Environment]::SetEnvironmentVariable("DEEPSEEK_API_KEY", "your-actual-api-key-here", "Machine")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "（链接已移除）, "Machine")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $env:DEEPSEEK_API_KEY, "Machine")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-v4-pro", "Machine")
[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")
[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")

Linux / macOS 示例

export DEEPSEEK_API_KEY="your-actual-api-key-here"
export ANTHROPIC_BASE_URL="（链接已移除）
export ANTHROPIC_AUTH_TOKEN="$DEEPSEEK_API_KEY"
export ANTHROPIC_MODEL="deepseek-v4-pro"
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"

五、常用问题

Windows 设置后没有生效

理解这一步时，系统级环境变量设置完成后，当前已打开的终端或 IDE 可能无法立即读取新设置。能够关闭同时重新打开终端，或重启 VS Code 等 IDE。

如仍未生效，可重启系统后再次验证。

Linux / macOS 设置后没有生效

需确认当前 shell 类型：

echo $SHELL

若是 zsh，通常修改 ~/.zshrc。

若是 bash，通常修改 ~/.bashrc 或 ~/.bash_profile。

修改完成后，需执行对应的 source 命令，或重新打开终端。

六、总结

结合项目来看，借助设置以下环境变量，能够让 Claude Code 采用 DeepSeek 的 Anthropic 兼容端点：

• DEEPSEEK_API_KEY
• ANTHROPIC_BASE_URL
• ANTHROPIC_AUTH_TOKEN
• ANTHROPIC_MODEL
• ANTHROPIC_DEFAULT_OPUS_MODEL
• ANTHROPIC_DEFAULT_SONNET_MODEL
• ANTHROPIC_DEFAULT_HAIKU_MODEL
• CLAUDE_CODE_SUBAGENT_MODEL

实际处理时，设置完成后，CLI 用户重新打开终端即可采用 claude 命令；IDE 插件用户重启 IDE 后即可生效。

在这个场景下，到此这篇关于Claude Code接入DeepSeek兼容端点的设置教程的文章就介绍到这了,更多相关Claude Code接入DeepSeek内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多兼容脚本之家！