企业官网建设流程全解析

1. 三条免费路径的底层逻辑与选型思路

OpenCode 这个工具最近在开发者圈子里讨论度很高，本质上它是一个终端里的 AI 编程助手，能在命令行里直接读写代码、执行任务、跑测试。但很多人装完之后卡在第一步：模型从哪来？官方免费额度有使用范围限制，直接调用会报opencode's free tier can only be used from within opencode这类错误。所以真正要解决的问题不是“怎么装 OpenCode”，而是“怎么给它接上一个稳定、免费、可控的模型来源”。

我把目前可行的方案归成三条路径，按上手难度和长期可用性排一下。第一条是 Zen 免费池，也就是 OpenCode 自带的免费模型通道，开箱即用但有调用范围约束；第二条是 OpenRouter 的免费模型，注册后拿 API Key，能白嫖一批带:free后缀的模型；第三条是本地 Ollama，把模型跑在自己机器上，彻底不依赖外部额度。这三条不是互斥的，实际用起来往往是组合拳：日常轻量任务走 Zen，复杂推理走 OpenRouter 免费模型，涉及隐私代码或者断网环境就切本地 Ollama。

为什么这么排？因为免费这件事有三个维度在互相拉扯：额度、隐私、稳定性。Zen 免费池额度最省心但受使用场景限制；OpenRouter 免费模型选择多、能力强，但免费额度有每日请求上限，且你的代码会经过第三方；Ollama 完全没有额度焦虑、数据不出本机，代价是吃硬件、首次下载模型慢。理解这个三角关系，后面所有配置选择就都有依据了。

这篇文章适合三类人：刚装好 OpenCode 不知道怎么接模型的新手、被官方免费额度报错卡住的用户、以及想搭一套“零成本 + 可离线”开发环境的折腾党。下面我会把三条路径的完整操作、参数含义、踩坑点全部拆开讲，配置能直接抄。

2. Zen 免费池：开箱即用的第一站与它的边界

2.1 Zen 免费池到底是什么

Zen 是 OpenCode 内置的模型接入层，你可以把它理解成官方帮你托管的一个模型网关。装完 OpenCode 后不需要填任何 API Key，直接就能调用它提供的免费模型。这对刚上手的人非常友好——不用注册、不用绑卡、不用配环境变量，敲命令就能用。

它的工作方式是这样的：OpenCode 客户端在发起请求时，会带上自己的身份标识，Zen 网关校验这个标识后决定是否放行。所以免费池的模型并不是“随便谁都能调”，而是“必须从 OpenCode 客户端内部发起”。这就是为什么你如果拿 Zen 的接口地址去别的工具里调用，会直接撞上opencode's free tier can only be used from within opencode这个报错。它不是配置错了，而是设计上就做了来源校验。

2.2 正确启用 Zen 免费池的步骤

启用过程比想象中简单，但有几个细节容易漏。第一步，确认 OpenCode 版本。老版本可能没有 Zen 通道或者模型列表不同，建议先升级到较新的版本。第二步，在 OpenCode 的配置文件里把 provider 指向 zen，或者直接在交互界面里选择免费模型。第三步，验证连通性，随便问一个简单问题看是否返回。

配置片段大致长这样，具体字段名以你本地版本为准：

{ "provider": "zen", "model": "zen-free-default" }

这里要强调一个点：不要手动去改 Zen 的 base URL。有些人看到报错就想着把接口地址换成别的，结果越改越乱。Zen 的地址是客户端内部管理的，你只需要选 provider 和 model，剩下的交给 OpenCode。

2.3 Zen 免费池的适用边界与注意事项

Zen 免费池最大的价值是“零配置起步”，但它的边界也很明确。第一，只能在 OpenCode 内部用，不能导出给别的工具；第二，免费模型通常是能力中等偏下的型号，适合日常补全、简单重构、写注释这类任务，遇到复杂算法或者长上下文推理会力不从心；第三，免费池可能有并发或频率限制，高峰期响应会变慢。

提示：如果你在 OpenCode 里看到free tier can only be used from within opencode，先别急着怀疑网络，九成是你在外部工具里调了 Zen 的接口，或者客户端身份校验没通过。回到 OpenCode 内部用就正常了。

我的实际体会是，Zen 适合当“默认档”。平时写点小脚本、改改配置、生成个正则，用它完全够。真正要它干重活的时候，再切到下面两条路径。

