🚀 AI 工具一键安装脚本
自动检测系统 · 一键安装 · 可视化进度 · 拒绝不兼容环境
📋 这是什么？
一个 智能检测 + 一键安装 的 Bash 脚本，帮你自动装上 Claude Code、Codex CLI 和 OpenCode CLI。
它会在安装前自动检查你的系统是否兼容，不支持的平台直接拒绝，避免装到一半才发现不行。
✨ 核心能力
- 🖥 自动检测系统：macOS、Ubuntu、Debian、Fedora、Arch、WSL2 全支持
- 🚫 拒绝不兼容：Windows 原生、不明 Linux 发行版、非 x86_64/ARM64 架构直接提示
- 📦 自动装依赖：Node.js 18+、Python3、Git 缺啥补啥
- 📊 可视化进度：旋转动画 + 进度条 + 彩色输出
- 🔬 安装后验证：自动跑版本检查，确认装成功
- 🧪 模拟模式：
--dry-run看会发生什么，不修改系统
⚡ 快速开始
复制下面这一行命令，贴到你的终端里，回车——脚本会自动检测系统、引导你选择安装。
curl -fsSL https://4si.cc/tools/ai-tools-installer.sh | bash
🧪 先模拟看看（推荐第一次用）
不确定脚本会做什么？加上 --dry-run 模拟运行：
curl -fsSL https://4si.cc/tools/ai-tools-installer.sh | bash -s -- --dry-run
🖥 系统兼容矩阵
脚本在安装前会精确检测你的系统，不合适的直接拒绝：
| 系统/环境 | 检测方式 | 状态 | 说明 |
|---|---|---|---|
| macOS 13+ | sw_vers + Homebrew 检测 | ✅ 完全支持 | M1/M2/M3 原生支持 |
| macOS < 12 | 版本号检查 | ⚠ 警告后继续 | 部分工具可能受限 |
| WSL2 (Ubuntu) | /proc/version + os-release | ✅ 完全支持 | Windows 用户首选方案 |
| WSL1 | 内核版本检测 | ⚠ 警告后继续 | 建议升级到 WSL2 |
| Ubuntu 20.04+ | /etc/os-release | ✅ 完全支持 | 最推荐的 Linux 发行版 |
| Ubuntu < 20.04 | 版本号检查 | ⚠ 警告后继续 | 建议升级 |
| Debian 11+ | ID 匹配 | ✅ 完全支持 | |
| Fedora / RHEL / CentOS / Rocky / Alma | ID 匹配 | ⚠ 部分支持 | 通过 dnf 安装依赖 |
| Arch / Manjaro / EndeavourOS | ID 匹配 | ⚠ 部分支持 | 通过 pacman 安装依赖 |
| Windows 原生（cmd/PowerShell/Git Bash） | uname -s 检测 MINGW/MSYS/CYGWIN | ❌ 直接拒绝 | 给出 WSL2 安装教程 |
| 其他 Linux（openSUSE, Alpine...） | 未匹配 ID | ❌ 直接拒绝 | 给出手动安装链接 |
| 非 x86_64/ARM64 | uname -m | ❌ 直接拒绝 | 架构不支持 |
📸 运行效果预览
╔══════════════════════════════════════════════╗ ║ 🤖 AI 工具一键安装脚本 v2.0 ║ ║ Claude Code · Codex CLI · OpenCode CLI ║ ╚══════════════════════════════════════════════╝ 🔍 第一步：检测当前系统环境 ✅ 系统: macOS 14.5 (arm64) ✅ 包管理器: Homebrew 已就绪 📋 请选择要安装的 AI 工具： 1) 🤖 Claude Code — Anthropic 的 CLI 编程助手 2) 🚀 Codex CLI — OpenAI 的命令行助手 3) 🔓 OpenCode CLI — 开源、不挑模型的 CLI 助手 4) 🎯 全部安装 — 三件套一键全装 0) ❌ 退出
🔧 手动下载（不通过 curl | bash）
如果你不喜欢 curl | bash 的安全方式，可以手动下载后执行：
# 下载脚本
wget https://4si.cc/tools/ai-tools-installer.sh
# 查看内容（可选）
less ai-tools-installer.sh
# 执行
bash ai-tools-installer.sh
或者直接 📥 点击下载脚本。
🩺 FAQ
Q1: 装完就能直接用吗？
工具装好之后，还需要配置 API Key 才能调用 AI。详见：Claude Code 配置与认证、Hermes Agent 配置。
Q2: Windows 用户怎么用？
原生 Windows 不支持。请先安装 WSL2（Windows Subsystem for Linux），然后在 WSL 的 Ubuntu 终端中运行脚本。安装 WSL2 只需一条命令：wsl --install（管理员 PowerShell）。
Q3: 脚本会不会搞坏我的系统？
不会。脚本只做三件事：安装 Node.js/Python3（如果缺的话）、npm install -g 装工具、验证安装。先用 --dry-run 跑一遍确认没意外。
Q4: Ubuntu 20.04 以下能用吗？
脚本会给出警告但允许继续。但 Node.js 20 可能需要额外的 PPA，成功率不如 20.04+。强烈建议升级系统或换用更新的版本。
Q5: 我已经装过其中一个了，再跑会怎样？
脚本会检测已安装的工具，✅ 已安装 跳过，只装你没装的。不会重复安装。
Q6: 我想装在服务器上，支持吗？
✅ 完全支持。特别推荐 Ubuntu 20.04+ 的云服务器，装完后配合 Hermes Agent 可实现 24 小时在线 AI 助手。
Q7: 安装失败怎么办？
看终端里的 ❌ 红色提示。最常见原因：网络问题（国内用户需要科学上网访问 npm registry）、权限问题（脚本已用 sudo）。详见 常见问题与故障排除。
Q8: 和 Hermes Agent 安装脚本有什么区别？
本脚本装的是 AI 编程 CLI 工具（Claude Code/Codex/OpenCode）。Hermes Agent 是另一个独立的 AI 管家系统，需要单独安装，见 Hermes Agent 安装入门。
⚠ 常见安装问题与避坑
| 坑 | 正确做法 |
|---|---|
| Windows 上直接跑，一堆报错 | 必须先装 WSL2，在 Ubuntu 终端里跑。脚本已经会拒绝 Windows 原生环境 |
| 国内的网络下载 npm 包很慢 / 卡住 | 设置 npm 镜像：npm config set registry https://registry.npmmirror.com，再重新运行 |
| 脚本提示 sudo 密码但你不知道 | 如果是自己的机器，用你登录的密码。如果是公司的机器，找 IT 要 sudo 权限 |
| 装了 Claude Code 但 claude 命令找不到 | 关闭终端重开，或运行 source ~/.bashrc（Linux）/ source ~/.zshrc（macOS） |
| curl 报 SSL 证书错误 | 确认系统时间正确，timedatectl 检查。老系统可能需 apt-get install ca-certificates |
| 公司网络有防火墙拦截 | 检查是否允许访问 npmjs.org 和 registry.npmjs.org，或联系 IT 放行 |
标签：#AI #教程 #安装脚本 #ClaudeCode #Codex #OpenCode