FAQ ja

📖 他の言語: English | 中文 | 日本語

FAQ - よくある質問

ALICE についてのよくある質問への簡単な回答です。

一般的な質問

ALICE とは何ですか？

ALICE は会話型 AI と実世界のツールを組み合わせた AI 駆動のコマンドラインアシスタントです。GitHub Copilot CLI のようなものですが、より多くの機能を持っています。

ALICE は何ができますか？

コードベースに関する質問への回答
ファイルの読み取りと検索
システムコマンドの実行
Git リポジトリ情報の取得
コーディング支援
その他、ツールシステムを通じて多数の機能

ALICE は無料ですか？

ALICE 自体はオープンソースで無料です。ただし、LLM バックエンドが必要です:

無料: LM Studio をローカルモデルで使用
有料: OpenAI API を使用（従量課金）

ALICE はどの LLM をサポートしていますか？

OpenAI 互換 API なら何でも:

OpenAI (GPT-3.5, GPT-4)
LM Studio（ローカルモデル）
Ollama
カスタム OpenAI 互換エンドポイント

モデル設定を見る →

インストールとセットアップ

ALICE をインストールするにはどうすればいいですか？

詳細な手順についてはインストールガイドを参照してください。

クイックインストール:

npm install -g alice-cli

設定ファイルはどこにありますか？

~/.alice/settings.jsonc

プラットフォーム固有のパス:

Windows: C:\Users\<username>\.alice\settings.jsonc
macOS: /Users/<username>/.alice/settings.jsonc
Linux: /home/<username>/.alice/settings.jsonc

設定をリセットするにはどうすればいいですか？

設定ファイルを削除してください:

# macOS/Linux
rm ~/.alice/settings.jsonc

# Windows
del %USERPROFILE%\.alice\settings.jsonc

ALICE は次回起動時にデフォルト設定で再作成します。

ALICE の使用

ALICE を起動するにはどうすればいいですか？

alice

またはソースから:

npm run dev

ALICE を終了するにはどうすればいいですか？

Ctrl+C または Ctrl+D を押してください

バナーなしで ALICE を実行できますか？

はい、--no-banner フラグを使用してください:

alice --no-banner

画面をクリアするにはどうすればいいですか？

/clear と入力するか、Ctrl+L を押してください

ALICE にはコマンド履歴がありますか？

はい！↑ と ↓ 矢印キーで履歴をナビゲートできます。

ALICE は以前の会話を覚えていますか？

はい、現在のセッション内では覚えています。終了すると会話履歴は失われます。

セッションの永続化は将来のリリースで予定されています。

ツールシステム

ツールとは何ですか？

ツールは ALICE がシステムと対話できるようにする機能です:

ファイルの読み取り
ディレクトリの検索
コマンドの実行
Git 情報の取得
その他多数

ツールシステムについて学ぶ →

ツールが使用されているかどうかはどうやってわかりますか？

ALICE はリアルタイムでステータスを表示します:

[🔧 readFile] package.json を読み取り中...
[✅ readFile] 成功（1024バイト）

ツールを無効にできますか？

まだできません。すべての組み込みツールは常に有効です。

ツール設定は将来のリリースで予定されています。

カスタムツールを作成できますか？

まだできません。プラグインシステムは v0.3.0 で予定されています。

"危険なコマンド" とは何ですか？

データ損失やシステム変更を引き起こす可能性のあるコマンド:

ファイル削除（rm -rf）
ディスクフォーマット
システムシャットダウン
など

危険なコマンドについて学ぶ →

危険なコマンド警告を無効にするにはどうすればいいですか？

~/.alice/settings.jsonc を編集してください:

{
  "dangerous_cmd": false
}

⚠️ 警告: 何をしているか理解している場合のみ行ってください！

LLM と API

API キーは必要ですか？

LLM バックエンドによります:

LM Studio: API キー不要 ✅
OpenAI API: 必要 ❌
Ollama: API キー不要 ✅

API キーはどこに置けばいいですか？

~/.alice/settings.jsonc に:

{
  "llm": {
    "apiKey": "sk-your-key-here"
  }
}

または環境変数を使用:

{
  "llm": {
    "apiKey": "$OPENAI_API_KEY"
  }
}

安全な API キー管理について学ぶ →

モデルを変更するにはどうすればいいですか？

~/.alice/settings.jsonc を編集してください:

{
  "llm": {
    "model": "gpt-4"
  }
}

変更を有効にするには ALICE を再起動してください。

