# Codex API 配置：Passion8、CC-Switch 与 config.toml

> 用 CC-Switch 或 auth.json 与 config.toml 配置 Codex 接入 Passion8，设置 API Key、Base URL、Responses 模型及上下文限制。

URL: https://docs.passion8.cc/docs/codex/config
Language: zh-CN
Publisher: Passion8
Last updated: 2026-10-11

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




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




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

核对日期：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` 仍在当前参考中，后两项只在模型支持时生效，不会创造模型能力。

## 配置前准备

| 项目 | 值 |
| --- | --- |
| Passion8 API Key | 在控制台「令牌」里创建,复制完整 `sk-...` |
| 模型 ID | 在 [模型广场](https://passion8.cc) 里复制支持 Codex / Responses API 的模型 ID |

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

## 用 CC-Switch 配置(推荐)

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







### 安装并打开 CC-Switch

从 [CC-Switch Releases](https://github.com/farion1231/cc-switch/releases) 下载对应系统版本并打开,在顶部切到 GPT / Codex,点击添加供应商。






### 填写 Passion8

| 字段 | 值 |
| --- | --- |
| 供应商名称 | `Passion8` |
| API Base URL | `https://passion8.cc/v1` |
| API Key | `sk-你的 Passion8 API Key` |
| 模型 | Passion8 后台实际支持 Codex / Responses API 的模型 ID(示例用 `gpt-6-sol`) |






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

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

```toml
model = "gpt-6-sol"
review_model = "gpt-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.7` 用 `500000` / `475000`,见 [Grok 接入教程](https://docs.passion8.cc/docs/grok))。






### 保存并测试

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

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

能正常返回后,再到 Passion8 控制台核对同一时间的请求记录、模型与用量,确认实际路由。









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




## 手动配置

已有配置先备份。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 路径要求的最终结果一致。






### macOS


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

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

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

```bash
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
```

测试:

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





### Windows


认证文件:`%USERPROFILE%\.codex\auth.json`

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

配置文件:`%USERPROFILE%\.codex\config.toml`

```powershell
@'
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"
```

测试:

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











如果 Passion8 后台没有 `gpt-6-sol`,把 `model` / `review_model` 改成 [模型广场](https://passion8.cc) 里实际支持 Codex / Responses API 的模型 ID,并同步改 `model_context_window` / `model_auto_compact_token_limit`。

CC-Switch 与手动配置应落到同一组上下文数值:示例 `gpt-6-sol` 用 `272000` / `250000`;`grok-4.7` 用 `500000` / `475000`。这里是本站 `gpt-6-sol` 的已部署客户端限制,不是模型官方最大窗口或固定费用保证。其他模型按通道实际限制核对。

切换配置后,新开一个终端窗口再运行 Codex。已打开的进程可能不会立刻读取新配置。




## 常见检查

```bash
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 扩展教程](https://docs.passion8.cc/docs/codex/ide)。Remote SSH、WSL 和容器在各自运行环境里读取配置，应检查实际用户目录。要在同一个编辑器扩展里切换四家模型，可看 [Cline 多模型配置](https://docs.passion8.cc/docs/cline)。

## 下一步



- [安装 Codex](https://docs.passion8.cc/docs/codex/install): CLI、桌面端和官方 IDE 插件的安装方式。
- [常见问题](https://docs.passion8.cc/docs/codex/troubleshooting): 排查认证、模型、Responses API 与权限问题。