3.1 Codex 系列

适用于：Codex CLI、Codex VSCode 插件、Codex 移动 App。 三种形态共用同一份 API 配置，只是填入位置不同。

一、准备好两样东西

• Base URL：https://axiomcode.top/v1
• API Key：sk-axiom-xxxx（2.2 节创建 那把）

如果还没拿到，请先回去走一遍上一章。

二、Codex CLI

Codex 官方 CLI 工具通过读取环境变量或 ~/.codex/config.toml 来定位接入点。

2.1 环境变量法（最快）

macOS / Linux：在 ~/.zshrc 或 ~/.bashrc 末尾追加：

export OPENAI_API_KEY="sk-axiom-你的Key"
export OPENAI_BASE_URL="https://axiomcode.top/v1"

保存后执行 source ~/.zshrc（或 source ~/.bashrc）让其生效。

Windows PowerShell（永久生效）：

[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-axiom-你的Key", "User")
[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://axiomcode.top/v1", "User")

执行后关闭并重新打开终端，环境变量才会被加载。

2.2 配置文件法

如果你不想污染系统环境变量，可以走 Codex 自己的配置文件。

• macOS / Linux：~/.codex/config.toml
• Windows：C:\Users\<你的用户名>\.codex\config.toml

文件内容示例：

[provider.axiom]
base_url = "https://axiomcode.top/v1"
api_key = "sk-axiom-你的Key"

[default]
provider = "axiom"
model = "gpt-5-codex"

保存后重启 Codex CLI 即可。

2.3 验证

终端里运行：

codex --version
codex chat "用一句话介绍 quicksort"

能正常返回内容即接入成功。

三、Codex VSCode 插件

1. 在 VSCode 扩展商店搜索 Codex 并安装。
2. 安装完成后，按 Ctrl/⌘ + , 打开「设置」，搜索 codex 关键字。
3. 在以下两项中填入你的 AxiomCode 配置：
   • Codex: Api Base Url → https://axiomcode.top/v1
   • Codex: Api Key → sk-axiom-你的Key

4. 按 Ctrl/⌘ + Shift + P → 输入 Codex: Reload，或者重启 VSCode。
5. 打开任意文件，按插件提示的快捷键（默认 Ctrl/⌘ + I）唤起 Codex，输入指令测试。

四、Codex 移动 App

1. 应用商店搜索安装「Codex」App（或下载官方 APK / TestFlight）。
2. 进入 「设置」→「API 接入」。
3. 填入：
   • API 地址：https://axiomcode.top/v1
   • API Key：sk-axiom-你的Key
4. 点 保存 → 回到首页，新开一个对话验证。

移动 App 建议为它单独开一把 Key

手机丢失或被借用时，可以一键去后台禁用这把 Key 而不影响电脑/服务器上的其它 Key。

五、常见问题

模型选什么？ 默认填 gpt-5-codex 即可；如需其他模型，在 接入配置 弹窗里查看当前账号开放的模型列表。

接口返回 401？ 99% 是 Key 写错（前后多空格、漏了 sk- 前缀）。回到密钥页核对一下。

接口返回 404 / 找不到模型？ Base URL 写错（少了 /v1 或者多了一层路径）或者填了你账号没开通的模型。