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

Written by

in

文章目录
  • 如果使用 Claude Code CLI,可通过 npm 全局安装: npm install -g @anthropic-ai/claude-code 如果使用 Claude Code IDE 插件,例如 VS Code 插件,可以跳过 CLI 安装步骤,直接配置环境变量。
  • 根据不同操作系统,选择对应的配置方式。
  • CLI 用户 重新打开终端后执行: claude IDE 插件用户 重启 IDE,例如 VS Code,使新的环境变量生效。
  • 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内容请搜索风君子博客以前的文章或继续浏览下面的相关文章,希望大家以后多多支持风君子博客!
  • 目录
    • 一、安装 Claude Code
    • 二、配置环境变量
      • Windows 配置
      • Linux / macOS 配置
    • 三、验证配置
      • 四、完整配置示例
        • Windows PowerShell 示例
        • Linux / macOS 示例
      • 五、常见问题
        • 六、总结

          本文介绍如何通过环境变量配置,将 Claude Code 的 API 后端切换为 DeepSeek 提供的 Anthropic 兼容端点。

          如果使用 Claude Code CLI,可通过 npm 全局安装:

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

          如果使用 Claude Code IDE 插件,例如 VS Code 插件,可以跳过 CLI 安装步骤,直接配置环境变量。

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

          以管理员权限打开 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 设置推理努力级别

          将以下内容追加到 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,使新的环境变量生效。

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

          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_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内容请搜索风君子博客以前的文章或继续浏览下面的相关文章,希望大家以后多多支持风君子博客!

          站内搜索