🤖安装 agent（趁早）
Claude Code 或 OpenCode，五分钟搞定。诀窍在于：现在就装上它，好让它替您配置机器剩下的一切。
这是整个旅程里最反直觉的秘诀：我们在其他一切之前先装代码 agent。
大多数教程让您花三个小时配置机器, 网络、防火墙、服务, 然后才在最后装上 AI，像一份奖赏。我们反着来。趁系统还光秃秃的时候，您现在就把 agent 装上，然后由它来帮您接上 Tailscale、Cloudflare、Ollama 等等一整套。您从「我敲着自己不懂的命令」变成「我描述我想要什么，我审一遍，我点头」。
Claude Code 还是 OpenCode：选哪个？
两者都是出色的命令行代码 agent。它们读您的项目、写文件、跑命令，并不断循环直到跑通为止。它们是本指南平等对待、一路跟到底的两个, 但它们不是仅有的选择。区别一句话说清：
- Claude Code : Anthropic 出品的 agent。您接上 Claude 模型（2026 年市面上写代码最强的模型）。安装极其简单，长任务上的可靠性顶尖。付费（订阅或 API）。
- OpenCode : 开源的 agent。同样的精神，但引擎由您挑：Claude、GPT，或者通过 Ollama 跑一个本地模型。如果您想要 100% 本地，或者在不同供应商之间切换，它再合适不过。
如果您想探索得更广，2026 年的版图很丰富, 它们全都遵循同一个原理（读、写、跑、循环）：
- Gemini CLI : Google 的命令行 agent，接的是 Gemini 模型。免费额度很慷慨。
- Codex CLI : OpenAI 的 agent，背靠 GPT 模型。
- Aider : 一个广受好评的开源 agent，围绕 git 设计（每次改动 = 一个干净的 commit），几乎兼容所有模型，本地的也算。
- Cline / Roo Code : 一些活在 VS Code 里而不是终端里的 agent，如果您更愿意留在编辑器里。
- Cursor、Windsurf : 围绕 AI 打造的完整代码编辑器，适合想要一站式体验的人。
共同的前提：Node 和一个干净的终端
两个 agent 都跑在 Node.js 上。我们用 nvm（版本管理器）干净地安装它，而不是用系统软件包，以避开权限上的麻烦。
# 安装 nvm（Node 版本管理器）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
# 重新加载您的 shell（或者关掉再打开终端）
source ~/.bashrc
# 安装最新的 Node LTS
nvm install --lts
node -v # 应显示 v22.x 或更新版本
安装并运行
这个 CLI 用 npm 全局安装：
npm install -g @anthropic-ai/claude-code
从任意目录启动它：
claude
首次启动时，它会打开您的浏览器让您登录（Anthropic 账号、Pro/Max 订阅或 API 密钥）。认证完成后，您就进了 agent。用中文敲一个请求，看着它干活。
您的第一个真正动作：让它配置机器
魔法就在这里发生。与其自己一条接一条地敲系统命令，不如开口要。下面是一个具体的首个任务，进了 agent 后几乎可以原样复制一次：
描述目标，而不是命令
在 agent 里，写类似这样的话：
「我们用的是一台全新的 Ubuntu 24.04。我想让您帮我把基础配置收尾：自动安全更新、一个只放行 SSH 的
ufw防火墙，还有给交换分区用的zram。每一步在执行前先给我解释，任何 sudo 命令在跑之前都先把命令给我看。」
点头之前先审计划
agent 会给您提一个计划和一些命令。**读它们。**这就是这门手艺的核心：您不再敲，而是审。如果某条命令看着可疑，先问「为什么是这条？」再接受。
让它执行，但手别离开方向盘
您一步一步地批准。出错时，agent 会读报错信息、看懂、然后修正。您刚刚靠聊天就配好了机器。
马上把记忆的地基打好
离开之前，创建那个 agent 每次会话都会读的文件：在您项目根目录放一个 CLAUDE.md（Claude Code）或 AGENTS.md（OpenCode）。开头两行就够了, 我们在 记忆文件 里深挖这个话题。
cd ~/mon-projet
cat > CLAUDE.md <<'EOF'
# 机器上下文
- 迷你 PC，Ubuntu 24.04，用途：个人开发工作室。
- 跑任何 sudo 命令前先把命令展示出来。
- 代码里不要出现明文密钥。
EOF