claude code 安装接入deepseek教程

大家好，我是程序员小叶，最近打算用AI编程，所以就用claude code+ds来写代码。

将 Claude Code 绑定国内大模型，核心思路是修改其API请求地址，将它指向国内模型服务商（如DeepSeek）的Anthropic兼容接口。整个配置分为两步：安装和绑定。

🛠️ 第一步：安装 Claude Code

1. 准备环境：安装 Node.js (版本 >= 18.0) 和 Git。在终端/命令行中分别输入 node -v 和 git --version 确认安装成功。

2. 执行安装：

• macOS / Linux: curl -fsSL https://claude.ai/install.sh | bash
• Windows: irm https://claude.ai/install.ps1 | iex
• **官方npm仓库安装 (推荐)**：

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

  如果下载较慢，可以使用国内镜像加速：

  npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
  

• **官方脚本安装 (备选)**：

3. 验证安装：运行 claude --version，如果正确输出版本号即表示安装成功。

🔗 第二步：绑定国内大模型（附主流模型示例）

Claude Code 主要通过环境变量或配置文件来指定其连接的API地址。以下是两种主流配置方法：

• 方法一：会话级临时配置（适合快速测试）这种方式配置在当前终端会话中有效，关闭后失效。

1. macOS / Linux：在终端中依次输入以下命令，并替换 {你的APIKey}。

   export ANTHROPIC_BASE_URL={模型的API接口地址}
   export ANTHROPIC_AUTH_TOKEN={你的APIKey}
   

2. **Windows (PowerShell)**：

   $env:ANTHROPIC_BASE_URL="{模型的API接口地址}"
   $env:ANTHROPIC_AUTH_TOKEN="{你的APIKey}"
   

• 方法二：全局配置文件（适合长期稳定使用）这种方式将配置写入文件，持久生效。

• macOS / Linux: ~/.claude/settings.json
• Windows: %USERPROFILE%\.claude\settings.json
1. 在用户目录下找到或创建配置文件：
2. 编辑该文件，使用以下格式填入API信息。

   {
   "env": {
   "ANTHROPIC_BASE_URL": "{模型的API接口地址}",
   "ANTHROPIC_AUTH_TOKEN": "{你的APIKey}",
   "ANTHROPIC_MODEL": "{你想使用的模型名称}"
       }
   }
   

🔧 主流国产模型配置示例

以下是几款主流模型提供的API地址和配置示例，多数平台在首次注册时会赠送免费额度以供测试。

1. DeepSeek

• API地址 (ANTHROPIC_BASE_URL): https://api.deepseek.com/anthropic
• 模型名称 (ANTHROPIC_MODEL): deepseek-v4-pro[1m] (建议) / deepseek-chat
• 配置文件参考:

  {
  "env": {
  "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
  "ANTHROPIC_AUTH_TOKEN": "你的DeepSeek API Key",
  "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
  "API_TIMEOUT_MS": "3000000"
      }
  }
  

• 附加说明：DeepSeek官方推荐通过环境变量配置，是其最稳定的接入方式之一。

2. 智谱AI (GLM)

• API地址 (ANTHROPIC_BASE_URL): https://open.bigmodel.cn/api/anthropic
• 模型名称 (ANTHROPIC_MODEL): glm-5 (示例，以平台最新为准)
• 配置文件参考:

  {
  "env": {
  "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
  "ANTHROPIC_AUTH_TOKEN": "你的智谱API Key",
  "API_TIMEOUT_MS": "3000000",
  "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
      }
  }
  

3. 通义千问 (Qwen)

通义千问有两种主流接入方式，你可以根据需求选择：

• 方式一：通过环境变量直连阿里云百炼平台

  {
  "env": {
  "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/compatible-mode/v1",
  "ANTHROPIC_AUTH_TOKEN": "你的阿里云百炼API Key",
  "ANTHROPIC_MODEL": "qwen3.5-plus"
      }
  }
  

