跳转至正文
Codex logo

通过 Codex 与 Capgo 快速交付您的移动应用

Codex 负责构建、发布并为您的 Capacitor 应用提供 Live Update：无需 Mac 即可构建 iOS 和 Android 版本，数分钟内完成 OTA 修复，支持一键回滚。

  • CLI Agent
  • 托管 MCP
  • 本地 MCP
  • 技能
  • CLI

在 Codex 中配置 Capgo

只需三步。直接复制每个代码块即可。

  1. 第 1 步

    添加托管的 Capgo MCP

    添加服务器并登录。Codex 会在浏览器中打开 Capgo 授权页面。无需 API 密钥。

    终端
    $ codex mcp add capgo --url https://api.capgo.app/mcp $ codex mcp login capgo

  2. 第 2 步

    添加用于构建和上传的本地 CLI MCP

    使用 Capgo API 密钥登录一次，然后注册本地服务器。Codex 会将两者都存储在 ~/.codex/config.toml 中。

    终端
    $ npx @capgo/cli@latest login $ codex mcp add capgo-cli -- npx @capgo/cli@latest mcp

  3. 第 3 步

    安装 Capgo skills

    Codex 从 .agents/skills 加载技能。安装程序会自动为你配置好。

    终端
    $ npx skills add Cap-go/capgo-skills

你可以向 Codex 提问的内容

复制 Prompt 并粘贴到 Codex 中。记得将 App ID 和版本号替换为你自己的。

  • 构建

    “使用 Capgo Build 为此应用构建一个已签名的 iOS release 版本。”

  • 发布

    “请求一个 Android release 构建，并发送到 Google Play 内部测试轨道。”

  • 更新

    “检查这个改动是否需要 Native Build，还是可以直接作为 live update 发布。”

  • 更新

    “构建 Web 应用，并将这个修复推送到 production 渠道。”

  • 回滚

    “回滚 production channel 上的最后一个 bundle。”

  • Observe

    “显示 v2.3.0 的更新统计数据：有多少设备已安装，有多少安装失败。”

  • Observe

    “为什么我上次的 iOS build 失败了？请阅读 build logs 并提供修复建议。”

  • 更新

    “把这个 build 上传到新的 beta 渠道，并给我一个 QR code 来测试。”

完整的发布闭环

一个账号就能覆盖从首次 build 到下一次线上修复的每一步。

  1. 1

    构建

    在云端完成 iOS 和 Android 的签名 build。你这边无需 Mac，也无需 Xcode。

    Capgo Build（原生应用）
  2. 2

    发布

    将 build 发送到 TestFlight 和 Google Play，或提交给应用商店审核。

    无需 Mac 即可构建并发布 iOS 应用
  3. 3

    更新

    几分钟内即可将 JavaScript、HTML 和 CSS 修复推送至 channel。支持一键回滚。

    Capgo 实时更新
  4. 4

    Observe

    查看更新覆盖情况、失败原因以及每次发布的性能表现。

    Capgo Observe

Codex 说明与限制

  • Codex 可在你的终端运行命令，因此它也可以使用 Capgo CLI 进行 build、upload 和 roll back。
  • 更喜欢编辑配置？将 [mcp_servers.capgo] url = "https://api.capgo.app/mcp" 添加到 ~/.codex/config.toml，然后运行 codex mcp login capgo。
  • 请勿跳过 codex mcp login：否则 Codex 会在未登录状态下连接，导致 Capgo 工具无法访问你的账号。
  • 相同的配置同样适用于 Codex IDE extension 和 Codex app。

常见问题

Capgo 与 Codex：常见问题

Codex 能在没有 Mac 的情况下构建我的 iOS 应用吗？

可以。Codex 会运行 Capgo CLI，将您的项目 upload 到 Capgo Build。Capgo 会在云端进行 iOS 和 Android 应用的签名与构建，并能将其发送至 TestFlight 和 Google Play。

Native Build 文档

使用 Codex 需要 Capgo API 密钥吗？

托管版 MCP 不需要 API 密钥：它通过 OAuth 登录。本地 CLI MCP 和 CLI 使用您通过 npx @capgo/cli@latest login 保存一次的 API 密钥。请在 Capgo 控制台的 Settings > Organization > API keys 下创建密钥。

创建 Capgo API 密钥

Codex 可以回滚错误的更新吗？

可以。只需让 Codex 将 channel 指向之前的 bundle 即可。设备会在下次检查更新时自动切换。此外，当新 bundle 启动失败时，Capgo updater 也会自动执行回滚。

Live update 文档

App Store 和 Google Play 允许使用 Live Updates 吗？

可以，但仅限 Web 层：JavaScript、HTML、CSS 和静态资源。Native code、新权限和新插件仍需通过应用商店发布，Capgo Build 可以帮你完成。

使用 Codex 中的 Capgo 需要多少费用？

MCP servers、skills 和 CLI 均可免费使用。你需要 Capgo 方案，每个方案都提供 14 天免费试用，无需信用卡。Build、Live Updates 和 Observe 都包含在每个方案中。

定价

通过 Codex 发布您的下一个版本

立即创建 Capgo 账号，连接 Codex，并推送您的首次 build 或 live update。

文档

相关页面