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 # 在对话中输入:你好,请确认连接正常

常见问题