在 AIStudio 镜像中心使用 Dockerfile 自助构建最新版 vLLM 镜像在 AIStudio 镜像中心使用 Dockerfile 自助构建最新版 vLLM 镜像 ，无需访问 DockerHub立即构建
文档中心

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

获取 GenStudio API Key ​

您可以复制已有 API Key 或创建新的 Key。

获取 API 密钥

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

安装 Claude Code ​

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

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

  • macOS, Linux, WSL:

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

  • Windows PowerShell:

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

  • Windows CMD:

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

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

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 等多种模型

核心配置是设置两个关键参数，使 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 密钥）：

    bash
    # ============= GenStudio + Claude Code 配置 =============
# 将 Claude Code 连接到 GenStudio 而非 Anthropic 官方服务

# 核心配置：GenStudio 端点和认证
export ANTHROPIC_BASE_URL="https://cloud.infini-ai.com/maas"  # GenStudio Anthropic 兼容端点
export ANTHROPIC_AUTH_TOKEN="sk-xxx"                          # 替换为您的 GenStudio API 密钥
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"           # 禁用非必要流量

# 避免冲突：如果之前在本地设置了 ANTHROPIC_API_KEY，显式清空它
export ANTHROPIC_API_KEY=""

# 默认模型配置（必需）：将 Haiku / Sonnet / Opus 速度层级映射到实际模型
export ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-4.5-air"   # 快速模型
export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-4.7"      # 平衡模型
export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-4.7"        # 高性能模型

    重要

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

  3. 应用配置（选择其一）：

    bash
    # 方式 1：重新加载配置文件（推荐）
source ~/.bashrc  # 如果使用 bash
# 或
source ~/.zshrc   # 如果使用 zsh

# 方式 2：重启终端窗口

方式 2：settings.json 配置 ​

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

json
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_GENSTUDIO_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-4.5-air",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7"
    }
}

Windows 配置 ​

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

方式 1：系统环境变量 ​

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

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-4.5-air
setx ANTHROPIC_DEFAULT_SONNET_MODEL glm-4.7
setx ANTHROPIC_DEFAULT_OPUS_MODEL glm-4.7

提示

提示

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

方式 2：settings.json 配置 ​

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

json
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_GENSTUDIO_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-4.5-air",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7"
    }
}

启动与验证 ​

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

操作步骤：

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

  2. 进入您的项目目录：

    bash
    cd /path/to/your/project

  3. 启动 Claude Code：

    bash
    claude

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

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

提示

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

验证连接状态：

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

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

验证清单：

  • ✅ Auth token 应显示 ANTHROPIC_AUTH_TOKEN（表示正在从环境变量读取）
  • ✅ Anthropic base URL 应显示 https://cloud.infini-ai.com/maas（GenStudio 端点）

如果匹配以上内容，设置完成。您现在可以通过 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 命令或重启终端：

bash
export ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-4.5-air"
export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-4.7"
export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-4.7"

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

json
{
    "env": {
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7"
    }
}

支持的模型 ​

GenStudio 为部分模型提供了 Anthropic Messages 兼容接口，具体支持的模型，请以 GenStudio 模型广场「Claude 兼容」筛选结果为准。

模型广场

故障排除 ​

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

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

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

模型不支持 Anthropic 协议 ​

  • 在 GenStudio 模型广场查看当前支持的模型，请以 GenStudio 模型广场「Claude 兼容」筛选结果为准。
  • 从支持列表中选择一个模型

Claude Code 无法连接到 GenStudio 服务 ​

  • 检查网络连接是否正常
  • 验证 ANTHROPIC_BASE_URL 正确设置为 https://cloud.infini-ai.com/maas
  • 确认防火墙设置未阻止出站连接

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

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

计费与限制 ​

了解 GenStudio API 的计费规则和使用限制。

API 计费 ​

租户可在 GenStudio 服务列表页面查看全部模型价格（区分输入与输出价格）。如租户享受折扣，此处展示折后价。

服务列表

API 频率限制 ​

了解 GenStudio API 的调用限制，确保服务的稳定性：

相关文档 ​

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

找不到想要的答案？
让 AI 助手为您解答