详情

首页手游攻略 Claude Code接入DeepSeek兼容端点的配置教程实用指南

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

佚名 2026-08-24 09:50:02

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

目录
  • 一、安装 Claude Code
  • 二、设置环境变量
    • Windows 设置
    • Linux / macOS 设置
  • 三、验证设置
    • 四、完整设置示例
      • Windows PowerShell 示例
      • Linux / macOS 示例
    • 五、常用问题
      • 六、总结

        落到代码里,这里主要介绍如何借助环境变量设置,将 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", "(链接已移除), "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内容请搜索脚本之家以前的文章或继续浏览下面的相关文章,希望大家以后多多兼容脚本之家!

        相关资讯
        点击查看更多
        游戏推荐
        推荐专题
        热门阅读
        推荐下载