Claude Code

Claude Code 终端 CLI 通过 Anthropic Messages 接入 ApiGo。Base URL 为 https://api.apigo.ai，客户端请求 /v1/messages。

从模型详情一键复制

在工作空间 → API Keys 创建密钥。
在模型目录打开目标模型。
选择 快速接入 → Claude Code，再选择 临时命令（Temporary command） 或 配置文件（Configuration file）。
选择 macOS / Linux 或 PowerShell，设置 APIGO_API_KEY 后按复制的说明操作。

临时命令 只配置当前终端；配置文件 会提供可长期保留的用户设置，并使用独立命令从终端读取 API Key。快速接入会填入当前模型 ID，并检查目录中的协议。没有 Messages 时会显示原因，不生成 CLI 配置。协议可用不代表流式输出、工具调用和全部编程功能都已通过验证。

非 Claude 模型需要网关兼容适配，不在 Anthropic 官方对 Claude Code 的支持范围内。请验证具体模型和工作流后再使用。参见 Anthropic 网关说明。

安装与手动配置

按照官方安装指南安装或更新 CLI，用 claude --version 确认安装结果。

将 YOUR_MODEL_ID 替换为 ApiGo 目录中的准确模型 ID，保留其实际前缀；将 YOUR_APIGO_API_KEY 替换为自己的密钥。两者均为占位符，不能直接调用。

临时命令

仅在当前终端会话中使用配置时，采用此方式。

macOS / Linux

export APIGO_API_KEY='YOUR_APIGO_API_KEY'
export ANTHROPIC_BASE_URL='https://api.apigo.ai'
export ANTHROPIC_AUTH_TOKEN="$APIGO_API_KEY"
export ANTHROPIC_MODEL='YOUR_MODEL_ID'
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"

claude --model "$ANTHROPIC_MODEL"

Windows PowerShell

$env:APIGO_API_KEY = 'YOUR_APIGO_API_KEY'
$env:ANTHROPIC_BASE_URL = 'https://api.apigo.ai'
$env:ANTHROPIC_AUTH_TOKEN = $env:APIGO_API_KEY
$env:ANTHROPIC_MODEL = 'YOUR_MODEL_ID'
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = $env:ANTHROPIC_MODEL
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = $env:ANTHROPIC_MODEL
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = $env:ANTHROPIC_MODEL

claude --model $env:ANTHROPIC_MODEL

ANTHROPIC_AUTH_TOKEN 使用 Bearer 鉴权。如果现有 ApiGo 配置已通过 ANTHROPIC_API_KEY（x-api-key 请求头）正常调用，可保留原有鉴权方式，只更新模型；避免留下冲突的凭据。不要在 Base URL 后拼接 /v1/messages。参见凭据与地址配置。

配置文件

将下面内容合并到用户级 ~/.claude/settings.json（Windows：%USERPROFILE%\.claude\settings.json）。其中不保存 API Key；每次启动 Claude Code 前，仍需在终端设置 APIGO_API_KEY。

{
  "model": "YOUR_MODEL_ID",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apigo.ai",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_MODEL_ID"
  }
}

替换已有同名字段，保留其它设置。不要将真实密钥写入共享项目文件。设置文件的 env 优先于同名 shell 环境变量；如果修改终端变量后没有生效，检查文件中是否保留旧值。

每个终端会话先设置密钥，再传给 Claude Code：

export APIGO_API_KEY='YOUR_APIGO_API_KEY'
export ANTHROPIC_AUTH_TOKEN="$APIGO_API_KEY"
claude --model 'YOUR_MODEL_ID'

$env:APIGO_API_KEY = 'YOUR_APIGO_API_KEY'
$env:ANTHROPIC_AUTH_TOKEN = $env:APIGO_API_KEY
claude --model 'YOUR_MODEL_ID'

桌面应用的网关配置请看独立的 Claude Desktop 指南。

切换模型与快捷别名

启动新会话时指定其它模型：

claude --model 'ANOTHER_MODEL_ID'

也可以在会话内切换：

/model ANOTHER_MODEL_ID

模型选择器不一定展示全部 ApiGo 模型，填入名称也不会补齐缺失协议。配置文件示例会将 sonnet、opus、haiku 映射到当前模型，避免这些别名选中其它默认模型。临时会话中可显式设置：

export ANTHROPIC_MODEL='YOUR_MODEL_ID'
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"

$env:ANTHROPIC_MODEL = 'YOUR_MODEL_ID'
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = $env:ANTHROPIC_MODEL
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = $env:ANTHROPIC_MODEL
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = $env:ANTHROPIC_MODEL

这些角色也可以分别填写不同的可用模型 ID。显式子代理模型设置、组织策略等仍可能影响选择；如果请求使用了意外的模型，请继续检查这些配置，不能认为主模型设置控制了所有后台任务。参见模型配置参考。

验证与排错

运行 /status 检查 ApiGo 地址与凭据来源。让 CLI 只读总结当前目录，再到调用日志核对模型、最终结果和用量。正式使用前，还应在测试项目中验证一次工具执行和完整流式回答。

现象	检查项
401	密钥状态，以及当前终端、用户设置中的凭据来源；不要向客服发送完整 Key。
404	Base URL、准确模型 ID、目录是否提供 Messages。
使用了其它模型	`--model`、`ANTHROPIC_MODEL`、别名、已保存设置、子代理配置和组织策略。
文本问答成功但编程失败	工具调用、工具结果回传、流式输出及模型特定参数；普通聊天成功不是完整编程验收。
ApiGo 没有日志	检查 `/status`，从配置过的终端重新启动，并确认 Workspace 与查询时间范围。

相关文档：Codex CLI · Claude Desktop · 用量与日志。

概览与选型

Claude Desktop