DocsプラットフォームセットアップmacOSセットアップ
ドキュメントに戻る
プラットフォームセットアップ

macOSセットアップ

Keychain連携でmacOS上にYeePilotをインストール・設定

最終更新: 2026年2月28日

概要

YeePilotはIntelおよびApple Silicon Mac上でネイティブに動作します。このガイドでは、インストール、Keychain連携、Gatekeeper権限、macOS固有の考慮事項を説明します。

システム要件

要件詳細
macOSバージョン12（Monterey）以降
アーキテクチャIntel（amd64）またはApple Silicon（arm64）
ターミナルTerminal.app、iTerm2、Warp、Alacritty、その他のターミナルエミュレータ

インストール

クイックインストール（推奨）

インストールスクリプトはMacのアーキテクチャを自動検出し、正しいバイナリをインストールします：

bash
curl -fsSL https://yee.to/install.sh | bash

これにより：

  1. IntelかApple Siliconかを検出。
  2. 適切なネイティブバイナリをダウンロード。
  3. ダウンロードのチェックサムを検証。
  4. バイナリを /usr/local/bin/yeepilot にインストール。

インストール後、動作を確認します：

bash
yeepilot version

手動インストール

  1. リリースページ (opens in new tab)から正しいアーカイブをダウンロード：

    • yeepilot-darwin-amd64.tar.gz -- Intel Mac用
    • yeepilot-darwin-arm64.tar.gz -- Apple Silicon Mac用（M1、M2、M3、M4）

  2. 展開してインストール：

bash
tar xzf yeepilot-darwin-arm64.tar.gz
sudo mv yeepilot /usr/local/bin/
sudo chmod +x /usr/local/bin/yeepilot
  1. インストールの確認：
bash
yeepilot version

Gatekeeper権限

macOS Gatekeeperは、バイナリがApple Developer証明書で署名されていないため、初回実行時にYeePilotをブロックする場合があります。次のようなメッセージが表示されます：「"yeepilot"は開発元を確認できないため開けません。」

システム設定から許可

  1. システム設定 を開きます（古いmacOSではシステム環境設定）。
  2. プライバシーとセキュリティ に移動します。
  3. セキュリティ セクションまでスクロールします。
  4. yeepilot がブロックされたというメッセージが表示されているはずです。このまま許可 をクリックします。
  5. yeepilot version を再度実行し、確認ダイアログで 開く をクリックします。

ターミナルから許可

または、quarantine属性を直接削除します：

bash
xattr -d com.apple.quarantine /usr/local/bin/yeepilot

これは一度だけ必要です。以降のアップデートではこの手順を繰り返す必要がある場合があります。

初期セットアップ

インタラクティブセットアップを実行してAIプロバイダーを設定します：

bash
yeepilot setup

~/.yeepilot/config.yaml に設定ファイルが作成されます。

クレデンシャルストレージ

YeePilotは macOS Keychain を自動的に使用して、APIキーと認証トークンを保存します。システムログインと統合された安全な暗号化ストレージを提供します。

  • クレデンシャルはデフォルトのログインキーチェーンに保存されます。
  • YeePilotがクレデンシャルを保存または取得する際、初回にKeychain Accessプロンプトが表示される場合があります。常に許可 をクリックして繰り返しのプロンプトを回避してください。
  • クレデンシャルはKeychain Accessで yeepilot のラベルで識別しやすくなっています。

保存されたクレデンシャルの表示

キーチェーンアクセス（アプリケーション > ユーティリティ内）を開き、yeepilot を検索して保存されたクレデンシャルを確認できます。

追加設定は不要

Linuxとは異なり、macOSではクレデンシャルストレージに追加パッケージは不要です。Keychainはすべてのmacosインストールで利用可能です。

サンドボックスの制限

macOSはLinuxカーネル名前空間をサポートしていません。YeePilotは代わりにプロセスレベルのリソース制限を使用し、基本的な分離を提供します：

  • CPU時間制限 -- 設定されたCPU時間を超えるとコマンドが終了。
  • メモリ制限 -- プロセスメモリが設定された上限に制限。
  • ファイルサイズ制限 -- 個々のファイル作成が制限。

サンドボックス設定の構成：

yaml
# ~/.yeepilot/config.yaml
sandbox:
  enabled: true
  use_namespaces: false  # macOSでは利用不可、自動的に無効化
  max_cpu_seconds: 300
  max_memory_mb: 512
  max_filesize_mb: 100
  max_processes: 64

設定値に関わらず、use_namespaces はmacOSでは自動的に false に設定されます。操作は不要です。

完全な名前空間分離には、Mac上のLinux仮想マシンまたはDockerコンテナ内でYeePilotを実行することを検討してください。

Apple Siliconに関するノート

YeePilotはApple Silicon Mac（M1、M2、M3、M4シリーズ）用のネイティブarm64バイナリを提供しています。Rosetta 2翻訳なしで動作し、最適なパフォーマンスを確保します。

ネイティブバイナリが実行されていることを確認するには：

bash
file $(which yeepilot)

Apple Siliconの場合は arm64、Intelの場合は x86_64 を含む出力が表示されるはずです。

Apple Silicon MacにIntelバージョンを誤ってインストールした場合、Rosetta 2で動作しますが、正しいアーキテクチャでの再インストールを推奨します：

bash
curl -fsSL https://yee.to/install.sh | bash

インストールスクリプトは常に正しいアーキテクチャを検出してインストールします。

ターミナルの推奨事項

YeePilotのTUIは以下をサポートするターミナルで最も良く動作します：

  • 256色またはtrue color -- 適切なテーマレンダリングのため。
  • Unicode -- 罫線文字やステータスインジケーターのため。
  • リサイズ -- TUIはターミナルサイズの変更に適応します。

すべての一般的なmacOSターミナルは問題なく動作します：

ターミナルノート
Terminal.app内蔵、そのまま動作。最良の結果を得るには「太字テキストに明るい色を使用」を有効にしてください。
iTerm2優れた色とUnicodeサポート。推奨。
Warp完全サポート。
Alacritty完全サポート。GPU加速。
Kitty完全サポート。GPU加速。

アップデート

最新バージョンにアップデート：

bash
yeepilot update

アップデート後、Gatekeeperでバイナリを再許可する必要がある場合があります（上記のGatekeeper権限セクションを参照）。

アンインストール

YeePilotとすべてのデータを削除：

bash
yeepilot uninstall --all

または設定を保持してバイナリのみ削除：

bash
yeepilot uninstall --binary-only

手動での削除：

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

保存されたKeychainエントリは、キーチェーンアクセスで yeepilot を検索し、該当するエントリを削除することで手動で削除できます。

前へ

Linuxセットアップ

Platform Setup

次へ

Windowsセットアップ

Platform Setup