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 版本和项目说明开始，并且他们的代理会读取相同的项目上下文。

快速开始

Claude Code 和 Codex 有官方 Expo 插件。一条命令即可安装 Expo Skills 并注册 Expo Model Context Protocol（MCP）Server。

Cursor 和其他代理没有官方 Expo 插件。要配置它们，请分别安装 Expo Skills 和 Expo MCP Server。

Expo 如何支持 AI 代理

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

• Expo Skills： expo 插件会向代理添加 Expo 专属说明和斜杠命令。代理会应用经过验证的 Expo 模式（SDK 升级、EAS Workflows、使用 Jetpack Compose 和 SwiftUI 构建原生 UI、API 路由），而不是根据训练数据进行猜测。Skills 在每台机器上只需安装一次。
• Expo MCP Server： 一个远程 Model Context Protocol（MCP）服务器，为代理提供对最新 Expo 文档、EAS Build 历史记录、EAS Update 通道和 TestFlight 元数据的实时访问权限。代理可以通过它安装与 SDK 匹配的包、读取构建日志，以及截取模拟器屏幕截图。对于 Claude Code 和 Codex，expo 插件会注册此服务器，因此无需单独添加。
• 项目上下文文件： create-expo-app 会在项目根目录写入 AGENTS.md，指引代理查阅与你的项目目标 SDK 版本相匹配的 Expo 文档。安装 Claude Code 时，它还会写入 .claude/settings.json 以启用 Expo 插件。

设置 Expo Skills 和 Expo MCP Server

Expo Skills 和 Expo MCP Server 适用于所有受支持的代理。如果你已安装上文中的 expo 插件，则两者都已设置完毕。以下指南介绍所有安装选项，包括没有插件的代理：

选择一个代理

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

代理的项目上下文文件

create-expo-app CLI 会将 AGENTS.md 添加到新项目的根目录。安装 Claude Code 时，它还会添加 .claude/settings.json：

将共享的项目说明添加到 AGENTS.md，这样 Claude Code、Codex 和 Cursor 就会读取相同的上下文。

设置现有项目

create-expo-app 仅在创建新项目时写入项目上下文文件。对于现有项目，请自行在项目根目录添加相同的文件。

{
  "enabledPlugins": {
    "expo@claude-plugins-official": true
  }
}

提交这两个文件，使团队中的每个代理会话都从相同的项目上下文开始。Codex 和 Cursor 只需要 AGENTS.md，因此第 2 步仅适用于 Claude Code。

验证设置

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

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

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

代理工具包

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