環境変数
明示CLIフラグと検証済みProfile設定を優先します。環境変数はプロセス既定値、無人導入、ターミナル互換性、認証参照に便利です。
Profileとランタイムの解決
| 変数 | 効果 |
|---|---|
ANYY_HOME | より具体的なフラグがなければ明示Homeを選択 |
ANYY_DEFAULT_HOME | Profile管理と名前付きProfileの基本Homeを変更 |
ANYY_TIMEZONE | Profileに未設定なら移植可能なIANAゾーンを指定 |
TZ | Profile未設定かつANYY_TIMEZONEが有効値を供給しない場合のホスト代替 |
ANYY_OFFLINE | 1、true、yesで不足管理rg／fdの自動取得を防止。既存は動く。モデル、Web、MCPなどの通信は無効にしない |
優先度はコマンド次第ですが、隠れたシェルexportより明示--home／--profileが明確です。anyy configで結果を確認します。
選択方法を不用意に混ぜない
名前付きProfile、--profile-root、コマンド別--home、環境上書きを混ぜるとターミナルごとに別データへ向く場合があります。通常は1方式にします。
ターミナルの表示と互換性
| 変数 | 値 | 効果 |
|---|---|---|
NO_COLOR | 空でない値 | CLI/setupの色を無効 |
FORCE_COLOR | 空でない値 | 非TTY、CI、TERM=dumbでも色を強制。ただし--no-colorとNO_COLORが優先 |
TERM | dumb | 既定で色なし、ASCII記号 |
CI | 空でない値 | 既定で色なし。FORCE_COLORで上書き可 |
ANYY_TUI_SPLASH | 0 | スプラッシュ無効 |
ANYY_TUI_BRACKETED_PASTE | off | 非互換端末でbracketed-paste無効 |
ANYY_SKIP_VERSION_CHECK | 空でない値 | TUIの更新確認を省略 |
1コマンドの上書きには--no-colorを推奨します。
認証情報参照
対応設定はenv:NAMEで環境変数を参照できます。名前は連携ごとに選び、実行時に解決し、シークレットをconfig.yamlにコピーしません。
常駐プロセスが実際に変数を受け取る間だけ正常です。対話シェルのexportはサービスに自動で渡りません。
参照設定が変数名を選びます。たとえばOPENAI_API_KEYをexportするだけでは全プロバイダーは設定されません。対応credential_refにenv:MY_MODEL_KEYを指定し、GatewayにMY_MODEL_KEYを渡します。MCP設定値は$NAMEまたは${NAME}で環境変数を展開し、独自のシェル式規則を持ちます。これらはenv:NAME認証情報参照とは異なります。MCP値を参照してください。
インストーラー変数
ネイティブ導入スクリプト用です。
| 変数 | 既定値 | 目的 |
|---|---|---|
ANYY_HOME | 通常$HOME/.anyy、root /root/.anyy | 導入Home選択 |
VERSION | 最新公開版 | 公開タグの固定 |
ANYY_INSTALL_COMPACT | 0 | 1で保持ロールバック履歴を減らす |
ANYY_RELEASE_BASE_URL | https://anyy.ai/releases | 信頼する互換ミラー |
ANYY_LATEST_URL | <ANYY_RELEASE_BASE_URL>/latest | VERSION省略時の版マーカーURL |
例：
curl -fsSL https://anyy.ai/install.sh | VERSION=v0.1.107 sh
curl -fsSL https://anyy.ai/install.sh | ANYY_INSTALL_COMPACT=1 sh
管理するか独立検証したミラーだけを使います。互換バイナリとチェックサムの入口が必要です。
セキュリティの指針
- 長期認証には管理シークレットを優先します。
- 環境シークレットは意図したサービス／プロセスだけに渡します。
- サポート資料やissueで環境全体を表示しません。
- 露出を疑ったらプロバイダーで更新します。
anyy configで値を出さず参照健全性を確認します。
トラブルシューティング
| 症状 | 確認する項目 |
|---|---|
| 違うProfile | ANYY_HOME、ANYY_DEFAULT_HOME、アクティブ、明示フラグ |
| 予定時刻が違う | ProfileかANYY_TIMEZONEに有効IANAゾーン |
| 貼り付けが不自然 | ANYY_TUI_BRACKETED_PASTE=offを試す |
Gatewayでenv:NAME未解決 | ログインシェルだけでなく常駐環境へ追加 |
Profile設定と保存は設定を参照してください。