搭场子：装 Xcode、注册账号、写一份 CLAUDE.md

Xcode 是从 Mac App Store 装的，安装包十几个 G，下载完往本地一撒占 30 G 出头。这步 AI 没办法替你——它不能登你的 Apple ID 也不能替你点同意。点完然后等就行，我那次下了 50 分钟。

装完之后第一次打开 Xcode，它会再往里装一组叫 Command Line Tools 的东西。这个不能跳——后面 Claude Code 用的 xcodebuild、xcrun simctl 全是它提供的命令，没装好后面什么都跑不起来。让它在后台装着，可以先去做下一件事。

下一件事是 Apple Developer 账号。免费和付费两种。免费的用日常 Apple ID 就行，能让你在自己电脑的模拟器上跑 app，也能签名装到自己真机上（每七天要重签一次，体验差点意思但够用）。99 美元的付费身份才能上 TestFlight 和 App Store。这个系列绝大部分章节都不需要付费，到第 12 篇上架那一篇再考虑掏钱也来得及。所以现在 Apple ID 在你这台 Mac 上登过就行了，别的没什么要做的。

Claude Code 的安装我在 claude-code 系列的 04 篇 里写过，重复啰嗦没意义。后面跟它打交道的方式都一样：终端里 cd 进项目目录，敲 claude，开始对话。

这一篇真正想讲的是 CLAUDE.md。

它的作用上一个系列里讲过——是写给未来每次会话的项目说明书，每次启动它都自动读一遍。在 iOS 项目上稍微特殊一点的是工具链：项目结构是个叫 .xcodeproj 的目录包、编译用 xcodebuild、跑模拟器用 xcrun simctl。这些 Claude 都知道，但它在你这个项目上的具体选择需要你写明——最低支持 iOS 哪个版本、用 SwiftUI 还是 UIKit、模拟器跑哪台机型、.xcodeproj 是手写还是用工具生成。

我在项目目录里建的第一份 CLAUDE.md 大致是这样：

# CLAUDE.md

## Project
"实图小记"：iOS 16+ 的图片识别 app，用 SwiftUI。
最低部署目标 iOS 16，目标设备 iPhone（不支持 iPad）。

## Project structure
- 用 xcodegen 管理 .xcodeproj，project.yml 是真相
- 改完 project.yml 跑 `xcodegen generate`
- Swift 源代码在 RealAlbum/，按 Views / Models / Services 分目录

## Build & run
- 编译：`xcodebuild -scheme RealAlbum -destination 'platform=iOS Simulator,name=iPhone 15'`
- 启模拟器:`xcrun simctl boot 'iPhone 15' && open -a Simulator`
- 装应用:`xcrun simctl install booted <path>.app`

## 已知约束
- 只用免费 Apple ID 调试，不要碰需要付费证书的功能
- API Key 不要写进代码，留个 TODO 等到后面接 Keychain

里面有几个隐含决定。最低 iOS 16 是为了让 SwiftUI 的一些新 API 能用而又不会把太多老机型挡在外面。xcodegen 这个工具是 iOS 社区维护 .xcodeproj 的常用方案——一个 yaml 当真相，比 .xcodeproj 那种二进制包好读太多，也好让 AI 自己改。模拟器选 iPhone 15 没什么讲究，能跑就行，后面真要适配多机型再加。

这一份是初始版本，跑起来之后会发现哪里需要补哪里需要删——CLAUDE.md 是边用边长出来的，不是一次性写到位的。

下一篇让 Claude Code 接管这个项目，从一句话需求开始建出 SwiftUI 骨架，跑到模拟器里出现一个白底页面这一步。

参考资料

• xcodegen — 维护 .xcodeproj 的 yaml 工具
• Apple Developer：Free vs Paid