服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务，不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动，严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外，不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- xcode-build 是 Gary Riches 的第三方早期工具，当前清单版本为 0.1.0；先做一次可控构建再决定长期使用。
- 模型摘要最多列出 50 条错误或失败测试；遇到剩余数量提示，应继续核对原始诊断。
- 诊断来自结果包还是日志，决定了还能找回哪些信息；Swift 依赖日志，已被截断的错误仍可能遗漏。
先确认环境，再决定是否试用
这篇指南针对 Mac 上的 Swift 开发者。项目清单将工具命名为 xcode-build，作者为 Gary Riches，版本 0.1.0，采用 MIT 许可。它是第三方项目，不能把插件出现当成 Anthropic 对编译结果的保证。
作者要求 macOS、Xcode 及 xcodebuild、xcrun；测试组合为 Claude Code 2.1.288 和 Xcode 27.1，这两个数字不是宣称的最低兼容版本。本文依据文档与源码核验，未在 Mac 上运行验证。
Claude 官方规定 Mods 需要 2.1.287 或更新版本。终端和 Desktop Code 可绘制界面，VS Code 聊天面板不显示 Mod 界面。首次确认建议用交互终端，并记录 claude --version；不要把换模型当成解决加载问题的方法。
先只加载一个会话，保留原来的工作方式
阅读作者仓库后，在终端克隆到固定目录：git clone https://github.com/griches/claude-xcode-mod.git ~/.claude/mods/claude-xcode-mod
加载前可运行 claude plugin validate ~/.claude/mods/claude-xcode-mod。官方说明这是静态检查，可列出 hooks 与 calls；它不等于已经在你的工程中构建成功。Mod 会以你的权限运行，应先确认这些行为符合项目要求。
在项目目录运行 claude --plugin-dir ~/.claude/mods/claude-xcode-mod，进入后输入 /xcode-build。面板打开只是加载检查，尚未验证项目构建。
第一次只构建，不把诊断与改代码混在一起
可以明确要求：“运行这个项目原有的构建命令，只报告结果，暂不修改源码。”先提供团队正在使用的 scheme、目标设备和配置，避免模型临时猜出另一套构建条件。留下一份未启用插件时的命令与结果，之后才能比较同一问题。
适用的单次 xcodebuild 会补入 -resultBundlePath，以结果包取回诊断；读取失败回退日志。先看摘要的来源说明。Swift 没有同样的结果包保障，被截断的日志错误仍可能丢失。
假设报错指向某个文件第 42 行，建议先打开该位置，核对文件是否属于当前目标，再决定要改类型、依赖还是构建设置。若摘要只剩失败结论，回到原始命令的输出找第一条具体错误；不要反复让模型根据 BUILD FAILED 猜修复。
短摘要有数量上限，先看来源再看结论
format.ts 把模型摘要中的错误、失败测试各限制为前 50 条，并提示还有多少未列出。它还会标记来源是 Xcode 结果包还是构建日志；检测到日志截断时附带缺失提示，有完整日志路径时会附上路径。
因此，看到 50 条或剩余数量提示时，建议先按共同原因归组，例如同一依赖缺失引起多个文件报错。先处理有证据支持的根因，再重新构建比较剩余项，而不是把摘要当成完整缺陷清单。
register.tsx 仅在信息可用、调用未中断且摘要更短时替换模型收到的内容；失败却无诊断时保留原输出。没有变短，也可能是不满足摘要条件。后台调用会跳过。
没反应时，按命令、调用路径和输出分别查
找不到 /xcode-build 时，先在 /plugin 查看活动 Mod 名单，并检查启动命令里的目录。若出现组织限制，按组织配置处理；不要为了显示面板去关闭全部 hooks。其他插件能运行，也不能证明这个目录已经加载。
命令能打开、构建却未出现时，检查实际调用。shell.ts 只分析可识别的直接构建命令，不会进入 make、fastlane 或脚本内部寻找构建；包含 here-document 的整条命令会被跳过。请先确认调用方式，而不是删掉工程的构建封装来迁就插件。
已经有结果但缺错误时，先记录来源、命令和未列出的数量。可以用同一配置在普通终端复核，并保存完整输出。只有编译器实际给出的诊断才能支持下一步修改；面板颜色、提示条或字数变化不能替代成功构建与项目测试。
关闭摘要、保留结果包，或结束试用
插件配置中的 condense=false 停止改写模型读取的摘要；resultBundle=false 停止补入结果包参数，compactRow=false 则关闭紧凑结果行。三项控制不同部分，排查时建议一次只改一项，并记下修改前的值。
源码会清理自己创建的临时结果包，用户指定的包会保留；已有路径不会被当成这次新结果读取。需要留证据时，建议每次使用不同路径，并检查文件是否实际生成。
仅用 --plugin-dir 试载时，结束会话，下次不带该参数启动即可。若以后加入了 CLAUDE_CODE_PLUGIN_DIRS，停用时删除其中本插件的目录并重新启动，保留其他目录。确认不再加载后，再决定是否移除克隆；工程源码和构建记录不属于卸载对象。
资料来源
常见问题
xcode-build 能替我修复所有编译错误吗？
不能。建议先让它整理一次构建结果，再根据具体诊断决定修改；修改后仍需重新构建并运行项目测试。不要把摘要变短当作问题已经解决。
出现编译错误后，要先清缓存或重装工具吗？
先保存完整命令、构建配置和第一条具体诊断，再与摘要对照。若直接运行原命令也失败，优先调查该错误；一次改很多环境设置，会让后续难以判断究竟是哪一步起作用。