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 和 Expo
编辑页面
使用 Claude Code 构建、升级、调试和部署你的 Expo 和 React Native 项目。
Claude Code 是 Anthropic 的基于终端的 AI 编程代理。它可以理解你的整个代码库，提出修改建议，运行终端命令，并管理 git 操作。使用 create-expo-app 创建的 Expo 项目会通过 CLAUDE.md 和 .claude/settings.json 为 Claude Code 搭建脚手架。它还可以检查 EAS 和 Expo CLI 日志，从 Expo Model Context Protocol (MCP) 服务器获取文档，使用 Expo Skills 了解最佳实践，管理你的 EAS 部署工作流，等等。
快速开始
1
安装 Claude Code
全局安装 Claude Code，然后从任意项目中启动它。其他安装方法请参阅 Claude Code 文档。
- curl -fsSL https://claude.ai/install.sh | bash2
3
设置 Expo Skills 和 Expo MCP Server
安装 Expo Skills 并连接 Expo MCP Server，这样 Claude Code 就能了解 Expo 约定并访问你的 EAS。
安装这个插件，让 agent 学习已知良好的 Expo 模式，并浏览可用技能的完整列表。
连接远程 Expo MCP Server，让 agent 可以实时访问 Expo 文档和 EAS。
5
Claude Code 如何读取你的 Expo 项目
当你在项目中启动 Claude Code 时，它会读取两个脚手架生成的文件：
- CLAUDE.md 包含一行：
@AGENTS.md。这一行会将 AGENTS.md 导入到 Claude Code 的上下文中。AGENTS.md 会将 Claude Code 指向与你项目的 Expo SDK 版本对应的文档。请将项目级说明添加到 AGENTS.md，而不是 CLAUDE.md，这样它们就能保留在同一个地方。 - .claude/settings.json 会从 Claude Code 插件市场启用官方 Expo 插件（
expo@claude-plugins-official）。
这两个文件都会提交到你的项目中，因此开发者的 Claude Code 会话会从相同的上下文开始。
示例提示词
完成设置后，用通俗语言描述 Expo 任务。例如：
| 任务 | 示例提示词 |
|---|---|
| 升级 SDK | 将此项目升级到最新的 Expo SDK，并修复所有破坏性变更。 |
| 添加导航 | 使用 Expo Router 添加一个选项卡导航器和一个新的设置屏幕。 |
| 自动化构建 | 创建一个 EAS Workflow，在每次拉取请求时构建应用。 |
| 调试构建 | 我最新的 iOS 构建失败了。读取 EAS Build 日志并告诉我出了什么问题。 |
| 添加通知 | 配置 expo-notifications，并在应用启动时显示本地通知。 |
| 设置 CI/CD | 创建一个在每次 PR 时构建的 CI/CD 工作流。 |
| 添加原生 UI | 向我的 Expo 应用添加一个 SwiftUI 选择器组件。 |
| 查看反馈 | 显示我的应用的 TestFlight 反馈。 |
| 验证 UI | 截取屏幕截图并验证蓝色圆形视图。 |
更多示例，请参阅 Expo Skills 和 Expo MCP Server 的示例提示词部分。
故障排除
项目设置中已启用插件 'expo'，但此处未安装。
如果你在 Claude Code 会话中看到此错误，那么你需要在开发机器上安装官方 Expo 插件。要安装它，请在终端窗口中运行以下命令，然后重新启动你的 Claude Code 会话：
- claude plugin install expo@claude-plugins-official上述命令会全局安装 Expo 插件。如果你只想为当前项目安装它，请在命令中添加 --scope project：
- claude plugin install expo@claude-plugins-official --scope project