Passion8 Docs
Passion8.docs

Codex · Node · CC-Switch

最短接入路径

把 Passion8 配到 Codex 和常用开发工具里。

这份精简文档只保留当前最需要的步骤：创建 Key、安装 Node、配置 Codex CLI，以及用 CC-Switch 管理多套工具配置。

注册账号 → 充值教程 创建 API Key
Base URL https://passion8.cc/v1 · Codex Provider · 轻量文档
1

创建 Key

登录 Passion8，在令牌页面创建一个给 Codex 使用的 API Key。不要把 Key 写进公开仓库、截图或聊天记录。

2

安装 Node

Codex CLI 使用 npm 发布。先确认本机有 Node.js LTS 和 npm，再安装 Codex。

3

配置 Codex CLI

把 Passion8 作为自定义 provider 写入 Codex 配置，并把 API Key 单独保存到 Codex 认证文件。

4

可选工具

如果需要在 Claude Code、Codex、Gemini 等配置之间切换，再安装 CC-Switch。

Step 1

安装 Node.js LTS

安装完成后，打开一个新的终端窗口，确认 `node` 和 `npm` 都能执行。

macOS

没有 Homebrew 时，也可以直接从 nodejs.org 下载 LTS 安装包。

brew install node
node -v
npm -v

Windows

如果没有 winget，就从 nodejs.org 下载 Windows LTS 安装包。

winget install OpenJS.NodeJS.LTS
node -v
npm -v

Linux

服务器环境建议固定一个 LTS 版本，避免自动升级导致 CLI 行为变化。

# 使用发行版包管理器或 nvm 安装 LTS
node -v
npm -v

Step 2

配置 Codex CLI

下面是 Passion8 的推荐配置。模型名以后台模型广场实际可用名称为准。

安装 Codex

macOS 用户也可以使用 Homebrew 安装 Codex。安装后先执行 `codex --version` 验证路径正常。

npm install -g @openai/codex
codex --version

写入认证文件

把下面示例里的 `sk-你的 Passion8 API Key` 替换成你自己在 Passion8 创建的 Key，只复制当前系统对应的代码块。

mkdir -p ~/.codex
cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "sk-你的 Passion8 API Key"
}
EOF
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex"
@'
{
  "OPENAI_API_KEY": "sk-你的 Passion8 API Key"
}
'@ | Set-Content "$env:USERPROFILE\.codex\auth.json"

Codex 使用 `requires_openai_auth = true` 时，会从 `auth.json` 读取 `OPENAI_API_KEY`。

写入 Codex 配置

macOS / Linux 路径是 `~/.codex/config.toml`，Windows 路径是 `%USERPROFILE%\.codex\config.toml`。

model_provider = "Passion8"
model = "gpt-5.5"
model_reasoning_effort = "medium"
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
approvals_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

如果后台没有 `gpt-5.5`，把 `model` 改成 Passion8 模型广场里实际支持 Codex / Responses API 的模型。Key 不写在 `config.toml`，而是放到 `~/.codex/auth.json` 的 `OPENAI_API_KEY`。

测试

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

如果提示未认证、模型不存在或 `/v1/responses` 不存在，先看本文最后的排错表。

可选：免确认启动

codex --dangerously-bypass-approvals-and-sandbox

确认当前项目目录可信、也能接受 Codex 直接改文件和执行命令时，再使用这个启动方式。本次会话后续通常不需要逐次手动确认；不要在陌生仓库、生产目录或有敏感文件的目录里使用。

Desktop App

Codex 桌面 App 入门

Codex 桌面 App 适合管理多个 agent、查看改动 diff、在项目之间切换。使用 Passion8 时，按应用提示填入自己的 API Key 和兼容地址。

下载安装

前往 OpenAI 官方入口下载 Codex App，当前官方说明已支持 macOS 和 Windows。

下载 Codex App

输入自己的 Key

打开 App 后选择 API Key / 自定义 Provider 登录方式，Key 填 Passion8 令牌，Base URL 填 `https://passion8.cc/v1`。

创建项目

新建 Project，选择本地文件夹。建议每个项目单独一个目录，避免 agent 修改不相关文件。

第一次使用建议

Inspect this folder and tell me what you see.
Then suggest one small task you can complete safely.
Wait for my approval before making changes.

入门时优先使用默认权限。Full permissions 适合你明确知道它会运行什么命令、访问什么文件时再开启。

Step 3

用 CC-Switch 管理配置

CC-Switch 适合同时维护 Claude Code、Codex、Gemini 等多套 Provider。只使用 Codex 的用户可以跳过。

下载安装

从 CC-Switch Releases 下载当前系统对应安装包。

打开 Releases

添加供应商配置

在顶部切换到 GPT / Codex 图标后，点击右上角加号，进入“添加新供应商”页面填写 Passion8 配置。

CC-Switch 添加 Passion8 Codex 供应商界面

添加 Passion8 Codex

新增 Codex / OpenAI 兼容 Provider，Base URL 填 `https://passion8.cc/v1`，Key 填 Passion8 令牌。

供应商名称 Passion8 Codex
模型 gpt-5.5
API Base URL https://passion8.cc/v1
API Key sk-••••••••••••••
保存配置

推荐 Provider 参数

名称
Passion8 Codex
Base URL
https://passion8.cc/v1
API Key
sk-...
模型
选择 Passion8 后台实际可用的 Codex 模型

Troubleshooting

常见问题

现象 优先检查 处理方式
401 / unauthorized `auth.json`、Key 是否复制完整 确认 `~/.codex/auth.json` 里存在 `OPENAI_API_KEY`，并重新打开 Codex。
model not found Codex 配置中的模型名 改成 Passion8 后台模型广场里实际存在的模型 ID。
404 /v1/responses New API 与上游通道是否支持 Responses API 切换到支持 Codex 的通道，或先升级 New API / 通道配置。
CC-Switch 切换后不生效 目标工具是否已重启 保存 Provider 后重启 Codex 或打开一个新的终端窗口。

References

官方参考

OpenAI Codex CLI Codex Config Reference CC-Switch Releases Node.js