33| 61| 34| 62|

🚀 AI 工具一键安装脚本

35| 63| 36| 64|

自动检测系统 · 一键安装 · 可视化进度 · 拒绝不兼容环境

37| 65| 38| 66|

39| 67| 40| 68|

📋 这是什么？

41| 69| 42| 70|

一个 智能检测 + 一键安装 的 Bash 脚本，帮你自动装上 Claude Code、Codex CLI 和 OpenCode CLI。

43| 71| 44| 72|

它会在安装前自动检查你的系统是否兼容，不支持的平台直接拒绝，避免装到一半才发现不行。

45| 73| 46| 74|

47| 75|

✨ 核心能力

48| 76|

🖥 自动检测系统：macOS、Ubuntu、Debian、Fedora、Arch、WSL2 全支持
🚫 拒绝不兼容：Windows 原生、不明 Linux 发行版、非 x86_64/ARM64 架构直接提示

📦 自动装依赖：Node.js 18+、Python3、Git 缺啥补啥

📊 可视化进度：旋转动画 + 进度条 + 彩色输出

🔬 安装后验证：自动跑版本检查，确认装成功

🧪 模拟模式：--dry-run 看会发生什么，不修改系统

56| 84|

57| 85| 58| 86|

59| 87| 60| 88|

⚡ 快速开始

61| 89| 62| 90|

复制下面这一行命令，贴到你的终端里，回车——脚本会自动检测系统、引导你选择安装。

63| 91| 64| 92|

65| 93| curl -fsSL https://4si.cc/tools/ai-tools-installer.sh | bash 66| 94| 67| 95|

68| 96| 69| 97| 70| 128| 71| 129|

🧪 先模拟看看（推荐第一次用）

72| 130| 73| 131|

不确定脚本会做什么？加上 --dry-run 模拟运行：

74| 132| 75| 133|

76| 134| curl -fsSL https://4si.cc/tools/ai-tools-installer.sh | bash -s -- --dry-run 77| 135| 78| 136|

79| 137| 80| 138| 81| 145| 82| 146|

83| 147| 84| 148|

🖥 系统兼容矩阵

85| 149| 86| 150|

脚本在安装前会精确检测你的系统，不合适的直接拒绝：

87| 151| 88| 152|

89| 153| 90| 154| 91| 155| 92| 156| 93| 157| 94| 158| 95| 159| 96| 160| 97| 161| 98| 162| 99| 163| 100| 164| 101| 165| 102| 166|

系统/环境	检测方式	状态	说明
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`	❌ 直接拒绝	架构不支持

103| 167| 104| 168|

105| 169| 106| 170|

📸 运行效果预览

107| 171| 108| 172|

   109|   173|╔══════════════════════════════════════════════╗
   110|   174|║        🤖 AI 工具一键安装脚本 v2.0           ║
   111|   175|║   Claude Code · Codex CLI · OpenCode CLI     ║
   112|   176|╚══════════════════════════════════════════════╝
   113|   177|
   114|   178|🔍 第一步：检测当前系统环境
   115|   179|
   116|   180| ✅ 系统: macOS 14.5 (arm64)
   117|   181| ✅ 包管理器: Homebrew 已就绪
   118|   182|
   119|   183|📋 请选择要安装的 AI 工具：
   120|   184|
   121|   185|  1) 🤖 Claude Code      — Anthropic 的 CLI 编程助手
   122|   186|  2) 🚀 Codex CLI         — OpenAI 的命令行助手
   123|   187|  3) 🔓 OpenCode CLI      — 开源、不挑模型的 CLI 助手
   124|   188|  4) 🎯 全部安装           — 三件套一键全装
   125|   189|  0) ❌ 退出
   126|   190|

127| 191| 128| 192|

129| 193| 130| 194|

🔧 手动下载（不通过 curl | bash）

131| 195| 132| 196|

如果你不喜欢 curl | bash 的安全方式，可以手动下载后执行：

133| 197| 134| 198|

135| 199|

# 下载脚本

   136|   200|wget https://4si.cc/tools/ai-tools-installer.sh

   137|   201|# 查看内容（可选）

   138|   202|less ai-tools-installer.sh

   139|   203|# 执行

   140|   204|bash ai-tools-installer.sh

141| 205|

142| 206| 143| 207|

或者直接 📥 点击下载脚本。

144| 208| 145| 209|

146| 210| 147| 211|

🩺 FAQ

148| 212| 149| 213|

Q1: 装完就能直接用吗？

150| 214|

工具装好之后，还需要配置 API Key 才能调用 AI。详见：Claude Code 配置与认证、Hermes Agent 配置。

151| 215| 152| 216|

Q2: Windows 用户怎么用？

153| 217|

原生 Windows 不支持。请先安装 WSL2（Windows Subsystem for Linux），然后在 WSL 的 Ubuntu 终端中运行脚本。安装 WSL2 只需一条命令：wsl --install（管理员 PowerShell）。

154| 218| 155| 219|

Q3: 脚本会不会搞坏我的系统？

156| 220|

不会。脚本只做三件事：安装 Node.js/Python3（如果缺的话）、npm install -g 装工具、验证安装。先用 --dry-run 跑一遍确认没意外。

157| 221| 158| 222|

Q4: Ubuntu 20.04 以下能用吗？

159| 223|

脚本会给出警告但允许继续。但 Node.js 20 可能需要额外的 PPA，成功率不如 20.04+。强烈建议升级系统或换用更新的版本。

160| 224| 161| 225|

Q5: 我已经装过其中一个了，再跑会怎样？

162| 226|

脚本会检测已安装的工具，✅ 已安装 跳过，只装你没装的。不会重复安装。

163| 227| 164| 228|

Q6: 我想装在服务器上，支持吗？

165| 229|

✅ 完全支持。特别推荐 Ubuntu 20.04+ 的云服务器，装完后配合 Hermes Agent 可实现 24 小时在线 AI 助手。

166| 230| 167| 231|

Q7: 安装失败怎么办？

168| 232|

看终端里的 ❌ 红色提示。最常见原因：网络问题（国内用户需要科学上网访问 npm registry）、权限问题（脚本已用 sudo）。详见常见问题与故障排除。

169| 233| 170| 234|

Q8: 和 Hermes Agent 安装脚本有什么区别？

171| 235|

本脚本装的是 AI 编程 CLI 工具（Claude Code/Codex/OpenCode）。Hermes Agent 是另一个独立的 AI 管家系统，需要单独安装，见 Hermes Agent 安装入门。

172| 236| 173| 237|

174| 238| 175| 239|

⚠ 常见安装问题与避坑

176| 240| 177| 241|

178| 242| 179| 243| 180| 244| 181| 245| 182| 246| 183| 247| 184| 248|

坑	正确做法
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 放行

185| 249| 186| 250|

187| 251| 188| 252|

标签：#AI #教程 #安装脚本 #ClaudeCode #Codex #OpenCode

189| 253| 190| 254|