インストールと起動

インストール後に alius コマンドが見つからない

インストールパスが PATH 環境変数にあることを確認：

# alius のパスを確認
which alius

# npm でインストールした場合、グローバルパスを確認
npm list -g @alius-tech/alius

alius 起動後にすぐ終了する

必要な環境設定が不足していないか確認：

  1. alius init を実行してプロジェクトを初期化
  2. .alius/config/providers.toml に有効なプロバイダーと API Key が設定されていることを確認
  3. Plan/Execute/Review の3つのモデルが少なくとも割り当てられていることを確認

alius init でモデル取得が失敗する

リモートモデルリストの取得が失敗した場合：

  1. ネットワーク接続と API Key が有効か確認
  2. /model の追加フローはモデル名の手動入力をフォールバックとしてサポート
  3. Base URL が正しいことを確認

ワークスペース

ワークスペース起動時に API Key が不足していると報告される

/init でモデルのインポートに成功すると、API Key はアクティブなランタイム設定に書き込まれます。providers.toml を手動で編集した場合、api_key_env が正しい環境変数を指していることを確認してください。

モデル割り当てエラー「モデルが有効ではありません」

/config でモデル割り当てを確認する前に、/model でモデルの enabled ステータスが true であることを確認してください。

モデルを削除できない

Plan Model、Execute Model、または Review Model で現在使用されているモデルは削除できません。先に /config で割り当てを変更してから、モデルを削除してください。

実行モード

プランモードでツール呼び出しが一時停止する

これは正常な動作です。プランモードでは承認が必要な操作（ファイル書き込み、リスキーなシェルコマンドなど）が一時停止し、確認を待ちます。承認または拒否を選択できます。

バイパスモードでリスキーな操作が自動実行された

バイパスモードでは、Shell Gate の ApprovalRequired 決定は確認プロンプトを表示せずに直接実行されます。特定の操作を自動実行させたくない場合は、プランモードで作業するか、permissions.toml で該当操作を deny に設定してください。

メモリ

メモリデータはどこに保存される？

すべてのメモリはプロジェクトディレクトリの .alius/memory/ に保存されます。外部へのデータ転送はありません。

プロジェクトメモリをクリアするには？

/memory clear

これはグローバルメモリをクリアします。プロジェクトメモリは memory_list と memory_clear ランタイム操作で管理されます。

レガシー REPL

古い REPL インターフェースを使用するには？

ALIUS_LEGACY_REPL=1 alius

レガシー REPL はスラッシュコマンドとターミナルストリーミング出力をサポートしていますが、主要な製品インターフェースではありません。

さらなるヘルプ