快速入门
从零到一次可用对话的最快路径。大约五分钟，每个步骤一条命令。本页刻意保持简短， 任何想深入了解的内容都通过链接指向对应的详细页面。
适用人群
你想立即在 macOS 或 Linux 上试用 Anyy，并在阅读其他内容之前先完成一次真正 的对话。你能熟练运行几条 shell 命令。你不需要先理解架构、配置后台服务或接入 消息平台就能开始——这些都留到后面的添加下一层功能。
最快路径
四条命令。前三条带你完成一次可用对话，最后一条用于验证。
curl -fsSL https://anyy.ai/install.sh | sh # 1. 安装
anyy setup # 2. 配置 provider 与模型
anyy # 3. 开始对话（TUI）
anyy status # 验证（在另一个终端）
无参数运行 anyy 会打开终端应用，并为你启动一个内嵌的 gateway——最快路径
上没有单独的“启动服务”步骤。下文逐条讲解这些命令。
1. 安装 Anyy
Anyy 以单个名为 anyy 的原生 Go 二进制文件分发。
通过发布产物安装
官方的一行安装脚本会为你的操作系统和架构下载经过校验和验证的发布版本，并安装到你 的主目录下。它不需要 root，也不会修改你的 shell 启动文件：
curl -fsSL https://anyy.ai/install.sh | sh
确认它已进入 PATH：
anyy --version
Anyy (anyy) version v0.1.57 channel stable commit 8627a748340f built 2026-06-15T08:03:45Z
如果提示找不到命令，请将入口目录（通常是 ~/.local/bin）加入 PATH。完整步骤、
可选项以及主目录结构见安装。
从源码构建
如果你有 Go 1.26+ 工具链，可以自行构建：
make build
这会生成 dist/anyy。如何将本地构建提升为常驻安装，见源码构建章节。
2. 运行初始设置
首次使用时，运行交互式向导来选择 provider、完成认证并选定默认模型：
anyy setup
向导会引导你完成 provider 选择、默认模型、可选的 fallback 路由、可选能力以及消息
平台配置。其中任何部分之后都可以重新运行（anyy setup model、
anyy setup channels……）。完整参考见设置。
Anyy 与具体 provider 无关。provider 和模型是你在此处选择的可配置后端—— Anyy 自身始终标识为 Anyy。
选择 Provider
在向导中选择你的 provider 并完成其认证。之后若只想重新配置这一项：
anyy setup model
配置默认模型
同一条 anyy setup model 步骤会设置新会话使用的默认模型。若要在多个模型间添加
自动 fallback 路由，运行 anyy setup model fallback。详情见模型设置。
配置的存储方式
设置会在 Anyy 主目录（默认 ~/.anyy）下写入 config.yaml，并将凭据单独
存放在 secrets/ 下。不会向你的 shell 配置文件写入任何内容。完整结构见配置存储方式。
3. 运行第一次对话
与 Anyy 对话有两种方式。第一次对话请用 TUI——它是自包含的。
启动 TUI
anyy
无参数时，anyy 会启动交互式终端应用。如果没有正在运行的 gateway，TUI 会
自动启动一个内嵌的 gateway，所以这一条命令就够了。输入消息、按回车，回复就会
流式返回。完整指南见 TUI。
使用一次性 chat
若要发送单条提示并在 shell 中拿到答复——便于脚本化——使用 anyy chat：
anyy chat "Summarize what you can help me with."
与 TUI 不同，一次性 chat 需要一个正在运行的 gateway。如果出现
Could not create chat session … dial unix … no such file or directory，请先启动
gateway：
anyy gateway start
anyy chat "Hello"
加上 --json 可获得机器可读输出。角色、会话、审批和退出码见 Chat。
4. 验证会话功能
在第二个终端中确认运行时是否健康：
anyy status
◆ Anyy status
Gateway running
Profile default
Default role default
Home /Users/you/.anyy
Timezone Asia/Shanghai (host)
Gateway running 表示你的对话由一个存活的 gateway 提供服务。要更深入地检查 provider、
存储和能力的健康状况，运行：
anyy doctor
你发送的每条消息都属于一个会话，会话会在重启之间以及跨界面（TUI、一次性、消息 平台）之间持续保留。验证一下：退出 TUI 后从上次的位置继续：
anyy --resume SESSION_ID
关于连续性、命名和搜索的更多内容见会话。
5. 尝试核心功能
第一次会话中值得试一试的几件事。
使用终端
让 Anyy 做一些真实的工作，并在过程中按需审批：
List the files in my current directory and tell me which are largest.
在会改变状态或风险较高的操作前，Anyy 会弹出审批卡片；普通只读查询不需要你 逐一确认。命令行入口的组织方式见 CLI 接口。
斜杠命令
在 TUI 中输入 / 打开命令菜单——列出或恢复会话、开始新会话、切换模型、查看状态、
压缩长上下文等。见 TUI 斜杠命令。
多行输入
你可以直接在 TUI 输入框中粘贴或编写多行提示。输入相关的按键见 TUI 指南。
中断 Agent
如果回复跑偏了，按 Esc 即可中断并取回你的提示——无需等它写完。
6. 添加下一层功能
对话跑通之后，把 Anyy 扩展成一个常驻助手。
常驻运行
让 Anyy 在后台持续运行，使其随时可用——也让一次性 chat 和消息平台在没有打开
TUI 的情况下也能工作：
anyy gateway start
要将其安装为真正的服务（systemd、launchd）并设置自启动，见常驻运行。
消息平台
从聊天应用而非终端接触 Anyy：
anyy setup channels
支持的平台和账号配置见消息平台。
自动化与工具
用 cron 任务调度周期性工作：
anyy cron list
Skills
Skills 封装了可复用的能力。列出并安装：
anyy skills list
详情见 Skills。
MCP 服务器
通过 Model Context Protocol 连接外部工具：
anyy mcp status
详情见 MCP 集成。
Dashboard
打开会话、任务和运行时状态的本地 Web 视图：
anyy dashboard
详情见 Dashboard。
常见故障模式
| 现象 | 可能原因 | 解决方法 |
|---|---|---|
anyy: command not found | 入口目录不在 PATH 中 | 将 ~/.local/bin 加入 PATH 并重开 shell（详情） |
anyy chat → dial unix … no such file or directory | 没有运行中的 gateway | 运行 anyy gateway start 后重试（TUI 会自动为你启动一个） |
| 对话回复出现认证或模型错误 | provider 未配置 | 重新运行 anyy setup model |
anyy status 显示 Gateway stopped | gateway 未启动 | 运行 anyy gateway start，或直接启动 anyy |
| 设置时无法连接 provider | 网络或凭据问题 | 运行 anyy doctor 定位失败的子系统 |
恢复工具包
当出现异常时，下面这些只读命令会告诉你当前处于什么状态：
anyy status # gateway、profile、子系统的一行摘要
anyy doctor # provider、存储、消息平台的深度健康检查
anyy gateway status # 常驻 gateway 是否存活？
anyy --version # 确认 PATH 上是哪个构建
无需重新安装即可重新配置——重新运行相应的设置步骤（anyy setup model、
anyy setup channels）。结构化的问题与解决方法清单见故障排查。
快速参考
| 目标 | 命令 |
|---|---|
| 安装 | curl -fsSL https://anyy.ai/install.sh | sh |
| 配置 provider 与模型 | anyy setup |
| 开始对话（TUI） | anyy |
| 一次性提示 | anyy chat "…" |
| 检查状态 | anyy status |
| 健康检查 | anyy doctor |
| 启动常驻 gateway | anyy gateway start |
| 恢复会话 | anyy --resume SESSION_ID |
| 完整用法 | anyy --help |