使用说明
与使用文档一致的接入流程被浓缩至单页。直接在下方选择产品与运行平台，快速获取环境准备、CLI 安装与分组令牌配置步骤。
选择产品
选择平台
接入步骤
1
准备运行环境
安装 Node.js 18+ 并确认本地 npm 正常可用，推荐选择长期支持版本。
方法一：使用 Homebrew（推荐）
- 如果你已经安装了 Homebrew，使用它安装 Node.js 会更方便：
1brew update1brew install node方法二：官网下载
- 访问 https://nodejs.org/
- 下载适合 macOS 的 LTS 版本
- 打开下载的 .pkg 文件
- 按照安装程序指引完成安装
注意事项
- 如果遇到权限问题，可能需要使用 sudo
- 首次运行可能需要在系统偏好设置中允许
- 建议使用 Terminal 或 iTerm2
验证安装是否成功
1node --version1npm --version2
安装 CodeX CLI
使用 npm 全局安装最新版本 CLI 并校验。
1npm install -g @openai/codex验证 CodeX CLI 安装
1codex --version3
配置环境（CodeX）
在 ~/.codex 下配置 config.toml 与 auth.json，三个平台一致。
~/.codex/config.toml
1model_provider = "tabcode"
2model = "gpt-5-codex"
3model_reasoning_effort = "medium"
4disable_response_storage = true
5preferred_auth_method = "apikey"
6requires_openai_auth = true
7
8[model_providers.tabcode]
9name = "openai"
10base_url = "https://api.tabcode.cc/openai"
11wire_api = "responses"~/.codex/auth.json
1{ "OPENAI_API_KEY": "粘贴您的apikey" }配置解释
- model 可选 gpt-5（或 2025-09-16 起的 gpt-5-codex）。
- model_reasoning_effort 可选 high/medium/low。
- model_provider 与 [model_providers.*] 需与中转一致；wire_api 依服务为 responses 或 chat。
4
初始化项目并启动
进入目标工程目录执行
codex，根据向导完成模型与权限配置。1mkdir my-codex-project
2cd my-codex-project
3codex首次运行可设置开发偏好与推理等级，后续会自动加载配置。
验证清单
完成以下自检可确保 CLI 调用代理正常工作。
- 在对应 CLI 中执行
codex --version显示版本号。 - 确保已将分组令牌写入配置文件或环境变量，重新打开终端后仍可读取。
- 尝试在项目目录中运行
codex，完成首次向导。 - 控制台的“使用统计”检查是否出现调用日志。
常见问题
摘录使用文档中的快速排查建议，便于在控制台即时查看。
调用失败如何排查？
前往“使用统计”按时间和密钥筛选请求，查看状态码与错误信息；若为 401，请确认分组令牌是否有效，若为 429 / 403，请检查额度或限流策略设置。
测试与生产环境如何区分？
建议在“API 管理”分别创建密钥，并在名称或标签中标记 Test / Prod，同时为测试环境设置更低调用限额。
账单统计周期是什么？
默认按自然月统计，当月费用会同步展示在仪表板与“我的订购”页面，可在订购页面更新发票抬头与开票信息。