Codex 配置教程

Codex 本地接入只需 Passion8 地址、API Key 和支持 Responses 的可用模型。推荐用 CC-Switch 管理配置，也可按下面步骤手动写文件；保存后重启 Codex，并在控制台核对测试请求。无需 OpenAI 账号或浏览器 OAuth。

#本站模型与当前官方型号

核对日期：2026-10-11。本站示例统一使用已有部署记录的 gpt-6-sol，客户端窗口 272000、自动压缩阈值 250000。官方当前 Codex 文档推荐可用时选择 gpt-6.1-sol，但上游发布不代表你的 Passion8 令牌已开放该 ID。以本站控制台的模型权限为准；切换型号时不要盲目沿用窗口限制。

配置清理：移除当前官方配置参考未列出的 disable_response_storage 与 approvers_reviewer，它们没有可以直接保证同等行为的替代项。数据保留以服务方政策为准，审批使用 approval_policy / sandbox_mode；旧模板把 suppress_unstable_features_warning 放在 [features] 下也不正确，此处直接省略非必要的警告抑制。review_model、show_raw_agent_reasoning、model_supports_reasoning_summaries 仍在当前参考中，后两项只在模型支持时生效，不会创造模型能力。

#配置前准备

下面示例用 gpt-6-sol。如果你的模型广场没有这个 ID,先把示例里的 model = "gpt-6-sol" 换成你的模型 ID。

#用 CC-Switch 配置(推荐)

CC-Switch 用图形界面管理 Codex 供应商,自动写入 auth.json 和 config.toml,不用手写文件。macOS 和 Windows 填写字段一致。

model = "gpt-6-sol"
review_model = "gpt-6-sol"
model_context_window = 272000
model_auto_compact_token_limit = 250000

codex "用一句话说明当前项目是什么"

#手动配置

已有配置先备份。Windows 示例建议使用 PowerShell 7;Windows PowerShell 5.1 的 UTF8 输出可能含 BOM,遇到解析错误时用编辑器保存为无 BOM 的 UTF-8。配置文件中的 OPENAI_API_KEY 字段填 Passion8 密钥,无需官方 OAuth 登录。

如果你不想装 CC-Switch,或想直接掌控两份配置文件,可以手动写入。下面 config.toml 的 Provider、模型、Base URL 和上下文窗口字段,与上方 CC-Switch 路径要求的最终结果一致。

mkdir -p ~/.codex
cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "sk-你的 Passion8 API Key"
}
EOF

cat > ~/.codex/config.toml << 'EOF'
model_provider = "Passion8"
cli_auth_credentials_store = "file"
forced_login_method = "api"
model = "gpt-6-sol"
review_model = "gpt-6-sol"
model_reasoning_effort = "medium"
model_context_window = 272000
model_auto_compact_token_limit = 250000
approval_policy = "on-request"
web_search = "live"
sandbox_mode = "workspace-write"
model_supports_reasoning_summaries = true
personality = "pragmatic"
show_raw_agent_reasoning = true

[model_providers]
[model_providers.Passion8]
name = "Passion8"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://passion8.cc/v1"

[features]
goals = true
EOF

codex "用一句话说明当前项目是什么"

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex"
@'
{
  "OPENAI_API_KEY": "sk-你的 Passion8 API Key"
}
'@ | Set-Content -Encoding UTF8 "$env:USERPROFILE\.codex\auth.json"

@'
model_provider = "Passion8"
cli_auth_credentials_store = "file"
forced_login_method = "api"
model = "gpt-6-sol"
review_model = "gpt-6-sol"
model_reasoning_effort = "medium"
model_context_window = 272000
model_auto_compact_token_limit = 250000
approval_policy = "on-request"
web_search = "live"
sandbox_mode = "workspace-write"
model_supports_reasoning_summaries = true
personality = "pragmatic"
show_raw_agent_reasoning = true

[model_providers]
[model_providers.Passion8]
name = "Passion8"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://passion8.cc/v1"

[features]
goals = true
'@ | Set-Content -Encoding UTF8 "$env:USERPROFILE\.codex\config.toml"

codex "用一句话说明当前项目是什么"

#常见检查

codex --version
codex "hello"

错误排查:

• auth.json 的字段名必须是 OPENAI_API_KEY
• config.toml 的 base_url 必须是 https://passion8.cc/v1
• model 必须是 Passion8 后台实际支持 Codex / Responses API 的模型 ID
• 自定义模型建议写 model_context_window 和 model_auto_compact_token_limit,避免长会话不压缩直接报错

不要同时保留多套互相冲突的 Codex 配置。

#接入常见问题

#OPENAI_API_KEY 要填 OpenAI 的 Key 吗？

这里是 Codex 固定的认证字段名，填的是你的 Passion8 API Key。请求由 base_url 指向 https://passion8.cc/v1，本地接入无需 OpenAI 账号或浏览器 OAuth。

#可以直接填任意 GPT 模型吗？

不可以。模型必须向你的令牌开放，并支持 Codex 使用的 Responses 协议。复制控制台的精确 ID；切换模型时还要核对上下文和自动压缩限制。能在 Cline 使用的 Chat Completions 模型不一定能在 Codex 使用。

#VS Code 扩展还要配一遍吗？

本机扩展与 CLI 共享用户级配置，详见 Codex VS Code 扩展教程。Remote SSH、WSL 和容器在各自运行环境里读取配置，应检查实际用户目录。要在同一个编辑器扩展里切换四家模型，可看 Cline 多模型配置。

#下一步