Gush API 快速开始

创建 API Key

登录 Gush API 控制台，从左侧导航进入「API 密钥」，点击右上角「创建密钥」。密钥名称只用于自己识别，可以按照用途命名，例如“Codex”“Claude Code”或“生产环境”。

1. 1

   打开 Gush API 控制台，完成注册或登录。

2. 2

   进入「API 密钥」，点击「创建密钥」，填写便于识别的名称。

3. 3

   先不要直接提交，继续完成下一步的分组选择。

选择正确的分组

创建密钥时必须选择分组。分组决定这个 Key 可以调用的平台、模型范围、账号池和计费倍率；选错分组会导致模型不可用、路由到错误平台或返回权限错误。

选择分组后提交创建，并立即保存完整的 sk-... 密钥。已有密钥也可以在列表的“分组”列中点击当前分组重新选择。

推荐：一键导入 CC Switch

创建密钥后，优先使用列表操作栏中的「导入到 CCS」。Gush API 会通过 CC Switch 深链自动带入供应商名称、API 地址、平台、API Key 和用量查询配置，省去手动复制多项参数。

1. 1

   先按照 CC Switch 使用说明完成安装，并开启目标工具的插件接管。

2. 2

   回到「API 密钥」列表，在目标 Key 的操作栏点击「导入到 CCS」。

3. 3

   允许浏览器打开 CC Switch，核对供应商、平台、API 地址与模型，然后保存并设为 Active。

4. 4

   完全重启正在运行的终端、Codex、Claude Code 或编辑器，让新配置生效。

{
  "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.2[1M]"
}

如果使用其他模型，请把 glm-5.2[1M] 替换为该分组实际提供的完整模型 ID。更多说明见 CC Switch → Claude Code 模型映射。

验证配置或发送请求

通过 CC Switch 导入后，重启目标工具并发送一条简单消息。如果需要独立验证 Key，可以使用下面的 OpenAI 兼容请求；模型 ID 必须属于创建 Key 时选择的分组。

curl https://api.gush.cc/v1/chat/completions \
  -H "Authorization: Bearer $GUSH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [
      {"role": "user", "content": "用一句话解释 API"}
    ],
    "stream": true
  }'

from openai import OpenAI

client = OpenAI(
    api_key="$GUSH_API_KEY",
    base_url="https://api.gush.cc/v1",
)

response = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[{"role": "user", "content": "Hello"}],
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.GUSH_API_KEY,
  baseURL: "https://api.gush.cc/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-5.6-sol",
  messages: [{ role: "user", content: "Hello" }],
});

身份认证

所有 API 请求都需要在 HTTP 请求头中发送 Bearer Token。服务端会根据密钥识别账户、权限和额度。

接口与端点

SDK 配置使用带 /v1 的 Base URL；直接发送 HTTP 请求时，在其后追加具体端点。

模型选择

模型权限以控制台和 GET /v1/models 的返回为准。建议在生产环境中使用返回列表里的精确模型 ID，不要依赖展示名称。

OpenAIgpt-5.6-sol

Anthropicclaude-*

智谱glm-5.2[1M]

流式响应

将请求体中的 stream 设置为 true，服务会通过 Server-Sent Events 持续返回增量内容。请逐行处理 data: 事件，并在客户端断开时及时取消上游请求。

Codex 安装与配置

Codex CLI 可以直接在项目目录中读取代码、修改文件和运行命令。下面先完成安装与验证，再配置 Gush API；Codex IDE 扩展和桌面 App 会复用同一份本地配置。

官方安装器需要访问 chatgpt.com。如果当前网络无法下载脚本，请切换到下方的 npm 安装方式。

1. 选择安装方式

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

curl -fsSL https://chatgpt.com/codex/install.sh | sh

# 或使用 Homebrew
brew install --cask codex

curl -fsSL https://chatgpt.com/codex/install.sh | sh

node -v
npm -v
npm install -g @openai/codex

2. 验证安装并启动

重新打开终端后检查版本。然后进入你的项目目录并启动 Codex。

codex --version
cd your-project-folder
codex

官方版本首次运行会显示登录方式。使用 Gush API 时，不需要完成 ChatGPT 登录，继续按下一步创建本地 API Key 配置即可。

3. 获取 Gush API Key

