用途:在 macOS 上安装 AI 智能体编程命令行工具(Claude Code、Codex、Gemini、Copilot、Grok Build、Kimi Code 等),用用户已有订阅完成认证。不适用于安装之后的智能体使用与配置(提示词、CLAUDE.md/AGENTS.md、MCP 服务器)、代码中的 Anthropic/OpenAI API 集成、本地模型(Ollama、LM Studio)以及带 AI 的编辑器(Cursor)。
主要能力:按用户选择只安装对应的 CLI;先检查是否已存在安装(which -a claude codex gemini copilot grok kimi),已存在则更新该渠道而非重复安装;安装后给出安全威胁模型说明,建议按项目设置权限白名单、审查危险命令提示、对敏感仓库使用容器或 worktree 沙箱,不默认放开权限。
使用方式:认证采用浏览器登录已有订阅,安装过程中不索取、不回显、不存储 API 密钥。安装渠道优先 brew/npm(Gemini、Copilot、Codex、Claude Code cask 等);只有 shell 安装脚本时,先下载到文件、阅读后再执行两步法,不把远程脚本直接管道进 shell。npm 方式需 Node ≥ 22。示例命令保持原样,如 curl -fsSL https://claude.ai/install.sh -o /tmp/claude-install.sh,再 less 查看后 sh 执行;Gemini 可 brew install gemini-cli 或 npm i -g @google/gemini-cli;Copilot 为 npm install -g @github/copilot(gh copilot 扩展已弃用归档);Grok Build 与 Kimi Code 使用官方安装脚本;pi 可 npm install -g --ignore-scripts @earendil-works/pi-coding-agent。
验证:每个所选 CLI 用 --version 确认,核对认证状态(claude doctor、codex /status 等),在临时目录用一个简单提示验证。
限制与注意:此类工具更新频繁,安装命令失败时应对照厂商文档重新核实;同一工具只用一种渠道,npm 与原生安装混用会导致 PATH 上两个二进制冲突;brew 的 claude-code cask 通常滞后原生渠道约一周且默认不自动更新;Grok/Kimi 的第三方 npm 镜像包名不一致,存在供应链风险,应使用官方脚本;worktree 只能隔离改动,不能隔离凭据或进程,敏感仓库需容器/VM 或独立账户。指令文件方面,AGENTS.md 是跨工具新兴标准,Claude Code 读 CLAUDE.md 并可用 @AGENTS.md 导入。资料未提供具体收费与价格信息。