クイックスタート

未設定のmacOSまたはLinuxマシンから、Anyy設定、Dashboardの初回会話、その会話がDashboardプロセス再起動後も残ることの検証までを案内します。

対象読者

次の方に向いています。

• macOS／Linuxで自分用にAnyyを実行したい。
• 日常はDashboardを使いつつ、背景のコマンドも知りたい。
• APIキー、対応サブスクリプションログイン、ローカルOllama／LM Studioのいずれかがある。
• メッセージング、自動化、Skill、外部ツールの前に、信頼できるチャットを1つ動かしたい。

最短の進め方

目的	最初の操作	次の操作
全機能の画面を使う	Anyyを入れる	anyy setup、次にanyy dashboard
ターミナルで会話	インストールと設定	anyy
スクリプトから1プロンプト	常駐Gatewayを起動	anyy chat "..."
Telegramなどに接続	先にローカル会話を検証	anyy setup channel

1つの動くチャットから始める

フォールバック、メッセージング、Cron、MCPを有効にする前に、1プロバイダーを設定して単純な会話を完了します。初回の問題を小さく、診断しやすくできます。

1. Anyyをインストールする

macOSまたはLinux

正式なネイティブインストーラーを実行します。

curl -fsSL https://anyy.ai/install.sh | sh

シェルがコマンドを解決できるかを確認します。

anyy --version

インストーラーはネイティブリリースを取得し、CHECKSUMS.sha256で検証し、Anyyホーム下で有効化して、安全な場合にコマンド入口を作成します。

インストーラーの対応対象

macOSとLinuxのamd64／x86_64とarm64／aarch64に対応します。Gateway起動やProfileデータ作成はしません。必要時にセットアップが行います。

anyyがPATHにない場合は表示されたBinary:パスで検証し、PATH案内の正確なディレクトリを追加します。通常の非rootでは、可能なら$HOME/.local/binに入口を置きます。

2. プロバイダーを選ぶ

対話設定を開始します。

anyy setup

初回チャットへの最短手順は次です。

1. Quick setupを選びます。
2. プロバイダーと認証方法を選びます。
3. 検出カタログから選ぶか、手動選択が必要ならモデルを入力します。
4. Set up model fallback routing?は今はNoにします。
5. メッセージング接続はSkipします。
6. プロバイダー、モデル、エンドポイント、シークレット数を確認し、**Write these changes?**を承認します。

次の接続方式に対応します。

手元にあるもの	設定での選択
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	Ollama／LM Studio。先にサーバーを起動
その他の互換サービス	OpenAI-compatible／Anthropic-compatibleとエンドポイント

他の現在使えるプロバイダーも表示します。ウィザードのカタログがインストール済みAnyyの正式な一覧です。

成功するとsetup completeを表示します。結果を確認します。

anyy config

アクティブProfile、Home、設定ファイル、DB、プロバイダー、モデル、エンドポイント、各認証参照の解決可否を表示し、シークレット値は表示しません。

設定の保存方法

各Profileは自己完結しています。

• プロバイダー／モデル設定は<PROFILE_HOME>/config.yaml。
• 管理認証情報は別の<PROFILE_HOME>/secrets/にモード0600で保存。
• セッションと状態は<PROFILE_HOME>/state.db。

既定の非rootでは通常<PROFILE_HOME>は$HOME/.anyy、rootでは/root/.anyyです。推測せずanyy configを実行します。ANYY_HOMEや名前付きProfileが関係する場合は特に確認してください。

設定は先に確認します

ウィザードは変更を一時保持して最終確認します。**Write these changes?**前にキャンセルすると書き込みません。

3. 最初の会話をする

Dashboardはチャット、セッション、プロバイダー、ツール、メモリ、Role、Profile、Channel、Skill、MCP、Cronをまとめるため、最初の画面に推奨します。

対話型ターミナルから起動します。

anyy dashboard

常駐GatewayがなければGateway requiredと表示し、尋ねます。

Start Anyy Gateway now? [Y/n]:

Enterで受け入れます。必要なら背景サービスをインストール・起動し、準備を待ってDashboardを開きます。Dashboard終了後もGatewayは利用可能です。

既定ではポート8767のThis machineと使用可能なLocal network URLを表示し、対話実行では前者を自動で開きます。表示だけなら--no-openを使います。

anyy dashboard --no-open

自動LANリスナーの代わりに、明示ループバック1つだけにするには次です。

anyy dashboard --listen 127.0.0.1:8767

Dashboard URLは非公開にする

表示URLには一時アクセストークンがあります。チャット、ログ、issue、スクリーンショットへ貼らないでください。リスナー停止はターミナルでCtrl+Cです。

最初のメッセージを送る

Dashboardで次を行います。

1. Chatを開きます。
2. New sessionを選びます。
3. 次を送ります。

Introduce yourself as Anyy in one sentence, then list three things you can help me do.

回答が表示され、セッションパネルに載れば動作しています。

実際のモデル要求を送ります

利用枠や料金が発生する場合があります。APIキー、アクセストークン、シークレットはプロンプトに含めないでください。

4. セッションを検証する

1回答で終わらず、永続性を確認します。

1. 同じセッションに続きのメッセージを送ります。
2. Dashboard実行ターミナルでCtrl+Cを押します。
3. 再びanyy dashboardを実行します。
4. Chatで前のセッションを選びます。
5. 両ターンがあることを確認して、さらに1通送ります。

