HolyCrab CLIのよくある問題を解決する

画面の文と一致する項目だけを試してください。エラーを共有するときはAPI Key、非公開リンク、QR、人物名、個人パスを必ず削除します。

インストール

表示	原因候補	安全な操作
Pythonがない／3.10未満	現在のPythonでは起動できない。	Python 3.12を入れ、ターミナルを開き直して再インストール。
`holycrab`が見つからない	PATH未読込またはインストール中断。	新しいターミナルで `holycrab doctor --json` を実行します（全OS共通）。まだ見つからない場合は、下記のOS別修復コマンドを使います。
PowerShellで`sh`が見つからない	macOS/Linux用をWindowsで実行した。	Windowsインストールガイドを開き、「HolyCrabをインストール」のコマンドをコピーしてPowerShellで実行します。見つからないのはUnixのシェル `sh` であり、SSHのインストールは不要です。
doctorでファイル不足・変更	管理ファイルの破損・欠落・版違い。	下記のOS別インストーラーで修復し、`holycrab doctor --json` を再実行。

Windowsでは新しいPowerShell、macOS/Linuxでは新しいターミナルを開きます。以下の確認コマンドは3つのOSで共通です。

holycrab doctor --json

holycrabが見つからないと表示される場合に限り、OSに合う公式コマンドを以下から選んで実行します。完了後に holycrab doctor --json を再実行してください。インストールに失敗した場合は、OS別ガイドを確認します。

詳細手順：Windows · macOS / Linux。

Windows PowerShell

irm https://holycrab.ai/cli/install.ps1 | iex

macOS / Linux (Bash / Zsh)

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

表示	原因候補	安全な操作
API Keyが無効	コピー不足、無効化、別アカウント。	API Accessで有効なKeyを確認し`holycrab setup`。
環境変数の上書き警告	一時Keyが保存Keyより優先。	Keyを共有せずdoctorのOS別指示に従う。
CodexがHolyCrabを見つけない	インストール前に起動、または古い接続先。	インストーラーを1回再実行し、新しいCodexタスクを開く。

スマートフォンでは表を左へスワイプできます。

表示	意味	次の操作
素材FAILED	オンライン処理で拒否。	公開エラーを読み、修正後の新規アップロード前に確認。
タスク待機タイムアウト	まだ処理中の可能性。	Task IDを保持し、同じタスクを再確認。
承認待機タイムアウト	本人が最終状態に達していない。	Authorization IDを保持し、新規作成しない。
生成・アップロードunknown	オンラインで実行済みの可能性。	既存記録を先に照会し、同じ操作を繰り返さない。

課金しない診断コマンドを表示

ローカル状態と既存記録を確認するだけです。

holycrab --version
holycrab doctor --json
holycrab doctor --json --online

holycrab tasks list
holycrab generate attempts list