快速开始
先让一条普通对话真正跑通,再添加渠道、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,不把保存回执当作成功调用 |