环境变量

先用 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 可检查引用健康状态，不会显示密钥。目录和手动配置见配置文件与设置入口。