#在 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 或更高版本即可繼續。

python3 --version

#3. 檢查 curl

執行下面命令。能看到 curl 版本資訊即可；缺少 Python 或 curl 時，先用系統常用的軟體管理工具安裝。

curl --version

#4. 安裝 HolyCrab

複製整行並按Enter。安裝器會儲存以後終端機要用的 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 時，關閉終端機並開啟新視窗。
• 仍無法找到時，請重新執行安裝器，並根據常見問題頁中的報錯說明排查。