客户端配置

将 你的_API_Key 替换为完整的 API Key，在启动客户端的同一个终端执行：

export GATEWAY_API_KEY='你的_API_Key'

运行下面的命令查询可用模型，此操作不消耗生成额度：

curl --fail-with-body 'https://gateway-47-236-83-169.sslip.io/v1/models' \
  -H "Authorization: Bearer $GATEWAY_API_KEY"

查询当前 API key 的已用额度和剩余额度：

curl --fail-with-body 'https://gateway-47-236-83-169.sslip.io/api/usage/token/' \
  -H "Authorization: Bearer $GATEWAY_API_KEY"

total_used 为已用额度，total_available 为剩余额度，单位是网关额度（quota），不是模型 token 数量。查询不消耗生成额度。

$env:GATEWAY_API_KEY = '你的_API_Key'
curl.exe --fail-with-body 'https://gateway-47-236-83-169.sslip.io/v1/models' `
  -H "Authorization: Bearer $env:GATEWAY_API_KEY"

curl.exe --fail-with-body 'https://gateway-47-236-83-169.sslip.io/api/usage/token/' `
  -H "Authorization: Bearer $env:GATEWAY_API_KEY"

直接在终端执行的环境变量设置只对当前终端及其启动的程序生效。若要在新终端自动生效，将 Key 和所用客户端的 export 配置写入对应的 shell 配置文件：

也可以保存后重新打开终端。Bash 登录终端通常读取 ~/.bash_profile，可在该文件中加入 source ~/.bashrc。配置文件只放环境变量设置，启动客户端的命令单独执行。从系统打开的桌面应用不一定读取这些 shell 配置。

设置好 Key 后，将 CLAUDE_MODEL_ID 换成实际模型 ID，在同一终端运行。示例把 Sonnet、Opus 和 Haiku 都设为同一个模型；有多个可用模型时，可以分别修改。

unset ANTHROPIC_API_KEY
export ANTHROPIC_BASE_URL='https://gateway-47-236-83-169.sslip.io'
export ANTHROPIC_AUTH_TOKEN="$GATEWAY_API_KEY"
export ANTHROPIC_MODEL='CLAUDE_MODEL_ID'
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
claude

Remove-Item Env:ANTHROPIC_API_KEY -ErrorAction SilentlyContinue
$env:ANTHROPIC_BASE_URL = 'https://gateway-47-236-83-169.sslip.io'
$env:ANTHROPIC_AUTH_TOKEN = $env:GATEWAY_API_KEY
$env:ANTHROPIC_MODEL = 'CLAUDE_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
$env:CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS = '1'
claude

启动后用 /status 查看实际使用的地址和 Key 来源。如果结果与配置不符，检查已有的 Claude Code 或 CC Switch 设置。CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY 请保持关闭，模型 ID 手动填写。由于未提供 /v1/messages/count_tokens，Claude Code 会按字符数估算上下文用量。CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 用于关闭 Claude Code 的实验性功能：目前在会话中用 /effort 调整档位后再压缩上下文，后续请求会报 400，设置后可避免。

1. 完成第 01 步，在当前终端设置 GATEWAY_API_KEY。
2. 编辑用户目录下的 ~/.codex/config.toml；Windows 为 %USERPROFILE%\.codex\config.toml。若设置了 CODEX_HOME，使用该目录里的文件。
3. 把以下字段合并进原配置，替换 CODEX_MODEL_ID。不要重复添加同名字段或表；顶层 model、model_provider 放在所有 […] 表之前。

model_provider = "gateway"
model = "CODEX_MODEL_ID"

[model_providers.gateway]
name = "Model Gateway"
base_url = "https://gateway-47-236-83-169.sslip.io/v1"
wire_api = "responses"
env_key = "GATEWAY_API_KEY"
requires_openai_auth = false

保存后从设置了 Key 的同一终端运行 codex。已有 profile 也可能覆盖模型或供应商，请一并检查。

以上配置适用于 Codex CLI。桌面版 Codex 可能读不到终端里的环境变量，需要单独设置。

在 CC Switch 顶部选择对应应用，点击右上角 +，进入应用专属供应商，预设选择自定义 / Custom。名称填写 Model Gateway，按下方字段填写。

这套配置无需开启本地代理或协议转换。CC Switch 会将 Key 存在本机，相关配置文件不要上传。首次切换前备份原配置，并检查终端中是否还设有其他供应商的环境变量。

完成第 01 步，编辑 ~/.config/opencode/opencode.json，将下面内容合并到现有配置。CHAT_MODEL_ID 的三个位置都替换为同一个完整模型 ID。

{
  "provider": {
    "gateway": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Model Gateway",
      "options": {
        "baseURL": "https://gateway-47-236-83-169.sslip.io/v1",
        "apiKey": "{env:GATEWAY_API_KEY}"
      },
      "models": {
        "CHAT_MODEL_ID": {
          "name": "CHAT_MODEL_ID"
        }
      }
    }
  },
  "model": "gateway/CHAT_MODEL_ID"
}

从同一终端运行 opencode。模型标识是 gateway/模型ID，其中 gateway 必须与上方 provider 名一致。项目内 opencode.json 也可能覆盖全局设置。

模型列表加载失败时，可以手动填写第 01 步查到的 ID。上下文窗口、最大输出长度等参数按所选模型的规格填写。

配置完成后，可以发一条简短消息检查是否正常。发送消息会消耗额度；遇到问题时参考下表。

需要查看当前 Key 的额度与用量时，在设置了 Key 的终端执行：

curl --fail-with-body 'https://gateway-47-236-83-169.sslip.io/api/usage/token/' \
  -H "Authorization: Bearer $GATEWAY_API_KEY"

Windows 使用 curl.exe 和 $env:GATEWAY_API_KEY。用量接口成功标志是 code: true；额度不是模型 token 数。查询成功也不等于仍有生成额度。