Codex 接入

用 OpenAI Codex 连接 SwatowAPI。Codex 走 OpenAI 兼容的 Responses API（wire_api = "responses"），因此所调用密钥的分组平台必须是 OpenAI。Base URL 为 https://swato.ai/v1。

准备工作

• 在控制台创建一个 分组平台为 OpenAI 的 API Key。分组平台如何决定路由，见 认证。
• 本地已安装 Codex CLI（或 IDE 扩展）。
• Base URL：https://swato.ai/v1。

配置

先用环境变量做临时连通性验证，确认无误后写入 ~/.codex/config.toml 持久化（推荐；CLI 与 IDE 扩展共用同一份配置）。

环境变量（临时）

export OPENAI_API_KEY="sk_your_swatowapi_key"
export OPENAI_BASE_URL="https://swato.ai/v1"
codex

~/.codex/config.toml（持久化）

model_provider = "SwatowAPI"
model = "gpt-5.3-codex"
review_model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true
network_access = "enabled"

[model_providers.SwatowAPI]
name = "SwatowAPI"
base_url = "https://swato.ai/v1"
wire_api = "responses"
requires_openai_auth = true

[features]
goals = true

TIP

把 gpt-5.3-codex 换成控制台或 GET /v1/models 中当前的 Codex 模型 id，模型 id 会随版本变化，不要当作固定值写死。

一键脚本

一键脚本不是公开下载文件：可用的脚本里嵌入了你选定的密钥。在控制台 API Key 页面，对某个密钥点击「使用密钥」，切到「Codex 一键脚本」标签页，复制或下载 macOS/Linux 或 Windows 版脚本。脚本在覆盖前会先备份你已有的 Codex 配置。

CLI 接入

先跑一个只读任务，确认认证、路由与网络都正常，再交给它写入类任务。

cd /path/to/your/project
codex "请只读取项目结构，并总结这个项目的主要模块。"

IDE 扩展

IDE 扩展读取的是同一份 ~/.codex/config.toml。

1. 确认配置里的 Base URL 与密钥正确。
2. 重启 IDE，让扩展重新加载配置。
3. 先运行一个只读任务。

MCP 与 AGENTS.md

MCP 服务器（可选）在配置中声明，用于接入外部工具或数据：

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]

AGENTS.md 记录仓库级协作规则（Codex 在本仓库里应该怎么做），与 MCP（外部工具/数据）是两回事。

验证

从三个层面确认链路打通：

• 客户端：Codex 能启动，并读到项目内容。
• 网关：请求打到站点的 /v1 入口，而不是走了系统代理或旧的过期配置。
• 账本：控制台用量日志出现这次调用，能看到模型、延迟、token 与计费。

常见排障

• 401 / Unauthorized：密钥必须是本站创建的；环境变量要在当前 shell 生效；配置里 env_key 的名称要对得上。
• Invalid base URL：必须带协议（如 https://swato.ai/v1）；不要用裸域名，也不要在 /v1 后面再接 /chat/completions。
• IDE 仍打到旧地址：重启 IDE 及扩展窗口；检查没有项目级配置覆盖了 ~/.codex/config.toml。
• 请求成功但账本无记录：确认用的是同一个站点域名和同一把 API Key；本地、预发、生产的账本互不相通。