天宝 AI 全场景接入指南

新手 8 步

地址怎么填

安装前准备

一键脚本只负责写入天宝 AI 的 Codex 配置，不会安装 Node.js，也不会安装 Codex CLI。新电脑请先完成本节，否则后面的 codex 命令会提示找不到。

node -v
npm -v

npm install -g @openai/codex
codex --version

winget install OpenJS.NodeJS.LTS

node -v
npm -v

npm install -g @openai/codex
codex --version

套餐与额度

额度按站内后台记录扣减。不同模型、输入输出长度、缓存、工具调用都会影响消耗。第一次使用建议先发短问题测试。

一键脚本

一键脚本是给 Codex CLI 用的配置脚本。每个用户下载到的脚本都带着自己当前选择的 API Key，会自动备份旧配置，再写入天宝 AI 的地址、模型和 Key。运行前请先完成 安装前准备。

cd ~/Downloads
bash setup-tianbao-ai-codex-mac.sh
codex exec "只回复 OK"

cd ~/Downloads
chmod +x setup-tianbao-ai-codex-mac.sh
./setup-tianbao-ai-codex-mac.sh

xattr -d com.apple.quarantine ~/Downloads/setup-tianbao-ai-codex-mac.sh
bash ~/Downloads/setup-tianbao-ai-codex-mac.sh

cd $env:USERPROFILE\Downloads
powershell -ExecutionPolicy Bypass -File .\setup-tianbao-ai-codex-windows.ps1
codex exec "只回复 OK"

cd $env:USERPROFILE\Downloads
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\setup-tianbao-ai-codex-windows.ps1

脚本会修改哪些文件

旧文件会先备份，备份名类似 config.toml.backup-20260605-120000。换 Key 或换套餐后，重新下载脚本运行一次即可。

Codex CLI 手动配置

如果你不想用脚本，也可以手动配置。手动配置前同样要先安装 Node.js 和 Codex CLI。Codex CLI 使用 OpenAI 兼容地址，Base URL 填 https://api.tianbaozy.top/v1。

model_provider = "tianbao_ai"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true
network_access = "enabled"

[model_providers.tianbao_ai]
name = "天宝 AI"
base_url = "https://api.tianbaozy.top/v1"
wire_api = "responses"
requires_openai_auth = true

API Key 保存到 auth.json：

{
  "OPENAI_API_KEY": "sk-你的APIKey"
}

Claude Code 配置

Claude Code 不是 OpenAI 兼容配置，它使用 Anthropic 环境变量。这里最容易填错的是 Base URL：不要加 /v1。

export ANTHROPIC_BASE_URL="https://api.tianbaozy.top"
export ANTHROPIC_AUTH_TOKEN="sk-你的APIKey"
export ANTHROPIC_MODEL="gpt-5.4"
export ANTHROPIC_DEFAULT_OPUS_MODEL="gpt-5.4"
export ANTHROPIC_DEFAULT_SONNET_MODEL="gpt-5.4"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="gpt-5.4"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

claude -p "只回复 OK" --model gpt-5.4

$env:ANTHROPIC_BASE_URL="https://api.tianbaozy.top"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的APIKey"
$env:ANTHROPIC_MODEL="gpt-5.4"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="gpt-5.4"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="gpt-5.4"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="gpt-5.4"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

claude -p "只回复 OK" --model gpt-5.4

VS Code / Cursor / IDE

1. 先按 安装前准备 安装 Node.js 和 Codex CLI。
2. 再按 一键脚本 完成 Codex CLI 配置。
3. 在系统终端运行 node -v、npm -v、codex --version、codex exec "只回复 OK"，确认都正常。
4. 打开 VS Code、Cursor 或 Trae。
5. 进入扩展市场，搜索并安装 OpenAI Codex 插件。
6. 完全退出并重新打开 IDE，再打开真正的项目目录使用 Codex，不要把 .codex 配置目录当成项目打开。

如果 IDE 插件提示找不到配置，先确认本机已有 ~/.codex/config.toml 和 ~/.codex/auth.json，然后重启 IDE。

常用软件

代码测试

curl 查看模型

curl https://api.tianbaozy.top/v1/models \
  -H "Authorization: Bearer sk-你的APIKey"

curl 对话测试

curl https://api.tianbaozy.top/v1/chat/completions \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "user", "content": "只回复 OK"}
    ],
    "max_tokens": 20
  }'

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的APIKey",
    base_url="https://api.tianbaozy.top/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "只回复 OK"}],
    max_tokens=20,
)

print(resp.choices[0].message.content)

常见报错

联系客服

遇到无法解决的问题，请把这些信息发给客服，定位会快很多：

• 注册邮箱。
• 使用的软件，例如 Codex CLI、Claude Code、ChatBox、Cherry Studio。
• 报错截图或完整错误文本。
• 大概发生时间、套餐名称、模型名称。