第5章 快速上手

快速上手

前提条件

需要以下任意一项：Antix 账号、Anthropic（Claude）订阅、OpenAI（ChatGPT/Codex）订阅，或某个服务商的 API key。

也可以使用离线模式，无需账号和 API key。

安装

Ante 以单个独立的二进制文件分发，没有任何外部依赖——下载即可运行。

curl -fsSL https://ante.run/install.sh | bash

默认安装到 ~/.ante/bin。如需安装到其他位置，请设置 ANTE_INSTALL_DIR：

curl -fsSL https://ante.run/install.sh | ANTE_INSTALL_DIR=/usr/local/bin bash

请以普通用户身份运行默认安装程序，不要使用 sudo。用 sudo 安装到用户目录会导致 ~/.ante 归 root 所有，Ante 将无法保存设置和输入历史，因此安装程序会拒绝这种组合。

macOS 的发布二进制文件已通过 Developer ID 签名并完成公证，Gatekeeper 会直接放行，无需手动绕过安全限制。

使用现有账号或 API key

如果你已经拥有上述账号或服务商的 API key，打开项目并启动 Ante：

cd your-project
ante

如果你的 API key 已在 shell 中导出，或者之前已通过 Ante 登录过，就可以直接发送提示了。Ante 会自动检测可用的凭据，使用其他服务商时无需登录 Antix。

Ante 支持检测 ANTHROPIC_API_KEY、OPENAI_API_KEY、GEMINI_API_KEY 等 key。完整的服务商列表及对应环境变量请参阅服务商目录。

第一次在 Ante 中使用账号？输入 /connect 并选择 Antix、Anthropic Subscription 或 OpenAI Subscription，然后在浏览器中完成登录。你也可以用 /welcome 粘贴 API key，或用 /providers 在已连接的服务商之间切换。

登录 Antix

若要从命令行连接 Antix 账号，请在启动会话前先登录：

ante auth login antix

在浏览器中完成登录后返回终端。Ante 会保存你的凭据，供后续会话使用。

打开项目并开始对话：

cd your-project
ante --provider antix

可以先试试这样的提示：解释一下这个项目的结构，以及主入口在哪里。

也可以在 TUI 中登录：运行 ante，输入 /connect 并选择 Antix。要使用其他服务商的 OAuth 登录或 API key，请参阅连接服务商。

快速示例

交互式会话

# 启动 TUI —— 与 agent 对话、批准工具调用、查看 diff
ante

无界面单次运行

# 运行一个任务后退出 `ante -p "add error handling to src/main.rs"`
通过标准输入管道传数据 # 将文件内容通过管道传入进行分析
`cat src/lib.rs | ante -p "review this code for bugs"`
切换到其他服务商 # 覆盖默认模型和提供商
`ante --provider openai --model gpt-6.1-sol -p "refactor this function"`
跳过工具调用审批 # YOLO 模式 — 自动批准所有工具调用
`ante --yolo -p "fix all clippy warnings"`
以服务器模式运行 # 启动长驻守护进程，便于程序化集成
`ante serve`
更新到最新版本 # 检查新发布版本并安装
`ante update`

# 单次试用开发渠道
`ante update nightly`

# 回退或固定到指定版本
`ante update --version v0.2.8`
下一步做什么？ 日常用例面向常见 TUI 工作流的专题指南 — 涵盖模型、文件、审批等。TUI 指南掌握交互式终端界面。Headless 模式所有 CLI 参数与输出格式。本地模型在你自己的硬件上运行模型。服务器模式通过 JSONL 以编程方式驱动 Ante。Skills 通过可移植的 Agent Skills 扩展 Ante。