# Codex 平台与集成

> Codex CLI、App、IDE、Web、Slack、Linear、GitHub、Sites、远程连接和 Passion8 Provider 的能力边界。

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

Codex 不是单一客户端,而是一组本地和云端入口。配置 Passion8 时最容易混淆的是:本地入口能读 `~/.codex`,云端入口通常走 OpenAI / ChatGPT 工作区的连接和权限。

## 入口选择

| 入口 | 运行位置 | 适合场景 | 是否继承本机 Passion8 |
| --- | --- | --- | --- |
| CLI | 本机终端 | 日常改代码、review、脚本化执行 | 是 |
| Desktop App Local | 本机 App | 多线程、Review pane、worktrees、浏览器/桌面能力 | 是 |
| IDE Extension | 本机编辑器 | 边看代码边对话、引用当前文件 | 是 |
| Codex Web / Cloud | OpenAI 云端 | 远程任务、GitHub 仓库、PR 生成 | 否 |
| Slack / Linear | OpenAI 云端任务 | 从协作工具派单 | 否 |
| GitHub PR review | GitHub + Codex cloud | 团队 PR 审查 | 否 |
| GitHub Action / CI | CI runner | 自动 review、迁移、release 检查 | 取决于 CI API Key |
| Remote connections | 连接的主机 | 手机或另一台设备控制本机/远程项目 | 看被连接主机配置 |
| Sites | OpenAI 托管 | 发布站点、Web app、游戏原型 | 否 |

## 本地三件套

本地三件套共享同一套 Codex 配置:

- CLI
- Desktop App 的 Local 线程
- IDE Extension

它们可以复用:

| 配置 | 文件 |
| --- | --- |
| Provider / model / sandbox | `~/.codex/config.toml` |
| API Key 或登录态 | `~/.codex/auth.json` |
| 项目规则 | `AGENTS.md` |
| MCP servers | `config.toml` 的 `[mcp_servers.*]` |
| Skills / Plugins | `$CODEX_HOME` 下的安装内容 |

Passion8 固定规则:

```toml
[model_providers.passion8]
name = "Passion8"
base_url = "https://passion8.cc/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
```

Claude Code 的 Base URL 不带 `/v1`,不要互相套用。

## Codex Web / Cloud

Codex Web 在 `https://chatgpt.com/codex` 里连接 GitHub 仓库,创建云端环境并执行任务。它适合:

| 场景 | 原因 |
| --- | --- |
| 从手机或网页派任务 | 不依赖本机终端开着 |
| 同时跑多个远程任务 | 云端环境隔离 |
| 生成 PR | 直接连接 GitHub |
| 团队协作 | 结合 workspace 权限、审计和 code review |

限制也要写清楚:

- 云端不会自动读取你本机 `~/.codex/config.toml`。
- 云端仓库需要 GitHub 连接和环境配置。
- 私有依赖、环境变量、secrets 要在 cloud environment 里单独配置。
- 接入 Passion8 的本地 Provider 不等于云端任务也走 Passion8。

## Slack 和 Linear

Slack / Linear 是云端派单入口:

| 工具 | 用法 | 前提 |
| --- | --- | --- |
| Slack | 在 channel 或 thread 里 mention `@Codex` | Codex cloud、GitHub 环境、Slack app |
| Linear | assign 给 Codex 或评论 mention `@Codex` | Codex cloud、GitHub 环境、Linear connector |

如果你只是想让本地 Codex 读取 Linear issue,优先用 MCP:

```bash
codex mcp add linear --url https://mcp.linear.app/mcp
codex mcp login linear
```

Slack 也是同理:能用本地 MCP / plugin 读取上下文时,就明确这是本地任务;需要 `@Codex` 派单时,就按云端任务处理。

## GitHub 集成

GitHub 有三条路:

| 路径 | 说明 |
| --- | --- |
| 本地 Git / gh | Codex 在你机器上读写仓库,可走 Passion8 |
| GitHub PR review | `@codex review` 或自动 review,走官方云端 |
| Codex GitHub Action | CI runner 调 `openai/codex-action`,取决于 secret 和 action 配置 |

实际项目建议:

1. 本地开发用 CLI / IDE / App。
2. PR 前跑 `/review`。
3. 团队 PR 用 GitHub review 或 CI review。
4. 自动修复只给受信任分支和受限权限。

## Remote connections

Remote connections 让你从手机、另一台 Codex App 设备或 SSH host 控制 Codex。关键点是:远程会使用被连接主机的项目、线程、文件、凭据、MCP、插件、浏览器和 Computer Use 设置。

适合:

- 从手机查看长任务进度。
- 对跑在办公室机器或远程开发机上的项目发后续指令。
- 让 Codex 在 SSH host 的文件系统和 shell 里工作。

安全边界:

- SSH host 按普通 SSH 安全治理,不要暴露无认证入口。
- 被控制主机的 sandbox、approval、Computer Use 和 browser 权限仍然生效。
- 远程控制不等于绕过本机审批。

## Sites

Sites 是 Codex 的托管发布能力,适合让 Codex 创建、保存、部署网站、Web app 或游戏原型。它不是你当前服务器的替代配置页。

使用前先判断:

| 问题 | 建议 |
| --- | --- |
| 只是本地预览 | 用本地 dev server 和 Browser |
| 需要公开或工作区内分享 | 再考虑 Sites |
| 需要数据库或文件存储 | 明确 D1 / R2 等持久化需求 |
| 含密钥 | 通过 Sites 面板配置 runtime secrets,不要提交到代码 |

每个 Sites deployment URL 都是生产部署。上线前必须确认访问范围、构建版本、环境变量和数据库迁移。

## 接着看



- [功能可用性与 Provider 差异](https://docs.passion8.cc/docs/codex/feature-availability): 快速判断某个能力能不能走 Passion8。
- [Browser 与 Computer Use](https://docs.passion8.cc/docs/codex/browser-computer-use): 浏览器、Chrome、桌面控制和 Record & Replay。
- [Review、GitHub 与 PR 工作流](https://docs.passion8.cc/docs/codex/review-github): 本地 review、GitHub review 和 CI review。



## 官方参考

- [Codex manual: Codex app](https://developers.openai.com/codex/codex-manual.md)
- [Codex manual: Codex CLI](https://developers.openai.com/codex/codex-manual.md)
- [Codex manual: Codex IDE extension](https://developers.openai.com/codex/codex-manual.md)
- [Codex manual: Codex web](https://developers.openai.com/codex/codex-manual.md)
- [Codex manual: Slack and Linear integrations](https://developers.openai.com/codex/codex-manual.md)
- [Codex manual: Remote connections](https://developers.openai.com/codex/codex-manual.md)
- [Codex manual: Sites](https://developers.openai.com/codex/codex-manual.md)