Codex 配置
Codex 是 OpenAI 官方推出的 CLI 编程工具,基于 GPT 系列模型构建,专为代码生成、解释和调试设计。接入 521code 后可使用 OpenAI 兼容端点调用 Codex/GPT 系列模型。
工具简介
Codex CLI 主要功能:
- 直接在终端中生成、解释和调试代码
- 支持多种编程语言的代码补全
- 自动进行代码审查和重构建议
- 支持对话式编程和多轮上下文
安装指南
通过 npm 安装(跨平台)
npm install -g @openai/codex
macOS(可选 Homebrew)
如果你使用 Homebrew,可以选择:
brew install --cask codex
验证安装
安装完成后,在终端中运行:
codex --version
启动 Codex
codex
521code 接入配置
Codex 接入 521code 时,需要配置两个文件:config.toml 放模型和服务商配置,auth.json 放 API Key。请先在 521code 控制台创建密钥,再按下面内容填写。
提示:更快捷的方式是使用 CC Switch 一键配置 CCS,可以减少手动编辑配置文件出错。
配置文件位置
macOS / Linux
~/.codex/config.toml
~/.codex/auth.json
Windows
%userprofile%\.codex\config.toml
%userprofile%\.codex\auth.json
config.toml
如果文件不存在,请手动创建。把以下内容放在文件开头:
model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000
[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://us.efxhp.cn/v1"
wire_api = "responses"
requires_openai_auth = true
auth.json
把 sk-xxxx 替换成你在 521code 控制台创建的真实 API Key。
{
"OPENAI_API_KEY": "sk-xxxx"
}
推荐模型示例
gpt-5.4(默认推荐)
质量和速度比较均衡,适合大多数编程任务。
gpt-5.5
需要更强质量可以改成这个。
gpt-5.3-codex
偏编程任务可以优先使用这个。
gpt-5.4-mini
需要更省额度时可以改成这个。
验证方式
保存文件后重启 Codex。如果仍然报鉴权或模型错误,先检查 auth.json 是否为合法 JSON,并确认 Key 没有多余空格。
codex
# 在对话中输入:你好,请确认连接正常
常见问题
- 提示鉴权失败:重新复制 API Key,确认没有多余空格或换行。
- 提示模型不存在:确认模型名称属于 521code 当前可用模型列表。
- 连接超时:检查网络状况,确认
https://us.efxhp.cn/v1可访问。 - Base URL 注意:OpenAI 兼容接口使用
/v1路径,不要漏掉。