macOS / Linux 一键安装脚本

本文用于帮助 macOS、Linux、WSL、MSYS、Cygwin 或 Git Bash 用户通过统一入口安装和管理常用 AI CLI 工具，并配置卡皮巴拉 API。

安装器支持检测和安装：

• Codex
• Claude Code
• OpenClaw
• HermesAgent

安装器也会检测 Node.js、npm、当前 CLI 版本和 npm registry 最新版本。缺少 Node.js/npm 时，可以按提示自动安装 Node.js LTS 和 npm。

WARNING

配置 provider 前请先准备好自己的卡皮巴拉 API Key。API Key 等同于账户调用凭证，请不要发送给他人，也不要公开上传到截图、文章或代码仓库中。

使用方法

打开终端

macOS 用户可以在启动台或聚焦搜索中搜索 terminal，然后打开“终端.app”或 “Ghostty.app”。任选一个终端工具即可。

Linux 用户打开系统自带终端即可。

打开交互式菜单

复制下面命令并粘贴执行：

curl -fsSL https://mirror.kapibala.asia/install.sh | bash

脚本启动后会显示 Kapibala Logo 和系统检测结果，然后进入菜单。可以按菜单提示选择安装 Codex、Claude Code、OpenClaw、HermesAgent，或配置 Kapibala provider。

TIP

curl ... | bash 会占用标准输入传输脚本内容，安装器会自动从 /dev/tty 读取菜单输入，所以一行命令运行时仍然可以正常交互。

常用命令

查看当前状态

curl -fsSL https://mirror.kapibala.asia/install.sh | bash -s -- --status

状态页会显示：

• 当前操作系统
• Node.js / npm 是否已安装
• Codex / Claude Code / OpenClaw / HermesAgent 是否已安装
• 已安装工具的当前版本、最新版本和是否可更新

单独安装某个工具

curl -fsSL https://mirror.kapibala.asia/install.sh | bash -s -- --install codex
curl -fsSL https://mirror.kapibala.asia/install.sh | bash -s -- --install claude
curl -fsSL https://mirror.kapibala.asia/install.sh | bash -s -- --install openclaw
curl -fsSL https://mirror.kapibala.asia/install.sh | bash -s -- --install hermes

安装所有缺失工具

curl -fsSL https://mirror.kapibala.asia/install.sh | bash -s -- --all-missing

如需跳过确认提示，可以加 --yes：

curl -fsSL https://mirror.kapibala.asia/install.sh | bash -s -- --yes --all-missing

演练模式

演练模式只显示将要执行的操作，不会真正下载或安装：

curl -fsSL https://mirror.kapibala.asia/install.sh | bash -s -- --dry-run --all-missing

卸载工具

卸载只移除 CLI 包，不删除配置、账号、历史或本地数据。

curl -fsSL https://mirror.kapibala.asia/install.sh | bash -s -- --uninstall codex
curl -fsSL https://mirror.kapibala.asia/install.sh | bash -s -- --uninstall claude
curl -fsSL https://mirror.kapibala.asia/install.sh | bash -s -- --uninstall openclaw
curl -fsSL https://mirror.kapibala.asia/install.sh | bash -s -- --uninstall hermes

配置 Kapibala Provider

安装器支持把 Kapibala provider 写入 Codex 和 Claude Code 配置。

查看 provider 状态

curl -fsSL https://mirror.kapibala.asia/install.sh | bash -s -- --provider-status

配置当前线路

curl -fsSL https://mirror.kapibala.asia/install.sh | bash -s -- --configure-providers

首次配置时，安装器会提示输入 Kapibala API Key，并保存到：

~/.kapibala/api-key

切换线路

内置线路如下：

线路	URL	说明
primary	https://kapibala.asia/	默认线路
backup	https://kapibala.curb0331.cloud/	备用线路

切换到主线路：

curl -fsSL https://mirror.kapibala.asia/install.sh | bash -s -- --switch-provider primary

切换到备用线路：

curl -fsSL https://mirror.kapibala.asia/install.sh | bash -s -- --switch-provider backup

切换线路会保存选择到：

~/.kapibala/provider

并更新：

Agent	配置文件	写入内容
Codex	~/.codex/config.toml、~/.codex/auth.json	Kapibala provider 和 API Key
Claude Code	~/.claude/settings.json	ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY

自动化环境可以用环境变量传入 API Key：

KAPIBALA_API_KEY="你的令牌" curl -fsSL https://mirror.kapibala.asia/install.sh | bash -s -- --switch-provider primary

参数说明

参数	说明
--status	输出系统、Node.js、npm 和 AI CLI 的安装状态，然后退出
--provider-status	输出当前 Kapibala provider 线路和配置文件位置
--configure-providers	将当前 provider 线路写入 Codex / Claude Code 配置
--switch-provider <primary|backup|url>	切换 provider 线路并写入配置
--install-node	安装或修复 Node.js/npm
--download-codex-app	下载当前系统对应的 Codex 桌面端 App
--node-help	输出 Node.js/npm 前置依赖安装建议
--install <tool>	安装指定工具，支持 claude、codex、openclaw、hermes
--uninstall <tool>	卸载指定工具，只移除 CLI 包，不删除配置和数据
--all-missing	安装所有缺失的 AI CLI 工具
--dry-run	只打印将执行的安装/卸载命令，不下载、不执行
-y、--yes	跳过远程安装脚本或卸载确认提示
-h、--help	显示帮助信息

--dry-run 和 --yes 需要放在主命令前面，例如：

bash install.sh --dry-run --all-missing
bash install.sh --yes --install claude

常见问题

粘贴命令后没有执行怎么办？

有些终端在粘贴命令后，需要再按一次回车才会执行。

为什么状态页显示“当前版本：无法获取”？

这通常不代表安装失败。安装器已经检测到本机存在对应命令时，会显示 installed；“当前版本：无法获取”只表示安装器没有成功自动读取版本号。

可以手动执行下面命令检查：

codex --version
claude --version
openclaw --version
hermes --version

也可以检查 npm 全局包信息：

npm list -g --depth=0 @openai/codex
npm list -g --depth=0 @anthropic-ai/claude-code
npm list -g --depth=0 openclaw
npm list -g --depth=0 hermes-agent

配置后没有生效怎么办？

请依次检查：

• API Key 是否完整复制，前后没有多余空格。
• 账户余额是否充足。
• Codex、Claude Code 或其他 CLI 是否已经完全退出并重新打开。
• ~/.kapibala/api-key 是否存在。
• Codex 配置文件 ~/.codex/config.toml 和 ~/.codex/auth.json 是否存在。
• Claude Code 配置文件 ~/.claude/settings.json 是否存在。

如何查看配置文件？

可以在终端中执行：

ls -la ~/.kapibala
ls -la ~/.codex
ls -la ~/.claude

如需编辑配置文件，可以使用系统自带文本编辑器打开对应文件。