This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

使用 Claude Code、Codex 和 Cursor 等 AI 编码代理构建并发布 Expo 和 React Native 应用。

Claude Code、Codex、Cursor 和其他 AI 编码代理可以帮助你构建、升级、调试和部署你的 Expo 和 React Native 项目。当你使用 create-expo-app 创建一个新项目时，该新项目已经配置好了 AI 代理所需的配置文件。这个设置也会提交到你的项目中，因此你团队中的每个人都从相同的 SDK 版本和项目说明开始，并且他们的代理会读取相同的项目上下文。

Expo 如何支持 AI 代理

有三个部分协同工作，为 AI 代理提供一致的、特定于 Expo 的上下文：

• Expo Skills： 一个插件，会向代理添加 Expo 特定的说明和斜杠命令。代理会应用已知可靠的 Expo 模式（SDK 升级、EAS 工作流、使用 Jetpack Compose 和 SwiftUI 的原生 UI、API 路由），而不是根据训练数据去猜测。Skills 每台机器只需安装一次。
• Expo MCP Server： 一个远程的 Model Context Protocol（MCP）服务器，为代理提供对最新 Expo 文档、EAS Build 历史记录、EAS Update 频道以及 TestFlight 元数据的实时访问。代理可以通过它安装与 SDK 匹配的包、读取构建日志，并获取模拟器截图。
• 项目上下文文件： create-expo-app 会在项目根目录写入 AGENTS.md、CLAUDE.md 和 .claude/settings.json。当你打开项目时，代理首先读取的就是这些文件。它们会将代理指向与你项目目标 Expo SDK 版本相对应的文档。

设置 Expo Skills 和 Expo MCP Server

Expo Skills 和 Expo MCP Server 可与每个受支持的代理配合使用。请按照下面的指南分别进行设置：

选择一个代理

每个代理指南都涵盖了该代理的安装、设置和示例提示：

代理的项目上下文文件

每个代理都会在不同的位置查找项目上下文。与其强制使用单一约定，不如在你使用 CLI 创建新的 Expo 项目时，create-expo-app CLI 会将以下配置文件添加到项目根目录中：

每个文件都面向不同的代理约定，因此同一个项目无需针对每个代理单独配置，就能同时适用于 Claude Code、Codex 或 Cursor。

验证设置

为确认代理可以读取你的项目，请在你的 Expo 项目中为 AI 代理打开一个会话，并运行以下提示：

打开 package.json，并告诉我这个项目目标使用的是哪个 Expo SDK 版本。

如果代理从 package.json 中回复了 SDK 版本，则说明代理正在正确读取你的项目。

代理工具包

在 选择代理 中提到的代理会读取你的代码和文档等内容。若要让代理在运行时也能对你的 Expo 项目进行操作，可以将其与第三方工具包配对。然后，代理工具包就可以点击完成各种流程、读取日志、检查 React 组件树，并分析性能。