用途：Airship（@airshiplabs/cli）是纯 CLI 的可视化编辑器，作为反向代理置于已运行的开发服务器（Vite、Next、Remix、Rails 或任何提供 HTML 的服务）之前，在无限画布上渲染实时设备框架。选中元素并描述改动后，会把文件/行号加提示交给 Claude Code、Codex 或 OpenCode，由后者编辑真实源文件。它不向项目依赖、配置或打包产物添加任何内容，每次编辑都可撤销。
主要能力：支持 canvas（默认，多设备框架可平移画布）与 inline（在运行页面上叠加编辑器）两种模式，可在底部栏运行时切换，或用 ?__airship=inline / ?__airship=shell 按 URL 切换。可选择 claude（默认）、codex、opencode 三种编码代理，它们在费用显示、--effort/--max-turns 支持及撤销上不同；codex/opencode 的撤销需要项目是 git 仓库。--safe 仅在 --agent codex 时是真正的操作系统级沙箱，claude/opencode 只做预检命令/编辑检查。
使用方式：先启动开发服务器，再指向它：pnpm dev 后运行 npx @airshiplabs/cli --target 3000；也可全局安装 npm i -g @airshiplabs/cli 后使用 airship --target 3000。可让 Airship 自行启停开发服务器：airship --exec "pnpm dev"（省略 --target 时从 package.json 读取端口）。无参数运行会交互式询问端口、代理和模式，需要终端。用 airship init 生成 airship.config.json（或 package.json 中的 airship 键）持久化设置，解析顺序为 CLI 标志 → AIRSHIP_* 环境变量 → airship.config.json → 默认值。用 airship doctor --agent claude 检查环境，失败时退出码为 1。
适用场景：针对本地开发服务器启动可视化编辑器、比较编码代理做点击式 UI 修改、用 --safe 沙箱化编辑、生成持久配置、诊断安装/认证/开发服务器问题、在 canvas 与 inline 模式间选择。
限制：不适合想要脱离真实源码的独立设计工具（Airship 始终写入实际代码库）；无视觉选择步骤的无头/CI 代码编辑应直接驱动代理；浏览器自动化或端到端测试应使用浏览器/测试工具，Airship 是编辑工具而非测试运行器。monorepo 中应显式设置 --cwd 以匹配开发服务器根目录。脚本化场景建议用 --json。更多 CLI 标志、退出码、代理对比与安全矩阵见 references/commands.md。