OpenCode 简介与核心特性
OpenCode 是一款完全开源的终端 AI 编程助手，基于 TypeScript 开发。项目代码公开于 GitHub，支持多场景应用（终端、桌面、IDE 插件）及 75+ 种模型（包括 OpenAI、Anthropic、Google、智谱 AI 等）。其核心优势在于免费使用及支持 OpenCode Zen 精选模型列表（如 GLM-4.7、MiniMax M2.1），无需付费即可调用优质 AI 模型。
安装配置指南
OpenCode 原生不支持 Windows 系统，Windows 用户建议使用 WSL（Windows Subsystem for Linux）、虚拟机或 Docker 环境。
第一步：下载安装包
访问 GitHub Releases 页面下载对应系统的二进制文件。Linux 和 macOS 用户可直接下载。
第二步：配置环境变量
将文件放入 PATH 路径或创建软链接：
sudo ln -s /path/to/opencode /usr/local/bin/opencode
第三步：连接模型
首次运行输入 /connect 命令选择模型提供商。推荐使用 OpenCode Zen 中的免费模型，如 GLM-4.7。
常用命令参考
OpenCode 命令以 / 开头，以下为常用指令：
基础命令
/init：初始化项目，生成AGENTS.md文件，自动分析项目结构并读取关键配置作为全局提示词。/connect：连接模型提供商。/model：快速切换当前使用的模型。/session：查看会话列表，支持继续或删除历史对话。/new：创建新会话。/compact：压缩会话内容，防止超出模型上下文限制。
文件操作
/open：搜索并打开文件（支持模糊搜索）。/review：审查代码变更，默认审查未提交代码。
功能开关
/mcp：开启或关闭 MCP（Model Context Protocol），允许调用外部工具。/agent：切换支持的 Agent 类型。
其他实用命令
/terminal：显示或隐藏终端，支持在 OpenCode 内直接运行 Shell 命令。/undo：撤销上一步操作。
Plan/Build 双模式工作流
Plan 模式：只看不干
在此模式下，AI 仅能分析项目和规划任务，无法修改文件。适用于理解新项目结构、拆解复杂需求或制定实现方案。
切换方式：按 Tab 键在 Plan 和 Build 模式间切换。
Build 模式：执行操作
此模式下 AI 拥有读写文件、运行命令及修改代码的权限。适用于确认方案后的实际编码、测试及构建。
推荐流程：
- 在 Plan 模式下沟通需求并确认方案。
- 切换到 Build 模式执行代码修改。
- 验证代码，如有问题返回 Plan 模式讨论。
实用技巧与避坑指南
提升效率的技巧
- 善用 AGENTS.md：通过
/init生成的文件可手动编辑，写入技术栈、编码规范等信息，辅助 AI 理解项目。 - @ 引用文件：在对话中使用
@文件名格式引用特定文件进行分析。帮我看看 @src/utils/helper.js 这个函数有没有问题 - 上传图片：支持上传 UI 设计稿或架构图，AI 可根据图片生成前端代码。例如 Figma 原型图。
注意事项
- Windows 兼容性：务必使用 WSL 或虚拟机，直接在 Windows 运行可能存在问题。
- 模型选择：不同模型效果差异较大，建议优先尝试 OpenCode Zen 推荐模型。
- 代码验证：AI 生成的代码可能存在 Bug，需人工验证并及时修正。
- 会话管理：长时间对话后使用
/compact压缩会话，避免占用过多上下文。
总结
OpenCode 是一款功能丰富的开源 AI 编程工具，支持多模型和多场景，Plan/Build 模式兼顾安全与效率。虽然对 Windows 原生支持有限且需要一定技术背景，但对于全栈开发者及独立开发者而言，是替代付费工具的优质选择。AI 旨在提高效率，最终代码质量仍需依靠开发者自身把控。
