速查区

• 项目地址：https://github.com/mooi-max/all-agent
• 功能：一站式安装/更新/配置 8 款终端 AI Agent
• 支持的 Agent：Claude Code、Codex CLI、Gemini CLI、openclaw、hermes、reasonix、deepseek tui、opencode
• 安装方式：下载 Release 包解压运行，或 sudo install 全局安装
• 核心特性：TUI 界面、批量安装、自动备份配置、API Key 管理

详细内容

项目简介

all-agent 是一个面向 Linux 终端的 AI Agent 快速安装与配置工具。它用 TUI（终端用户界面）把环境检查、Agent 安装/更新、API Key 创建、模型选择和配置写入集中到一个界面里，目标是让用户少记命令、少改配置文件，打开工具就能完成主要流程。

支持的 Agent

当前支持以下 8 款终端 AI Agent：

Agent	安装包	命令	备注
Claude Code	@anthropic-ai/claude-code	claude	使用 Anthropic-compatible 配置
Codex CLI	@openai/codex	codex	使用 OpenAI-compatible 配置
Gemini CLI	@google/gemini-cli	gemini	使用 Gemini API Key
openclaw	openclaw	openclaw	建议 Node.js 22.19+ 或 24+
hermes	PyPI hermes-agent	hermes	使用 venv 安装到 ~/.local/bin
reasonix	reasonix	reasonix	使用 OpenAI-compatible 配置
deepseek tui	codewhale	codewhale	CodeWhale 是 deepseek tui 的后续包
opencode	opencode-ai	opencode	使用 OpenAI-compatible provider

核心功能

环境检测与安装

• 首次启动自动检测 Node.js / npm，并检测已安装 Agent 和版本
• 缺少 Node.js / npm 时，可在界面中按 Enter 确认安装
• 安装页可直接按 Enter 安装当前 Agent，也可用 Space 勾选多个 Agent 后批量安装/更新
• npm 安装默认先用阿里/npmmirror 源，失败后自动切换官方源
• Hermes 会使用独立 venv 安装，避免污染系统 Python

配置管理

• 配置页只显示已安装的 Agent，避免给不存在的工具写配置
• 支持创建 DeepSeek、Mimo、Gemini、自定义 Provider 的 API Key
• 创建 API Key 时会测试模型列表，测试失败也可以强制填写模型保存
• 应用 API Key 前有确认窗口，避免误写配置
• API Key 和模型会写入各 Agent 的真实配置文件
• 写入前自动备份已有配置，密钥相关文件会尽量设置为 chmod 600

快速使用

从 GitHub Releases 下载 Linux x86_64 压缩包后：

tar -xzf all-agent-linux-x86_64.tar.gz
cd all-agent-linux-x86_64
chmod +x all-agent
./all-agent

如果希望全局使用：

sudo install -m 755 all-agent /usr/local/bin/all-agent
all-agent

界面和按键

程序包含 4 个页面：

页面	用途
帮助	查看工具功能和推荐流程
环境	检测 Node.js/npm，提示 Hermes 所需 Python/venv/pip
安装	安装或更新 Agent，显示当前版本
配置	创建 API Key，选择模型，应用到已安装 Agent

常用按键：

按键	作用
Tab	切换页面
↑ / ↓	移动光标
← / →	配置页切换左右区域
Space	勾选/取消勾选
Enter	确认、安装、创建、应用
Esc	返回或取消弹窗
f	API Key 测试失败时强制填写模型
d	配置页删除已保存 API Key
Ctrl+C	退出确认，再按一次可强制退出

配置写入位置

all-agent 会把 API Key 和模型写入对应工具实际读取的位置：

Agent	配置位置
Claude Code	~/.claude/settings.json，~/.claude/all-agent.env
Codex CLI	~/.codex/config.toml，~/.codex/auth.json
Gemini CLI	~/.gemini/settings.json，~/.gemini/all-agent.env
openclaw	~/.openclaw/openclaw.json
hermes	~/.hermes/config.yaml，~/.hermes/.env
reasonix	~/.config/reasonix/config.toml，~/.config/reasonix/all-agent.env
deepseek tui / CodeWhale	~/.codewhale/config.toml
opencode	~/.config/opencode/opencode.json

Provider 地址转换

DeepSeek 和 Mimo 会按目标 Agent 自动转换地址：

Provider	OpenAI-compatible	Anthropic-compatible
DeepSeek	https://api.deepseek.com	https://api.deepseek.com/anthropic
Mimo	https://token-plan-cn.xiaomimimo.com/v1	https://token-plan-cn.xiaomimimo.com/anthropic

对于明确只支持 OpenAI-compatible 或 Anthropic-compatible 的 Agent，all-agent 会提示不兼容，不会静默写入无效配置。

从源码构建

需要 Rust 工具链：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env"

构建并运行：

cargo build --release
./target/release/all-agent

注意事项

• 当前主要面向 Linux x86_64
• 中文 TUI 需要 UTF-8 终端环境
• npm 源只在安装命令中临时指定，不会修改用户全局 npm 配置
• 修改 Agent 配置前会自动备份，但仍建议保留自己的重要配置
• 写入 shell 环境变量或 ~/.local/bin PATH 后，新开的终端会自动生效

总结

all-agent 解决了终端 AI Agent 安装配置分散的痛点，把 8 款主流 Agent 的管理集中到一个 TUI 界面。对于需要在 Linux 终端使用多个 AI Agent 的开发者来说，这是一个非常实用的工具。