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 兼容端点:
DEEPSEEK_API_KEYANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKENANTHROPIC_MODELANTHROPIC_DEFAULT_OPUS_MODELANTHROPIC_DEFAULT_SONNET_MODELANTHROPIC_DEFAULT_HAIKU_MODELCLAUDE_CODE_SUBAGENT_MODEL
配置完成后,CLI 用户重新打开终端即可使用 claude 命令;IDE 插件用户重启 IDE 后即可生效。
到此这篇关于Claude Code接入DeepSeek兼容端点的配置教程的文章就介绍到这了,更多相关Claude Code接入DeepSeek内容请搜索脚本之家以前的文章或继续浏览下面的相关文章,希望大家以后多多支持脚本之家!
