文档中心

Appearance

✨充值控制台

使用 Claude Code 集成 GenStudio API ​

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

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

警告

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

已知问题 2：使用 claude -p 命令（无头模式）执行提示词时，有可能遇到 API 错误 400 失败：claude -p fails with "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

获取 API 接入信息 ​

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

信息

在调用接口时，不同的应用或客户端工具可能需要您输入完整的 Endpoint（Base URL + 具体路径），或者分别输入 Base URL 与路径。请根据所用工具的要求提供以下参数。

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'

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

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

打开模型广场

部分模型提供 Anthropic Messages 兼容接口。最新支持情况可前往 GenStudio 模型广场查看「Claude 兼容」筛选结果。

安装 Claude Code ​

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

如需单独安装 Claude Code CLI 工具，Anthropic 官方推荐 Native Install，该方式需要终端内支持魔法上网。

  • 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 ​

根据您的操作系统选择对应的配置方式。您可以使用 Shell 环境变量或 settings.json 配置文件，两种方式均可正确连接到 GenStudio。

配置原理说明 ​

Claude Code 默认连接到 Anthropic 官方服务。通过配置，可以将其请求重定向到 GenStudio。主要优势包括：

  • 无需修改 Claude Code：仅通过配置切换服务端点
  • 使用 GenStudio API 密钥认证：替代 Anthropic API Key
  • 访问更多模型选择：除 Claude 外，还可使用第三方模型，例如智谱 GLM、Minimax 等多种模型

核心配置是设置两个关键参数，使 Claude Code 的所有请求都通过 GenStudio 转发。您可以通过 Shell 环境变量或 ~/.claude/settings.json 配置文件来设置这些参数。

  • ANTHROPIC_BASE_URL（GenStudio 服务端点）
  • ANTHROPIC_AUTH_TOKEN（您的 GenStudio API 密钥）

macOS / Linux 配置 ​

macOS 和 Linux 用户可以选择以下两种配置方式。

方式 1：Shell 环境变量 ​

此方式将 GenStudio 连接配置写入您的 Shell 配置文件，每次打开终端时自动应用。

操作步骤：

  1. 确定您使用的 Shell（通常是 bash 或 zsh）：

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

  2. 在对应配置文件末尾追加以下内容（记得替换 API 密钥）：

    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"
export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5"

    警告

    确保将 API 密钥替换为您真实的密钥。您可以从控制台获取 API 密钥。

方式 2：settings.json 配置 ​

您也可以通过 Claude Code 配置文件 ~/.claude/settings.json 进行配置。添加或替换 YOUR_GENSTUDIO_API_KEY 为您的 GenStudio API 密钥。

language-json
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://cloud.infini-ai.com/maas",
        "API_TIMEOUT_MS": "3000000",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5"
    }
}

Windows 配置 ​

Windows 用户可以选择以下两种配置方式。

方式 1：系统环境变量 ​

在 Windows 系统中，安装 Claude Code 后，在 CMD 中运行以下命令设置系统环境变量。添加或替换 YOUR_GENSTUDIO_API_KEY 为您的 GenStudio API 密钥。

language-shell
setx ANTHROPIC_AUTH_TOKEN YOUR_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
setx ANTHROPIC_DEFAULT_SONNET_MODEL glm-5
setx ANTHROPIC_DEFAULT_OPUS_MODEL glm-5

提示

提示

运行 setx 命令后，需要重新打开命令提示符或 PowerShell 窗口，新的环境变量才会生效。

方式 2：settings.json 配置 ​

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

language-json
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://cloud.infini-ai.com/maas",
        "API_TIMEOUT_MS": "3000000",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5"
    }
}

启动与验证 ​

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

操作步骤：

  1. 打开新的终端窗口（以确保环境变量已加载）

  2. 进入您的项目目录：

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

  3. 启动 Claude Code：

    language-bash
    claude

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

    • 自动从环境变量读取 ANTHROPIC_AUTH_TOKEN
    • 通过 ANTHROPIC_BASE_URL 指定的 GenStudio 服务进行认证
    • 无需额外登录步骤即可开始使用

提示

如果遇到找不到 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 应显示正确的端点地址

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

环境变量参考 ​

以下是配置 Claude Code 连接 GenStudio 时使用的主要环境变量。

  • ANTHROPIC_BASE_URL：GenStudio Anthropic Messages 兼容接口地址
  • ANTHROPIC_DEFAULT_HAIKU_MODEL：任何支持 Messages 接口的 GenStudio 预置模型（快速模型）
  • ANTHROPIC_DEFAULT_SONNET_MODEL：任何支持 Messages 接口的 GenStudio 预置模型（平衡模型）
  • ANTHROPIC_DEFAULT_OPUS_MODEL：任何支持 Messages 接口的 GenStudio 预置模型（高性能模型）

切换/设置默认模型 ​

如果想切换到其他模型，只需修改配置中的模型参数。

Shell 环境变量方式：修改 ~/.bashrc 或 ~/.zshrc 中的以下变量，然后运行 source 命令或重启终端：

language-bash
export ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5"

settings.json 方式：修改 ~/.claude/settings.json 中 env 对象的相应字段：

language-json
{
    "env": {
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5"
    }
}

支持的模型 ​

Claude Code 使用 Anthropic Messages 协议。本文中的模型名称仅作配置示例，最新支持情况建议优先通过前文“获取最新支持模型列表”中的接口查询，再结合 GenStudio 模型广场「Claude 兼容」筛选结果进行核对。

模型广场

信息

如您已订阅 Infini 编码套餐 (Coding Plan)，请优先以模型列表接口的实时返回结果为准；编码套餐页面和模型广场可作为控制台侧的辅助核对。

故障排除 ​

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

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

  • 检查环境变量中的 GenStudio API 密钥是否正确
  • 确认 API 密钥已激活且有足够余额
  • 验证 API 密钥格式以 sk- 开头

模型不支持 Anthropic 协议 ​

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

Claude Code 无法连接到 GenStudio 服务 ​

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

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

VSCode Claude Code 扩展可能无法读取环境变量，可尝试使用 settings.json 文件配置。

相关文档 ​

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