OpenCode 接入免费模型实战

⚠️ 待更新·2026-08-29核验 · 更新时间待核验 · 本文信息可能已过期，请以官方文档为准 更新时间：2026-08-29 · 核验状态：待更新 · 官方溯源待补

简介

OpenCode 自身不收费,成本完全来自模型 API。好消息是,OpenRouter、Groq、Together AI 等平台都提供免费层模型,通过 OpenAI 兼容协议即可接入。本文给出三套即用配置,并对比各家免费层在编程任务上的实际表现。

架构图

前置准备

确认已安装 OpenCode(参考 us-01),并准备好以下 Key:

• OPENROUTER_API_KEY:在 https://openrouter.ai/keys 申请
• GROQ_API_KEY:在 https://console.groq.com/keys 申请
• TOGETHER_API_KEY:在 https://api.together.ai/settings/api-keys 申请

全部用环境变量管理,避免硬编码到配置文件。

配置文件

把以下内容写入项目根目录 opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openrouter": {
      "options": {
        "baseURL": "https://openrouter.ai/api/v1"
      },
      "models": {
        "meta-llama/llama-3.3-70b-instruct:free": {
          "name": "Llama 3.3 70B (free)"
        }
      }
    },
    "groq": {
      "options": {
        "baseURL": "https://api.groq.com/openai/v1"
      },
      "models": {
        "llama-3.3-70b-versatile": { "name": "Llama 3.3 70B Groq" },
        "llama-3.1-8b-instant": { "name": "Llama 3.1 8B Instant" }
      }
    },
    "together": {
      "options": {
        "baseURL": "https://api.together.xyz/v1"
      },
      "models": {
        "meta-llama/Llama-3.3-70B-Instruct-Turbo": { "name": "Llama 3.3 70B Together" }
      }
    }
  },
  "model": "groq/llama-3.3-70b-versatile"
}

注入密钥

export OPENROUTER_API_KEY="sk-or-v1-..."
export GROQ_API_KEY="gsk_..."
export TOGETHER_API_KEY="..."

OpenCode 会按 provider 名称自动匹配同名环境变量,无需在配置中硬编码 Key。

启动与切换

opencode

进入 TUI 后,按 Ctrl+M 可在已配置的模型间快速切换。日常写代码选 Groq 的 llama-3.3-70b-versatile(速度极快,首字延迟常低于 300ms),复杂推理切到 OpenRouter 的 llama-3.3-70b-instruct:free,代码补全用 llama-3.1-8b-instant 最划算。

免费层对比

模型选型经验

经过实测,各家免费模型在不同任务上表现差异明显:代码补全选 Groq 的 llama-3.1-8b-instant,延迟低且免费配额大;复杂重构与算法题选 OpenRouter 上的 llama-3.3-70b-instruct:free,70B 参数量带来更强推理;中文文档撰写选 Together 上的 Qwen 系列。建议把多家都配上,任务来时按需切换。

常见问题

• 429 Too Many Requests:免费层有 RPM 限制,等 30 秒或切换另一家 provider。推荐把三家都配上,出问题就 Ctrl+M 切换。
• 中文输出乱码:终端设置 export LANG=en_US.UTF-8,或在 prompt 里加 Always respond in Simplified Chinese。
• 想用 OpenRouter 的 :free 模型但报 403:确认账户已绑定信用卡(OpenRouter 免费模型也要求验证,不会扣费)。
• context 超 8K 报错:8B 模型上下文有限,改用 70B 或拆分文件。

至此,你已经拥有一个完全免费的终端 AI 编程环境。

常见坑与最佳实践

• 多 provider 切换需要 /model 命令：OpenCode 不会自动 fallback，单个 provider 429 时需要手动切到备用模型。
• Token 上下文要小：免费模型大多 8K-32K 上下文，长文件先 chunk 再投。
• API Key 不入 Git：apiKey: "${ENV_VAR}" 引用语法必须用，避免 commit hook 拦不住的泄露。
• Groq 比 OpenRouter 快：日常编程优先接 Groq，OpenRouter :free 留作降级。

🚀 立即开始：免费 API 一键调用

想要无需逐一注册、统一鉴权调用以上全部免费模型？Apishare.cc 提供统一 API Key，一个 Key 调用 100+ 模型，免费模型零成本直连。

👉 立即注册 Apishare.cc → 获取你的统一 API Key

📊 想看更多免费模型排行？查看 2026年9月 免费 LLM API 综合实力榜单 →

立即上手：APIShare 免费 API 目录

• 🆓 注册领取免费额度：立即注册 APIShare · 登录控制台
• 🔍 浏览全部免费 API 与实时榜单：APIShare 免费 API 目录
• 📊 查看免费 LLM API 排行：Free LLM API Rankings

免费 API 聚合平台说明

本文涉及的模型均由 APIShare 免费 API 聚合平台 统一接入，一份 Key 调用全站模型。

• 完整模型目录：APIShare 免费 API 目录
• 注册即送免费额度：注册领取 API Key