OpenCode：重新定义 AI 编程
OpenCode 是 MIT 许可的开源终端 AI 编程 agent，也有桌面应用和 IDE 扩展。截至 2026-10-20，OpenCode 1 的最新稳定版是 v1.19.3，官方文档写它支持 75+ 家 LLM Provider，也能运行本地模型。
什么是 OpenCode？
截至 2026-10-20，OpenCode 1 的最新稳定版是 v1.19.3。OpenCode 是一款开源的终端 AI 编程助手，由社区驱动，拥有精美的 TUI 界面、多代理架构和 75+ 模型 Provider 支持，官方文档写它也能运行本地模型。它的核心理念是 BYOK（自带密钥），让开发者只需支付 API 费用，无需额外订阅。
核心功能
多代理架构
内置 Build、Plan 两个主代理和 General、Explore、Scout 三个子代理，也可以用 opencode.json 或 Markdown 文件自定义代理。
75+ 模型 Provider
基于 AI SDK 和 Models.dev 支持 75+ 家 LLM 提供商，也能运行本地模型；任何提供商都可以用 baseURL 指向自定义端点。
LSP 原生集成
自动加载语言服务器，为 LLM 提供精确的代码理解能力，包括定义跳转、引用查找等。
多会话并行
在同一项目中运行多个并行代理会话，前端和后端可同时开发。
oh-my-opencode
社区打造的增强配置框架，包含 Sisyphus、Prometheus、Oracle 等专业化代理角色。
桌面应用
支持 macOS、Windows、Linux 桌面客户端，也可在终端和 IDE 中使用。
OpenCode vs Claude Code vs Codex
| 对比项 | OpenCode | Claude Code | Codex |
|---|---|---|---|
| 定价 | 免费（BYOK） | 官方价 $20/月起 | 订阅制 |
| 模型 | 75+ Provider | Anthropic 专属 | OpenAI 专属 |
| 运行方式 | TUI + 桌面 + IDE | CLI + IDE | 桌面 + CLI + Web |
| 开源 | MIT 开源 | 闭源 | 部分开源 |
| LSP 集成 | 原生集成 | 内置 | 有限 |
| 多代理 | 内置 + oh-my-opencode | Agent Teams | Agents SDK |
| 最佳场景 | 模型灵活性、本地模型 | 复杂推理、长链编程 | 自主长时间任务 |
配合 QCode.cc 使用
在 OpenCode 里通过 provider 配置接入 QCode：Claude 型号走 anthropic provider（见下方 opencode.json 示例），GPT 与国产型号按 docs.qcode.cc 的 OpenCode 接入页配置。使用前需为 API Key 开通 API 直接请求权限。
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"anthropic": {
"options": {
"baseURL": "https://api.qcode.cc/claude/v1"
}
}
},
"model": "anthropic/claude-opus-5",
"small_model": "anthropic/claude-haiku-4-5-20251001"
}按 token 计费，各模型单价见 /models
一把 Key 调用 Claude、GPT 与主流国产模型，Claude Code、OpenCode、Codex 都能用
全程自助：支付宝、微信支付、信用卡、Apple Pay、Google Pay 与加密货币均可付款
深入：OpenCode 安装、多代理、自带 Key 与在 QCode 上接入（截至 2026-10-20）
安装与第一次上手
OpenCode 是开源的 AI 编码 agent，有终端界面、桌面应用和 IDE 扩展三种用法，代码以 MIT 许可发布在 GitHub 的 anomalyco/opencode 仓库；截至 2026-10-20，这个仓库有 217,923 个 star，OpenCode 1 的最新稳定版是 v1.19.3。
以下安装与配置按 OpenCode 1 的官方文档（opencode.ai/docs）整理；截至 2026-10-20，该文档顶部提示 OpenCode v2 已推出，v2 文档在 opencode.ai/v2/docs。OpenCode 1 最简单的安装方式是安装脚本：curl -fsSL https://opencode.ai/install | bash；也可以 npm install -g opencode-ai，或在 macOS 与 Linux 上 brew install anomalyco/tap/opencode，官方也提供 Docker 镜像 ghcr.io/anomalyco/opencode。Windows 官方建议在 WSL 里使用。这些方式装出的 opencode 命令可能与已装的 OpenCode 2 冲突或把它替换掉：两者共用 opencode 命令，按默认命令名不能同时安装。
进入项目目录运行 opencode，再执行 /init：它会分析项目，在根目录生成 AGENTS.md。官方建议把这个文件提交到 Git，帮助 OpenCode 理解项目结构与代码约定。
- 按 Tab 在 Build 与 Plan 之间切换：先让 Plan 出方案，确认后切回 Build 动手。
- 输入 @ 可模糊搜索项目文件，把文件放进提示词。
- 改错了用 /undo 撤销，可以连续多次；/redo 重做。
多代理：Build、Plan 与三个子代理
按 OpenCode 1 的官方 Agents 文档（2026-10-20 核对），OpenCode 内置两个主代理和三个子代理。Build 是默认主代理，开放全部工具；Plan 是受限的规划代理，改文件和执行 bash 默认都要先征求你的同意。子代理 General 可以并行跑多步任务，Explore 只读、用来快速检索代码库，Scout 只读、用来查外部文档和依赖源码。
主代理在会话中用 Tab 切换；子代理会被主代理按描述自动调用，也可以在消息里用 @ 点名，例如 @general。自定义代理有两种写法：在 opencode.json 的 agent 段里配置模型、提示词和权限；或在 ~/.config/opencode/agents/（全局）、.opencode/agents/（项目）下放 Markdown 文件，文件名就是代理名。
- 评审类代理设成 subagent，并把 edit 权限设为 deny，让它只提意见、不改代码。
自带 Key（BYOK）：provider 怎么配
OpenCode 基于 AI SDK 和 Models.dev 支持 75+ 家 LLM 提供商，也能运行本地模型。接入一家提供商分两步：用 /connect 填入 API key，再在配置文件的 provider 段里配置它。全局配置文件是 ~/.config/opencode/opencode.json，项目里的配置可以覆盖全局默认值。
通过 /connect 添加的 key 保存在 ~/.local/share/opencode/auth.json。任何提供商都可以设置 baseURL 选项，改用代理服务或自定义端点；不在列表里的 OpenAI 兼容服务，在 /connect 里选 Other 新建一个 provider ID，再在 opencode.json 里用 @ai-sdk/openai-compatible 包声明它。
在 QCode 上怎么做
QCode 一把 Key 调用 Claude、GPT 与主流国产模型，按 token 计费，各模型单价见 /models；全程自助，几分钟上手。下面的步骤照 docs.qcode.cc 的 OpenCode 接入页整理。
- 注册 QCode 并充值，付款支持支付宝、微信支付、信用卡（Visa / Mastercard / AMEX）、Apple Pay、Google Pay 与加密货币。
- 为 API Key 开通 API 直接请求权限：该权限默认关闭，联系在线客服或发邮件到 hi@qcode.cc 开通。
- 在 ~/.config/opencode/opencode.json 的 anthropic provider 里把 options.baseURL 设为 https://api.qcode.cc/claude/v1，模型写 anthropic/claude-opus-5，日常也可用 anthropic/claude-sonnet-5。
- 运行 /connect，选 Anthropic，再选 Manually enter API Key，粘贴 QCode 的 Key；输入 /exit 退出后重新打开 OpenCode。
- GPT 型号走 openai provider，baseURL 按同一接入页填写；Claude 只支持 Anthropic 协议，不要配到 OpenAI 兼容端点上。
OpenCode 常见问题
OpenCode 要付费吗？
OpenCode 本身是 MIT 许可的开源软件，费用来自你接入的模型：用自己的提供商 API key 时按对方计费，也可以用 OpenCode 官方的 Zen（按量付费）或 Go（官方价 $10/月，Go Plus 官方价 $40/月）。截至 2026-10-20。
OpenCode 能用 Claude 模型吗？
能，走 anthropic provider 即可。接 QCode 时把 baseURL 设为 https://api.qcode.cc/claude/v1，模型写 anthropic/claude-opus-5 这类 ID。Claude 只能走 Anthropic 协议，配到 OpenAI 兼容端点会返回错误。
Build 和 Plan 代理有什么区别？
Build 是默认主代理，开放全部工具，用来实际改代码；Plan 是受限代理，改文件和执行 bash 默认都要先征求你同意，适合先分析、出方案。会话中按 Tab 切换。
接 QCode 后连不上或提示模型不可用，怎么排查？
按接入页的提示逐项查：Key 是否已开通 API 直接请求权限；baseURL 是否填对、Key 是否已保存；模型 ID 是否与 QCode 支持的名称一致（见 /models）；仍不行可以换用 asia.qcode.cc 或 us.qcode.cc。
OpenCode 必须自备 API Key 吗？
不一定。官方文档写：用 OpenCode 时你可以配置任意一家 LLM Provider 的 API key；刚开始用 LLM Provider 的话，官方推荐先用 OpenCode Zen——那是 OpenCode 团队测试并验证过的模型清单。想用 QCode 一把 Key 调 Claude、GPT 与主流国产模型也可以：QCode 支持支付宝和微信支付，也支持信用卡（Visa / Mastercard / AMEX）、Apple Pay、Google Pay 与加密货币，全程自助，无需境外信用卡；按 token 计费，各模型单价见 /models。充值后为 Key 开通 API 直接请求权限，就能在 OpenCode 里使用。截至 2026-10-20。
OpenCode Go 和自带 Key 怎么选？
截至 2026-10-20，Go 是官方价 $10/月（Go Plus 官方价 $40/月）的开源模型订阅，额度按每个模型的月度美元额度计，5 小时内最多用掉 20%、一周最多 50%；名单里没有 Claude Opus 和 Claude Sonnet。需要 Claude、GPT 前沿型号，或更想按 token 计费，用自带 Key（例如 QCode）更合适。QCode 无 4 小时窗口。