文档中心
费用中心控制台

使用 Claude Code 集成 GenStudio API ​

连接 AI 助手

Claude Code 是 Anthropic 官方推出的编码助手工具。GenStudio 完全支持 Anthropic Messages API 协议，可无缝集成 Claude Code CLI 工具。

通过 GenStudio，您可以在 Claude Code 中使用智谱 GLM 系列等多种大语言模型，享受灵活的模型选择和稳定的 API 服务。

获取 API 接入信息 ​

在配置之前，您需要先获取对应的 API Key。

GenStudio 通用 LLM API ​

适用于按量付费、包并发服务等场景，可用于大语言模型、生图模型、视频模型等。LLM API 按 Token 计费，请关注账户余额。GenStudio 通用 LLM API 使用平台通用的的 Base URL 和 Endpoints，请根据您的客户端工具支持的协议（OpenAI 兼容或 Anthropic）来配置。

  • API Key： 创建以 sk- 前缀的 API 密钥。详见 GenStudio API 快速集成。

    获取通用 API Key

    注意

    GenStudio 通用 LLM API 服务有 API 频率限制。租户在 GenStudio 的服务等级决定了 API 调用是否计费，以及享受的 API 频率上限。详见 LLM API 计费规则。

  • OpenAI (OpenAI Compatible)

    • Base URL: https://cloud.infini-ai.com/maas/v1

    • Endpoints

      • Create Chat Completion: /chat/completions
      • List Models: /models

  • Anthropic (Anthropic Messages)

    • Base URL: https://cloud.infini-ai.com/maas

    • Endpoints

      • Create a Message: /v1/messages
      • List Models: /v1/models

通过 API 获取最新可用模型列表 ​

若需获取当前接入方式下最新可用的模型 ID，建议通过 Agent 或手动调用模型列表接口。

该接口仅返回当前可用的模型列表，不返回上下文长度、最大输出长度等模型元数据。请使用通用 API Key（sk- 前缀）查询。

language-shell
curl --request GET \
  --url 'https://cloud.infini-ai.com/maas/v1/models' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer sk-xxxxxxxxxx'

在控制台查看上下文长度和最大输出长度 ​

如需查看模型的上下文长度和最大输出长度，请前往模型广场查看对应模型卡片。模型卡片会展示每个模型的上下文长度、最大输出长度等信息。

打开模型广场

在模型广场筛选 Claude 兼容模型 ​

如需确认哪些模型提供 Anthropic Messages 兼容接口，请前往 GenStudio 模型广场，并使用「Claude 兼容」筛选条件查看最新支持情况。

配置 Kimi K2.7 Code ​

如果模型列表或模型广场确认当前账号可使用 kimi-k2.7-code，可以把 ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL 和 ANTHROPIC_DEFAULT_OPUS_MODEL 设置为 kimi-k2.7-code，让 Claude Code 默认使用该模型。

kimi-k2.7-code 是强制思考模型。不要额外配置会发送 thinking.type: "disabled" 的客户端开关；该请求会返回 400。Claude Code 可通过 Anthropic-compatible Messages 接口使用该模型的流式响应、工具调用和工具结果回传路径；模型列表仍建议使用前文的 OpenAI-compatible /models 接口或模型广场确认。

安装 Claude Code ​

如果只在 VSCode 中，可直接安装 Claude Code 扩展，无需单独安装 Claude Code CLI 工具。在配置过程中，建议使用 settings.json 方式。

如需单独安装 Claude Code CLI 工具，Anthropic 官方推荐 Native Install，该方式需要终端能够访问 Claude Code 官方安装源。

  • macOS, Linux, WSL:

    language-shell
    curl -fsSL https://claude.ai/install.sh | bash

  • Windows PowerShell:

    language-powershell
    irm https://claude.ai/install.ps1 | iex

  • Windows CMD:

    language-cmd
    curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

如果无法使用 Native Install 安装 Claude Code CLI 工具，可使用 npm 或 pnpm 全局安装。

language-bash
# 使用 pnpm 安装（推荐）
pnpm install -g @anthropic-ai/claude-code

# 或使用 npm 安装
npm install -g @anthropic-ai/claude-code

配置 Claude Code ​

Claude Code 官方支持通过 settings 系统管理持久配置。对于日常使用，建议优先将配置写入 settings.json；Shell 或系统环境变量更适合临时切换、CI 场景，或在遇到当前版本已知问题时作为回退方案。

完成安装后，只需配置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，即可让 Claude Code 通过 GenStudio 访问 Anthropic Messages 兼容接口。

macOS / Linux 配置 ​