3. OpenRouter 免费模型：白嫖一批强模型的正确姿势

3.1 OpenRouter 是什么，为什么值得接

OpenRouter 是一个模型聚合平台，把市面上大量模型统一成一个 API 接口。它的价值在于：你注册一个账号、拿一个 Key，就能调用几十上百个模型，其中一批带:free后缀的是完全免费的。对 OpenCode 用户来说，这意味着不用分别去各家注册，一个 Key 打通。

为什么推荐它作为第二条路径？因为 Zen 免费池的模型能力有限，而 OpenRouter 的免费模型里不乏能力不错的型号，做代码理解、重构、解释报错都够用。而且它支持支付宝充值（虽然免费模型不需要充值），对国内用户友好。免费模型的额度通常是按天算的请求次数，日常个人开发基本够。

3.2 获取 API Key 与配置 OpenCode

第一步，进 OpenRouter 官方入口注册账号，邮箱验证后进控制台。第二步，在 Keys 页面创建一个新的 API Key，复制保存好——它只显示一次。第三步，回到 OpenCode 配置里新增一个 provider。

配置示例：

{ "provider": "openrouter", "apiKey": "sk-or-v1-你的密钥", "model": "某个模型:free" }

模型名一定要带:free后缀，否则会走付费通道。比如你想用某个免费模型，就去 OpenRouter 的模型列表里筛“Free”标签，把完整模型 ID 复制过来。这里有个坑：模型列表更新很快，今天免费的明天可能下架，所以配置前先去官网确认当前还有哪些:free模型在线。

3.3 免费额度的规则与省钱技巧

OpenRouter 免费模型的额度规则大致是：每个账号每天有一定次数的免费请求，具体数字会调整。超过之后要么等第二天重置，要么充值走付费。这里分享几个实测有效的技巧。

第一，把免费模型当“主力轻任务”用，付费模型留给硬骨头。日常问答、代码解释用免费的就够，遇到需要长上下文或者高推理能力的任务再考虑付费，这样免费额度消耗得慢。

第二，注意请求频率。短时间内连续发大量请求容易触发限流，报 429。写脚本批量调用时加个间隔。

第三，密钥管理。不要把 Key 硬编码在会提交到仓库的文件里，用环境变量。OpenCode 支持从环境变量读 Key，配置里写变量名即可。

注意：OpenRouter 免费模型的数据会经过平台，涉及公司私有代码或者敏感信息时，别用免费通道，切本地 Ollama。

3.4 常见报错与排查

接 OpenRouter 最常遇到的是 401 和 429。401 基本是 Key 错了或者没生效，检查有没有多余空格、有没有复制完整。429 是限流，等一会儿或者换模型。还有一种情况是模型名写错，报 model not found，回去核对完整 ID。另外，如果你在国内网络环境下遇到连接问题，优先检查本地网络配置，不要盲目改 OpenCode 的代码。

4. 本地 Ollama：彻底摆脱额度焦虑的终极方案

4.1 为什么要在本地跑模型

前两条路径都依赖外部服务，额度、隐私、网络都是变量。Ollama 把模型跑在你自己的机器上，数据不出本机，没有请求次数限制，断网也能用。对于经常处理私有项目、或者想搭一套完全自主可控开发环境的人来说，这是最踏实的方案。

代价也很直接：吃硬件。模型越大，对内存和显存要求越高。一台 16GB 内存的普通笔记本，跑 7B 级别的量化模型勉强可以，跑更大的就吃力。所以选模型时要看自己机器的配置，别一上来就拉最大的。

4.2 安装 Ollama 与解决下载慢的问题

安装本身不复杂，官网下载对应系统的安装包，一路下一步。真正的痛点是下载模型慢。默认从官方源拉模型，国内速度经常感人，几个 G 的模型能下半天。解决办法是配置国内镜像源。

设置环境变量指向镜像，然后重启 Ollama 服务：

export OLLAMA_HOST=127.0.0.1:11434

镜像源的配置方式因版本而异，核心思路是把模型拉取地址指向国内可访问的镜像。配好之后再用ollama pull拉模型，速度会有明显改善。如果还是慢，可以找离线安装包，手动导入模型文件，适合网络条件特别差的环境。

4.3 拉取与运行模型

拉模型命令很直观：

