OpenCode。一句话总结：终端里跑的、完全开源的、Claude Code平替（甚至更丝滑）的AI编程Agent。GitHub Star 已超7万，月活超65万，开源社区活跃到爆。最关键：免费、可自托管、模型随便接。今天这份从0到1的保姆级上手指南。一、OpenCode到底是什么？一句话定义：一个专为命令行/终端爱好者打造的AI编码智能体，能读懂整个项目、改代码、写功能、跑命令、做review，全程不离开你的iTerm / Windows Terminal / Alacritty。它和Cursor、Claude Code、GitHub Copilot Workspace最像，但三大致命优势：
- 完全开源（github.com/opencode-ai/opencode）
- 终端原生TUI体验（Bubble Tea写的，贼丝滑）
- 模型自由：支持Claude 4、Gemini 2.5、GPT-4o/o1、Grok、DeepSeek、GLM-4、通义千问……几乎所有主流API都能接
如果你每天敲命令行超过2小时，OpenCode大概率会成为你2026年最常用的生产力工具。二、3分钟极速安装（推荐方式）Mac / Linux（一键脚本最爽）
bash
curl -fsSL https://opencode.ai/install |bash
Windows（推荐用Scoop，或直接去官网下exe）
powershell
scoop bucket add extras
scoop install opencode
或者直接访问 https://opencode.ai/download 下载桌面版（也有Windows原生版）。安装完立刻敲：
bash
opencode
出现TUI界面就算成功。三、第一次必须做的3件事（5分钟搞定）
- 授权模型（最重要一步）
bash
opencode auth login
# 或者直接在TUI里敲 /connect
目前最推荐的几种模型组合（2026年1月性价比排序）：
排序 | 模型组合 | 速度 | 代码质量 | 价格 | 推荐场景 |
|---|
1 | Gemini 2.5 Pro / Flash | ★★★★★ | ★★★★☆ | 极便宜 | 日常主力（目前最香） |
2 | Claude 4 Sonnet / Opus | ★★★★☆ | ★★★★★ | 较贵 | 追求极致代码质量 |
3 | DeepSeek-R1 / GLM-4系列 | ★★★★★ | ★★★★☆ | 几乎免费 | 预算有限/本地党 |
4 | Grok-3 / Grok-2 | ★★★★☆ | ★★★★☆ | 中等 | 喜欢xAI风格的同学 |
选好模型后，强烈建议再敲：
bash
opencode /init
它会在当前目录生成 AGENTS.md 文件，这是OpenCode的“项目说明书”，写得越详细，AI后续表现越聪明。示例AGENTS.md内容（直接复制粘贴后改）：
markdown
# 项目角色与规范
项目类型：前后端分离的SaaS后台管理系统
主要语言：TypeScript / Go
代码规范：Google TypeScript Style + ESLint推荐规则
文件夹结构：src/api、src/components、src/views、src/utils...
数据库：PostgreSQL + Prisma
前端状态管理：Zustand
UI组件库：Ant Design + Tailwind
核心开发原则：
- 优先函数式 + 类型安全
- 所有API必须有OpenAPI文档
- 错误处理要统一（使用自定义Error类）
- 写单元测试覆盖率 > 80%
当前痛点：
- 老代码技术债务多
- 接口字段经常对不上
四、常用指令速查表（建议截图保存）
指令 | 作用 | 使用频率 |
|---|
/init | 初始化项目说明（生成AGENTS.md） | ★★★★★ |
/review | Review当前改动 / 未提交代码 | ★★★★★ |
/plan | 只读分析模式（最安全，先思考） | ★★★★☆ |
/build | 完整构建/修改模式（Tab切换文件） | ★★★★★ |
/models | 切换当前模型 | ★★★★☆ |
/new | 新建session（清空上下文） | ★★★☆☆ |
/session list | 查看所有会话 | ★★☆☆☆ |
/editor | 用VSCode/Neovim打开当前消息编辑 | ★★★☆☆ |
/undo | 撤销上一次AI写的内容 | 救命键 |
最常用的一句话指令模板（直接复制用）：
帮我用React + TypeScript + Zustand + Tailwind实现一个带分页、搜索、批量删除的用户管理列表页，要求代码规范、类型安全、错误处理完整。
五、真实案例：3分钟让AI帮你重构烂代码场景：有一个300行React组件，逻辑混乱，想拆分成多个hooks + 组件在项目目录敲 opencode，然后输入：
@components/UserList.tsx 这个组件太乱了
请帮我：
1. 把状态抽到自定义hooks
2. 把UI拆成Table、Filter、Pagination三个子组件
3. 用zustand管理选中行状态
4. 保持原有功能不变
5. 给每个文件写注释
直接开始吧，用/build模式
然后Tab → build → y（确认改动）→ 看AI给你拆得明明白白。六、进阶玩法速览（后续可展开）
- 社区最强增强：Oh My OpenCode
- MCP自定义工具（让AI调用你自己的脚本）
- 多Agent协作（前端Agent + 后端Agent + 测试Agent）
- GitHub Action集成（PR自动Review）
- 本地部署DeepSeek / Qwen全家桶
最后：一句话总结如果你是终端重度用户，2026年不试试OpenCode，你可能会后悔。安装3分钟，配置好模型和AGENTS.md大概10分钟，后面省下来的时间可能是成百上千个小时。
