Claude Code 接入

    如果您已安装好 Claude Code（Anthropic 终端 / IDE 中的 AI 编程助手），请按照以下步骤接入 Gate.AI。

    1. 创建 Gate.AI API 密钥

    1. 进入控制台 → 设置 → API 密钥，创建密钥。
    2. 复制以 sk-v1- 开头的密钥，后续替换下文占位符。
    3. 若需 自动路由 ： 控制台 → 设置 → 路由 → 打开「自动路由」。关闭时需在请求中显式指定模型 ID。

    2. 配置 Anthropic Base URL 与 API Key

    Claude Code 会读取环境变量；推荐与官方 LLM gateway 说明一致，设置：

    变量值
    ANTHROPIC_BASE_URLhttps://api.gate.ai/anthropic
    ANTHROPIC_API_KEY您的 Gate.AI API 密钥（sk-v1-…）

    方式 A：当前终端会话（临时）

    bash
    1export ANTHROPIC_BASE_URL="https://api.gate.ai/anthropic"2export ANTHROPIC_API_KEY="sk-v1-xxxxxxxxxxxxxxxx"3claude

    方式 B：写入 Shell 配置文件

    将以下内容追加到 ~/.zshrc 或 ~/.bashrc：

    bash
    1export ANTHROPIC_BASE_URL="https://api.gate.ai/anthropic"2export ANTHROPIC_API_KEY="sk-v1-xxxxxxxxxxxxxxxx"

    执行 source ~/.zshrc（或重新打开终端）后，再运行 claude。

    方式 C：Claude Code settings.json（推荐）

    在用户级或项目级配置中写入 env（路径见 Claude Code settings），例如 项目目录下 .claude/settings.json：

    json
    1{2  "env": {3    "ANTHROPIC_BASE_URL": "https://api.gate.ai/anthropic",4    "ANTHROPIC_API_KEY": "sk-v1-xxxxxxxxxxxxxxxx"5  }6}

    安全提示：不要将真实密钥提交到公共仓库；可使用各操作系统的密钥管理或 CI 密钥注入，本地仅用环境变量。

    恢复直连 Anthropic 官方

    若需临时绕过网关：

    bash
    1env -u ANTHROPIC_BASE_URL -u ANTHROPIC_API_KEY claude

    （需已配置 Anthropic 官方账号或其它默认凭据。）

    3. 配置模型（Gate.AI 模型 ID）

    Gate.AI 文档中的模型 ID 形如 provider/model-name（如 anthropic/claude-sonnet-4.6），与 Claude Code 内置别名（如 sonnet）不完全相同。任选其一：

    3.1 使用环境变量指定默认模型

    bash
    1export ANTHROPIC_MODEL="anthropic/claude-sonnet-4.6"

    或在 settings.json 的 env 中增加同名键。

    3.2 使用别名映射

    将别名映射到 Gate.AI 的模型 ID（示例为 Sonnet）：

    bash
    1export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-4.6"2export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-4.6"3export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-4.5"

    具体 ID 以 Gate.AI 文档 - 模型 列表为准。

    3.3 在 /model 中选自定义项

    若需在界面中选择网关侧模型，可使用 Claude Code 的自定义模型项（见官方 Model configuration - ANTHROPIC_CUSTOM_MODEL_OPTION）：

    bash
    1export ANTHROPIC_CUSTOM_MODEL_OPTION="anthropic/claude-sonnet-4.6"2export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Sonnet（Gate.AI）"

    3.4 自动路由模型 auto

    若在控制台已开启自动路由，可尝试将 ANTHROPIC_MODEL 设为 auto（与 OpenAI 接入页的 auto 语义一致）。若遇报错，请改回显式模型 ID（如 anthropic/claude-sonnet-4.6）。

    4. 验证接入是否成功

    1. 在已配置环境的终端执行：
    bash
    1claude
    1. 进入会话后输入简单指令，例如：请用一句话介绍你自己。
    2. 若返回正常回复且无鉴权/路由错误，即表示请求已到达 Gate.AI 并由所选模型响应。

    5. 常见问题

    现象可能原因处理建议
    401 / 鉴权失败API Key 错误或未导出检查 ANTHROPIC_API_KEY，与控制台密钥一致
    404 on URLBase URL 误用 OpenAI 路径使用 https://api.gate.ai/anthropic
    模型不存在 / 路由错误模型 ID 格式错误或控制台未允许该模型对照文档「模型」表；检查控制台路由与允许列表
    仍走官方 Anthropic环境变量未生效确认 settings.json 位置层级；或在新 shell 中 echo $ANTHROPIC_BASE_URL 验证