把现有应用接入比高AI

先创建并保存 API 密钥，再选择 SDK、Codex 或 Claude Code。所有示例均使用比高AI正式网关。

创建 API 密钥选择模型

从 OpenAI SDK 迁移

使用 Chat Completions 等已支持文本接口时，通常只需替换接口地址、API 密钥和模型 ID。迁移前请先对照 API 手册确认所需参数。

1保留现有 SDK继续使用现有 OpenAI 客户端和业务逻辑。

2替换 Base URL改为 https://api.bigao.ai/v1。

3替换密钥与模型使用 bgai_ 密钥和控制台展示的模型 ID。

修改前base_url = "https://api.openai.com/v1"

修改后base_url = "https://api.bigao.ai/v1"

Python 与 Node.js

选择你的开发语言，复制示例后把占位密钥与模型 ID 换成控制台中的实际值。

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://api.bigao.ai/v1",
    api_key=os.environ["BIGAO_API_KEY"],
)

result = client.chat.completions.create(
    model="你的模型ID",
    messages=[{"role": "user", "content": "你好"}],
)
print(result.choices[0].message.content)

Codex / Claude Code

选择命令行工具和操作系统。Codex 使用 config.toml 配置自定义模型提供方；Claude Code 使用 Anthropic 兼容地址。

下面的命令只需要配置一次。配置会写进系统（Codex 写 config.toml，环境变量写进用户环境），之后新开终端直接输 codex 或claude 就能用，不必重来一遍。

安装

npm install -g @openai/codex --registry=https://registry.npmmirror.com --prefix "$HOME/.bigao"
export PATH="$HOME/.bigao/bin:$PATH"
grep -qsF 'export PATH="$HOME/.bigao/bin:$PATH"' "$HOME/.zshrc" || echo 'export PATH="$HOME/.bigao/bin:$PATH"' >> "$HOME/.zshrc"

配置密钥与模型

mkdir -p "$HOME/.codex"
[ -f "$HOME/.codex/config.toml" ] && cp "$HOME/.codex/config.toml" "$HOME/.codex/config.toml.bak"
cat > "$HOME/.codex/config.toml" <<'BIGAO_EOF'
model = "你的模型ID"
model_provider = "bigao"
model_context_window = 200000
model_auto_compact_token_limit = 160000

[features]
apps = false

[model_providers.bigao]
name = "Bigao AI"
base_url = "https://api.bigao.ai/v1"
env_key = "BIGAO_API_KEY"
wire_api = "responses"
BIGAO_EOF
export BIGAO_API_KEY='bgai_PASTE_YOUR_KEY'
grep -qsF 'export BIGAO_API_KEY='"'"'bgai_PASTE_YOUR_KEY'"'"'' "$HOME/.zshrc" || echo 'export BIGAO_API_KEY='"'"'bgai_PASTE_YOUR_KEY'"'"'' >> "$HOME/.zshrc"

开始使用

codex

官方客户端（桌面端 / 编辑器扩展）

图形客户端不读命令行那套配置，三个入口各认各的地方：Claude 桌面端只认应用内的「第三方推理」配置，Claude Code 的编辑器扩展只认编辑器自己的设置， Codex 的两个图形入口与命令行共用 ~/.codex/config.toml。照命令行那套配完，桌面端不会报错，只是完全没有反应——它根本没读那些地方。

Claude 桌面端

菜单栏 Help → Troubleshooting → Enable Developer Mode（应用会重启），再打开 Developer → Configure Third-Party Inference…，把 Connection 里的 Inference provider 选成 Gateway，然后填这四格：

Gateway base URLhttps://api.bigao.ai

Gateway API keybgai_PASTE_YOUR_KEY

Credential kindStatic API key

Gateway auth schemeBearer选 x-api-key 也能用，两种比高都接受

接入网关后，桌面端只在本机跑会话，不再提供云端环境和远程控制；claude.ai 的订阅额度也不再生效，费用统一走比高余额。这是官方设计，不是故障。

Claude Code 编辑器扩展

命令面板 → Preferences: Open User Settings (JSON)，加入下面这段。必须写在这里：扩展自己的登录检查只读这一处，写进 ~/.claude/settings.json它看不到，会一直要求你登录 claude.ai。

"claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.bigao.ai" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "bgai_PASTE_YOUR_KEY" },
    { "name": "ANTHROPIC_MODEL", "value": "你的模型ID" },
    { "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "value": "1" }
]

Codex 编辑器扩展 / 桌面 app

与命令行共用同一份配置，只多一步：把密钥写成文件让 Codex 自己去取。从图标启动的程序读不到终端里的环境变量，这一步不能省（Windows 例外，图形程序能读到用户环境变量，命令行那份配完重启客户端即可）。

mkdir -p "$HOME/.codex" "$HOME/.bigao"
[ -f "$HOME/.codex/config.toml" ] && cp "$HOME/.codex/config.toml" "$HOME/.codex/config.toml.bak"
cat > "$HOME/.codex/config.toml" <<'BIGAO_EOF'
model = "你的模型ID"
model_provider = "bigao"
model_context_window = 200000
model_auto_compact_token_limit = 160000

[features]
apps = false

[model_providers.bigao]
name = "Bigao AI"
base_url = "https://api.bigao.ai/v1"
wire_api = "responses"

[model_providers.bigao.auth]
command = "/bin/sh"
args = ["-c", "cat \"$HOME/.bigao/codex-key\""]
timeout_ms = 5000
BIGAO_EOF
(umask 177 && printf '%s' 'bgai_PASTE_YOUR_KEY' > "$HOME/.bigao/codex-key")

Codex 桌面 app 目前对自定义供应商支持不完整：模型选择器可能不显示比高的模型，切换后原有会话也可能看起来消失。这是 Codex 自身的限制——需要稳定指定模型时，建议用命令行或编辑器扩展。

先验证密钥与网络连接

调用模型列表接口。返回 JSON 即表示网关可访问且密钥通过验证；401 表示密钥缺失、无效或已过期。

curl https://api.bigao.ai/v1/models \
  -H "Authorization: Bearer bgai_你的密钥"

上线前检查

密钥只放在服务端

通过环境变量或密钥管理服务读取，不打包进网页。

区分测试与生产

为不同环境创建独立密钥，便于停用、轮换和排查。

记录 request_id

保留错误响应中的请求编号，出现问题时便于定位。

处理限流与余额

对 429 做退避重试，对 402 提示检查账户余额。