# Codex 桌面 App

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

URL: https://docs.passion8.cc/docs/codex/app
Language: zh-CN
Publisher: Passion8

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




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




## 下载安装







### 下载

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

[下载 Codex App](https://chatgpt.com/codex/download)






### 填入自定义 Provider

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

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






### 创建项目

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






## 第一次使用建议

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

```text
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` 对应,概念详见 [高阶玩法 → 审批与沙箱](https://docs.passion8.cc/docs/codex/tips#审批与沙箱)。

## 桌面端的几个玩法

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



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






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




## 接着看



- [CLI 配置](https://docs.passion8.cc/docs/codex/config): 命令行版的完整接入:认证文件与 config.toml。
- [高阶玩法](https://docs.passion8.cc/docs/codex/tips): Profile、MCP、exec 与审批沙箱进阶。