介绍开源 AI 编程代理 OpenCode 的使用。涵盖全平台安装方式（通用脚本、Homebrew、Docker 等）、API 密钥配置（OpenCode Zen 及第三方模型）、项目初始化（生成 AGENTS.md）。核心功能包括 Plan+Build 双模式工作流、Slash 命令体系（如 /connect, /init, /undo）、VSCode 集成及高级自定义技巧。旨在帮助开发者利用 AI 提升编码效率，支持多模型兼容与本地部署。
当下 AI 编程工具层出不穷，OpenCode 凭借开源免费、多模型兼容、多端适配、项目级上下文感知的核心优势，成为程序员的高效工具。它不是简单的代码补全工具，而是能真正理解项目架构、帮你从需求分析到代码落地的 AI 编码代理，支持终端、桌面应用、IDE 扩展等多种使用方式，还能对接国内外 75 + 种 LLM 模型，兼顾便捷性和代码隐私性。
本文结合 OpenCode 官方文档和实际使用经验，从安装配置、核心操作、实战技巧、高级玩法四个维度，带你彻底玩转 OpenCode。
| 特性 | 优势说明 |
|---|---|
| 完全开源 | 支持二次开发，无商业绑定，社区生态活跃 |
| 多模型兼容 | 对接 GPT-4o、Claude 3、Gemini、GLM-4.7 等 75 + 模型，可自由切换 |
| 多端适配 | 终端 TUI、桌面应用、VSCode 等 IDE 扩展，适配不同开发习惯 |
| 项目级上下文 | 深度扫描项目结构，理解整体架构，生成代码可无缝融入工程 |
| 双模式工作流 | Plan（规划）+Build（构建）分离，先设计再编码，减少逻辑偏差 |
| 轻量高效 | 低延迟，支持本地部署，对硬件要求低，小项目秒级响应 |
OpenCode 支持 Windows、macOS、Linux 全平台，安装方式多样，这里推荐通用安装脚本（最便捷）和各平台专属方式。
打开终端，直接执行以下命令，一键安装最新版本：
curl -fsSL https://opencode.ai/install | bash
适合已配置 Node.js 环境的开发者，全局安装即可：
# npm
npm install -g opencode-ai
# bun
bun install -g opencode-ai
# pnpm
pnpm install -g opencode-ai
# yarn
yarn global add opencode-ai
推荐使用 OpenCode 官方 tap 源（更新最快）：
brew install anomalyco/tap/opencode
sudo pacman -S opencode # 稳定版
paru -S opencode-bin # AUR 最新版
除了 WSL，还支持 Chocolatey/Scoop/NPM，任选其一：
# Chocolatey
choco install opencode
# Scoop
scoop install opencode
# NPM
npm install -g opencode-ai
注意：Windows 上通过 Bun 安装的支持目前正在开发中，暂不推荐。
适合不想配置环境的开发者，直接运行容器：
docker run -it --rm ghcr.io/anomalyco/opencode
安装完成后，终端输入以下命令，显示版本号即安装成功：
opencode --version
安装完成后，核心配置就是对接 LLM 模型的 API 密钥，这里分新手推荐（OpenCode Zen）和进阶配置（自定义模型）。
OpenCode Zen 是官方测试验证的精选模型集合，适配编码场景，步骤如下：
opencode 选项，终端会提示前往授权地址：opencode.ai/auth；在 TUI 中输入连接命令，按回车：
/connect
终端启动 OpenCode 的 TUI 界面：
opencode
如果想使用 GPT-4o、Claude 3、GLM-4.7 等第三方模型，只需在 /connect 命令后选择对应模型提供商，输入其官方 API 密钥即可，步骤和上述一致。
小技巧：API 密钥建议存入项目本地配置，避免全局泄露；国内开发者可优先选择 GLM-4.7、DeepSeek-V3 等国产模型，中文支持更好，访问速度更快。
配置完成后，需要先对项目进行初始化，让 OpenCode 扫描项目结构、理解编码规范，后续才能精准生成 / 修改代码。
输入初始化命令，按回车：
/init
启动 OpenCode：
opencode
终端导航到你的项目根目录：
cd /path/to/your/project # 替换为你的项目路径
重要提示：一定要将
AGENTS.md提交到 Git 仓库！后续团队协作或重新使用 OpenCode 时，它能让工具快速读懂项目，无需重复扫描。
OpenCode 的核心精髓是 Plan（规划模式）+Build（构建模式）双工作流，先让 AI 出方案，再让 AI 写代码，避免直接编码导致的逻辑偏差。同时支持直接修改、代码解释、撤销重做等基础功能。
适合需要跨文件、多步骤的复杂功能开发（如新增业务模块、开发新页面）。示例需求：实现用户删除笔记后，标记为软删除，新增回收站页面支持恢复 / 永久删除。
执行编码：在终端输入指令，让 AI 开始开发：
按照计划执行，完成所有修改。
迭代计划：OpenCode 会生成实施计划（如修改哪些文件、新增哪些接口、页面布局设计等），如果计划不符合预期，直接在终端补充需求即可，比如：
回收站页面的设计参考项目中已有的笔记列表页面，使用相同的 UI 组件。
小技巧：可直接将设计图 拖放到终端，OpenCode 会自动识别图片内容，作为设计参考！
描述需求：在终端输入详细需求（把 AI 当初级开发者，越详细越好）：
当用户删除笔记时，在数据库中将该笔记标记为 deleted 状态（软删除，不真正删除）；新增一个回收站页面，展示所有标记为 deleted 的笔记；在回收站页面，用户可以点击恢复按钮将笔记恢复为正常状态，也可以点击永久删除按钮彻底删除笔记。
适合单行代码修改、简单功能添加、代码重构等轻量操作（如给接口加鉴权、修改按钮样式）。示例需求：给 /settings 路由添加鉴权，参考 /notes 路由的鉴权逻辑。直接在 Build 模式下输入指令（需提供足够细节，指定参考文件）：
给@packages/functions/src/settings.ts 中的/settings 路由添加身份验证，参考@packages/functions/src/notes.ts 中/notes 路由的鉴权逻辑，实现完全相同的功能。
小技巧：使用 @符号 可模糊搜索项目文件，直接引用文件路径，无需手动输入完整路径，大幅提升效率！
遇到不熟悉的代码库或老项目时，可让 OpenCode 直接讲解代码逻辑，示例：
解释@packages/functions/src/api/index.ts 中的认证逻辑，说明每一步的作用。
适合快速接手新项目、理解团队同事的代码，省去逐行阅读的时间。
如果 AI 生成的代码不符合预期，无需手动修改，直接用命令快速回滚：
/undo，可撤销上一步操作，多次输入可撤销多次修改；/redo，可恢复最近一次撤销的修改。如果需要和团队同事沟通开发方案，可将 OpenCode 的对话生成链接分享，输入命令：
/share
链接会自动复制到剪贴板，同事打开即可查看完整的需求分析、计划设计、代码修改过程，无需反复沟通。
OpenCode 的 Slash 斜杠命令 是核心操作方式，所有功能都可通过命令实现，无需鼠标操作。
| 命令 | 核心功能 | 适用场景 |
|---|---|---|
/connect | 配置 LLM 模型 API 密钥 | 首次使用 / 切换模型时 |
/init | 初始化项目，生成 AGENTS.md | 新项目接入 OpenCode 时 |
/undo | 撤销上一步修改 | AI 代码不符合预期时 |
/redo | 重做最近一次撤销的修改 | 误操作撤销时 |
/share | 生成对话链接，分享给团队 | 团队协作、同步开发思路时 |
/add | 添加指定文件到上下文 | 让 AI 聚焦特定文件分析 / 编码时 |
/compact | 压缩上下文历史，释放 Token | 对话过长、Token 接近上限时 |
/review | 代码审查，检查 Bug / 性能问题 | 提交代码前，自动查错 |
/web | 联网搜索最新资料 / API 文档 | 需要查询外部信息时 |
OpenCode 支持高度定制化，可通过自定义主题、快捷键、模型参数、Agent 代理等，让工具完全适配你的开发习惯。
在配置面板中可修改模型核心参数，根据开发场景调整：
可创建自定义 Agent（如代码审查专家、安全检测专家），让 OpenCode 扮演特定角色，实现专属功能：
.opencode/prompts/；/run security，即可调用该自定义 Agent，对项目进行安全检测。创建自定义 Agent 文件（如 security.md），写入系统提示词：
你是一名资深网络安全专家，专门检查代码中的 SQL 注入、XSS 漏洞、权限绕过等安全问题，发现问题后给出详细的修复方案，不直接修改代码。
对于习惯用 VSCode 的开发者，可将 OpenCode 集成到 IDE 中，实现 终端 + 编辑器 无缝操作。
Ctrl+Shift+X（Windows/Linux）/Cmd+Shift+X（Mac）打开扩展市场；keybindings.json 中绑定快捷键（如 Ctrl+'），可快速唤起 OpenCode，无需手动输入命令。优势：可直接将 VSCode 左侧文件树的文件 拖放到终端，OpenCode 会自动识别并执行
/add命令，添加到上下文，大幅提升操作效率。
/init 命令，且 AGENTS.md 文件存在，未被修改 / 删除；AGENTS.md 中补充项目编码规范（如代码风格、命名规则、框架使用要求），OpenCode 会自动遵循；/compact 命令压缩上下文，避免无关对话占用 Token，简单任务用轻量模型（如 gpt-4o-mini、GLM-4.7）。OpenCode 作为一款开源的 AI 编码代理，真正做到了'解放程序员双手，聚焦核心业务'，它不是替代开发者，而是成为开发者的 '编程搭子'—— 帮你处理重复编码、读懂陌生代码、重构老项目、写技术文档，让你把时间花在更有价值的需求设计和架构优化上。
本文从安装配置到实战技巧，覆盖了 OpenCode 的核心使用场景，只要掌握 Plan+Build 双模式 和 Slash 命令体系，就能搞定绝大多数开发工作。后续随着社区生态的完善，OpenCode 的功能会越来越强大，赶紧上手试试，让 AI 帮你提升开发效率吧！
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online