面对AI编程工具日趋封闭化的现状,OpenCode作为开源终端编程Agent提供了更自由的解决方案。本文分享10个核心使用技巧,从项目初始化到Agent权限控制,帮助开发者掌握这个支持多模型、可深度定制的编程助手,实现更高效的工程化开发体验。
智能速览
OpenCode支持Claude/GPT/Gemini等多种模型,完全开源可审计
/init命令生成项目说明书AGENTS.md,建立项目级上下文记忆
Plan/Build模式切换,先规划再执行降低代码改错概率
通过@文件或@目录精确控制Agent上下文范围
支持非交互模式运行,适合Git hooks和CI自动化
提供Agent权限控制,精细化操作权限管理
精华内容
掌握OpenCode的核心技巧,不仅能提升开发效率,更能构建属于自己的AI编程工作流。下面深入解析关键功能点,帮你快速上手这个强大的开源工具。
快速上手
安装OpenCode官方推荐使用curl命令一键安装:curl -fsSL https://opencode.ai/install | bash。安装完成后确认版本:opencode --version。启动时建议选择Git代码仓库目录,确保项目结构清晰。不要在脏乱无章的目录启动,这会影响Agent对项目的理解能力。
项目初始化
进入项目后第一件事是执行/init命令,这会扫描当前项目结构并生成AGENTS.md文件,建立项目级上下文记忆。AGENTS.md是OpenCode理解项目的核心入口,建议将其纳入Git管理,类似于Claude Code中的claude.md文件。这一步为后续Agent行为提供了准确的项目说明书。
TUI命令技巧
OpenCode TUI界面支持丰富的Slash命令。/connect快速添加API提供商,解决免费模型并发限制问题;/models查看可用模型清单;/new开始全新会话,清空上下文;/compact压缩当前会话,减少信息干扰。这些命令让操作更高效,无需离开当前上下文或重启界面。
撤销与重做
/undo和/redo是常用命令,基于Git管理文件更改。当Agent改动方向不对时,直接执行/undo撤销,比发消息说改回来更高效。/redo重做之前撤销的操作,仅在使用/undo后可用。这一功能让错误修复变得简单快捷,类似Git revert的体验。
模式切换技巧
Plan Mode和Build Mode是核心工作模式。Plan Mode只规划不执行,Build Mode直接改代码执行命令。通过Tab键快速切换,比Claude Code需要两次Tab体验更好。推荐工作流:先切换到Plan Mode描述目标,让AI输出步骤拆解和风险点,确认无误后切回Build Mode执行,显著降低改错概率。
Agent定制
OpenCode中Agent是一等公民。可通过opencode agent create创建专用Agent,如api-doc-agent自动编写API文档、review-agent专注代码审查、test-agent生成修复测试、security-agent关注安全问题。这种细分工的Agent设计让任务处理更专业精准。
OpenCode通过开源架构和多模型支持,为开发者提供了更可控的AI编程解决方案。它适合流程化、工程化的开发场景,特别是重构、问题分析和自动化流程。与其他AI IDE不是替代关系,而是互补,让开发者能自由搭建属于自己的AI编程工作流。