これは保存、再接続、常駐Gatewayでの継続実行という3経路の確認です。

ターミナルではanyyから/sessionsで過去の会話を選びます。IDが分かれば直接開けます。

anyy --resume SESSION_ID

5. 主な機能を試す

Dashboard操作

ナビゲーションで設定を確認します。

• Overviewは健全性と選択Profile。
• Modelsは接続、認証状態、利用モデル、アクティブモデル。
• Chatは通常会話と背景セッションを分離。
• RolesとMemoryはアイデンティティと永続個人コンテキスト。
• Tools、Skills、MCP、Channel、Cronは基本チャット安定後の追加機能。

Sendボタンは1つです。実行中の送信は入力欄上のキューに現れ、項目のSteerで作業へ反映できます。改行はShift+Enter、中断はEscape、コマンドメニューは/です。Chat操作を参照してください。

ターミナルインターフェース

TUIを開きます。

anyy

便利なコマンドは次です。

/help       Show commands and keyboard shortcuts
/new        Start a new session
/sessions   Open recent sessions
/status     Show the current conversation state
/model      Inspect or change the active model
/provider   Inspect providers and provider authentication
/usage      Show provider usage and context
/skills     Insert an available Skill command

TUIのEnterは待機中に送信、作業中にsteerし、Alt+Enterはfollow-upをキューに入れます。Shift+Enter／Ctrl+Jは改行、終了は/quitです。中断や保留文章の返却はTUI操作を参照してください。

単発CLI

Gateway実行中なら、画面を開かず1件送れます。

anyy chat "Give me a five-line summary of what Anyy can do."

機械可読出力は--jsonです。有効ツールは直接実行するため、送信前にタスク、パス、宛先アカウントを確認します。

6. 次の機能を追加する

次に必要な機能だけ追加します。

機能	入口	追加内容
メッセージング	anyy setup channel	対応プラットフォームとアクセスポリシー
フォールバック	anyy setup model fallback	順序付き予備プロバイダー／モデル
Web、画像、動画、音声	anyy tools	任意機能サービス
Skill	anyy skills list	追加前に既存を確認
MCP	anyy mcp --help	サーバー／ツールの追加、認証、プローブ、有効化、呼び出し
予約作業	anyy cron --help	スケジュールと配信付き反復ジョブの作成・管理

DashboardとGatewayの寿命は異なります

Dashboardは必要時のWebサイドカー、Gatewayは常駐ランタイムです。Ctrl+Cで止まるのはWebリスナーで、背景サービスのGatewayは停止しません。

よくある失敗

症状	原因の候補	対処
anyy: command not found	入口がPATHにない	インストーラーの正確なPATH指示に従い、シェルを開き直してanyy --version
空APIキー入力後に終了	初回キー設定は空でキャンセル	anyy setup modelで有効キーかサブスクリプション／ローカルを選択
ローカルモデル利用不可	サーバー停止か誤エンドポイント	起動後にanyy setup model
Gateway required	常駐Gatewayに到達不能	受け入れるかanyy gateway start後にanyy dashboard
127.0.0.1:8767使用中	他Dashboard／プロセスが所有	anyy dashboard --statusで調べ、古いDashboardをanyy dashboard --stopで止めるか--listen 127.0.0.1:8768
Dashboardで送信できない	モデル、認証、Gateway健全性が不正	anyy config、anyy status、anyy doctor。必要ならanyy setup modelで再設定
anyy chatが接続不能	単発チャットはGatewayを起動しない	先にanyy gateway start
保存セッションがない	別Profile／Home	DashboardのProfile／Homeとanyy configを比較

復旧用の手順

変更前に問題を絞れるよう、次の順に使います。

1. ランタイムとProfileを確認します。

   anyy status
   anyy config

2. 組み込み診断を実行します。

   anyy doctor

3. Gatewayが不正常で実行中ターンがなければ再起動します。

   anyy gateway restart

4. 認証やモデル選択が誤っていれば、その層だけ直します。

   anyy setup model

5. Dashboardリスナーの問題なら古いプロセスを調べ、停止して新しく開始します。

   anyy dashboard --status
   anyy dashboard --stop
   anyy dashboard

6. 複数Profileがあればアクティブを確認します。

   anyy profile list

クイックリファレンス

コマンド	目的
anyy	対話ターミナルUIを開く
anyy dashboard	起動してThis machine URLを開く
anyy dashboard --no-open	ブラウザーを開かず起動
anyy chat "PROMPT"	常駐Gatewayへ1件送信
anyy --resume SESSION_ID	TUIで既存セッションを開く
anyy status	ランタイムとGateway状態
anyy doctor	設定とランタイム診断
anyy config	解決パス、プロバイダー、モデル、認証状態
anyy gateway start	常駐サービスのインストール・起動
anyy gateway restart	常駐サービス再起動
anyy setup model	プロバイダー、認証、モデル、任意フォールバック設定
anyy setup channel	メッセージング設定
anyy update --check	新ネイティブリリースの確認

次のステップ

• Dashboardで画面操作を学びます。
• モデル設定でプロバイダーを追加／変更します。
• TUIでコマンドとキー操作を学びます。
• メッセージングで接続します。
• 機能で製品全体を把握します。
• CLIリファレンスで正確なフラグを調べます。