ガイド

アップデートとトラブルシューティング

YeePilotのアップデート、一般的な問題のトラブルシューティング、インストールの管理

最終更新: 2026年3月1日

YeePilotのアップデート

YeePilotには、コマンドラインから直接新しいバージョンをダウンロードしてインストールする組み込みアップデーターが含まれています。

アップデートの確認

インストールせずに新しいバージョンが利用可能か確認します：

bash

yeepilot update --check

現在のバージョン、利用可能な最新バージョン、変更内容が表示されます。

強制再インストール

インストールが破損している場合、または同じバージョンを再インストールしたい場合：

bash

yeepilot update --force

すでに最新であっても、最新バージョンをダウンロードしてインストールします。

前のバージョンへのロールバック

新しいバージョンに問題がある場合、前にインストールされていたバージョンにロールバックします：

bash

yeepilot update --rollback

YeePilotはロールバックを可能にするため、前のバイナリのバックアップを保持しています。ロールバックは直前のアップデートに対してのみ利用可能で、複数バージョンをロールバックすることはできません。

自動アップデート

デフォルトでは、YeePilotは1時間ごとに自動的にアップデートを確認し、新しいバージョンが利用可能な場合に通知します。

設定

yaml

# ~/.yeepilot/config.yaml
update:
  auto_check: true
  check_interval_hours: 1

自動アップデートチェックの無効化

手動でアップデートを管理したい場合：

yaml

update:
  auto_check: false

または環境変数で：

bash

export YEEPILOT_UPDATE_AUTO_CHECK=false

チェック頻度の調整

ネットワークリクエストを減らすためにチェック頻度を下げます：

yaml

update:
  check_interval_hours: 24  # 1日1回

よくある問題のトラブルシューティング

「Connection refused」または「Connection timed out」

症状： YeePilotがAIプロバイダーAPIに接続できない。

原因と解決策：

無効なAPIキー -- APIキーが正しいことを確認：
bash
```
yeepilot status
```
キーが間違っている場合は再設定：
bash
```
yeepilot setup --auth
```
間違ったプロバイダーURL -- カスタム base_url を使用している場合、到達可能であることを確認：
bash
```
curl -I https://api.openai.com/v1/models
```
ネットワークの問題 -- インターネット接続とプロキシ/ファイアウォール設定を確認。企業プロキシの背後にいる場合、AIプロバイダーのAPIエンドポイントへのHTTPSトラフィックが許可されていることを確認してください。
サンドボックスがネットワークをブロック -- sandbox.network_access が false に設定されている場合、YeePilotが実行するコマンドはネットワークにアクセスできません。ただし、YeePilot自身のAPI呼び出しはサンドボックス設定の影響を受けません。このエラーはネットワーク設定の問題である可能性が高いです。

「Model not found」または「Invalid model」

症状： AIプロバイダーがモデルIDを拒否する。

原因と解決策：

間違ったモデルID -- モデル識別子はプロバイダー固有です。正しい形式を使用しているか確認：

プロバイダーモデルIDの例
OpenAI gpt-4o、gpt-4o-mini
Anthropic claude-sonnet-4-20250514
OpenRouter openai/gpt-4o、anthropic/claude-sonnet-4-20250514
モデルアクセスが有効でない -- 一部のモデルはプロバイダーからの明示的なアクセス承認が必要です。プロバイダーのダッシュボードでモデルへのアクセス権があることを確認してください。

プロバイダー	モデルIDの例
OpenAI	`gpt-4o`、`gpt-4o-mini`
Anthropic	`claude-sonnet-4-20250514`
OpenRouter	`openai/gpt-4o`、`anthropic/claude-sonnet-4-20250514`

プロバイダーの不一致 -- モデルIDが設定されたプロバイダーと一致していることを確認。AnthropicのモデルIDはOpenAIプロバイダー設定では動作しません。

yaml

# 正しい：モデルがプロバイダーと一致
ai:
  provider: anthropic
  model: claude-sonnet-4-20250514
 
# 間違い：OpenAIプロバイダーにAnthropicモデル
ai:
  provider: openai
  model: claude-sonnet-4-20250514

「Permission denied」

症状： YeePilotがコマンドを実行できない、またはファイルにアクセスできない。

原因と解決策：

バイナリの権限 -- YeePilotバイナリに実行権限が必要：
bash
```
chmod +x /usr/local/bin/yeepilot
```
インストール場所 -- /usr/local/bin/ へのインストールにrootが必要な場合は sudo を使用：
bash
```
sudo curl -fsSL https://yee.to/install.sh | bash
```
サンドボックスの拒否パス -- 対象パスが sandbox.denied_paths リストに含まれていないか確認：
yaml
```
sandbox:
  denied_paths:
    - "/etc/shadow"  # コマンドがこのパスにアクセスできない
```
ファイルの所有権 -- 設定ディレクトリがあなたのユーザーに所有されていることを確認：
bash
```
ls -la ~/.yeepilot/
# rootに所有されている場合：
sudo chown -R $(whoami) ~/.yeepilot/
```

「Keyring not available」またはクレデンシャルストレージエラー

症状： YeePilotがシステムキーリングからAPIキーを保存・取得できない。

原因と解決策：

Linux：libsecret-toolsのインストール

bash

# Ubuntu / Debian
sudo apt install libsecret-tools
 
# Fedora / CentOS
sudo dnf install libsecret
 
# Arch
sudo pacman -S libsecret

