主题
桌面 App
Codex 桌面 App 适合管理多个 agent、查看改动 diff、在项目之间切换。使用 Gushen888 时,按应用提示填入自己的 API Key 和兼容地址即可。
桌面 App 的 Base URL 同样带 /v1:https://api.gushen888.cloud/v1。Key 是你在 控制台 创建的 Gushen888 令牌。
下载安装
下载
前往 OpenAI 官方入口下载 Codex App,当前已支持 macOS 和 Windows。
填入自定义 Provider
打开 App 后选择 API Key / 自定义 Provider 登录方式,而不是 ChatGPT 账号登录:
- API Key:填 Gushen888 令牌
- Base URL:填
https://api.gushen888.cloud/v1(带/v1) - 模型:选 模型广场 里实际支持 Codex / Responses 的模型 ID
创建项目
新建 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 通常也能识别。两边可以混用。