Claude Code

关注公众号 jb51net

关闭
AI > Claude Code >

Claude Code接入DeepSeek兼容端点的配置教程

Arom_Corgi

本文介绍如何通过环境变量配置,将 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")
变量说明
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC禁用非必要网络流量
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK禁用非流式回退
CLAUDE_CODE_EFFORT_LEVEL设置推理努力级别

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"
变量说明
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC禁用非必要网络流量
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK禁用非流式回退
CLAUDE_CODE_EFFORT_LEVEL设置推理努力级别

使配置生效

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

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", "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_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="https://api.deepseek.com/anthropic"
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 兼容端点:

配置完成后,CLI 用户重新打开终端即可使用 claude 命令;IDE 插件用户重启 IDE 后即可生效。

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