资源、帮助与排障

好了，您的机器在转，您的智能体在干活。还剩一个简单的真相：您不可能全都记住，而总有一天会有东西坏掉。这很正常。这一篇，就是您的通讯录，权威的文档、会回答您的人、以及出岔子时该做的动作。

官方文档

每当冒出一个技术疑问，官方来源永远胜过被抄了十遍的教程。下面是各工具的权威页面：

• Claude Code : code.claude.com/docs（文档已从 docs.claude.com 和 docs.anthropic.com 迁出）。安装、Hooks、Skills、MCP、各项设置：全都在这里。
• OpenCode : opencode.ai。安装、供应商、多模型配置。
• Pi : pi.dev。OpenCode 的极简、可扩展替代品（内核精简，TypeScript 扩展）。见 安装 agent。
• Antigravity CLI : antigravity.google。Google 的 CLI agent（原 Gemini CLI）及其迁移文档。
• 统一 API : openrouter.ai（数百个模型，一把密钥）和 opencode.ai/zen + opencode.ai/go（OpenCode 精选的网关，按量付费或包月）。见 安装 agent。
• Orca : onorca.dev（开源）。让多个 agent 并行运行的环境。
• Ollama : docs.ollama.com 是文档（上下文大小、接入 Claude Code 或 OpenCode），ollama.com/library 用来浏览可用的模型及其大小。
• Quelle IA : quelleia.com（法语网站），由本指南作者维护的语言模型排名。做本地 AI 时，下载任何模型之前都该先打开它：哪台机器跑哪个 AI、本地模型排名，以及用四个问题 找到我的模型。见 选择并调好您的模型。
• llmfit : llmfit.org（开源 AlexsJones/llmfit）。扫描您的机器，告诉您哪些本地模型在上面跑得好，以及该用哪个量化。参见选择并匹配您的模型。
• CanIRun.ai : canirun.ai。同样的思路，在浏览器里一键搞定（零安装）：它估算您的硬件，给每个模型打分，从「Runs great」到「Too heavy」。在动用 llmfit 之前用来快速粗筛很合适。
• Tailscale : tailscale.com/docs。官方文档，清晰且及时更新。
• Cloudflare Tunnel : developers.cloudflare.com。用来干净地把一个服务对公网暴露。
• Ubuntu : ubuntu.com 和 docs.ubuntu.com，针对系统本身。

学习与汲取灵感

排障之外，这里是您抽身退一步、了解最新动向的地方：

• Anthropic Engineering, Anthropic 的文章，其中包括 Claude Code 最佳实践。这些读物真能改变您驾驭智能体的方式。
• Hugging Face, open-weight 模型的中枢。几乎所有能在本地跑的东西都从这里过。
• r/LocalLLaMA, 本地模型社区的脉搏。新东西、民间跑分、一线反馈。
• Quelle IA（法语网站）：每周按任务给模型排名（代码、智能体、法语……），还有 性价比排名，以及用 比较 把两个模型放在一起对照。
• Artificial Analysis, 模型对比（速度、质量、价格），基于实测数据而非凭感觉。

去哪里求助

最划算的反射动作：别人早就碰到过您这个错误了。 真的。把那条错误信息原样粘进搜索引擎，您常常会撞上一个半年前和您一样焦头烂额的陌生人写下的解决方案。万一没有，下面这些地方欢迎提问：

• r/LocalLLaMA, 一切跟本地模型和 Ollama 有关的事。
• 官方论坛和 Discord, Ollama、Tailscale、Cloudflare。
• Ask Ubuntu 和 Ubuntu Discourse（它在 2025 年取代了旧的 Ubuntu 论坛），系统问题的金矿。
• Stack Overflow, 一涉及代码或命令就绕不开的地方。

排障的反射动作

有东西坏了，别慌。有一套操作顺序能解决 90% 的情况：

让机器保持状态

几条值得记住的命令，用于快速健康检查：

htop          # 实时 CPU/RAM 负载，以及谁在吃资源
df -h          # 磁盘空间, 模型会把它填满得飞快
ollama ps      # 此刻、当下，哪些模型加载在内存里

至于会自动运转的维护：自动安全更新（unattended-upgrades，在系统设置里配置好的）会在您毫不操心的情况下让系统保持打过补丁。这正是那种装一次就忘掉的东西，恰到好处。