Linuxヘッドレスサーバー：キーリングデーモンがない -- デスクトップ環境のないサーバーでは、YeePilotは ~/.yeepilot/credentials.json の暗号化JSONファイルにフォールバックします。このフォールバックが機能しない場合は、設定ディレクトリが存在し書き込み可能であることを確認：
bash
```
mkdir -p ~/.yeepilot
chmod 700 ~/.yeepilot
```
macOS：Keychain Accessプロンプト -- Keychainプロンプトが繰り返し表示される場合は、常に許可 をクリックしてYeePilotに永続的なアクセスを付与してください。
回避策として環境変数を使用 -- クレデンシャルストレージの問題が続く場合、環境変数でAPIキーを設定：
bash
```
export OPENAI_API_KEY=sk-...
```

サンドボックスエラー

症状： 名前空間やサンドボックス関連のエラーでコマンドが失敗する。

原因と解決策：

ユーザー名前空間が無効 -- 一部のLinuxカーネルや堅牢化された設定ではユーザー名前空間が無効です。確認：
bash
```
cat /proc/sys/kernel/unprivileged_userns_clone
```
出力が 0 の場合、有効化：
bash
```
sudo sysctl kernel.unprivileged_userns_clone=1
```
または名前空間サンドボックスを無効化：
yaml
```
sandbox:
  use_namespaces: false
```
macOSまたはWindows -- これらのプラットフォームでは名前空間サンドボックスは利用できません。YeePilotは自動的に無効化しますが、エラーが表示される場合は明示的に設定：
yaml
```
sandbox:
  use_namespaces: false
```

サンドボックスが厳しすぎる -- 正当なコマンドがブロックされている場合、制限を調整：

yaml

sandbox:
  max_cpu_seconds: 600    # 300から増加
  max_memory_mb: 1024     # 512から増加
  max_processes: 128      # 64から増加

「Token limit exceeded」またはコンテキストが大きすぎる

症状： メッセージが長すぎるため、AIプロバイダーがリクエストを拒否する。

原因と解決策：

会話履歴を減らす -- メッセージ数を減らすと送信するコンテキストが減ります：
yaml
```
ai:
  conversation_max_history: 5
```
出力の切り詰めを減らす -- コマンド出力の含有量を制限：
yaml
```
ai:
  output_truncate_length: 200
```
トークンセーバーモードを有効にする -- コンテキストをより積極的に圧縮：
yaml
```
ai:
  token_mode: saver
```
新しいセッションを開始 -- 現在のセッションに蓄積されたコンテキストが多すぎる場合は、新しく始めてください。AIはセッション間でコンテキストを引き継ぎません。

TUI表示の問題

症状： 文字化け、壊れた罫線文字、色の欠落。

原因と解決策：

最新のターミナルを使用 -- 古いターミナルはUnicodeやtrue colorをサポートしていない場合があります。Windowsでは Windows Terminalを使用。Linuxでは最新のターミナルエミュレータ（GNOME Terminal、Konsole、Alacritty、Kitty）を使用。
ロケール設定を確認 -- ロケールがUTF-8をサポートしていることを確認：
bash
```
locale
```
LANG が .UTF-8 で終わっていない場合、設定：
bash
```
export LANG=en_US.UTF-8
```
テーマを切り替える -- 色がおかしく見える場合、別のテーマを試す：
yaml
```
tui:
  theme: dark  # またはlight、neon、auto
```
ライブストリームパネルを無効にする -- ライブパネルがちらつきを起こす場合：
yaml
```
tui:
  live_stream_panel_enabled: false
```

設定のリセット

設定ファイルが破損している、またはやり直したい場合：

bash

yeepilot setup --reset

~/.yeepilot/config.yaml がデフォルト値で再生成され、セットアップウィザードが再度実行されます。

手動でリセットするには、設定ファイルを削除してセットアップを実行：

bash

rm ~/.yeepilot/config.yaml
yeepilot setup

YeePilotのアンインストール

完全アンインストール

バイナリ、設定、監査ログ、ボールト、すべての保存データを削除：

bash

yeepilot uninstall --all

設定を保持

バイナリを削除するが設定ファイルは保持（再インストールする予定がある場合に便利）：

bash

yeepilot uninstall --keep-config

バイナリのみ

バイナリのみ削除し、それ以外はそのまま：

bash

yeepilot uninstall --binary-only

手動アンインストール

uninstall コマンドが利用できない、またはバイナリが見つからない場合：

Linux/macOS：

bash

sudo rm /usr/local/bin/yeepilot
rm -rf ~/.yeepilot

Windows（PowerShell）：

powershell

Remove-Item "C:\Program Files\YeePilot\yeepilot.exe"
Remove-Item -Recurse "$env:USERPROFILE\.yeepilot"

Windowsでは C:\Program Files\YeePilot をPATHから削除することも忘れないでください。

ヘルプの入手

ここに記載されていない問題に遭遇した場合：

バージョンを確認 -- 最新バージョンを実行していることを確認：
bash
```
yeepilot update
```
ステータスを確認 -- アクティブな設定を確認：
bash
```
yeepilot status
```
監査ログを確認 -- 監査ログにエラーの詳細が含まれている場合があります：
bash
```
tail -50 ~/.yeepilot/audit.log
```
Webサイトを訪問 -- 最新のドキュメントとお知らせは yee.to (opens in new tab) をご確認ください。

ベストプラクティス

Guides

YeePilotのアップデート

アップデートの確認

最新バージョンのインストール

強制再インストール

前のバージョンへのロールバック

自動アップデート

設定

自動アップデートチェックの無効化

チェック頻度の調整

よくある問題のトラブルシューティング

「Connection refused」または「Connection timed out」

「Model not found」または「Invalid model」

「Permission denied」

「Keyring not available」またはクレデンシャルストレージエラー

サンドボックスエラー

「Token limit exceeded」またはコンテキストが大きすぎる

TUI表示の問題

設定のリセット

YeePilotのアンインストール

完全アンインストール

設定を保持

バイナリのみ

手動アンインストール

ヘルプの入手