macOS 和 Linux 用户建议优先使用 ~/.claude/settings.json。如果您只想在当前 Shell 中临时生效，或遇到当前版本的 settings.json 已知问题，可改用 Shell 环境变量。

持久配置（推荐）：settings.json ​

将以下内容写入 ~/.claude/settings.json。请将示例中的 API Key 替换为您实际创建的密钥。

language-json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_GENSTUDIO_API_KEY",
    "ANTHROPIC_BASE_URL": "https://cloud.infini-ai.com/maas",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.1",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.1",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.1"
  }
}

重要

请将示例中的 API Key 替换为您的真实密钥。您可以从控制台获取 API 密钥。

临时配置或兼容性回退：Shell 环境变量 ​

如果您只想让当前终端会话临时生效，或遇到 Claude Code v2.0.7x 读取 settings.json 的已知问题，可改用 Shell 环境变量。

  1. 确定您使用的 Shell：

    • bash：编辑 ~/.bashrc
    • zsh：编辑 ~/.zshrc
    • 如果不确定，运行 echo $SHELL

  2. 在对应配置文件末尾追加以下内容：

    language-bash
    export ANTHROPIC_BASE_URL="https://cloud.infini-ai.com/maas"
export ANTHROPIC_AUTH_TOKEN="sk-xxx"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
export ANTHROPIC_API_KEY=""
export ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-5.1"
export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5.1"
export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5.1"

Windows 配置 ​

Windows 用户建议优先使用 settings.json。如需临时调试或跨工具共享配置，也可使用环境变量。为避免排查困难，建议同一组变量只保留一种持久配置方式。

settings.json（推荐） ​

生效范围：仅对当前用户的 Claude Code 生效；在 CMD、PowerShell 等不同终端中启动 Claude Code 时共用同一份配置；重启 Claude Code 后持续生效；不会影响其他工具。

Windows 用户也可以使用 settings.json 配置文件。文件位置为 %USERPROFILE%\.claude\settings.json（通常是 C:\Users\<用户名>\.claude\settings.json）。

language-json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_GENSTUDIO_API_KEY",
    "ANTHROPIC_BASE_URL": "https://cloud.infini-ai.com/maas",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.1",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.1",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.1"
  }
}

当前终端会话环境变量（临时调试） ​

生效范围：仅对当前 CMD 或 PowerShell 窗口，以及从该窗口启动的 Claude Code 子进程生效；关闭该窗口后失效；不会影响其他终端窗口或其他工具。

如果您只想临时验证配置，或排查 settings.json 是否生效，建议优先使用这一方式。

如果您使用 Windows CMD：

language-shell
set ANTHROPIC_AUTH_TOKEN=YOUR_GENSTUDIO_API_KEY
set ANTHROPIC_BASE_URL=https://cloud.infini-ai.com/maas
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
set ANTHROPIC_API_KEY=
set ANTHROPIC_DEFAULT_HAIKU_MODEL=glm-5.1
set ANTHROPIC_DEFAULT_SONNET_MODEL=glm-5.1
set ANTHROPIC_DEFAULT_OPUS_MODEL=glm-5.1

如果您使用 Windows PowerShell：

language-powershell
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_GENSTUDIO_API_KEY"
$env:ANTHROPIC_BASE_URL = "https://cloud.infini-ai.com/maas"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"
$env:ANTHROPIC_API_KEY = ""
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "glm-5.1"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "glm-5.1"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "glm-5.1"

当前用户账户的环境变量（高级 / 共享） ​

生效范围：对当前用户后续新打开的 CMD、PowerShell、Claude Code，以及其他会读取这些环境变量的程序生效；对当前已经打开的终端窗口不会立即生效。

如果您明确希望多个终端、脚本或其他工具共享同一套配置，可使用这一方式。

如果您使用 Windows CMD：

language-shell
setx ANTHROPIC_AUTH_TOKEN YOUR_GENSTUDIO_API_KEY
setx ANTHROPIC_BASE_URL https://cloud.infini-ai.com/maas
setx CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 1
setx ANTHROPIC_DEFAULT_HAIKU_MODEL glm-5.1
setx ANTHROPIC_DEFAULT_SONNET_MODEL glm-5.1
setx ANTHROPIC_DEFAULT_OPUS_MODEL glm-5.1

如果您使用 Windows PowerShell：

