Claude Code

在 Claude Code 中使用 SurgeAI 模型（GLM、Kimi、MiniMax、DeepSeek 等）

什么是 Claude Code？

Claude Code 是由 Anthropic 开发的智能编码工具，在您的终端中运行。它帮助开发者通过自然语言命令快速完成代码生成、调试、重构等任务。

💡 提示：通过 SurgeAI，您可以直接在 Claude Code 中使用 160+ AI 模型——包括顶级提供商（GLM、Kimi、MiniMax、DeepSeek 等）——只需一个 API Key，无需更改代码。

📝 注意：SurgeAI 提供完全兼容 Anthropic 的 API 端点。Claude Code 会显示类似 claude-sonnet-4-20250514 的模型名称，但实际运行的是您选择的模型（如 GLM-5、Kimi-K2.5 等）。

步骤 1：安装 Claude Code

前置条件： Node.js 18+

通过 npm 全局安装 Claude Code：

安装后，进入您的项目目录并启动 Claude Code：

⚠️ 注意：首次运行时，Claude Code 会提示您登录 Anthropic 账号。您可以跳过此步骤——我们将在下一步配置 SurgeAI API。

步骤 2：配置 SurgeAI API

选项 A：快速设置（环境变量）

最快的入门方式。在启动 Claude Code 之前设置这些环境变量：

macOS/Linux

Windows (PowerShell)

$env:ANTHROPIC_BASE_URL = "https://surgeai.one"
$env:ANTHROPIC_API_KEY = "sk-your-surgeai-api-key"
claude

💡 提示：要使其永久生效，请将 export 行添加到您的 shell 配置文件（~/.bashrc、~/.zshrc 或 ~/.profile）中。

选项 B：配置文件（推荐）

编辑 Claude Code 设置文件 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://surgeai.one",
    "ANTHROPIC_API_KEY": "sk-your-surgeai-api-key"
  }
}

⚠️ 注意：如果您手动编辑 settings.json，必须重启 Claude Code 才能使更改生效。如果在 IDE 插件中运行，也请重启 IDE。

步骤 3：选择您的模型

默认情况下，Claude Code 将其内部模型层级映射到特定模型。使用 SurgeAI，您可以自定义每个层级使用哪个模型。

默认模型映射

Claude Code 层级	环境变量	默认模型	说明
Opus（重型任务）	`ANTHROPIC_DEFAULT_OPUS_MODEL`	`claude-opus-4-20250514`	复杂推理、架构设计
Sonnet（主要）	`ANTHROPIC_DEFAULT_SONNET_MODEL`	`claude-sonnet-4-20250514`	主要编码模型
Haiku（轻量任务）	`ANTHROPIC_DEFAULT_HAIKU_MODEL`	`claude-haiku-3-5-20241022`	快速补全、小型编辑

使用 GLM 模型

要在 Claude Code 中使用智谱 GLM 模型，添加到 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://surgeai.one",
    "ANTHROPIC_API_KEY": "sk-your-surgeai-api-key",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air"
  }
}

使用 Kimi 模型

要使用 Moonshot Kimi 模型：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://surgeai.one",
    "ANTHROPIC_API_KEY": "sk-your-surgeai-api-key",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "kimi-k2.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "kimi-k2.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "kimi-k2.5"
  }
}

使用 MiniMax 模型

要使用 MiniMax 模型：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://surgeai.one",
    "ANTHROPIC_API_KEY": "sk-your-surgeai-api-key",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.5"
  }
}

使用 DeepSeek 模型

要使用 DeepSeek 模型：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://surgeai.one",
    "ANTHROPIC_API_KEY": "sk-your-surgeai-api-key",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v3.2",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v3.2",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v3.2"
  }
}

混合搭配（推荐）

最佳方法是根据不同层级模型的 strengths 分配不同的模型：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://surgeai.one",
    "ANTHROPIC_API_KEY": "sk-your-surgeai-api-key",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "kimi-k2.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v3.2"
  }
}

💡 提示：混合搭配以获得最佳效果！ 使用强大的模型如 GLM-5 处理复杂任务（Opus），平衡的模型如 Kimi-K2.5 处理主要编码（Sonnet），快速的模型如 DeepSeek-V3.2 处理快速补全（Haiku）。

步骤 4：开始使用 Claude Code

配置后，在项目目录中启动 Claude Code：

您现在可以使用自然语言与代码库交互：

> 帮我重构认证模块，使用 JWT 令牌

> 查找并修复支付处理逻辑中的 bug

> 为用户服务编写单元测试

> 解释这个项目的架构

📝 注意：Claude Code 会在 UI 中显示类似 claude-sonnet-4-20250514 的模型名称，但实际运行的是您配置的 SurgeAI 模型（如 GLM-5、Kimi-K2.5 等）。这是预期行为。

可用模型

以下是通过 SurgeAI 可用于编码任务的推荐模型：

模型	提供商	最适合	速度
`glm-5`	智谱	复杂推理、全栈开发	⭐⭐⭐
`glm-4.7`	智谱	平衡编码、调试	⭐⭐⭐⭐
`glm-4.5-air`	智谱	快速补全、轻量任务	⭐⭐⭐⭐⭐
`kimi-k2.5`	Moonshot	长上下文、代码分析	⭐⭐⭐⭐
`MiniMax-M2.5`	MiniMax	通用编码、创意任务	⭐⭐⭐⭐
`deepseek-v3.2`	DeepSeek	代码生成、数学	⭐⭐⭐⭐
`qwen3-235b`	Qwen	多语言、推理	⭐⭐⭐

💡 提示：SurgeAI 支持 160+ 模型。您可以使用模型列表中的任何模型，只要它支持聊天补全 API。

常见问题

如何切换模型？

您可以随时通过更新 ~/.claude/settings.json 中的环境变量并重启 Claude Code 来切换模型。

或者，在启动前直接在终端中设置环境变量：

为什么 UI 仍然显示"Claude"模型名称？

这是设计如此。Claude Code 内部使用 Anthropic 模型标识符。SurgeAI 充当透明代理——它接收带有 Claude 模型名称的请求，并将其路由到您配置的模型。功能完全相同；只是显示名称不同。

手动配置更改不生效？

如果您手动编辑了 ~/.claude/settings.json：

完全关闭 Claude Code（不仅仅是当前会话）

如果使用 IDE 插件，重启 IDE

验证 JSON 语法是否有效

重新启动 Claude Code

推荐的 Claude Code 版本？

我们建议使用最新稳定版本的 Claude Code 以获得最佳兼容性：

连接问题？

如果遇到连接错误：

验证您的 API Key 是否有效：访问 surgeai.one 控制台

检查 ANTHROPIC_BASE_URL 是否设置为 https://surgeai.one（无尾部斜杠）

测试连接：

资源

SurgeAI 控制台：surgeai.one

SurgeAI API 文档：docs.surgeai.one

Claude Code 官方文档：docs.anthropic.com/claude-code

Node.js 下载：nodejs.org

什么是 Claude Code？#

步骤 1：安装 Claude Code#

步骤 2：配置 SurgeAI API#

选项 A：快速设置（环境变量）#

选项 B：配置文件（推荐）#

步骤 3：选择您的模型#

默认模型映射#

使用 GLM 模型#

使用 Kimi 模型#

使用 MiniMax 模型#

使用 DeepSeek 模型#

混合搭配（推荐）#

步骤 4：开始使用 Claude Code#

可用模型#

常见问题#

如何切换模型？#

为什么 UI 仍然显示"Claude"模型名称？#

手动配置更改不生效？#

推荐的 Claude Code 版本？#

连接问题？#

资源#