複数のモデルを使用できますか？

はい、ただし設定を編集して毎回 ALICE を再起動する必要があります。

マルチモデル切り替えは将来のリリースで予定されています。

レスポンスが遅いのはなぜですか？

考えられる理由:

大きなモデル - より小さなモデルを試してください
高い temperature - 0.3-0.5 に下げてください
ネットワーク遅延 - 接続を確認してください
LM Studio のパフォーマンス - ローカルモデルは速度が異なります

レスポンスを速くできますか？

はい:

より小さなモデルを使用（例: GPT-4 の代わりに GPT-3.5）
設定で maxTokens を下げる
より集中した応答のために temperature を下げる
ネットワーク遅延のないローカル LM Studio を使用

エラーとトラブルシューティング

エラー: "Failed to connect to LLM"

原因:

LM Studio が実行されていない
設定で baseURL が間違っている
ネットワークの問題

解決策:

LM Studio を起動
baseURL を確認: http://localhost:1234/v1
ポート 1234 にアクセス可能か確認

完全なトラブルシューティングガイドを見る →

エラー: "Invalid API key"

原因:

間違った API キー
環境変数が設定されていない
API キーが期限切れ

解決策:

API キーが正しいことを確認
環境変数を確認: echo $OPENAI_API_KEY
OpenAI ダッシュボードから新しい API キーを生成

エラー: "Model not found"

原因:

LM Studio でモデルが読み込まれていない
モデル名のタイプミス
プランでモデルが利用できない

解決策:

LM Studio でモデルを読み込む
モデル名のスペルを確認
「auto」を使用して LM Studio に選択させる

エラー: "Tool execution failed"

原因:

ファイルが見つからない
権限が拒否された
無効なパラメータ

解決策:

ファイルパスが正しいか確認
必要な権限があることを確認
詳細についてはエラーメッセージを確認

ALICE が応答しない

試してみてください:

Ctrl+C を押して中断
ALICE を再起動
LLM バックエンドが実行されているか確認
ターミナルでエラーメッセージを確認

出力に奇妙な文字が表示される

原因:

ターミナルが Unicode をサポートしていない
ANSI エスケープコードが機能していない

解決策:

モダンなターミナルを使用（Windows Terminal、iTerm2 など）
ターミナル設定を更新
別のターミナルエミュレータを試す

機能

ALICE はストリーミングをサポートしていますか？

はい！レスポンスはデフォルトでリアルタイムにストリーミングされます。

ALICE はファイルを編集できますか？

まだできません。現在、ALICE は以下のみ可能です:

✅ ファイルの読み取り
✅ ファイルの検索
✅ ディレクトリのリスト表示
❌ ファイルの書き込み/編集（予定）

ALICE には GUI がありますか？

いいえ、ALICE はコマンドライン専用です。それが目的です！😊

スクリプトで ALICE を使用できますか？

推奨しません。ALICE は対話的な使用を目的として設計されています。

自動化には、LLM API を直接使用することを検討してください。

ALICE はオフラインで動作しますか？

部分的に:

✅ ローカルツールはオフラインで動作
❌ LLM にはネットワークが必要（ローカル LM Studio を使用しない限り）

ALICE は Web を閲覧できますか？

いいえ。ALICE はローカル開発タスクに焦点を当てています。

Web 検索は将来のバージョンで追加される可能性があります。

開発

ALICE に貢献できますか？

はい！ALICE はオープンソースです: https://github.com/AndersHsueh/Alice

ソースからビルドするにはどうすればいいですか？

git clone https://github.com/AndersHsueh/Alice.git
cd Alice
npm install
npm run build
npm run dev

開発ガイドを見る →

バグを報告するにはどこに行けばいいですか？

GitHub で Issue を作成してください: https://github.com/AndersHsueh/Alice/issues

機能をリクエストするにはどこに行けばいいですか？

同じ場所です - "feature request" ラベルの付いた GitHub Issues。

ロードマップは何ですか？

GitHub Issues と Projects を参照してください。

比較

ALICE vs GitHub Copilot CLI

機能	ALICE	Copilot CLI
オープンソース	✅	❌
ローカル LLM サポート	✅	❌
ツールシステム	✅（7ツール）	✅（制限あり）
ストリーミング	✅	✅
コスト	無料*	有料

*ローカル LLM では無料、OpenAI では有料

ALICE vs ChatGPT