1. 1

   登录 Gush API 控制台，进入「API 密钥」。

2. 2

   创建一个便于识别的密钥，复制完整的 sk-... 内容。

3. 3

   妥善保存密钥。下面示例中的 sk-your-gush-api-key 必须替换为你的真实密钥。

4. 创建 Codex 配置文件

在用户目录创建 .codex 文件夹，并在其中创建 config.toml 和 auth.json。Windows 路径为 %USERPROFILE%\.codex，macOS/Linux 路径为 ~/.codex。

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.OpenAI]
name = "Gush API"
base_url = "https://api.gush.cc/v1"
wire_api = "responses"
requires_openai_auth = false
http_headers = { "x-openai-actor-authorization" = "local-image-extension" }

[features]
goals = true

{
  "OPENAI_API_KEY": "sk-your-gush-api-key"
}

5. 在项目中使用 Codex

打开新的终端，进入项目目录并运行 codex。进入交互界面后可以使用 /status 检查当前模型和 Provider，使用 /permissions 设置命令与文件权限。

cd your-project-folder
codex

# 进入 Codex 后输入
/status

6. 安装 VS Code / Cursor 扩展

在扩展商店搜索 Codex，确认发布者为 OpenAI 后安装。扩展会读取同一份 ~/.codex 配置；如果之前登录过其他账户，先在扩展菜单中退出登录，关闭编辑器，完成配置后再重新打开。

7. 安装 Codex App

需要桌面端时，前往 OpenAI Codex 官方页面下载安装包。安装后先完全退出 App，按上文配置好 config.toml 和 auth.json，再重新打开；App 会复用 Codex CLI 的用户目录配置。

更新 Codex

常见安装问题

Claude Code

在终端设置 Anthropic 兼容地址和密钥。环境变量名称以你当前 Claude Code 版本支持的配置为准。

export ANTHROPIC_BASE_URL="https://api.gush.cc"
export ANTHROPIC_AUTH_TOKEN="$GUSH_API_KEY"

OpenAI SDK

现有 OpenAI SDK 项目通常无需修改业务逻辑。把 api_key 替换为 Gush API Key，并将 base_url 设置为 https://api.gush.cc/v1。

使用 CC Switch 管理供应商

CC Switch 是一款跨平台 API 供应商切换工具，可以在一个界面中管理 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 的 API 配置。适合需要在多个开发工具之间共用或快速切换 Gush API 的用户。

安装与通用配置

1. 1

   安装软件。运行安装包。如果 Windows SmartScreen 拦截，请先确认文件来自官方 Release，再点击“更多信息”与“仍要运行”。

2. 2

   开启插件接管。打开左上角设置，在“通用”中开启“应用到 XXX 插件”。只开启你实际使用的工具，也可以按需启用开机自启。

3. 3

   添加供应商。返回主界面，点击右上角加号。只配置单个工具时，在对应工具标签中添加；多个工具共用时，可以创建统一供应商。

4. 4

   填写并启用。供应商名称填写 Gush API，API Key 使用控制台生成的令牌。保存后点击供应商卡片，确认它处于 Active 状态。

各应用配置

先在 CC Switch 顶部选择目标应用，再按下表填写。模型 ID 应以控制台或 GET /v1/models 的实际返回为准。

Claude Code 模型映射

Claude Code 会按 Sonnet 等内置模型类型发起请求。使用 GLM 等第三方模型时，只填写模型名称可能不会生效，还需要在 CC Switch 的 Claude Code 供应商高级配置或 Env 中设置默认模型映射。例如，将默认 Sonnet 映射到 GLM-5.2：

{
  "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.2[1M]"
}

让切换后的配置生效

每次切换供应商后，关闭并重新打开正在运行的终端或开发工具。若配置没有变化，请依次检查：对应插件接管开关是否开启、供应商卡片是否为 Active、API Key 是否完整，以及请求地址是否出现重复的 /v1。

错误处理

速率限制

具体并发和用量限制以控制台套餐页面为准。遇到 429 时，使用带随机抖动的指数退避策略；不要在固定时间间隔内无限重试。

获取支持

无法通过文档解决时，请发送邮件至 hi@gush.cc。附上请求时间、端点、HTTP 状态码和响应中的请求 ID；不要发送完整 API Key。