企业官网建设流程全解析

1. 从一个终端里的报错说起：OpenCode 到底是个什么东西

第一次接触 OpenCode 的人，大概率不是从官网文档开始的，而是从一行红色的报错开始的。我自己就是。那天在终端里敲完命令，屏幕上弹出一句error from provider (console): opencode's free tier can only be used from within opencode，我盯着这句话看了半天——什么叫"免费额度只能在 OpenCode 里面用"？我不是正在用 OpenCode 吗？

后来才搞明白，这句话的意思是：你当前调用模型的方式，绕过了 OpenCode 自己的客户端入口，而是直接拿它的接口去喂给了别的工具。OpenCode 的免费额度是绑定在它自己的运行环境里的，你换个壳子去调，它就不认。这个设计其实挺聪明的，既控制了滥用，也把用户留在了自己的生态里。

所以 OpenCode 是什么？简单说，它是一个跑在终端里的 AI 编程助手。你在命令行里跟它对话，它能读你的项目文件、改代码、跑命令、解释报错。跟那些装在编辑器里的插件不一样，OpenCode 是独立进程，不依赖 VS Code 或者 JetBrains，你在纯 SSH 环境、远程服务器、甚至一个没有图形界面的容器里都能用。这一点对经常在服务器上干活的人来说，价值非常大。

它适合谁？三类人最该关注：一是常年泡在终端里的后端和运维，二是需要在远程环境里改代码但不想折腾图形界面的开发者，三是想找一个轻量、可脚本化、能接进自己工作流的 AI 编程工具的人。如果你只是偶尔写写前端页面，编辑器插件可能更顺手；但如果你的一天有一半时间在命令行里，OpenCode 值得认真试试。

这篇内容我会把 OpenCode 的定位、安装、免费额度的坑、Go 套餐怎么选、以及实际用起来的手感，按我自己的使用顺序讲一遍。不吹不黑，重点讲那些文档里不会写、但一上手就会撞到的东西。

2. 终端原生 AI 助手和编辑器插件的本质区别

2.1 为什么"跑在终端里"不是一个小差异

很多人第一反应是：终端里用 AI，跟编辑器里用 AI，不都是问它答它吗？差别能有多大？我一开始也这么想，直到有一次我在一台只有 SSH 的测试机上要改一个 Nginx 配置，编辑器插件完全用不了，而 OpenCode 直接就在那儿跑起来了。那一刻我才意识到，"运行位置"这件事本身就是功能。

编辑器插件的本质是寄生在编辑器进程里的。它能看到你打开的文件，能拿到光标位置，能调用编辑器的 API 去改代码。但它的边界也很清楚：编辑器没打开的文件它看不到，编辑器管不到的系统层面它碰不了，编辑器不支持的远程场景它进不去。而 OpenCode 是独立进程，它的工作目录就是你的项目根目录，它能用 shell 干任何 shell 能干的