language-powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_GENSTUDIO_API_KEY", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://cloud.infini-ai.com/maas", "User")
[System.Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_HAIKU_MODEL", "glm-5.1", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_SONNET_MODEL", "glm-5.1", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_OPUS_MODEL", "glm-5.1", "User")

警告

排查建议：不要同时在当前终端会话、%USERPROFILE%\.claude\settings.json、当前用户环境变量中为同一组变量配置不同的值。若您怀疑存在冲突，建议按以下顺序逐项排查：

  1. 当前终端窗口中的环境变量
  2. %USERPROFILE%\.claude\settings.json
  3. 当前用户账户下持久保存的环境变量

提示

运行 setx 或 [System.Environment]::SetEnvironmentVariable(...) 后，需要重新打开命令提示符或 PowerShell 窗口，新的环境变量才会生效。

启动与验证 ​

配置完成后，启动 Claude Code 并验证连接状态。

操作步骤：

  1. 根据您使用的配置方式完成准备：

    • 如果您修改的是 settings.json，请重启 Claude Code。
    • 如果您设置的是当前终端会话环境变量，请在同一个终端窗口中继续执行后续命令。
    • 如果您设置的是当前用户账户的环境变量，请打开新的终端窗口。

  2. 进入您的项目目录：

    language-bash
    cd /path/to/your/project

  3. 启动 Claude Code：

    language-bash
    claude

  4. 首次启动时，Claude Code 将：

    • 从当前生效的配置中读取 ANTHROPIC_AUTH_TOKEN
    • 通过 ANTHROPIC_BASE_URL 指定的 Anthropic Messages 兼容服务进行认证
    • 无需额外登录步骤即可开始使用

提示

如果遇到找不到 claude 命令的错误，请确认 Claude Code 已全局安装（参见上述安装步骤）。

验证连接状态：

在 Claude Code 提示符下运行 /status 并确认配置：

language-text
> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://cloud.infini-ai.com/maas

验证清单：

  • ✅ Auth token 应显示 ANTHROPIC_AUTH_TOKEN
  • ✅ Anthropic base URL 应显示与当前接入方式匹配的 Anthropic Base URL

如果匹配以上内容，设置完成。您现在可以通过 GenStudio 使用 Claude Code 了。

使用 cc-switch 快速切换配置 ​

如果您需要频繁切换默认模型、Base URL 或 API Key，可使用社区工具 cc-switch。它不是 Anthropic 官方工具，但适合在多个 Claude Code 配置之间快速切换。

cc-switch 的工作方式是：

  • 将 provider 配置保存在 ~/.cc-switch/cc-switch.db
  • 在切换时，把当前选中的 provider 同步写入 Claude Code 的实际配置文件
  • 对 Claude Code 来说，切换的结果最终仍然体现在 ~/.claude/settings.json 等生效配置上

该项目也提供系统托盘快速切换；其 README 说明 Claude Code 支持热切换，通常无需重启即可切换 provider。

如需配置具体字段，请直接参考前文的 settings.json 示例，并将需要切换的模型、Base URL、API Key 等参数分别保存为不同 provider 配置。

故障排除 ​

如果在使用过程中遇到问题，请参考以下常见问题及解决方案。

API 密钥错误，看到"无效的 API 密钥"或"未授权"消息 ​

  • 检查当前配置中的 API 密钥是否正确
  • 确认 API 密钥已激活且有足够余额
  • GenStudio 通用 LLM API 应使用 sk- 前缀的 API Key
  • Infini 编码套餐应使用 sk-cp- 前缀的 API Key

模型不支持 Anthropic 协议 ​

  • 先通过前文“获取最新支持模型列表”中的接口确认当前可用模型，再用 GenStudio 模型广场「Claude 兼容」筛选结果进行交叉核对。
  • 从支持列表中选择一个模型

Claude Code 无法连接到 GenStudio 服务 ​

  • 检查网络连接是否正常
  • 验证 ANTHROPIC_BASE_URL 设置正确
  • 确认防火墙设置未阻止出站连接

Claude Code 版本已知问题 ​

重要

settings.json 读取问题：Claude Code v2.0.7x 中，~/.claude/settings.json 的 env 配置在首次登录或 logout 后重新登录时可能无法正确读取。如遇此问题，请临时改用 Shell 环境变量配置。详见 Claude Code issue #13827。

无头模式 400 错误：使用 claude -p 执行提示词时，可能遇到 tools.3.custom.input_examples: Extra inputs are not permitted。可尝试降级到 Claude Code 2.0.36，或设置环境变量 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1。详见 Claude Code issue 11678。

VSCode 中 Claude Code 扩展 GUI 模式出现问题 ​

VSCode Claude Code 扩展可能无法稳定读取终端环境变量，建议优先使用 settings.json 文件配置。

相关文档 ​

更多关于 GenStudio API 的使用说明，请参考以下文档。