初始化设置
安装完成后，运行 anyy setup 把 Anyy 配置成可以实际对话的个人助手。这个向导可以完成模型连接、消息渠道以及图像、语音、网页搜索和 MCP 等可选能力的设置。
先打通一个模型和一次本地对话，再逐项添加消息渠道、备用模型或外部工具。这样出现问题时最容易判断是哪一层导致的。
开始前的准备
设置向导需要交互式终端。模型连接至少准备一种：
- 服务商 API Key；
- Anyy 支持的订阅账号登录；
- 已经启动的 Ollama 或 LM Studio；
- OpenAI-compatible 或 Anthropic-compatible 接口。
配置默认 Profile：
anyy setup
配置指定 Profile 或 Home：
anyy --profile work setup
anyy setup --home /path/to/anyy-home
--profile 是全局参数，必须放在 setup 前；--home 是子命令参数，放在后面。
Quick setup 和 Full setup
向导首先让你选择设置范围：
| 模式 | 包含内容 |
|---|---|
| Quick setup | 服务商、认证、主模型、可选的备用模型，以及消息渠道 |
| Full setup | Quick setup 的全部内容，再加图像、视频、语音、网页搜索和 MCP |
两种模式都会在最后显示一次完整变更摘要。只有确认 Write these changes? 后，Anyy 才会写入本地配置。
设置主模型
在 Provider & Model 中依次选择：
- 模型服务商；
- 该服务商提供的认证方式；
- 所需的地址和凭据；
- 主模型。
如果服务商支持模型列表，Anyy 会实时读取并供你选择；兼容接口或本地服务也可以要求手动填写准确的模型 ID。
常见选择如下：
| 你已有的连接 | 向导中的选择 |
|---|---|
| OpenAI API Key | OpenAI → OpenAI API key |
| ChatGPT 订阅 | OpenAI → ChatGPT subscription (Codex) |
| Anthropic API Key | Anthropic → Anthropic API |
| Claude Code 订阅 | Anthropic → Claude Code subscription |
| 本地模型 | Ollama 或 LM Studio |
| 兼容服务 | OpenAI-compatible 或 Anthropic-compatible |
以当前安装版本的向导列表为准：它只展示这一版本真实实现的服务商、协议和认证组合。
兼容接口可能收到提示词、上下文、附件和请求元数据。只填写你自己运营或明确信任的地址。
只修改模型
不需要重新走消息渠道和工具设置时，运行：
anyy setup model
确认写入后，如果当前 Gateway 可连接，Anyy 会让运行中的服务商配置重新加载；否则，新配置会在下次启动运行时生效。
添加备用模型
Quick setup 和 Full setup 都会询问是否设置 fallback。第一次使用建议先跳过，等主模型验证正常后再运行：
anyy setup model fallback
备用模型按保存顺序组成路由链，前提是主模型已经配置完成。它用于当前目标不可用时选择替代目标，不能修复无效凭据，也不能替代服务商自身的可用性检查。
连接消息渠道
在 Messaging 中选择一个平台，或者暂时跳过。以后只设置消息渠道可以运行：
anyy setup channel
不同平台会要求账号标识、访问策略、Webhook 字段和凭据。确认写入渠道变更后，Anyy 会在需要时安装并启动常驻 Gateway 服务，让消息连接在终端关闭后继续工作。
支持的平台、配对和诊断方式见消息平台。
Full setup 的可选能力
Full setup 还可以设置：
- 图像理解；
- 视频理解；
- 图像生成；
- 文本转语音和语音转文字；
- 网页搜索；
- 一个或多个 MCP Server。
这些项目都可以跳过。外部服务可能有独立的凭据、数据处理规则和费用，只开启你明确需要的能力。
确认写入
最后的 Review Changes 会列出服务商、主模型、Endpoint、凭据数量、fallback、消息渠道、可选能力和 MCP。逐项检查后再确认：
Write these changes? [Y/n]
成功时会显示 setup complete，随后可以运行：
anyy status
anyy config
anyy
在最终确认前取消，本地暂存设置不会写入；向导中尚未最终批准的渠道动作也会被放弃。
配置保存在哪里
每个 Profile 都有自己的 Home：
| 内容 | 位置 |
|---|---|
| 服务商、模型、路由和能力配置 | <PROFILE_HOME>/config.yaml |
| Anyy 管理的凭据 | <PROFILE_HOME>/secrets/ |
| 会话和运行状态 | <PROFILE_HOME>/state.db |
凭据与 config.yaml 分开保存，文件权限为 0600。anyy config 会显示实际路径及凭据引用是否有效，但不会输出密钥内容。
专项设置命令
anyy setup [--home PATH]
anyy setup model [--home PATH]
anyy setup model fallback [--home PATH]
anyy setup channel [--home PATH]
anyy setup channel CHANNEL [--home PATH] \
[--set INPUT=VALUE] \
[--sensitive-fd INPUT=FD] \
[--external-locator-fd INPUT=FD]
最后一种形式用于非交互渠道配置。敏感值通过文件描述符传入，避免直接出现在命令历史和进程参数中。
常见问题
| 现象 | 处理方法 |
|---|---|
提示 requires an interactive terminal | 在真实交互终端中运行设置向导 |
| API Key 留空后设置退出 | 重新运行 anyy setup model，输入有效 Key 或换用其他认证方式 |
| Ollama/LM Studio 没有模型 | 先启动本地服务，确认地址和已安装模型，再重试 |
| 订阅登录没有完成 | 完成浏览器或设备登录；终端流程已过期时重新运行向导 |
| 配置完成却看不到变化 | 用 anyy config 核对当前 Profile 和 Home |
| 消息渠道无法连接 | 运行 anyy channel doctor CHANNEL，修正后执行 anyy channel reload |