快速開始
先確認一般對話能夠順利完成，再新增通訊管道、Skills、MCP 或定時任務。本頁使用原生正式版，不需要舊的階段體驗目錄或專用啟動腳本。
安裝並確認版本
macOS 和 Linux 的 amd64、arm64 都有原生發行套件：
curl -fsSL https://anyy.ai/install.sh | sh
anyy --version
本手冊對應 v0.1.107。版本輸出也會顯示發行管道、提交和建置時間。安裝器會核對釋出校驗值；如果提示找不到 anyy，先使用輸出中的 Binary: 完整路徑，再按它給出的提示把指令目錄加入 PATH。
一般非 root 使用者預設使用 ~/.anyy，指令入口為 ~/.local/bin/anyy。不要把安裝成功與模型已經設定、Gateway 已經啟動混為一談。安裝佈局和依賴見安裝。
連線一個模型
在互動式終端機執行：
anyy setup
選擇 Quick setup，完成服務商、認證方式、位址和模型選擇。第一次可以跳過備用模型與訊息平台，核對 Review Changes 後再確認寫入。
API Key、受支援的訂閱登入、已執行的 Ollama／LM Studio、相容介面都以目前精靈實際列出的選項為準。不要把某家服務的模型名稱直接套到另一家介面。
完成後檢查：
anyy config
核對 Profile、Home、服務商、模型和認證資料引用是否有效。該指令不會顯示金鑰原文。只想重新設定模型時用 anyy setup model，完整選項見初始化設定。
開啟 Dashboard
anyy dashboard
沒有常駐 Gateway 時，互動終端機會詢問 Start Anyy Gateway now?。接受後會按需啟動服務，再繼續開啟 Dashboard；非互動環境應先顯式執行 anyy gateway start。
預設模式會顯示本機及可用的區域網路位址。只需要本機存取時可以顯式綁定：
anyy dashboard --listen 127.0.0.1:8767
不自動開啟瀏覽器可加 --no-open。以本次終端機顯示的位址為準，請勿直接套用舊工作階段裡的連接埠或權杖。權杖用於一次性領取登入狀態，按臨時認證資料保護；開啟後繼續使用同一瀏覽器。
進行兩回合對話，再確認歷史還在
- 進入 對話，建立工作階段。
- 傳送：「請用一句話介紹你是 Anyy，再給我兩個適合初次試用的小任務。」
- 收到回答後追問：「把剛才第二個任務再說清楚一些。」
- 在啟動 Dashboard 的終端機按
Ctrl+C，再執行anyy dashboard。 - 開啟剛才的工作階段，確認兩回合內容都在，再繼續提問。
這裡檢查的是模型請求、工作階段持續儲存與重新連線。關閉 Dashboard 不代表關閉常駐 Gateway。
對話保持一個傳送按鈕。執行中繼續傳送的文字出現在輸入框上方佇列；要引導目前工作，使用佇列項的 提前執行（Steer）。換行用 Shift+Enter，中斷用 Escape。更多行為見 Dashboard 對話。
換一種介面，仍使用同一套環境
終端機互動：
anyy
已知工作階段 ID 時：
anyy --resume SESSION_ID
TUI 空閒時按 Enter 傳送，執行中按 Enter 插入引導，Alt+Enter 排隊，Shift+Enter 或 Ctrl+J 換行。中斷、取回輸入和結束見 TUI。
腳本中的單次請求先確保 Gateway 已啟動：
anyy chat "把 Anyy 可以处理的日常事务归纳为三类。"
需要機器可讀結果時加 --json；準確參數見 CLI 參考。
基礎對話正常後，再增加能力
- 從 Skills 上傳一個經過檢查的本機 ZIP，並在下一次對話中使用它。
- 在 MCP 新增一個伺服器，分別檢查儲存、連線和實際呼叫。
- 在 Codemode 頁面按步驟啟用並執行一個小程式；它不是角色切換。
- 連線一個訊息平台，做連續兩回合對話。
- 建立一個定時任務，確認觸發與投遞結果。
卡住時先縮小範圍
| 現象 | 下一步 |
|---|---|
| 指令找不到 | 用安裝器給出的完整路徑執行 --version，修正 PATH |
| 模型不能連線 | 核對 anyy config，重新執行 anyy setup model |
| Dashboard 需要 Gateway | 在互動終端機接受啟動，或先執行 anyy gateway start |
| 連接埠已佔用 | 檢視 anyy dashboard --status，或改用 --listen 127.0.0.1:8768 |
| 工作階段似乎丟失 | 對照 Dashboard 與 anyy config 的 Profile、Home |
| 已儲存設定但能力不可用 | 做對應連線測試或 Doctor，不把儲存操作回條當作成功呼叫 |