OpenCode2迁移与免费模型

OpenCode：16 万 star 级开源终端 AI 编程代理（v2 时代主仓库 209K star / 950+ contributors / 官方称 1600 万+ 月活开发者）。2026-07 beta、09 月中旬转正。本文沉淀 v1→v2 迁移要点与免费模型清单。

转正信号（别听社区传言，盯官网三个信号）

1. 首页横幅 “New OpenCode v2 is now available”；
2. 全站安装命令换成 curl -fsSL https://opencode.ai/v2/install | bash（或 npm i -g @opencode/cli）；
3. 官网 GitHub 链接全部指向 v2 分支。

版本线佐证：v2.0.2（9/12）→ v2.0.10（9/19）一周 9 个小版本；v1.18.31（9/14）仍在发，双线并行维护。注意 changelog 页可能滞后、GitHub releases 主页可能还停在 v1——以官网为准。

安装与共存

• v1/v2 共用 opencode 一个命令，不再默认并行安装（beta 期”装两个、opencode2 指 v2”结束）；装 v2 的 curl 安装器会直接替换旧二进制，先卸包管理器装的 v1；
• v2 技术栈：Bun→Node、桌面端 Tauri→Electron、多标签并行会话、内存占用下降、服务常驻跨设备可连。

3 个 Breaking Changes

1. 插件 API 重构：v1 插件在 v2 跑不了（入口/hooks/工具/事件全按新 API 重写）——依赖插件的工作流这是最大成本；
2. Server API 重构：调过 v1 服务端的集成迁到新契约，用官方 @opencode/client 包；
3. 终端配置合并：分层 tui.json(c) → 单一全局 ~/.config/opencode/cli.json（首次启动自动迁移）。

.opencode/ 下的 agents、commands、skills 文件官方承诺”应该不用改就能用”。

配置改名速查（想转原生格式时用）

• 权限动作：bash→shell、task→subagent、write/patch→edit；结构从按工具分组变单一有序 permissions 数组；
• 单数变复数：agent→agents、command→commands、provider→providers、snapshot→snapshots、attachment→media；
• compaction：preserve_recent_tokens/reserved→keep.tokens/buffer；
• skills：paths+urls 合并成一个数组；
• MCP：服务器收进 mcp.servers，enabled→disabled（语义反转），timeout 拆 catalog/execution 两档；
• providers：azure-cognitive-services→azure、google-vertex-anthropic→google-vertex、npm→package（AI SDK 包加 aisdk: 前缀）；
• 模型 variant：独立 variant: high 合并进模型引用 anthropic/claude-sonnet-4-5#high。

关键原则：v2 直接读 v1 格式配置并自动归一化，不强制转。想转时可以直接让 OpenCode 自己动手（提示词：“Migrate my OpenCode configuration… Preserve its behavior and all unrelated settings.”），v1/v2 字段顶层可共存。

迁移 5 步与细节坑

五步：保留现有配置 → 启动 v2 验证（模型/凭证/agents/permissions/MCP）→ 移植插件（必做）→ 移植 server API 集成 → 可选转换配置。

细节坑：v2 不跑 LSP 了（lsp 配置接受但不生效，依赖 LSP 诊断的换 lint/typecheck/编译命令）；转成 v2 原生格式后别再喂回 v1；mcp/compaction/experimental 可混写但单个 agent/provider/command/model 内部必须单一格式；logLevel 被忽略改用 OPENCODE_LOG_LEVEL 环境变量；autoshare→share（布尔变 "auto"/"disabled" 三态）；subtask 命令改名 subagent。

升不升：插件一堆的先别切（等生态迁移）；无插件依赖可升（配置自动迁移，翻车代价小）；尝鲜先备份配置。

免费模型全家桶（9 个，2026-09-24 口径）

模型	出品	定位
Big Pickle	OpenCode 自家	日常写代码最稳的主力
Space Bunny Free	OpenCode 自家	官方标注零保留（数据不留存）
MiMo-V2.6-Flash / V2.5 Free	小米	开源模型
Ling 3.0 Flash Fin Free	阶跃星辰	长上下文
Nemotron 3 Ultra / 3.5 Lightning Free	NVIDIA	开源模型
Muse Spark 1.3 Contributor Free	Meta	写代码表现不错
Jev 1.13 Free	TypeSafe	决策专用（systemone 端点，不能聊天；限时免费）

搭配思路：写代码 Big Pickle，长文档 Ling/Nemotron，拍板的事 Jev（Jev 用法详见 Jev与SystemOne模型）。注意免费模型随时可能调整，重要流程别绑死单个免费项。

增补：多 Agent 统一管理（Paseo 与 Paperclip，2026-10-04）

Paseo（开源 18.7k★，#801）：把 Claude Code / Codex / OpenCode / Pi 收进一个界面统一管理——Agent 仍跑在本地（账号/配置/Skill/MCP 都是自己的），Paseo 只做管理层。跨 Agent 协作三指令：/paseo-handoff（任务交接：Claude 规划→Codex 开发）、/paseo-advisor（拉一个 Agent 当顾问只给意见不接手）、/paseo-committee（两个风格不同的 Agent 组小组分析根因对比方案）。手机 iOS/Android 客户端配对后看的就是电脑上同一份 Agent 列表，支持语音口述（语音识别可放本地）；多 Agent 改同一项目用独立 git worktree 隔离，界面对照基线分支合并/开 PR；无遥测不强制登录，配对走端到端加密中继或 Tailscale 直连，另有桌面/Web/CLI 与 TypeScript SDK。

Paperclip（8.5 万★，#797 热榜）：把一群 Agent 管成一家公司——岗位/目标/任务看板 + 组织架构/审批/预算/审计；Agent 到预算上限自动停，重要任务先进审批，每次对话与工具调用留痕。定位差异：Paseo 偏个人多窗口管理，Paperclip 偏团队治理（只跑一个 Agent 的话组织图反而是负担）。

原始素材

• v2 转正与迁移（AI 阿砚）
• #801 Paseo
• #797 热榜（Paperclip）
• 免费模型盘点与 Jev 上手（AI 阿砚）

相关页面

• Jev与SystemOne模型
• Claude-Code使用与内部机制（同类终端 AI 编程代理的对照）