機能	ALICE	ChatGPT
CLI インターフェース	✅	❌
システム統合	✅	❌
ファイルアクセス	✅	❌
コマンド実行	✅	❌
Web アクセス	❌	✅
音声	❌	✅

パフォーマンス

ALICE はどのくらいのメモリを使用しますか？

おおよそ:

ベース: 約 50-100 MB
LLM あり: モデルによる（ローカルモデル: 2-8 GB）

ALICE はシステムを遅くしますか？

いいえ。ALICE は軽量です。LLM バックエンド（ローカルの場合）がリソースを使用する可能性があります。

Raspberry Pi で ALICE を実行できますか？

技術的には可能ですが:

✅ ALICE 自体は問題なく動作
❌ ローカル LLM には強力なハードウェアが必要
✅ 代わりにクラウド LLM API を使用

プライバシーとセキュリティ

ALICE は私のコードをクラウドに送信しますか？

クラウドベースの LLM（OpenAI など）を使用する場合のみです。

ローカル LM Studio を使用すると、すべてがマシン上に留まります。

独自のコードで ALICE を使用するのは安全ですか？

はい、ローカル LLM を使用する場合。クラウド LLM では注意が必要です - 会社のポリシーを確認してください。

ALICE はどのようなデータを収集しますか？

なし。ALICE には分析やテレメトリはありません。

ALICE は許可なしに私のファイルにアクセスできますか？

ALICE がファイルにアクセスするのは以下の場合のみです:

LLM がツールを使用することを決定した場合
どのツールが呼び出されているか確認できます
Ctrl+C でキャンセルできます

危険な操作には確認が必要です（無効にしない限り）。

まだ質問がありますか？

ドキュメントを確認: ホーム
GitHub Issues を検索: https://github.com/AndersHsueh/Alice/issues
GitHub Discussions で質問: https://github.com/AndersHsueh/Alice/discussions
新しい Issue を作成: https://github.com/AndersHsueh/Alice/issues/new

お探しのものが見つかりませんか？ お知らせいただければ FAQ に追加します！

FAQ ja

FAQ - よくある質問

一般的な質問

ALICE とは何ですか？

ALICE は何ができますか？

ALICE は無料ですか？

ALICE はどの LLM をサポートしていますか？

インストールとセットアップ

ALICE をインストールするにはどうすればいいですか？

設定ファイルはどこにありますか？

設定をリセットするにはどうすればいいですか？

ALICE の使用

ALICE を起動するにはどうすればいいですか？

ALICE を終了するにはどうすればいいですか？

バナーなしで ALICE を実行できますか？

画面をクリアするにはどうすればいいですか？

ALICE にはコマンド履歴がありますか？

ALICE は以前の会話を覚えていますか？

ツールシステム

ツールとは何ですか？

ツールが使用されているかどうかはどうやってわかりますか？

ツールを無効にできますか？

カスタムツールを作成できますか？

"危険なコマンド" とは何ですか？

危険なコマンド警告を無効にするにはどうすればいいですか？

LLM と API

API キーは必要ですか？

API キーはどこに置けばいいですか？

モデルを変更するにはどうすればいいですか？

複数のモデルを使用できますか？

レスポンスが遅いのはなぜですか？

レスポンスを速くできますか？

エラーとトラブルシューティング

エラー: "Failed to connect to LLM"

エラー: "Invalid API key"

エラー: "Model not found"

エラー: "Tool execution failed"

ALICE が応答しない

出力に奇妙な文字が表示される

機能

ALICE はストリーミングをサポートしていますか？

ALICE はファイルを編集できますか？

ALICE には GUI がありますか？

スクリプトで ALICE を使用できますか？

ALICE はオフラインで動作しますか？

ALICE は Web を閲覧できますか？

開発

ALICE に貢献できますか？

ソースからビルドするにはどうすればいいですか？

バグを報告するにはどこに行けばいいですか？

機能をリクエストするにはどこに行けばいいですか？

ロードマップは何ですか？

比較

ALICE vs GitHub Copilot CLI

ALICE vs ChatGPT

パフォーマンス

ALICE はどのくらいのメモリを使用しますか？

ALICE はシステムを遅くしますか？

Raspberry Pi で ALICE を実行できますか？

プライバシーとセキュリティ

ALICE は私のコードをクラウドに送信しますか？

独自のコードで ALICE を使用するのは安全ですか？

ALICE はどのようなデータを収集しますか？

ALICE は許可なしに私のファイルにアクセスできますか？

まだ質問がありますか？

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!