ollama pull qwen2.5-coder:7b

这里选模型有个经验：代码任务优先选带 coder 后缀的模型，它们在代码补全和理解上针对训练过，效果比通用模型好。7B 是甜点尺寸，兼顾效果和资源占用。机器好的可以上 14B 甚至更大。

拉完之后运行：

ollama run qwen2.5-coder:7b

能进交互界面就说明本地服务正常。有时候会遇到500 internal server error: llama-server process这类报错，多半是内存不够或者模型文件损坏。先确认内存余量，再重新拉一次模型。

4.4 把 Ollama 接进 OpenCode

Ollama 默认在本地 11434 端口提供兼容接口，OpenCode 可以直接把它当 provider。配置大致如下：

{ "provider": "ollama", "baseUrl": "http://127.0.0.1:11434", "model": "qwen2.5-coder:7b" }

配好之后，OpenCode 的请求就打到本地模型上，完全不经过外网。实测下来，本地模型在简单任务上响应很快，复杂任务会慢一些，但胜在稳定和私密。

4.5 本地部署的硬件与模型选择建议

给个粗略的参考表，方便你对号入座：

提示：量化版本（如 q4）能大幅降低资源占用，效果损失有限，普通开发优先选量化版。

5. 三条路径的组合策略与切换技巧

5.1 按任务类型分流

单独用一条路径都有短板，组合起来才顺。我的习惯是：写注释、改格式、生成小片段走 Zen，零配置最快；解释报错、理解陌生代码走 OpenRouter 免费模型，能力强；处理私有代码、断网环境走 Ollama。OpenCode 支持配置多个 provider，切换成本很低。

5.2 配置多 provider 的写法

在配置里把三个 provider 都列上，用的时候指定：

{ "providers": { "zen": { "model": "zen-free-default" }, "openrouter": { "apiKey": "sk-or-v1-xxx", "model": "xxx:free" }, "ollama": { "baseUrl": "http://127.0.0.1:11434", "model": "qwen2.5-coder:7b" } }, "default": "zen" }

这样默认走 Zen，需要时切到别的。切换命令看 OpenCode 版本，一般在交互界面里能选。

5.3 额度与成本的平衡

免费不等于无限。Zen 有范围限制，OpenRouter 有每日次数，Ollama 有硬件成本。把高频轻任务放在额度消耗慢的通道，把重任务放在能力强的通道，是长期可持续的用法。别把所有请求都堆到一个免费通道上，很容易撞限流。

6. 实操中踩过的坑与排查速查表

6.1 典型问题速查

6.2 几个容易忽略的细节

第一，环境变量优先级。OpenCode 读 Key 时，环境变量和配置文件可能冲突，搞清楚哪个优先，避免改了没生效。第二，模型名大小写。有些平台的模型 ID 对大小写敏感，复制时别手改。第三，本地端口占用。Ollama 默认 11434，如果被别的程序占了会起不来，改端口或者关掉冲突程序。

6.3 关于“只思考不回答”的现象

有用户反馈 OpenCode 接了某些模型后只输出思考过程不给出最终答案。这通常是模型本身的输出格式和 OpenCode 的解析逻辑没对齐。换一个模型试试，或者在配置里调整输出格式相关的参数。这不是 OpenCode 的 bug，多半是模型适配问题。

7. 我个人的组合用法与几点体会

折腾这套环境有段时间了，最后稳定下来的用法是：默认 Zen 打底，遇到 Zen 搞不定的切 OpenRouter 免费模型，涉及公司代码一律切本地 Ollama。三套配置都留在配置文件里，切换就是改一行的事。

几个真实体会。第一，别追求“一条路径通吃”，免费方案的本质就是用组合换成本，接受这个前提心态会好很多。第二，本地模型的首次下载是最劝退的环节，配好镜像源能省大量时间，值得花十分钟搞定。第三，免费额度是公共资源，别写脚本疯狂刷，既容易被限流也不厚道。第四，配置改完记得重启 OpenCode 服务，很多“改了没生效”都是忘了重启。

如果你刚开始，建议按 Zen → OpenRouter → Ollama 的顺序逐步加，每加一条验证一条，别一次性全配上，出问题不好定位。等三条都跑通了，再根据自己的任务类型定默认通道。这套组合用下来，日常开发基本可以做到零模型成本，同时保留随时切换到更强模型的能力。