セットアップ
anyy setupは、インストール済みコマンドを動くパーソナルアシスタントにする案内付きの方法です。モデル、メッセージング、任意のメディア／Web、MCPサーバーを設定できます。
初回はQuick setupを選びます。フォールバック、メッセージング、外部ツールを足す前に、ローカル会話を1つ動かしてください。
開始前
対話型ターミナルと、次のいずれかの使えるモデル接続が必要です。
- プロバイダーAPIキー。
- 対応サブスクリプションログイン。
- 実行中のOllama／LM Studio。
- OpenAI互換／Anthropic互換エンドポイント。
設定するProfileから実行します。
anyy setup
既定以外には、コマンド前の--profile NAMEまたは後の--home PATHを使います。
anyy --profile work setup
anyy setup --home /path/to/anyy-home
設定モードを選ぶ
最初の画面で2つの経路を選べます。
| モード | 設定内容 |
|---|---|
| Quick setup | プロバイダー、認証、メインモデル、任意フォールバック、メッセージング |
| Full setup | Quickの全項目に続き、任意の画像、動画、音声、Web検索、MCP |
両方とも最後に一度確認します。**Write these changes?**を承認すると収集した設定を確定します。明示開始したサインインは、その前にも認証サービスへ接続する場合があります。
メインモデルを設定する
Provider & Modelは次を尋ねます。
- プロバイダー。
- そのプロバイダーが提供する認証方法。
- 必要なエンドポイントや認証情報。
- メインモデル。
カタログを提供するプロバイダーでは取得してモデルを選べます。互換／ローカルでは手動モデルIDが必要な場合もあります。
一般的な選択例は次のとおりです。
| 接続 | 選択 |
|---|---|
| OpenAI APIキー | OpenAI → OpenAI API key |
| ChatGPTサブスクリプション | OpenAI → ChatGPT subscription (Codex) |
| Anthropic APIキー | Anthropic → Anthropic API |
| Claude Codeサブスクリプション | Anthropic → Claude Code subscription |
| ローカルモデル | OllamaまたはLM Studio |
| 互換サービス | OpenAI-compatibleまたはAnthropic-compatible |
インストール済みウィザードが正式なカタログで、そのバージョンに実装された認証方法だけを表示します。
互換エンドポイントはプロンプト、添付、要求メタデータを受け取ります。管理するか信頼する宛先を使ってください。
モデルだけを設定する
メッセージングや任意ツールを通らず、認証やメインモデルだけ変えるには次を使います。
anyy setup model
Gatewayに到達できれば、確認して書き込んだ後にプロバイダー設定を再読み込みします。いなければ次回ランタイム起動時に反映します。
フォールバックを追加する
FullとQuickの途中で設定するかを尋ねます。2つ目のテスト済み組み合わせがなければ初回は省略します。
後から順序付き経路を管理できます。
anyy setup model fallback
メインモデルが設定済みである必要があります。主対象が利用不可でルーティングを続けられる場合、保存順に試します。有効な認証や正常なプロバイダーの代わりにはなりません。
メッセージングを接続する
Messagingで対応プラットフォームを接続するか省略します。ここだけの設定には次を使います。
anyy setup channel
アカウント識別子、アクセスポリシー、Webhook詳細、認証情報などを尋ねる場合があります。変更を承認すると、ターミナル終了後も接続できるよう、常駐Gatewayサービスをインストール・起動します。
WebhookにはGatewayリスナーも必要です。既定で無効なので、channel_webhooks.enabledを有効にし、到達可能なchannel_webhooks.listenを選んでGatewayを再起動してからコールバックを設定します。保存やアカウント再読み込みだけでは有効になりません。認証と公開HTTPS要件はプラットフォーム別ガイドを参照します。
対応プラットフォーム、ペアリング、診断、再読み込みはメッセージングプラットフォームを参照してください。
任意の機能
Full setupでは次も設定できます。
- 画像理解。
- 動画理解。
- 画像生成。
- TTSとSTT。
- Web検索。
- 1つ以上のMCPサーバー。
すべて任意です。利用予定の機能だけ選んでください。各外部バックエンドには独自の認証、データ処理、利用料がある場合があります。
メディアは対応入力画面で検証します。DashboardはPNG/JPEGを画像、他をファイルに分類します。音声や動画をアップロードするだけでは理解処理を起動しません。メディア理解を参照してください。
確認して書き込む
書き込み前のReview Changesで、プロバイダー、モデル、エンドポイント、認証情報数、フォールバック、チャンネル、任意機能、MCPを確認します。
確認します。
Write these changes? [Y/n]
成功するとsetup completeと次の案内を表示します。
anyy status
anyy config
anyy
最終確認前のキャンセルはローカル収集設定を書かず、収集したChannelアクションも送信しません。確認後は常駐Gatewayで直接実行し、ローカル受領記録を検査して接続診断を別に報告します。
データの保存先
選択Profileホームでは次に保存します。
| データ | 場所 |
|---|---|
| プロバイダー、モデル、経路、機能設定 | <PROFILE_HOME>/config.yaml |
| Provider/MCP認証情報ファイル | <PROFILE_HOME>/secrets/ |
| Channelアカウントと保護された暗号化認証情報 | <PROFILE_HOME>/state.db |
| セッションとランタイム状態 | <PROFILE_HOME>/state.db |
認証情報ファイルと暗号化Channel紐付けはconfig.yamlとは別で、ファイルモード0600で書きます。値を表示せず解決パスと認証状態を見るにはanyy configを使います。
目的別の設定コマンド
anyy setup [--home PATH]
anyy setup model [--home PATH]
anyy setup model fallback [--home PATH]
anyy setup channel [--home PATH]
anyy setup channel CHANNEL [--home PATH] \
[--set INPUT=VALUE] \
[--sensitive-fd INPUT=FD] \
[--external-locator-fd INPUT=FD]
最後は非対話型のChannel設定です。機密値はファイル記述子から読み、履歴やプロセス引数に出す必要がありません。
トラブルシューティング
| 問題 | 対処 |
|---|---|
requires an interactive terminal | anyy setup、anyy setup model、対話型anyy setup channelを直接ターミナルで実行 |
| 空APIキーでキャンセルされる | anyy setup modelを再実行して有効キーを入れるか別認証を選択 |
| ローカルモデルが出ない | Ollama/LM Studioを起動し、エンドポイント確認後に再設定 |
| サブスクリプションログインが終わらない | ブラウザー／デバイス認証を完了し、ターミナル期限切れなら再設定 |
| 保存設定が見えない | anyy configでProfileとHomeを比較。別Profileの可能性 |
| チャンネルが接続しない | anyy channel doctor CHANNELで確認し、修正後anyy channel reload |
Dashboardの概要かモデル設定へ進んでください。