Codex（安装与接入 SuperToken）

Codex 是 OpenAI 的终端编程代理，可以在本地仓库中进行代码阅读、修改、执行命令和审查。

你需要准备

• 已安装 Node.js（推荐 22+ 版本）
• 一个 SuperToken 的 API Key（注册并创建）
• 已创建 GPT 分组（详见 分组与计价）

TIP

Codex 通过 OpenAI 兼容方式接入 SuperToken，地址使用 https://api.supertoken.cc/v1。

1. 安装 Codex

打开 PowerShell，运行：

npm install -g @openai/codex

验证安装：

codex --version

打开终端，运行：

npm install -g @openai/codex

验证安装：

codex --version

打开终端，运行：

npm install -g @openai/codex

验证安装：

codex --version

2. 配置 Codex（接入 SuperToken）

Codex 主要需要两部分配置：

• OPENAI_API_KEY：你的 SuperToken API Key
• ~/.codex/config.toml：指定 SuperToken 网关和默认模型

设置 API Key

[Environment]::SetEnvironmentVariable("OPENAI_API_KEY","你的SuperToken API Key","User")

写入配置文件

mkdir -Force "$env:USERPROFILE\.codex"
@"
model = "gpt-5.4"
model_provider = "supertoken"

[model_providers.supertoken]
name = "SuperToken"
base_url = "https://api.supertoken.cc/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"
"@ | Out-File -Encoding utf8 "$env:USERPROFILE\.codex\config.toml"

写入认证文件

@'
{
  "OPENAI_API_KEY": "你的SuperToken API Key",
  "tokens": null,
  "last_refresh": null
}
'@ | Set-Content -Path "$env:USERPROFILE\.codex\auth.json" -Encoding UTF8

设置 API Key

将下面这段追加到 ~/.zshrc：

{
  echo ''
  echo '# SuperToken for Codex'
  echo 'export OPENAI_API_KEY="你的SuperToken API Key"'
} >> ~/.zshrc

然后执行：

source ~/.zshrc

写入配置文件

mkdir -p ~/.codex
cat > ~/.codex/config.toml <<'EOF'
model = "gpt-5.4"
model_provider = "supertoken"

[model_providers.supertoken]
name = "SuperToken"
base_url = "https://api.supertoken.cc/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"
EOF

设置 API Key

根据你的 Shell 写入配置文件：

{
  echo ''
  echo '# SuperToken for Codex'
  echo 'export OPENAI_API_KEY="你的SuperToken API Key"'
} >> ~/.bashrc

然后执行：

source ~/.bashrc

如果你使用的是 Zsh，请写入 ~/.zshrc 并执行 source ~/.zshrc。

写入配置文件

mkdir -p ~/.codex
cat > ~/.codex/config.toml <<'EOF'
model = "gpt-5.4"
model_provider = "supertoken"

[model_providers.supertoken]
name = "SuperToken"
base_url = "https://api.supertoken.cc/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"
EOF

你必须将 你的SuperToken API Key 替换为真实 Key。默认模型写的是 gpt-5.4，你也可以根据 SuperToken 当前可用模型自行替换。

3. 启动并验证

进入你的项目目录后，运行：

codex

如果能正常进入并开始对话，说明已经成功接入 SuperToken。