#在 macOS 或 Linux 安装 HolyCrab CLI

本页说明手动安装步骤。已通过一键安装完成的用户，可直接进入配置 API Key。本页只适用于 macOS 和 Linux。Windows 请使用单独的 PowerShell 安装页。

#开始前的准备

• 一台可以联网的 Mac 或 Linux 电脑。
• 下面会先检查 Python 3.10+ 和 curl 是否已经存在。
• Codex 或 Claude Code 要使用同一个电脑账号运行。

#安装步骤

#1. 打开终端

Mac 按 Command + 空格，输入 Terminal 后回车；Linux 从应用菜单打开 Terminal。

在 macOS 用聚焦搜索打开 Terminal。

#2. 检查 Python

运行下面命令。看到 Python 3.10 或更高版本即可继续。

python3 --version

#3. 检查 curl

运行下面命令。能看到 curl 版本信息即可；缺少 Python 或 curl 时，先用系统常用的软件管理工具安装。

curl --version

#4. 安装 HolyCrab

复制整行并按回车。安装器会保存以后终端要用的 PATH，并让当前窗口立即生效。

curl -fsSL https://holycrab.ai/cli/install.sh | sh && export PATH="$HOME/.local/bin:$PATH"

安装器最后应显示 HolyCrab 0.4.4 installed。

#5. 运行本地检查

运行下面命令并寻找 "ok": true。尚未配置 API Key 属于正常现象。

holycrab doctor --json

#未成功时

• 缺少 python3 或 curl 时，先使用 Mac/Linux 常用的软件管理工具安装，再重新检查。
• 安装成功但找不到 holycrab 时，关闭终端并打开新窗口。
• 仍无法找到时，请重新运行安装器，并根据常见问题页中的报错说明排查。