• API地址: https://dashscope.aliyuncs.com/compatible-mode/v1
• 模型名称: qwen3.5-plus / qwen3.5-flash
• 方式二：使用本地代理适配器使用 qwen-adapter 工具在本地将通义千问的API转换为Claude Code兼容的格式。

  npm install -g qwen-adapter  # 安装工具
  npx qwen-adapter start -k 你的阿里云API Key  # 启动本地代理
  

  然后修改Claude Code的配置文件，将API地址指向本地：

  {
  "env": {
  "ANTHROPIC_BASE_URL": "http://localhost:3000",
  "ANTHROPIC_AUTH_TOKEN": "qwen-key"
      }
  }
  

4. 豆包 (Doubao-Seed-Code)

• 平台: 火山引擎方舟
• 配置方式: 在该平台获取API Key和专属的API地址后，填入Claude Code的配置文件即可。

📋 常用配置命令与环境变量参考

为了方便你排查问题或进行配置，以下是一些有价值的参考信息。

• 核心环境变量说明：

• ANTHROPIC_BASE_URL: 覆盖API端点URL（配置国产大模型的关键）。
• ANTHROPIC_AUTH_TOKEN: 第三方服务商的API Key。
• ANTHROPIC_MODEL: 默认使用的模型名称。
• ANTHROPIC_SMALL_FAST_MODEL: 快速模型，用于简单任务。
• API_TIMEOUT_MS: 设置超时时间，第三方模型建议设置为一个较大的值（如600000-3000000毫秒）。
• CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 设置为1可阻止向Anthropic发送非必要流量，保障国内使用稳定性。

• **配置优先级 (从高到低)**： 会话内 /model 命令 > CLI --model 参数 > 系统环境变量 > ~/.claude/settings.json 配置文件 > 运行时默认值。

💡 注意事项与进阶技巧

• 确保 API 兼容：并非所有 API 都与 Claude Code 完美兼容。DeepSeek、智谱AI (GLM) 和阿里云百炼的 API 已被验证兼容性良好。
• 处理网络环境：如果在某些网络环境下无法连接，可以尝试使用代理（如果可用）或中转服务，但推荐优先配置已验证兼容的国产模型。
• 多模型管理：你可以将多个模型的配置信息保存在~/.claude/settings.json文件中，需要时修改ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN即可快速切换。
• 轻量级工具：如果觉得手动修改配置比较繁琐，也可以考虑使用一些社区工具，例如cc-switch，它提供图形化界面，可以帮助你更轻松地管理和切换不同模型。将 Claude Code 绑定国内大模型，核心思路是修改其API请求地址，将它指向国内模型服务商（如DeepSeek）的Anthropic兼容接口。整个配置分为两步：安装和绑定。

🛠️ 第一步：安装 Claude Code

1. 准备环境：安装 Node.js (版本 >= 18.0) 和 Git。在终端/命令行中分别输入 node -v 和 git --version 确认安装成功。

2. 执行安装：

• macOS / Linux: curl -fsSL https://claude.ai/install.sh | bash
• Windows: irm https://claude.ai/install.ps1 | iex
• **官方npm仓库安装 (推荐)**：

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

  如果下载较慢，可以使用国内镜像加速：

  npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
  

• **官方脚本安装 (备选)**：

3. 验证安装：运行 claude --version，如果正确输出版本号即表示安装成功。

🔗 第二步：绑定国内大模型（附主流模型示例）

Claude Code 主要通过环境变量或配置文件来指定其连接的API地址。以下是两种主流配置方法：

• 方法一：会话级临时配置（适合快速测试）这种方式配置在当前终端会话中有效，关闭后失效。

1. macOS / Linux：在终端中依次输入以下命令，并替换 {你的APIKey}。

   export ANTHROPIC_BASE_URL={模型的API接口地址}
   export ANTHROPIC_AUTH_TOKEN={你的APIKey}
   

2. **Windows (PowerShell)**：

   $env:ANTHROPIC_BASE_URL="{模型的API接口地址}"
   $env:ANTHROPIC_AUTH_TOKEN="{你的APIKey}"
   

• 方法二：全局配置文件（适合长期稳定使用）这种方式将配置写入文件，持久生效。

• macOS / Linux: ~/.claude/settings.json
• Windows: %USERPROFILE%\.claude\settings.json
1. 在用户目录下找到或创建配置文件：
2. 编辑该文件，使用以下格式填入API信息。

   {
   "env": {
   "ANTHROPIC_BASE_URL": "{模型的API接口地址}",
   "ANTHROPIC_AUTH_TOKEN": "{你的APIKey}",
   "ANTHROPIC_MODEL": "{你想使用的模型名称}"
       }
   }
   

