Codex CLI 与多环境安装全览

#安装

采用 npm 安装时，先准备受支持的 Node.js 环境，再运行：

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

也可从 OpenAI 官方 CLI 文档 选择独立安装器。npm 不是唯一安装方式。

#手动配置本站服务商

备份已有 ~/.codex/config.toml 后，将以下内容合并到文件中；不要覆盖已有 MCP、项目权限或其他供应商配置。Windows 的默认位置是用户目录下的 .codex\config.toml。

model_provider = "superfast"
model = "替换为模型广场中的可用模型ID"

[model_providers.superfast]
name = "SuperFast"
base_url = "https://api.sfapi.de/v1"
wire_api = "responses"
env_key = "SUPERFAST_API_KEY"

国内直连专线把 base_url 改为 https://api-cn.sfapi.de/v1。模型必须属于密钥对应分组，并支持所需协议。

为启动 Codex 的终端设置 SUPERFAST_API_KEY 环境变量。下面使用占位符，真实密钥不要提交到仓库或公开截图：

export SUPERFAST_API_KEY="替换为本站密钥"
codex

Windows PowerShell：

$env:SUPERFAST_API_KEY="替换为本站密钥"
codex

环境变量需要对运行 Codex 的进程可见。从桌面图标启动的应用不一定继承终端里的变量；桌面端可以使用配置工具或官方支持的网关认证方式。

#验证

在项目目录启动 Codex，发送简短消息，并在本站控制台核对使用记录。不要仅凭客户端显示的账户名判断供应商。

Claude Code 使用不同的协议和环境变量，参见 Claude Code 教程，不要直接照搬 Codex 的配置文件。

资料依据：Codex CLI · 配置参考。