与一个协同工作的智能体一起阅读、构建、调试和审查代码。
使用相同的工具进行网络安全研究、技术调查和日常自动化。
Alter Zero 是一个用 Rust 编写的开源 AI 编码智能体。它直接在你的项目中工作：读取文件、进行编辑、运行命令并检查结果，而你可以同时在终端中跟进。编码是它的核心，同时它也具备灵活性，可利用你现有的工具调查安全问题、探索陌生的系统并自动化任务。
| 你将获得 | 为何重要 |
|---|---|
| 可跟进的工作过程 | 实时命令输出、可读的差异对比和任务清单让进度一目了然。 |
| 对执行的控制 | 选择权限模式、审查提议的更改，并在智能体工作时进行引导。 |
| 自由选择模型 | 通过受支持的订阅或 API 密钥连接，或使用 Ollama 运行本地模型。 |
| 充足的扩展空间 | 添加专业子智能体、可复用技能、生命周期钩子和 MCP 服务器，以契合你的工作流程。 |
| 原生的终端体验 | 单个 Rust 二进制文件，支持持久会话、内联图像和键盘驱动的控制。 |
Alter Zero 可在现代终端中运行于 Linux（x86_64、arm64）和 macOS（Intel、Apple silicon）。
在 Linux 或 macOS 上只需一行：
curl -fsSL https://raw.githubusercontent.com/linuztx/alter-zero/main/install.sh | sh
它会为你的机器选择对应的构建版本，对照发布时公布的校验和验证其 SHA-256，将 alter-zero 安装到 ~/.local/bin，并在该目录不在你的 PATH 中时告知你。
或者使用 npm 安装相同的构建版本：
npm install -g @linuztx/alter-zero
将 ALTER_ZERO_INSTALL_DIR 设置为安装到其他位置，或将 ALTER_ZERO_VERSION=vX.Y.Z 设置为固定某个发布版本。CHANGELOG.md 记录了各版本之间的变更。
ALTER_ZERO_INSTALL_DIR="$HOME/bin" ALTER_ZERO_VERSION=v0.1.0 \
sh -c "$(curl -fsSL https://raw.githubusercontent.com/linuztx/alter-zero/main/install.sh)"
手动安装时，每个版本的发布说明都会列出每个归档文件及其 SHA-256，因此你可以手动下载、校验并解压其中一个。
docker/ 围绕最新版本构建了一个小型无头 Kali Rolling 镜像，其中包含一套可用的命令行工具，适用于 Docker 或 Podman。只需一条命令即可构建它，并在你的某个文件夹上启动容器：
docker/build.sh ~/projects/site # add --engine podman for Podman
docker exec -it -e TERM -e COLORTERM -e TERM_PROGRAM -e KITTY_WINDOW_ID -e TMUX \
alter-zero-kali alter-zero
在复用器之外，-e 标志会传递你终端的身份信息，使图片以真实图像而非半块字符的形式渲染。容器指南涵盖了工作区、已发布的端口、粘贴图片以及添加工具。
在 tmux 内部，需在宿主机上启用 allow-passthrough，并为该 docker exec 显式选择外层终端的图像协议；tmux 说明中包含一个可直接运行的 Podman 示例。
你需要 rustup 和一个 C 编译器。仓库固定了 Rust 工具链，rustup 会自动安装它。
git clone https://github.com/linuztx/alter-zero.git
cd alter-zero
cargo install --path .
alter-zero
在没有配置提供商的情况下，Alter Zero 会打开一个离线演示，其中包含预设的对话轮次，以便你探索界面。要处理你自己的任务：
/login 并选择一个受支持的订阅、API 提供商或本地模型服务器。按照提示进行连接。/model 选择一个模型。Alter Zero 会记住你在此目录中的选择。通过 /login 添加的登录信息会保存到 ~/.alter-zero/.env，位于你的仓库之外。使用 / 浏览命令，或在空的输入框中按 ? 查看快捷键。
你也可以在启动前选择提供商。设置其 API 密钥变量和提供商 ID，然后启动应用。例如，使用 OpenRouter：
export OPENROUTER_API_KEY="your-api-key"
export ALTER_ZERO_PROVIDER=openrouter
alter-zero
使用 /model 选择一个模型，或在启动前将 ALTER_ZERO_MODEL 设置为其模型 ID。
从一个具体任务开始，让智能体与你一起完成它。
| 使用场景 | 可以这样提问 |
|---|---|
| 编码与调试 | “找出这个测试失败的原因，修复根本问题，并运行相关测试。” |
| 网络安全研究 | “审查这个仓库的安全漏洞。将每个发现追溯到代码并建议修复方案。” |
| 技术调查 | “追踪这个项目中的身份验证是如何工作的，并解释访问检查发生在哪里。” |
| 自动化 | “编写一个脚本，汇总这些日志并标记反复出现的错误。” |
连接到受支持的订阅服务、API 提供商或本地模型服务器。使用 /login 连接，使用 /model 选择模型。
| 提供商 | 连接方式 | 须知 |
|---|---|---|
| Agent Zero API | API 密钥。 | 通过 Agent Zero 代理访问 Venice.ai 模型，A0T 代币持有者享有每日免费额度。 |
| Venice | API 密钥。 | 直接通过 Venice 自己的 API 使用 Venice.ai 的私密、无审查模型——与 Agent Zero API 代理的目录相同，但使用你自己的账户访问。 |
| GitHub Copilot | 订阅，使用一次性设备代码。 | 模型能力（包括上下文窗口、视觉和推理级别）来自 Copilot。 |
| ChatGPT Codex | 订阅，使用 ChatGPT Plus 或 Pro 账户：浏览器登录，或在无头机器上使用一次性设备代码。 | 使用账户登录流程；无需粘贴 API 密钥。 |
| Anthropic | API 密钥或通过 Anthropic Console 进行账户登录。 | 无论使用哪种方式，用量都会计入你的 API 组织。 |
| Cline | API 密钥。 | 通过 Cline 的 OpenAI 兼容 API 使用 Cline 扩展和 CLI 背后的模型——包括 Anthropic、OpenAI、Google 等，费用计入你账户的额度。 |
| ClinePass | 订阅（$9.99/月），使用 Cline 账户登录。 | 在 Cline 精选的开源编码模型上享有 2-5 倍用量——该计划的 cline-pass/… 模型会出现在 /model 中。 |
| OpenRouter | API 密钥。 | 通过一个账户访问多个提供商的模型。 |
| Ollama | 将 Alter Zero 指向你的本地服务器；无需密钥。 | 使用本地托管的模型在你自己的机器上运行推理。 |
| Ollama Cloud | API 密钥。 | 使用由 Ollama 托管的开放模型。 |
页脚显示你当前使用的模型、思考模式、速度层级和上下文用量。Ctrl+T 循环切换模型支持的推理级别，列出速度层级的 ChatGPT 模型会为每个层级提供一个命令（/fast、/ultrafast），将其切换到该处理方式（回复更快，但会增加计划用量），发送图像前会检查视觉支持，并且在提供商允许的情况下，请求支持提示缓存。
任何具有 OpenAI 兼容 API 的服务，或本地服务器（如 LM Studio、llama.cpp 或 vLLM），都可以在 ~/.alter-zero/providers.toml 中添加。该文件是在上述提供商基础上追加，而不是替换它们：
[providers.groq]
name = "Groq"
api_key_url = "https://console.groq.com/keys"
[providers.groq.kwargs]
api_base = "https://api.groq.com/openai/v1"
用 /login 保存其密钥（此密钥从 GROQ_API_KEY 读取），然后用 /model 选择模型。两者都会重新读取该文件，因此无需重启。指定内置提供商的配置块只会更改它所设置的密钥。docs/user-providers.md 涵盖了所有密钥、无需密钥的本地服务器，以及每条错误消息的含义。