在 macOS 或 Linux 安裝 HolyCrab CLI
本頁說明手動安裝步驟。已通過一鍵安裝完成的使用者,可直接進入配置 API Key。本頁只適用於 macOS 和 Linux。Windows 請使用單獨的 PowerShell 安裝頁。
開始前的準備
- 一臺可以聯網的 Mac 或 Linux 電腦。
- 下面會先檢查 Python 3.10+ 和 curl 是否已經存在。
- Codex 或 Claude Code 要使用同一個電腦帳號執行。
安裝步驟
1. 開啟終端機
Mac 按 Command + 空格,輸入 Terminal 後Enter;Linux 從應用選單開啟 Terminal。

在 macOS 用聚焦搜尋開啟 Terminal。
2. 檢查 Python
執行下面命令。看到 Python 3.10 或更高版本即可繼續。
3. 檢查 curl
執行下面命令。能看到 curl 版本資訊即可;缺少 Python 或 curl 時,先用系統常用的軟體管理工具安裝。
4. 安裝 HolyCrab
複製整行並按Enter。安裝器會儲存以後終端機要用的 PATH,並讓當前視窗立即生效。

安裝器最後應顯示 HolyCrab 0.7.5 installed。
5. 執行本機檢查
執行下面命令並尋找 "ok": true。尚未配置 API Key 屬於正常現象。
未成功時
- 缺少
python3或curl時,先使用 Mac/Linux 常用的軟體管理工具安裝,再重新檢查。 - 安裝成功但找不到
holycrab時,關閉終端機並開啟新視窗。 - 仍無法找到時,請重新執行安裝器,並根據常見問題頁中的報錯說明排查。