Passion8Docs
Codex

桌面 App

Codex 桌面 App 接入 Passion8 — 下载安装、填入自定义 Provider、创建项目、审批与权限、多 agent 与 diff 复查玩法。

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

桌面 App 的 Base URL 同样带 /v1:https://passion8.cc/v1。Key 是你在 控制台 创建的 Passion8 令牌。

#下载安装

1

下载

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

下载 Codex App

2

填入自定义 Provider

打开 App 后选择 API Key / 自定义 Provider 登录方式,而不是 ChatGPT 账号登录:

  • API Key:填 Passion8 令牌
  • Base URL:填 https://passion8.cc/v1(带 /v1)
  • 模型:选 模型广场 里实际支持 Codex / Responses 的模型 ID
3

创建项目

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

#第一次使用建议

入门时先用一个安全的开场 prompt,让它先了解项目、再提议小任务:

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 适合你明确知道它会运行什么命令、访问什么文件时再开启。

#审批与权限

桌面 App 的安全模型和 CLI 一致,由「审批策略 + 沙箱」共同决定。App 里通常以开关 / 下拉呈现:

模式适合场景
只读 / 每步确认陌生项目、第一次跑,稳妥起步
工作区可写个人项目,在项目目录内自由读写,出界才问
完全放开仅限可信 + 有 git 兜底的目录,谨慎使用

切换逻辑与 CLI 的 approval_policy / sandbox_mode 对应,概念详见 高阶玩法 → 审批与沙箱。

#桌面端的几个玩法

App 相比 CLI 的优势在于「看得见」,下面几个是真正提效的地方:

多 agent 并行同一个项目可以开多个 agent 同时跑不同任务,在侧栏间切换,互不干扰上下文。
diff 可视复查改动以 diff 形式呈现,逐文件确认后再应用,比终端里翻 git diff 直观。
项目间切换多个 Project 之间一键切换,各自独立的目录与会话历史。
会话存档图形界面保留每次会话与改动记录,方便回看与回滚。

桌面 App 与 CLI 共用同一套 ~/.codex 配置(auth.json / config.toml)。在 CLI 里配好的 Provider、Profile,App 通常也能识别。两边可以混用。

#接着看

CLI 配置命令行版的完整接入:认证文件与 config.toml。高阶玩法Profile、MCP、exec 与审批沙箱进阶。
上一页配置参考下一页IDE 扩展

Support / 支持

Need help? / 需要帮助？

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

Support Emailsupport@passion8.ccService Statusstatus.passion8.cc

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