環境變數

先用 anyy config 看實際解析結果，再檢查啟動 Anyy 的程序獲得了哪些變數。日常設定優先使用明確的指令參數和 Profile 設定；Shell 中的匯出不會自動傳給已執行的常駐服務。

選擇資料目錄與時區

變數	實際作用
`ANYY_HOME`	沒有更明確的指令參數時，指定 Home
`ANYY_DEFAULT_HOME`	改變 Profile 管理器和命名 Profile 使用的基礎 Home
`ANYY_TIMEZONE`	Profile 沒有設定時區時，提供 IANA 時區名稱
`TZ`	Profile 未設定且 `ANYY_TIMEZONE` 無有效值時，參與主機時區檢測

--profile、--profile-root、指令自己的 --home 與環境變數會共同影響目錄選擇。日常使用時固定一種方式即可，疑難排解時以 anyy config 為準。已有 Profile 填了無效時區時，應修正該設定，不能依賴環境變數替它覆蓋。

支援認證資料引用的欄位可以填寫 env:NAME。例如，把模型的 credential_ref 設定為 env:MY_MODEL_KEY，再讓 Gateway 的啟動環境包含 MY_MODEL_KEY；引用只在實際讀取時解析，不會把值複製進 config.yaml。

僅匯出 OPENAI_API_KEY 等常見名稱，不會自動給所有 provider 設定認證資料。變數名稱由設定裡的引用決定。長期認證資料也可以使用 Anyy 代管 Secret，減少對服務環境的依賴。

MCP 設定值用 $NAME 或 ${NAME} 展開環境變數，shell 表示式也依 MCP 的值解析規則處理；這與 env:NAME 認證資料引用不同，不能混用；詳見 MCP 設定值。

變數與取值	效果
`NO_COLOR` 非空	關閉 CLI/設定精靈顏色
`FORCE_COLOR` 非空	覆蓋非 TTY、`CI`、`TERM=dumb` 的預設無色行為；`--no-color` 和 `NO_COLOR` 仍優先
`TERM=dumb`	預設無色並使用 ASCII 符號
`CI` 非空	預設無色，可被 `FORCE_COLOR` 覆蓋
`ANYY_TUI_SPLASH=0`	不顯示 TUI 啟動畫面
`ANYY_TUI_BRACKETED_PASTE=off`	關閉括號貼上模式，適用於不相容終端機
`ANYY_SKIP_VERSION_CHECK` 非空	不做 TUI 更新可用性檢查

只影響一次指令時，可以使用 --no-color。

ANYY_OFFLINE 為 1、true 或 yes 時，Anyy 不會自動下載缺少的代管 rg/fd；已有可用程式仍可執行。這個變數不會關閉模型請求、連網工具、MCP 或其他網路存取，不能當作全域離線切換開關。

以下設定傳給安裝腳本，不是對執行中 Gateway 的即時修改：

變數	預設與作用
`ANYY_HOME`	一般使用者為 `$HOME/.anyy`，root 為 `/root/.anyy`；可明確選擇安裝目錄
`VERSION`	省略時安裝最新發布版本；填寫一個存在的版本 Tag 可固定版本
`ANYY_INSTALL_COMPACT`	預設 `0`；`1` 時減少保留的還原歷史
`ANYY_RELEASE_BASE_URL`	預設 `https://anyy.ai/releases`，只改為可信且相容的鏡像來源
`ANYY_LATEST_URL`	預設 `<ANYY_RELEASE_BASE_URL>/latest`；省略 `VERSION` 時從這裡讀取版本標記

curl -fsSL https://anyy.ai/install.sh | VERSION=v0.1.107 sh
curl -fsSL https://anyy.ai/install.sh | ANYY_INSTALL_COMPACT=1 sh

自訂鏡像來源需提供安裝器要求的二進位與校驗介面。變數應放在管道中執行 sh 的一側，才能傳給安裝器。

問題	檢查
兩個終端機開啟不同資料	Profile、Home 環境變數及顯式參數是否一致
定時任務時間不對	Profile 的時區是否有效，其次檢查 `ANYY_TIMEZONE`
貼上內容異常	嘗試 `ANYY_TUI_BRACKETED_PASTE=off`
認證資料引用未解析	變數是否存在於 Gateway 的啟動環境，而非僅登入 Shell

不要把完整環境輸出貼到支援報告中；懷疑 Key 洩露時去服務商處輪換。anyy config 可檢查引用健康狀態，不會顯示金鑰。目錄和手動設定見設定檔與設定入口。