之前，xiaoz 一直使用 VS Code + GitHub Copilot 作为 AI 编程方案，但由于 Copilot 额度越来越不够用，不得不寻找替代品。大约半年前，我开始接触并使用 OpenCode，如今它已成为我的主力 AI 编程工具。起初有些不习惯，但现在越用越顺手，于是写下这篇文章，分享我的 OpenCode 编程方案。
注意：这篇文章不适合新手小白，推荐有一定编程基础的人士阅读！！！
关于OpenCode
OpenCode 是一个开源的 AI 编码工具。它提供终端界面、WebUI、桌面应用和 IDE 扩展等多种使用方式。
安装OpenCode
直接使用下面的命令安装即可：
# pnpm命令安装
pnpm install -g opencode-ai
# bun命令安装
bun install -g opencode-ai配置和使用OpenCode
使用WebUI
OpenCode提供了多种使用方式，包括：终端界面（TUI）、桌面应用、WebUI等，xiaoz目前用得最多的是WebUI，原因是WebUI可以很方便的在多个项目、多个模型之间快速切换，所以下面也会以WebUI的使用方式展开介绍。
要通过WEB界面访问OpenCode，我们只需要进入项目目录，然后输入命令：opencode web即可，如下图所示：
然后根据提示访问：http://IP:4096端口即可。
两种模式
在开始使用OpenCode之前，我们需要了解OpenCode的两种模式，分别是Plan和Build，区别是：
- Plan模式：只读模式，不会修改和创建任何文件，适合先和AI讨论需求
- Build模式：自动执行代码修改、创建、删除等操作，适合确认需求后执行任务
我个人建议是，先用Plan模式和AI讨论具体需求，待需求确认完毕后，再切换到Build模式执行，这样能写出更好、更符合预期的代码，而不是一上来就使用Build模式。另外模式切换只需要在对话框切换即可。
免费模型
OpenCode会不定期推出一些免费模型，在对话框底部OpenCode Zen可以看到可用的免费模型，比如近期提供的免费模型包括：DeepSeek V4 Flash Free、MiMo V2.5 Free、MiniMax M3 Free
OpenCode的良心之处在于使用这些免费模型不需要你注册任何账号和配置，直接切换使用即可。而且xiaoz摸清了一个套路，基本上国内新上的顶级模型，在一段时间内都会在OpenCode免费提供，但这些免费模型在不断变化。
配置更多模型
OpenCode工具如其名，非常的开放，几乎市面上的所有AI大模型均可接入使用，几乎来着不拒，你可以在设置里面选择供应商接入，也可以自定义API接入（只需要兼容OpenAI格式即可）
查看代码
我个人不太推荐使用WebUI来查看代码（不太方便），建议配合专业的编辑器一起使用，xiaoz常用的编辑器主要是Zed 和 VS Code
初始化项目
要想发挥AI编程工具的能力，千万别一来就闷头写，这样可能无法达到预期效果，在对话框输入/init指令，OpenCode会扫描项目结构、技术框架、组件等内容，然后整理并输出为AGENTS.md,后续再写代码的时候AI大模型均会参考AGENTS.md里面的内容（部分弱智模型除外），如果你发现内容不符合你的预期，也可以自行微调或补充。
更多可复用的规范、函数或文档，还可以让OpenCode帮你整理为skills，从而提高代码质量。
OpenCode写代码效果咋样？
模型能力差异
OpenCode本质上只是一个AI编程工具，实际的最终效果比较依赖大模型的能力，不同质量的模型写出来的效果差异还是蛮大的。xiaoz常用的模型包括：
- GPT-5.5、GPT5.4
- DeepSeek V4
- Mimo V2.5
- Qwen最新模型
有条件的话上旗舰模型是最好的。
一些使用技巧
先用Plan模式讨论功能需求，再用Build模式执行方案，不建议一上来就用Build模式，除非是非常简单且明确的需求。- 一定要用
/init指令初始化和整理项目 - 修改文件的时候尽可能描述并明确指出文件，而不是让AI去寻找和猜测，不然耗费tokens会比较多，且可能还不太准确
- 规范或可复用函数，建议整理为skills
- 尽量使用更优质的大模型
项目可维护性
AI编程确实把门槛拉低了不少，但博主觉得不是人人都能做好开发——尤其是一个要长期维护的项目。你连技术框架、项目结构、业务逻辑都不了解，项目就注定不可持续，到后面根本没法维护。自己都搞不清框架和流程，就没法跟AI讲清楚需求，AI自然也给不出你想要的代码。所以说，同样的工具、同一个模型，有人写出来的项目结构清晰、能长期跑下去，有人却写成一团乱麻，最后只能重来。区别不在AI，在开发者自己的逻辑能力和工程素养。
所以开始一个新项目前，xiaoz 都会亲自确认所用的开发语言、框架、组件、规范，以及目录结构、路由组织等，只用自己熟悉的那一套，决不让项目脱离把控。换个角度说，这时你充当的是架构师或产品经理，而不再是一个程序员。
其它说明
升级OpenCode版本
# 升级OpenCode版本
opencode update配置文件
OpenCode全局配置位于：~/.config/opencode/opencode.json
使用文档
现在OpenCode提供了中文使用文档，建议在使用前大概扫一遍文档：https://opencode.ai/docs/zh-cn/ 可极大的帮我们提高使用效率和效果。
结语
总而言之，OpenCode 凭借开放、灵活的模型接入和便捷的 WebUI，已成为我的主力 AI 编程工具。但工具只是放大器，真正决定项目长期可维护性的，仍是开发者自身的工程素养与架构能力。用好 /init、Plan/Build 配合与优质模型，方能事半功倍，最后祝你编码愉快。