🔧 主流国产模型配置示例

以下是几款主流模型提供的API地址和配置示例，多数平台在首次注册时会赠送免费额度以供测试。

1. DeepSeek

• API地址 (ANTHROPIC_BASE_URL): https://api.deepseek.com/anthropic
• 模型名称 (ANTHROPIC_MODEL): deepseek-v4-pro[1m] (建议) / deepseek-chat
• 配置文件参考:

  {
  "env": {
  "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
  "ANTHROPIC_AUTH_TOKEN": "你的DeepSeek API Key",
  "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
  "API_TIMEOUT_MS": "3000000"
      }
  }
  

• 附加说明：DeepSeek官方推荐通过环境变量配置，是其最稳定的接入方式之一。

2. 智谱AI (GLM)

• API地址 (ANTHROPIC_BASE_URL): https://open.bigmodel.cn/api/anthropic
• 模型名称 (ANTHROPIC_MODEL): glm-5 (示例，以平台最新为准)
• 配置文件参考:

  {
  "env": {
  "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
  "ANTHROPIC_AUTH_TOKEN": "你的智谱API Key",
  "API_TIMEOUT_MS": "3000000",
  "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
      }
  }
  

3. 通义千问 (Qwen)

通义千问有两种主流接入方式，你可以根据需求选择：

• 方式一：通过环境变量直连阿里云百炼平台

  {
  "env": {
  "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/compatible-mode/v1",
  "ANTHROPIC_AUTH_TOKEN": "你的阿里云百炼API Key",
  "ANTHROPIC_MODEL": "qwen3.5-plus"
      }
  }
  

• API地址: https://dashscope.aliyuncs.com/compatible-mode/v1
• 模型名称: qwen3.5-plus / qwen3.5-flash
• 方式二：使用本地代理适配器使用 qwen-adapter 工具在本地将通义千问的API转换为Claude Code兼容的格式。

  npm install -g qwen-adapter  # 安装工具
  npx qwen-adapter start -k 你的阿里云API Key  # 启动本地代理
  

  然后修改Claude Code的配置文件，将API地址指向本地：

  {
  "env": {
  "ANTHROPIC_BASE_URL": "http://localhost:3000",
  "ANTHROPIC_AUTH_TOKEN": "qwen-key"
      }
  }
  

4. 豆包 (Doubao-Seed-Code)

• 平台: 火山引擎方舟
• 配置方式: 在该平台获取API Key和专属的API地址后，填入Claude Code的配置文件即可。

📋 常用配置命令与环境变量参考

为了方便你排查问题或进行配置，以下是一些有价值的参考信息。

• 核心环境变量说明：

• ANTHROPIC_BASE_URL: 覆盖API端点URL（配置国产大模型的关键）。
• ANTHROPIC_AUTH_TOKEN: 第三方服务商的API Key。
• ANTHROPIC_MODEL: 默认使用的模型名称。
• ANTHROPIC_SMALL_FAST_MODEL: 快速模型，用于简单任务。
• API_TIMEOUT_MS: 设置超时时间，第三方模型建议设置为一个较大的值（如600000-3000000毫秒）。
• CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 设置为1可阻止向Anthropic发送非必要流量，保障国内使用稳定性。

• **配置优先级 (从高到低)**： 会话内 /model 命令 > CLI --model 参数 > 系统环境变量 > ~/.claude/settings.json 配置文件 > 运行时默认值。

💡 注意事项与进阶技巧

• 确保 API 兼容：并非所有 API 都与 Claude Code 完美兼容。DeepSeek、智谱AI (GLM) 和阿里云百炼的 API 已被验证兼容性良好。
• 处理网络环境：如果在某些网络环境下无法连接，可以尝试使用代理（如果可用）或中转服务，但推荐优先配置已验证兼容的国产模型。
• 多模型管理：你可以将多个模型的配置信息保存在~/.claude/settings.json文件中，需要时修改ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN即可快速切换。
• 轻量级工具：如果觉得手动修改配置比较繁琐，也可以考虑使用一些社区工具，例如cc-switch，它提供图形化界面，可以帮助你更轻松地管理和切换不同模型。