Passion8Docs
Codex

配置教程

在 macOS 和 Windows 上把 Codex 配置到 Passion8:手动写 auth.json/config.toml,或用 CC-Switch 图形化配置。

两份文件:auth.json(保存 OPENAI_API_KEY)和config.toml(声明模型、Provider、Base URL、权限开关)。base_url 必须是 https://passion8.cc/v1,带 /v1。认证 Key 写进 auth.json,不要写进 config.toml。

#配置前准备

项目值
Passion8 API Key在控制台「令牌」里创建,复制完整 sk-...
模型 ID在 模型广场 里复制支持 Codex / Responses API 的模型 ID

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

#用 CC-Switch 配置(推荐)

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

1

安装并打开 CC-Switch

从 CC-Switch Releases 下载对应系统版本并打开,在顶部切到 GPT / Codex,点击添加供应商。

2

填写 Passion8

字段值
供应商名称Passion8
API Base URLhttps://passion8.cc/v1
API Keysk-你的 Passion8 API Key
模型Passion8 后台实际支持 Codex / Responses API 的模型 ID(示例用 gpt-5.6-sol)
3

核对上下文窗口(与手动配置相同)

CC-Switch 保存后,打开 ~/.codex/config.toml(Windows 为 %USERPROFILE%\.codex\config.toml),确认与手动配置使用同一组上下文数值。示例模型 gpt-5.6-sol 推荐:

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

缺这些项时请手补;若 CC-Switch 写了 model_catalog_json,catalog 里该模型的 context_window / max_context_window 也要与上面一致,不要写成 1000000 或几百万(窗口虚高会导致 auto-compact 过晚,长会话顶满才报错)。换模型时按真实窗口改这两个数(例如 grok-4.5 用 500000 / 475000,见 Grok 接入教程)。

4

保存并测试

保存并核对后,切换到这个供应商,新开终端或 PowerShell 运行:

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

能正常返回内容,就说明 Codex 已通过 Passion8 发起请求。

Windows 上如果软链接同步失败,在 CC-Switch 里改用文件复制策略,或用管理员权限 / 开发者模式再试。

#手动配置

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

认证文件:~/.codex/auth.json

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

配置文件:~/.codex/config.toml

cat > ~/.codex/config.toml << 'EOF'
model_provider = "Passion8"
model = "gpt-5.6-sol"
review_model = "gpt-5.6-sol"
model_reasoning_effort = "medium"
model_context_window = 272000
model_auto_compact_token_limit = 250000
disable_response_storage = true
approval_policy = "on-request"
web_search = "live"
sandbox_mode = "danger-full-access"
model_supports_reasoning_summaries = true
personality = "pragmatic"
show_raw_agent_reasoning = true
approvers_reviewer = "user"

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

[features]
goals = true
suppress_unstable_features_warning = true
EOF

测试:

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

如果 Passion8 后台没有 gpt-5.6-sol,把 model / review_model 改成 模型广场 里实际支持 Codex / Responses API 的模型 ID,并同步改 model_context_window / model_auto_compact_token_limit。

CC-Switch 与手动配置应落到同一组上下文数值:示例 gpt-5.6-sol 用 272000 / 250000;grok-4.5 用 500000 / 475000。不写这两项、或把窗口写成 1000000 时,Codex 往往不会及时 auto-compact,长会话容易直接撞上游上下文上限报错。

切换配置后,新开一个终端窗口再运行 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 配置。

#下一步

安装 CodexCLI、桌面端和官方 IDE 插件的安装方式。常见问题排查认证、模型、Responses API 与权限问题。
上一页安装教程下一页CC-Switch 配置

Support / 支持

Need help? / 需要帮助？

接入、计费与模型异常可邮件联系；服务可用性以状态页为准。For setup, billing, or model issues, email us. Check the status page for uptime.

Support Email[email protected]Service Statusstatus.passion8.cc

也可使用右下角微信 / QQ 客服 · WeChat / QQ support is available at the bottom right