安装 agent（趁早）

这是整个旅程里最反直觉的秘诀：我们在其他一切之前先装代码 agent。

大多数教程让您花三个小时配置机器，网络、防火墙、服务，然后才在最后装上 AI，像一份奖赏。我们反着来。趁系统还光秃秃的时候，您现在就把 agent 装上，然后由它来帮您接上 Tailscale、Cloudflare、Ollama 等等一整套。您从「我敲着自己不懂的命令」变成「我描述我想要什么，我审一遍，我点头」。

Claude Code、OpenCode 还是 Codex：选哪个？

这些都是出色的命令行代码 agent。它们读您的项目、写文件、跑命令，并不断循环直到跑通为止。本指南平等对待其中三个，凡是步骤有差别的地方，每个 agent 都有自己的标签页。区别一行说清：

• Claude Code : Anthropic 出品的 agent。您接上 Claude 模型，它们在 2026 年 9 月 28 日那一期的 Quelle IA 代码榜上排名第一（法语网站）。安装极其简单，长任务上的可靠性顶尖。包含在 Claude Pro 和 Max 订阅里，也可以通过 API 按用量付费。
• Codex : OpenAI 的 agent，背靠 GPT 模型（同一期里 GPT-6 Astra 领跑 agent 榜，法语网站）。包含在 ChatGPT 订阅里（从 Plus 到 Pro），也可以用 API 密钥按用量付费。它还能跑在本地模型上（codex --oss）。
• OpenCode : 开源的 agent。同样的精神，但引擎由您挑：Claude、GPT、Grok，或者通过 Ollama 跑一个本地模型。它接受 API 密钥，也接受好几种订阅（ChatGPT、SuperGrok、GitHub Copilot）。如果您想要 100% 本地，或者在不同供应商之间切换，它再合适不过。

另外两家前沿厂商也有自己的终端 agent，包含在各自的订阅里。如果您已经在为其中一家付费，它们就是一等的选择：

• Grok Build（xAI，命令 grok）：xAI 的所有套餐都勾选了它，从免费版到 SuperGrok Heavy，额度随订阅升高。安装：curl -fsSL https://x.ai/cli/install.sh | bash，在没有浏览器的机器上再运行 grok login --device-auth。
• Antigravity CLI（Google，命令 agy）：它取代了 Gemini CLI。自 2026 年 6 月 18 日起，Gemini CLI 不再为免费账号以及 Google AI Pro 和 Ultra 提供服务（付费 API 密钥和 Gemini Code Assist 许可证仍可使用 Gemini CLI）。它用 Go 编写，能在后台编排多个子 agent。安装：curl -fsSL https://antigravity.google/cli/install.sh | bash。

四种订阅的价格、各档额度和使用规则：订阅前沿模型。

如果您想探索得更广，版图很丰富，它们全都遵循同一个原理（读、写、跑、循环）：

• Aider : 一个广受好评的开源 agent，围绕 git 设计（每次改动 = 一个干净的 commit），几乎兼容所有模型，本地的也算。
• Pi : OpenCode 的极简替代品。同属开源世界，理念相反：一个精简到骨架、由您自己扩展的内核。见下方的提示框。
• Cline : 一个活在 VS Code 里而不是终端里的 agent，如果您更愿意留在编辑器里。（它的近亲 Roo Code 已于 2026 年 5 月关停。）
• Cursor、Devin Desktop（原 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 式编程精选并跑过基准的模型（截至 2026 年 10 月 1 日共 85 个，从前沿到又小又快的都有，还含几个免费的）。选择面不如 OpenRouter 广，但每一个都被验证过能在一个 agent 里好好工作（而不只是在聊天里）。按用量付费（批发价 + 处理费），可设置自动充值和月度上限。接入方式：在 OpenCode 里 /connect →「OpenCode Zen」→ 粘贴密钥。
• OpenCode Go : 同样的思路，但走包月：每月 10 美元（Go Plus 为 40 美元），用上低成本的开放代码模型。这个套餐有上限，按美元用量计算：每个模型有一份月度额度（Go 为 15 到 60 美元），任意 5 小时内最多用掉其中 20%，一周内最多 50%（2026 年 10 月 1 日查自 OpenCode Go 页面）。如果您每天都写代码、宁愿要一个固定金额而非浮动账单，这是个划算的选择。

Node.js：不再必需，依然有用

好消息：Claude Code、Codex 和 OpenCode 都不需要 Node.js。三者都用一个脚本安装，装上的是独立运行的程序。您可以跳过这一节，直接去安装。

不过很多项目仍然会用到 Node：一个 JavaScript 网站、一个 npm 包、用 npm 安装的 Pi。到那一天，请用 nvm（版本管理器）来安装，而不是用系统软件包，这样能避开权限上的麻烦，也能轻松切换版本。

# 安装 nvm（Node 版本管理器）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh | bash
# 重新加载您的 shell（或者关掉再打开终端）
source ~/.bashrc
# 安装最新的 Node LTS
nvm install --lts
node -v   # 截至 2026 年 10 月 1 日为 v24.x（Node 26 预计 10 月 28 日成为 LTS）

安装并运行

# 下载 Claude Code 并安装到 ~/.local/bin
curl -fsSL https://claude.ai/install.sh | bash
# 打开一个新终端，然后检查
claude --version

claude

curl -fsSL https://opencode.ai/install | bash
# 备选方案（如果已装 Node）：npm install -g opencode-ai

opencode

# 安装 Codex（再运行一次同一条命令即可更新）
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# 另一种方式，如果装了 Node：npm install -g @openai/codex

codex

# 显示一个网址和一个代码，在您的电脑上输入（测试版）
codex login --device-auth

您的第一个真正动作：让它配置机器

魔法就在这里发生。与其自己一条接一条地敲系统命令，不如开口要。下面是一个具体的首个任务，进了 agent 后几乎可以原样复制一次：

马上把记忆的地基打好

离开之前，创建那个 agent 每次会话都会读的文件：在您项目根目录放一个 CLAUDE.md（Claude Code）或 AGENTS.md（Codex、OpenCode）。开头两行就够了，我们在 记忆文件 里深挖这个话题。

cd ~/mon-projet
cat > CLAUDE.md <<'EOF'
# 机器上下文
- 迷你 PC，Ubuntu 26.04，用途：个人开发工作室。
- 跑任何 sudo 命令前先把命令展示出来。
- 代码里不要出现明文密钥。
EOF