Appearance
手动配置
对应控制台「配置客户端」里的 手动配置:自己在用户目录下创建 .codex 文件夹,写入 config.toml 和 auth.json 两个文件。适合想弄清每个字段的人。
推荐方式
更倾向一键导入,优先用 CC Switch 一键导入(支持 13 个客户端)或 一键脚本配置。
三步最小可用配置
1. 创建配置目录
在用户主目录下创建 .codex 文件夹:
bash
mkdir -p ~/.codex
# 之后可在访达按 Command + Shift + G,输入 ~/.codex 回车打开该目录powershell
mkdir $env:USERPROFILE\.codex
# 之后可按 Win + R,输入 %USERPROFILE%\.codex 回车打开该目录2. 创建 config.toml
在 .codex 目录中创建 config.toml,写入以下内容:
toml
model_provider = "codexzh"
model = "gpt-5.6-terra"
model_reasoning_effort = "medium"
# 缓存优化配置
cache_size_mb = 512
cache_ttl = "30m"
smart_cache = true
cache_compression = true
[model_providers.codexzh]
name = "codexzh"
base_url = "https://api.codexzh.com/v1"
wire_api = "responses"
requires_openai_auth = true
web_search = "live"
[features]
collaboration_modes = true
unified_exec = false
multi_agent = true
search_tool = true
steer = true3. 创建 auth.json
同目录创建 auth.json,将 OPENAI_API_KEY 替换为控制台里 sk- 开头的真实密钥:
json
{
"OPENAI_API_KEY": "sk-你的实际密钥"
}验证配置
保存后完全退出并重新打开客户端,发一句话能正常回复即配置成功。ChatGPT 客户端要先在左上角切到 Codex 模式;CLI 在项目目录运行 codex。
想把默认模型改成 Grok 等其他型号,只改 config.toml 里的 model,见 模型与切换。