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 安装步骤直接配置环境变量。二、配置环境变量根据不同操作系统选择对应的配置方式。2.1 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设置推理努力级别2.2 Linux / macOS 配置将以下内容追加到 shell 配置文件中。常见配置文件包括~/.bashrc~/.zshrc~/.bash_profile配置 API Keyexport DEEPSEEK_API_KEYyour-actual-api-key-here配置 API 地址与认证 Tokenexport ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN$DEEPSEEK_API_KEY配置默认模型高性能模型export ANTHROPIC_MODELdeepseek-v4-pro快速模型export ANTHROPIC_MODELdeepseek-v4-flash二选一配置即可。配置模型映射export ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro export ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-pro export ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flash export CLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-pro附加配置export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC1 export CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK1 export CLAUDE_CODE_EFFORT_LEVELmax变量说明CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC禁用非必要网络流量CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK禁用非流式回退CLAUDE_CODE_EFFORT_LEVEL设置推理努力级别使配置生效根据实际修改的配置文件执行对应命令。source ~/.bashrc或source ~/.zshrc或source ~/.bash_profile三、验证配置CLI 用户重新打开终端后执行claudeIDE 插件用户重启 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_KEYyour-actual-api-key-hereexport ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropicexport ANTHROPIC_AUTH_TOKEN$DEEPSEEK_API_KEYexport ANTHROPIC_MODELdeepseek-v4-proexport ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-proexport ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-proexport ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flashexport CLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-proexport CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC1export CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK1export CLAUDE_CODE_EFFORT_LEVELmax五、常见问题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 后即可生效。