OpenCode 开源 AI 编程助手实战指南
OpenCode 是一个 100% 开源的 AI 编程代理（Coding Agent），提供终端界面（TUI）、桌面应用和 IDE 扩展多种使用方式。它不只是简单的对话工具，而是能帮你分析代码库、自动修改重构、调试修复问题甚至生成文档的得力助手。
相比闭源的竞品，它的核心优势在于完全开源（MIT 协议）、支持 75+ 个模型提供商（包括本地部署）、内置 LSP 语言服务器以及极致的 TUI 体验。如果你习惯在终端工作，或者想摆脱对特定云厂商模型的依赖，OpenCode 值得深入尝试。
安装与环境准备
安装前确保你的终端模拟器支持现代特性，推荐 WezTerm、Alacritty 或 Windows Terminal。LLM Provider 的 API 密钥也是必须的。
通用与系统安装
最通用的方式是使用官方脚本，适用于 macOS 和 Linux：
curl -fsSL https://opencode.ai/install | bash
macOS 用户更推荐 Homebrew，更新更及时：
brew install anomalyco/tap/opencode
Linux 发行版如 Debian/Ubuntu 可使用 npm 或脚本，Arch 用户则直接通过 paru 安装：
npm install -g opencode-ai
# 或 Arch
paru -S opencode-bin
Windows 环境支持 Chocolatey、Scoop 或 npm。Docker 用户也可以直接运行容器镜像：
docker run -it --rm ghcr.io/anomalyco/opencode
💡 提示：安装脚本支持自定义目录，可通过环境变量
OPENCODE_INSTALL_DIR指定路径。
快速上手与配置
首次使用时，我们需要连接一个模型 Provider。进入项目目录后直接运行 opencode。
连接模型
输入 /connect 命令，选择你偏好的 Provider（如 OpenCode Zen、Anthropic 或 OpenAI）。如果是本地模型，可以配置 Ollama 或 LM Studio。这里有个小技巧：如果工具调用不生效，尝试在 Ollama 中将 num_ctx 调大至 16k-32k。
初始化项目
为了让 AI 更好地理解上下文，建议运行 /init 命令。这会在项目根目录生成 AGENTS.md 文件，记录项目结构和编码规范。强烈建议将这个文件提交到 Git 仓库，这样团队成员都能受益。
基础交互
在 TUI 界面中，你可以直接输入自然语言提问。引用文件时使用 @ 符号，例如 @src/components/Button.tsx。执行 Shell 命令则需加 ! 前缀，如 !npm test。
OpenCode 提供了两种模式，按 Tab 键切换：
- Build 模式：拥有完整权限，可修改文件，适合实际开发。
- Plan 模式：只读模式，仅分析不修改，适合代码审查或方案规划。
实际工作中，我习惯先用 Plan 模式让 AI 梳理思路，确认无误后再切回 Build 模式执行。
配置文件详解
OpenCode 的配置基于 JSON 格式，支持注释（JSONC）。优先级从高到低依次为：远程组织配置、全局用户配置、环境变量、项目专属配置。
一个典型的配置示例如下：
