Passion8Docs
Codex

平台与集成

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

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

#入口选择

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

#本地三件套

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

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

它们可以复用:

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

Passion8 固定规则:

[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 @CodexCodex cloud、GitHub 环境、Slack app
Linearassign 给 Codex 或评论 mention @CodexCodex cloud、GitHub 环境、Linear connector

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

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

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

#GitHub 集成

GitHub 有三条路:

路径说明
本地 Git / ghCodex 在你机器上读写仓库,可走 Passion8
GitHub PR review@codex review 或自动 review,走官方云端
Codex GitHub ActionCI 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 差异快速判断某个能力能不能走 Passion8。Browser 与 Computer Use浏览器、Chrome、桌面控制和 Record & Replay。Review、GitHub 与 PR 工作流本地 review、GitHub review 和 CI review。

#官方参考

上一页功能可用性与 Provider 差异下一页Browser 与 Computer Use

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