Codex 配置指南

安装

NPM

npm install -g @openai/codex

Homebrew

brew install --cask codex

API 配置

配置文件

编辑 ~/.codex/config.toml：

model_provider = "xcode"
model = "gpt-5.2-codex"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.xcode]
name = "xcode"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://x-code.cc/v1"

环境变量配置

export OPENAI_BASE_URL="https://x-code.cc/v1"
export OPENAI_API_KEY="your-api-key"

Windows PowerShell

$env:OPENAI_BASE_URL = "https://x-code.cc/v1"
$env:OPENAI_API_KEY = "your-api-key"

永久配置（macOS / Linux）

在 ~/.bashrc 或 ~/.zshrc 中添加：

export OPENAI_BASE_URL="https://x-code.cc/v1"
export OPENAI_API_KEY="your-api-key"

重新加载配置：

source ~/.bashrc

永久配置（Windows）

在系统环境变量中添加：

变量名	值
OPENAI_BASE_URL	https://x-code.cc/v1
OPENAI_API_KEY	你的 API Key

快速配置工具

推荐使用 CC Switch 进行可视化配置管理。

CC Switch 是一个跨平台桌面工具，支持：

• 可视化管理多个 API Provider
• 一键切换不同配置
• 自动同步配置文件
• 支持 MCP 服务器管理
• 云端配置同步（Dropbox、OneDrive、iCloud）

下载地址：GitHub Releases

配置文件位置：

文件	路径
认证文件	~/.codex/auth.json
配置文件	~/.codex/config.toml
MCP 服务器	~/.codex/config.toml → [mcp_servers]

启动

配置完成后，运行：

codex