最近 AI 编程工具火得不行，但很多人用完总觉得差点意思——要么功能太单一，要么只能当个聊天机器人使唤。今天给大家介绍一个真正能干活的开源 AI 编程助手OpenCode，它不仅能理解你的代码，还能帮你执行命令、调试问题、甚至是自动修复 Bug。

更重要的是，这玩意儿完全开源，支持 75+ AI 模型，最重要的是——它是为"项目"而生的。

下面我结合实际项目场景，分享 5 个超实用的使用技巧。

技巧一：项目初始化，让 AI 真正懂你的代码

很多人刚用 OpenCode 时，直接就开始让 AI 干活，结果发现它总是理解错你的意图。其实只要你多做一步，效果完全不一样。

进入项目目录后，第一句话输入：

/init

这货会干嘛？它会分析你的项目结构、依赖、编码规范，然后在根目录生成一个 AGENTS.md 文件。这文件就是 AI 的"项目说明书"，里面记录了：

• 项目用的什么框架

• 目录结构是怎样的

• 编码风格偏好

• 常用的命令和脚本

一定要把这个文件提交到 Git 仓库。下次团队其他人用 OpenCode 或者换台机器开发，AI 瞬间就能上手。

这就是为什么同样是 AI 工具，有人觉得好用有人觉得难用——差距就在于有没有做好"项目初始化"。

技巧二：双模式切换，精准控制 AI 的行为

OpenCode 最核心的设计就是两个 Agent 模式：Build 和 Plan。

• Build 模式：默认模式，AI 有完全的编辑权限，可以直接修改文件、运行命令。适合日常开发。

• Plan 模式：只读分析模式，AI 默认拒绝编辑文件，运行 bash 命令前会先问你。适合探索陌生代码库、做代码审查。

切换方式超级简单：按 Tab 键。

举几个实用场景：

场景 1：接手别人的项目 先用 Plan 模式问："这个项目的架构是怎么样的？主要模块有哪些？"AI 不会乱改代码，而是帮你分析。等你熟悉了，再切到 Build 模式开始干活。

场景 2：代码审查 切到 Plan 模式，然后说："帮我审查 src/utils/auth.js，看看有没有安全问题。"AI 会只读分析，不会手痒去改代码。

场景 3：实现新功能 先用 Plan 模式让 AI 给出实现计划，看完再切到 Build 模式让它执行。这一步的思考往往能帮你发现没想到的问题。

技巧三：文件引用，正确姿势是这样的

很多人在和 AI 描述问题时，喜欢用"那个文件""某个函数"这种模糊表达，AI 猜错了别怪它。

正确的做法是用 @ 引用文件：

@src/app.js

引用具体行号也可以：

@src/app.js#L37-42

这样 AI 就知道你说的是哪一行，定位问题特别准。

如果不确定文件在哪，可以用子 Agent @search 来搜：

@search 查找所有 API 路由定义

这个功能在大型项目里特别香，比如你想知道项目中哪些地方用到了某个废弃的 API，一搜一个准。

技巧四：自定义命令和 Skills，让重复工作自动化

如果你经常让 AI 做一类事情，比如"每次都要解释这段代码的逻辑""每次都要生成单元测试"，别傻傻地每次都打一遍相同的提示词。

OpenCode 支持自定义命令。在 ~/.config/opencode/commands/ 目录下创建个 markdown 文件就行。

比如创建一个 test.md：

---
description: 生成单元测试
---

为指定的代码生成完整的单元测试，包括：
- 边界条件测试
- 错误处理测试
- 使用你项目现有的测试框架
- 测试文件放在同目录下的 __tests__ 文件夹中

以后只要输入 /test，AI 就知道你要干嘛了。

类似的还有 Agent Skills，可以创建更复杂的自动化流程。比如你可以创建一个 release 技能：

/skill release

AI 就会自动执行：检查版本号、更新 CHANGELOG、创建 git tag 这一套流程。

这些自定义配置放在项目根目录的 .opencode/skill/ 下，还可以提交到 Git，团队共享。

技巧五：IDE 集成和 GitHub 自动化，这才是王炸

OpenCode 不仅可以在终端里用，还能深度集成到你的开发工作流中。

VS Code / Cursor 用户： 安装扩展后，可以用快捷键直接调出 OpenCode：

• Mac: Cmd+Option+K 插入文件引用

• Cmd+Esc 在分屏终端打开 OpenCode

工作时选中一段代码，点击 OpenCode 按钮，AI 自动获得上下文，效率很高。

GitHub 集成才是真正的大招：

opencode github setup

配置好之后，你可以在 GitHub Issue 里直接 @ OpenCode：

@opencode 修复这个 bug：用户登录后 token 过期时间显示错误

AI 会自动：

1. 创建新分支

2. 定位并修复问题

3. 提交 PR

整个过程你只需要确认和合并。这才是真正的 AI 编程助手该有的样子。

写在最后

OpenCode 之所以好用，核心在于它不是简单地给你答案，而是真正融入到项目开发流程中。从初始化、到开发、到审查、到发布，每个环节都有对应的用法。

关键是要改变思维——不要把它当成一个聊天机器人，而是当成一个可以深度协作的开发者伙伴。

当然，再智能的工具也需要你懂得怎么用。希望这 5 个技巧能帮你更快上手。