Claude Code 已能在 Windows 终端里改 Swift / UIKit 工程、跑单元测试脚本、整理 Git 提交说明。但要把应用编成能上架的 ipa,xcodebuild、钥匙串签名和 iOS 模拟器只能在装了 Xcode 的 Mac 上跑。下面按「谁改代码、谁出包」写清交接步骤,避免在 Windows 上误以为已经能 Archive。
三步落在哪台机器,见没有 Mac 怎么做 iOS 开发。16GB 够不够打 Release 包,用三天试用在同一套流程里验证。
Claude Code 在 Windows 上能做什么
在 Windows 上,Claude Code 适合承担「日常脑力工位」:读仓库、改 Swift / Objective-C、维护 Podfile 与 SPM 清单、写 Fastlane 脚本草稿、跑不涉及 iOS SDK 的检查(例如 swift-format 若只针对可移植模块)。这和在 VS Code 里写代码一样——源码是文本,不绑定 macOS。
Claude Code 也可以帮你在本机生成 xcodebuild 命令,但那些在 Windows 上不能真正执行 iOS 目标。若 agent 提示「编译成功」,要先确认它是不是只跑了语法检查或 Linux 版 Swift,而不是 iOS destination。
不能留在 Windows 上的三步
| 步骤 | 必须在 Mac | 在 Windows 用 Claude Code 的误区 |
|---|---|---|
| 拉取 iOS SDK 并链接 | xcodebuild + iOS destination | 误用 Linux Swift 以为能过编译 |
codesign / Archive | 钥匙串私钥在 Mac | 以为导出 p12 到 Windows 就能签 |
| iOS 模拟器 | macOS 上的 Simulator 进程 | 以为安卓模拟器能代替 |
Windows 上的 Claude Code 负责改工程和提交;要出 ipa,总是把同一套 Git commit 交到 Mac 上再 Archive。
把工程交到 Mac:Git 与 rsync
推荐 Git:Windows 上 git push 到远端,Mac 上 git pull 后在干净的 working tree 里编译。Claude Code 适合在 push 前整理 commit message、检查是否误提交了 xcuserdata。
rsync / scp:不走红网的单机或小团队可以用 rsync -avz --delete 同步仓库目录。务必排除 DerivedData、.build、Pods(若 Mac 上重新 pod install)。
- 锁文件要进版本库:
Podfile.lock、Package.resolved。 - 签名用的
*.mobileprovision通常不进 Git;装在 Mac 的固定路径或 CI 密钥库里。 - 路径大小写:Windows 不敏感,Mac 敏感;Claude Code 改文件名时注意和 Xcode target 一致。
SSH 触发编译与 Archive
Mac 打开「远程登录」后,Windows 终端可以 ssh user@mac-host 进入打包机。日常流水线可以是:
cd ~/ios-app && git pull --ff-only xcodebuild archive \ -scheme YourApp \ -configuration Release \ -destination 'generic/platform=iOS' \ -archivePath build/YourApp.xcarchive
Claude Code 在 Windows 侧可以维护这份脚本、根据 scheme 名改参数,但真正执行要在 SSH 会话里。Archive 成功后,导出 ipa 或上传商店仍在 Mac 上用 Xcode Organizer 或 xcodebuild -exportArchive。
连接与权限说明见帮助中心里的 SSH 与 VNC 章节。
签名与钥匙串只在那台 Mac
Apple 要求用持有私钥的 Mac 做 codesign。常见做法是:
- 在 Apple Developer 生成 Distribution 证书,在打包专用 Mac 上创建 CSR 并安装私钥。
- 用自动签名或 Fastlane
match,但生产私钥仍只出现在用来 Archive 的机器。 - Windows 上不保存生产 p12;Claude Code 也不要把私钥写进对话日志。
编译和签名必须在同一台 Mac上完成——私钥不在那台机器上,Archive 会在导出阶段失败。详见没有 Mac 怎么做 iOS 开发里的签名一节。
一天里典型的往返节奏
| 时段 | Windows + Claude Code | Mac |
|---|---|---|
| 上午 | 改 UI、修 bug、本地 git commit | 空闲或别人在用 |
| 午休前 | git push | git pull,跑单元测试 |
| 下午 | 继续改下一版 | Release Archive,上传 TestFlight |
| 需要看 UI | 读日志、看截图 | 开模拟器;远程可看 VNC(另文) |
若一天里 Archive 超过一次,先确认 16GB 内存是否在模拟器开着时拖慢编译——用三天试用在同一工程上记录耗时。
证书不要和别人混在同一桌面
若打包 Mac 是多人共用的远程桌面,别人的描述文件和登录项会留在同一用户里。Claude Code 在 Windows 上改的是你的源码,但签名用的是 Mac 上当时登录帐号钥匙串里的证书。独立开发者应使用只有自己证书的机器;共享环境要拆用户或拆实例,避免「Archive 成功但签成了别人的 team」。
试完以后链到哪里
先用 16GB 按天跑通:Windows 上 push → Mac 上 pull → SSH Archive → 签名通过。流程理顺后再决定是否月付或买机。
打开定价页,选 16GB,按天。支付后进工单。
依据
- Xcode 与 iOS SDK:developer.apple.com/xcode
- 证书与签名:Certificates overview
- 发布与 Archive:Distributing your app
- 在模拟器或真机运行:Running your app in Simulator or on a device
常见问题
Claude Code 能在 Windows 上直接 Archive iOS 吗?
不能。Claude Code 可以读写工程和跑脚本,但 iOS SDK、模拟器和 codesign 只随 Xcode 出现在 macOS。Archive 必须在 Mac 上执行。
私钥能不能留在 Windows,只在 Mac 上编译?
不行。签名读的是 Mac 钥匙串里的私钥。常见做法是把 Distribution 证书和私钥装进用来打包的那台 Mac,Windows 机器上不存生产私钥。
用 Git 交代码时,DerivedData 要不要一起同步?
不要。只同步源码和锁文件(Podfile.lock、Package.resolved)。Mac 上本地生成 DerivedData,避免把 Windows 路径写进缓存。
团队多人用同一台打包 Mac,Claude Code 改完的工程会不会串证书?
会,如果共用同一用户目录且描述文件混在一起。独立开发者应使用只有自己证书的 Mac;小团队按人或按仓库拆分登录或拆机器。