信息层级：【有据可查】= 附官方文档或可信来源链接；【社区共识】= 社区用户普遍经验，未经官方确认；【待考察/推测】= 推测或暂未能核实，请谨慎对待。
0. 一句话建议（实践建议）
先想办法装好"第一个"能用的 Agent，然后把剩下的下载、配置、排错工作交给这个 Agent。
这是经验判断【社区共识（不少用户有类似做法）/ 待考察（效果因人而异）】。理由很简单：安装过程中 80% 的麻烦是环境问题（Node 版本、PATH、权限、镜像源、证书），而这些恰恰是 Agent 最擅长读报错、查文档、一步步试的事。
重要提醒：让 Agent 帮你装软件时，请保持沙箱/审批开启，并只让它从官方渠道下载。curl ... | bash 这类命令等于"信任远端脚本"，请确认域名是官方域名。
1. 安装难度总览（主观打分）
⭐ 越多越难。评分是本文对一位中国大陆普通新手的主观估计【待考察/推测】，不同网络、系统、地区差异很大。
| 工具 | 官方安装方式（有据可查） | 前置依赖 | 国内新手难度 | 主要卡点 |
|---|---|---|---|---|
| dsh | npx @deepseek-ai/dsh web；或源码 pnpm install && pnpm run build（README） |
Node.js（源码需 pnpm） | ⭐⭐ | npm 下载慢、Node 版本 |
| Codex CLI | npm install -g @openai/codex（文档） |
Node.js | ⭐⭐⭐⭐ | 账号、登录、网络 |
| Claude Code | curl -fsSL https://claude.ai/install.sh | bash；Windows PowerShell irm https://claude.ai/install.ps1 | iex（文档） |
无（原生安装器） | ⭐⭐⭐⭐⭐ | 地区限制、账号风控 |
| Grok Build | curl -fsSL https://x.ai/cli/install.sh | bash 或 npm install -g @xai-official/grok（文档） |
无 / Node.js | ⭐⭐⭐⭐ | 账号、网络 |
| ZCode | 官网下载桌面端（文档） | 无 | ⭐ | 较少 |
| Cursor | 官网下载安装包（https://cursor.com） | 无 | ⭐⭐⭐ | 登录与付费 |
| Qoder | 官网下载 IDE / CLI（https://qoder.com，国内版 https://docs.qoder.cn） | 无 | ⭐～⭐⭐ | 较少 |
| WorkBuddy | 官网下载桌面端（https://www.workbuddy.ai） | 无 | ⭐ | 较少 |
| 千问办公 | 网页 https://qwenwork.cn，钉钉扫码/大陆手机号（文档）；也有多平台桌面客户端（2026-10 修订，见千问办公使用：个人空间、扩展与文档交付） | 浏览器或桌面端 | ⭐ | 几乎没有 |
| OpenClaw | 中文文档推荐 Node 24，Windows 建议 WSL2；npm install -g openclaw@latest 后 openclaw onboard --install-daemon（中文文档，第三方中文站，以 官方文档 为准） |
Node.js、（Win）WSL2 | ⭐⭐⭐⭐ | 常驻进程、安全加固 |
国内新手安装难度（主观 1–5 分，非测量数据）
| 工具 | 难度 | 直观条 |
|---|---|---|
| 千问办公 | 1 | ■□□□□ |
| WorkBuddy | 1 | ■□□□□ |
| ZCode | 1 | ■□□□□ |
| Qoder | 1.5 | ■▪□□□ |
| dsh | 2 | ■■□□□ |
| Cursor | 3 | ■■■□□ |
| Codex | 4 | ■■■■□ |
| Grok Build | 4 | ■■■■□ |
| OpenClaw | 4 | ■■■■□ |
| Claude Code | 5 | ■■■■■ |
2. 为什么"海外"工具普遍更难？
不是因为安装命令更复杂——命令往往就一行。难点在"命令之外"：
- 账号：注册需要被支持地区的手机号/邮箱，有的还要求付款方式。【有据可查：如 Anthropic 支持地区、Antigravity 地区列表】
- 网络：下载源、登录回调、API 接口都在海外。（网络话题见网络、地区与建站基础：把地址、账号和服务器分清，务必合规。）
- 风控：账号所在地、支付卡地区、使用 IP 不一致时，可能触发风控。【社区共识】
- 更新：原生安装器会自动更新（Claude Code 文档写明 native installs update automatically）【有据可查】，网络不稳时更新可能失败。
国内产品（ZCode、Qoder CN、WorkBuddy、千问办公）的优势在于网络、账号、支付都本地化，对新手几乎无门槛。【社区共识】
3. 通用前置：Node.js、Git、终端
多数 CLI Agent 依赖 Node.js。新手最常踩的坑：
| 问题 | 表现 | 处理思路 |
|---|---|---|
| Node 版本过旧 | 报语法错误、Unsupported engine |
安装官方 LTS 版本：https://nodejs.org/ |
| 全局安装权限 | EACCES |
不要动辄 sudo npm -g；用 nvm 等版本管理器【社区共识】 |
| npm 下载慢 | 卡在 idealTree |
可考虑国内镜像，如 npmmirror（https://npmmirror.com/）；注意镜像同步可能有延迟，新发布的包可能暂时拉不到【社区共识】 |
| 命令找不到 | command not found |
检查 PATH；Claude Code 文档提示将 ~/.local/bin 加入 PATH【有据可查：troubleshoot】 |
| Windows 兼容 | 各种路径/脚本问题 | 部分工具推荐 WSL2（如 OpenClaw 中文文档） |
💡 新手小技巧：装完任何工具后先运行
工具名 --version，能输出版本号再进行下一步。
4. 实操剧本："先装一个，再让它装其它"
4.1 选第一个 Agent：选"你当前环境最容易装上的"
- 在中国大陆、无特殊网络条件：可从国内桌面端产品或 dsh + 国内模型 API 起步。
- 已有合规的海外账号与网络：从你已订阅的那家起步（例如有 ChatGPT 订阅就先装 Codex）。
4.2 让 Agent 干活的提示词模板
请帮我安装 <工具名>。要求：
1. 只参考官方文档 <官方文档链接>，先把你要执行的命令列给我看；
2. 先检查我的系统环境（操作系统、node、git 版本），不满足就告诉我怎么升级；
3. 不要使用 sudo，除非你先解释为什么必须；
4. 不要修改我家目录以外的系统文件；
5. 安装后运行 --version 验证，并把结果告诉我。
4.3 让 Agent 读报错
把完整报错粘给它，并加一句："先解释原因，再给方案，不要直接执行"。这一步是新手提升最快的环节。【社区共识】
5. 安全检查清单（安装任何 Agent 前）
- ☐ 下载链接/安装脚本域名是不是官方域名？（警惕搜索引擎广告位的仿冒站）【社区共识】
- ☐ 安装的 npm 包名是否与官方文档一字不差？（typosquatting 仿冒包是常见攻击）【社区共识】
- ☐ 该工具是否要求常驻后台、开放端口？（如 OpenClaw 这类需额外加固）
- ☐ 是否先在测试项目/虚拟机里试用？
- ☐ API Key 是否只放在环境变量或工具配置里，而不是贴进聊天、提交进 Git？
6. 本篇无法核实/需谨慎的点
- 难度星级为主观估计，无测量数据。
- ZCode、WorkBuddy、Qoder 的具体安装包平台支持（Win/Mac/Linux）未逐一核实，请看官网下载页。
- OpenClaw 安装步骤引用的是第三方中文文档站，以官方文档为准。
- npm 国内镜像的可用性与同步延迟随时变化。
小白练习：把本文流程逐项走通
练习目标：分清桌面安装包和终端命令，验证工具确实装好了。
上文已介绍概念、配置和操作示例。下面侧重第一次实际操作时的顺序、检查点和结果核对；需要查具体参数时回到对应小节。命令逐条输入，看到上一条的结果后再继续。
-
Windows 用户先从开始菜单打开 PowerShell；macOS 打开终端；Linux 打开系统终端。不要把终端命令输入浏览器地址栏。
-
先单独运行 node --version，再运行 npm --version，最后运行 git --version。逐条确认输出版本号；出现命令找不到时先处理对应依赖。
-
桌面工具下载与系统匹配的安装包；CLI 工具只复制所选工具那一行安装命令，不要一次安装表中所有工具。
-
安装完成后关闭终端，再重新打开一个窗口，让新 PATH 生效。运行所选工具的 --version 命令。
-
在文件管理器创建练习文件夹，再用 cd 切换进去，最后启动工具。先发一个只读任务，确认模型连接和项目目录都正确。