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 项目包含 AGENTS.md,用于提供项目上下文。安装 Claude Code 后,这些项目还会包含 .claude/settings.json,以启用 Expo 插件。它还可以检查 EAS 和 Expo CLI 日志,从 Expo Model Context Protocol(MCP)Server 获取文档,使用 Expo Skills 获取最佳实践,管理 EAS 部署工作流等。
快速开始
1
3
安装 Expo 插件
安装官方 Expo 插件,让 Claude Code 了解 Expo 约定,并能够使用你的 EAS 项目。一条命令即可安装 Expo Skills 并注册 Expo MCP Server:
然后在 Claude Code 会话中运行 /mcp,登录你的 Expo 账号。
以下指南介绍了可用的 skills,以及 MCP Server 可以执行的其他操作:
浏览插件提供的完整 skills 列表,并查看其他 agents 的安装选项。
连接远程 Expo MCP Server,让 agent 可以实时访问 Expo 文档和 EAS。
5
Claude Code 如何读取你的 Expo 项目
当你在项目中启动 Claude Code 时,它会读取两个脚手架生成的文件:
- AGENTS.md 会指引 Claude Code 查阅与你的项目 Expo SDK 版本对应的文档。将项目级指令添加到此文件中,以便你的 agents 读取相同的上下文。
- .claude/settings.json 会从 Claude Code 插件市场启用官方 Expo 插件(
expo@claude-plugins-official)。
这两个文件都会提交到你的项目中,因此开发者的 Claude Code 会话会从相同的上下文开始。
直接读取 AGENTS.md 需要 Claude Code v2.1.277 或更高版本。有关加载规则和可用性,请参阅 Claude Code 文档。
示例提示词
完成设置后,用通俗语言描述 Expo 任务。例如:
更多示例,请参阅 Expo Skills 和 Expo MCP Server 的示例提示词部分。
故障排除
项目设置中已启用插件 'expo',但此处未安装。
如果你在 Claude Code 会话中看到此错误,那么你需要在开发机器上安装官方 Expo 插件。要安装它,请在终端窗口中运行以下命令,然后重新启动你的 Claude Code 会话:
上述命令会全局安装 Expo 插件。如果你只想为当前项目安装它,请在命令中添加 --scope project: