DocsはじめにYeePilotをはじめよう
ドキュメントに戻る
はじめに

YeePilotをはじめよう

数分でYeePilotを使い始めましょう。AIプロバイダーの設定、最初のプロンプト送信、コマンドの安全性について理解できます。

最終更新: 2026年3月1日

YeePilotの起動

インストール後、以下のコマンドでYeePilotを起動します:

bash
yeepilot

同じ動作の短縮エイリアス:

bash
yee

初回起動時、YeePilotは自動的にセットアップウィザードを開始します。事前に設定するものはありません。

セットアップウィザード

セットアップウィザードは、約1分で基本的な設定を案内します。yeepilot setup でいつでも再実行できます。

ステップ1:AIプロバイダーの選択

YeePilotは複数のAIプロバイダーに対応しています。ニーズに合ったものを選択してください:

プロバイダーモデルコストAPIキーの要否
OpenRouter無料オプションを含む複数モデル無料枠あり必要(無料で作成可)
OpenAIGPT-4o、GPT-4、GPT-3.5有料必要
AnthropicClaude Sonnet、Claude Haiku有料必要

費用をかけずにYeePilotを試したい場合は、OpenRouter を選択してください。ほとんどのサーバー管理タスクに十分な無料モデルが利用できます。

ステップ2:APIキーの入力

プロンプトが表示されたらAPIキーを貼り付けます。YeePilotはOSのキーリング(macOS Keychain、Linux Secret Service、またはWindows Credential Manager)に安全に保存します。キーリングのないシステムでは、暗号化されたローカルファイルに保存されます。

ステップ3:モデルの選択

選択したプロバイダーで利用可能なモデルから選択します。ウィザードは機能とコストに基づいて推奨モデルを表示します。後から設定で変更できます。

ステップ4:言語の選択

YeePilotのインターフェースは以下の言語に対応しています:

  • 英語 (デフォルト)
  • ドイツ語 (Deutsch)

これはシステムメッセージ、プロンプト、TUIインターフェースの言語を制御します。AI自体は、入力に基づいてどの言語でも応答できます。

ステップ5:セキュリティモード

お好みのセキュリティ体制を選択します。コマンド実行前のバリデーションの厳格さを制御します。ほとんどのユーザーにはデフォルト設定が推奨されます。

最初のプロンプト

セットアップが完了すると、インタラクティブターミナルに入ります。実現したいことを自然言語で入力してください:

plaintext
> Show me disk usage on all mounted filesystems, sorted by usage percentage

YeePilotはリクエストを具体的なコマンドプランに変換します:

plaintext
Plan:
  1. df -h --output=source,pcent,target | sort -k2 -rn
 
Risk: SAFE
Execute? [Y/n]

Enter または Y を押してプランを承認し実行します。出力はターミナルに直接表示されます。

その他の例

試してみたい一般的な最初のプロンプトをいくつか紹介します:

plaintext
> Find the 10 largest files in /var/log
plaintext
> Check which ports are listening and what processes own them
plaintext
> Show memory usage breakdown by process
plaintext
> Create a new user called deploy with SSH key authentication

コマンドプランの理解

システム上でコマンドが実行される前に、YeePilotは確認用のプランを提示します。各プランには以下が表示されます:

  • 実行される正確なコマンド
  • 各コマンドのリスク指標
  • 承認を求めるプロンプト

最終決定権は常にあなたにあります。明示的な確認なしには何も実行されません。

リスク指標

提案されるすべてのコマンドは、4段階のリスクレベルに分類されます:

SAFE(安全 - 緑)

システムに変更を加えず、状態を確認するだけの読み取り専用コマンドです。

例:lscatdfpsuptimewhoami

MODERATE(中程度 - 黄)

制御された方法でファイルやシステム状態を変更するコマンドです。一般的な管理タスクですが、確認が望ましいものです。

例:mkdircpmvchmodsystemctl restart

DANGEROUS(危険 - 赤)

重大な破壊的可能性を持つコマンドです。YeePilotはこれらを目立つように強調表示し、明示的な確認を要求します。

例:rm -rfddmkfsiptables -F

BLOCKED(ブロック - 停止)

自動実行には危険すぎるコマンドです。YeePilotは承認の有無にかかわらず実行を拒否します。不可逆的なシステム全体への損害を引き起こす可能性のあるコマンドが含まれます。

例:rm -rf /:(){ :|:& };:chmod -R 777 /

次のステップ

YeePilotが動作するようになったら、以下のトピックを探索してください: