メインコンテンツへスキップ

Crush とは

Crush は、Charm が開発したターミナル向けのオープンソースのコーディング エージェントです。設定は crushrc ファイルから読み込みます。このファイルは、Crush 独自のコマンドを含む Bash スクリプトです。このセットアップでは、Capriole AI を 1 つの OpenAI 互換プロバイダーとして追加します。

前提条件

始める前に、次を用意してください。

インストール

Homebrew で Crush をインストールします。
または、npm でインストールします。
インストールを確認します。

設定

モデルの検証

Crush 0.98.1 は、下記の設定を使い、「対応モデル」のすべてのモデルで、Capriole AI 経由のファイル読み取り、ファイル書き込み、最終回答の確認に合格しています。 ~/.config/crush/crushrc を作成または更新します。
各設定の役割は次のとおりです。
  • --type openai-compat はすべてのモデルを Chat Completions に送ります。Capriole AI はこれらのモデルをすべて Chat Completions で提供しています。
  • --api-key "$CAPRIOLE_AI_API_KEY" は、Crush がファイルを読み込むときに環境変数からキーを読み取ります。Crush はキーを Bearer トークンとして送ります。
  • --discover-models false により、一覧は追加したモデルだけになります。
  • model large はメインのコーディング モデルです。model small は、セッション タイトルの生成などの軽いタスク用のモデルです。

Crush を実行する

API キーを設定してから、プロジェクト ディレクトリから Crush を起動します。
Ctrl+L でモデルを切り替えます。非対話で実行するには、crush run を使います。

対応モデル

モデル参照は capriole/<model-id> の形式です。 openai-latest と claude-latest は、常に各ファミリーの最新の旗艦モデルを指します。

トラブルシューティング

Crush が認証エラーを返すのはなぜですか?

Crush を起動する前に CAPRIOLE_AI_API_KEY をエクスポートしてください。Crush は crushrc を読み込むときにこの変数を読み取ります。

Claude モデルが Unsupported chat model_key で失敗するのはなぜですか?

Chat Completions では、anthropic/claude-opus-5-5 などの anthropic/ プレフィックス付きの Claude ID を使ってください。claude-opus-5-5 などのプレフィックスなしの ID は Anthropic Messages 用です。

設定の変更が反映されないのはなぜですか?

プロジェクト ディレクトリにある .crushrc または crushrc ファイルは、~/.config/crush/crushrc より優先されます。そのようなファイルがないか確認してから、Crush を再起動してください。

注意事項

  • crushrc はシェル スクリプトとして実行されます。キーを直接貼り付けないでください。
  • Capriole AI の別のモデルを追加するには、model add の行を 1 行追加します。GET https://api.caprioletech.com/v1/models ですべてのモデル ID を一覧できます。
  • 公式リファレンス: Crush、Crush の設定。
最終更新日 2026年10月20日