跳到正文
mini PC AI.
← 学习路径
第 6 步 · 基础搭建 简单 · 12 分钟

🤖安装 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 年的版图很丰富, 它们全都遵循同一个原理（读、写、跑、循环）：

  • Antigravity CLI（命令 agy）: Google 全新的命令行 agent，接的是 Gemini 模型。它取代了 Gemini CLI, Google 已于 2026 年 6 月 18 日关停后者的大众版服务（免费、Pro、Ultra 账号被自动迁移；只有企业版 Gemini Code Assist 许可证仍留在旧工具上）。它用 Go 编写，能在后台编排多个子 agent。改用脚本安装，不再走 npm：curl -fsSL https://antigravity.google/cli/install.sh | bash。
  • Codex CLI : OpenAI 的 agent，背靠 GPT 模型。
  • Aider : 一个广受好评的开源 agent，围绕 git 设计（每次改动 = 一个干净的 commit），几乎兼容所有模型，本地的也算。
  • Pi : OpenCode 的极简替代品。同属开源世界，理念相反：一个精简到骨架、由您自己扩展的内核。见下方的提示框。
  • Cline / Roo Code : 一些活在 VS Code 里而不是终端里的 agent，如果您更愿意留在编辑器里。
  • Cursor、Windsurf : 围绕 AI 打造的完整代码编辑器，适合想要一站式体验的人。
  • Orca : 不是又一个 agent，而是一个让它们跑起来的环境（即「ADE」，Agent Development Environment）。见下方的提示框。

一把密钥，所有模型：统一 API

当 OpenCode 这样开放的 agent 问您「用哪个供应商？」时，您本可以在每家厂商（Anthropic、OpenAI、Google……）都开一个账号，同时应付五把密钥、五张账单、五份配额。或者，接一个统一 API：一个挡在几十个模型前面的服务，对外只暴露一把密钥、一张账单、一种格式。换模型无需换账号，而且所有花费都在同一处结算。

  • OpenRouter : 最知名的一个。一把密钥就能用上数百个模型（Claude、GPT、Gemini、Grok、Llama、Qwen、DeepSeek……），自动把请求路由到最便宜或最快的供应商，某家挂了还能自动回退，并有一块仪表盘把开销精确到 token 地记下来。按用量付费，在批发价之上只加一点薄利。非常适合用同一个任务横向对比十个模型，而不必注册十次。
  • OpenCode Zen : OpenCode 团队的自家网关：一组为 agent 式编程精选并跑过基准的模型（40+ 个，从前沿到又小又快的都有，还含几个免费的）。选择面不如 OpenRouter 广，但每一个都被验证过能在一个 agent 里好好工作（而不只是在聊天里）。按用量付费（批发价 + 处理费），可设置自动充值和月度上限。接入方式：在 OpenCode 里 /connect →「OpenCode Zen」→ 粘贴密钥。
  • OpenCode Go : 同样的思路，但走包月：首月约 5 美元，之后每月 10 美元，用上低成本的代码模型而不必数 token。如果您每天都写代码、宁愿要一个固定金额而非浮动账单，这是个划算的选择。

共同的前提：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