这篇内容深入介绍了一款名为 OpenCode 的开源免费 AI 编程助手。它通过保姆级教程的形式，详细讲解了其安装、配置、核心功能与实用技巧，旨在为开发者提供一个无需付费、功能强大且安全可控的编程辅助方案，特别适合寻求成本效益与高度定制化工具的独立开发者与开源参与者。
智能速览
OpenCode 是一个完全开源且免费的 AI 编程助手，支持终端、桌面和IDE。
它兼容超过75种AI模型，并通过 OpenCode Zen 提供精选的免费模型选项。
安装过程仅需三步，但 Windows 用户需通过 WSL 或虚拟机进行部署。
独特的 Plan/Build 双模式设计，分别用于安全规划与实际代码执行。
善用 AGENTS.md 文件和 @ 文件引用等技巧，能显著提升 AI 理解项目的准确性。
精华内容
为了深入了解这款备受关注的开源工具，以下将详细介绍其安装、核心功能与实用技巧，帮助开发者快速上手并发挥其最大效能。
初识 OpenCode
OpenCode 是一个基于 TypeScript 开发的、完全开源的 AI 编程助手，其核心优势在于免费与开放。用户可以在 GitHub 上查阅全部源代码，确保了透明度和可定制性。它支持包括终端、桌面应用及 IDE 插件在内的多种使用场景，并兼容 OpenAI、Anthropic、Google、智谱 AI、MiniMax 等 75+ 种主流模型。
其中，OpenCode Zen 功能尤为突出，它提供了一份官方精选的免费模型列表，如 GLM-4.7 和 MiniMax M2.1，让用户无需任何花费即可体验高质量的 AI 编程辅助。
三步快速上手
安装 OpenCode 的流程相对简洁，但需注意其原生不支持 Windows 系统。Windows 用户可通过 WSL（Windows Subsystem for Linux）、虚拟机或 Docker 来解决兼容性问题。
第一步，访问 GitHub 的 Releases 页面，下载对应操作系统的二进制安装包。第二步，将下载的文件放置到系统 PATH 路径下，或通过 `sudo ln -s` 命令创建软链接。第三步，首次运行时，输入 `/connect` 命令，从列表中选择并连接模型提供商，推荐选用 OpenCode Zen 中的免费模型如 GLM-4.7 开始体验。
核心命令与模式
OpenCode 的操作以 `/` 开头的命令驱动，掌握核心命令是高效使用的关键。`/init` 命令用于初始化项目，它会生成一个 AGENTS.md 文件，AI 会据此理解项目全局信息。`/connect` 和 `/model` 用于切换模型提供商和具体模型。`/open` 可快速搜索并打开文件，而 `/review` 则能审查代码变更。
其最具创新性的设计是 Plan/Build 双模式。Plan 模式下，AI 仅进行分析和规划，不修改任何文件，如同技术顾问。此模式适用于理解新项目或拆解复杂任务。Build 模式则赋予 AI 读写文件和执行命令的完整权限，用于实际的编码和构建工作。通过 Tab 键即可在两种模式间切换，形成“先规划，后执行”的安全工作流。
实用技巧与避坑
要让 OpenCode 更好地服务，有几个技巧值得掌握。首先，应善用 `/init` 生成的 AGENTS.md 文件，手动补充项目技术栈、编码规范等关键信息，能显著提升 AI 的理解准确度。其次，在对话中使用 `@文件名` 可以直接引用文件内容进行分析。此外，上传 UI 设计稿让 AI 生成对应代码的功能也十分实用。
使用过程中也需注意几个“坑”。除了 Windows 的兼容性问题，不同模型的效果差异巨大，建议从官方推荐的免费模型开始尝试。同时，不能完全依赖 AI，其生成的代码仍需人工验证和调试。对于长时间对话，应适时使用 `/compact` 命令压缩会话，避免超出模型的上下文限制。
