Codex 配置指南

安装

NPM

npm install -g @openai/codex

Homebrew

brew install --cask codex

API 配置

配置文件

编辑 ~/.codex/config.toml：

model_provider = "xcode"
model = "gpt-5.6-sol"
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

配置文件位置

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

启动

配置完成后，运行：

codex