瞬界AI 工具 · 模型资料 · 每日快讯
04宿主工具 · 文档

资料修改2026-09来源核对 2026-10-26 · V2安装、配置位置、重载及V1边界;非安装实测或全文核验

TOOLBOX / 宿主工具 · CLI · 开源

本文仍包含未全面复核的历史资料;安装、许可、费用与当前权限请回到官方确认。查看已核信息范围

OpenCode V2

2026-10-26按官方V2文档核对。OpenCode提供终端、桌面和Web客户端,客户端与后台服务分离;旧V1安装包和配置片段不要与V2教程混用。

安装与入口

npm install -g @opencode/cli
opencode

macOS / Linux官方V2脚本:

curl -fsSL https://opencode.ai/v2/install | bash

Windows也可从官方V2页面选择x64/ARM64独立CLI或桌面安装包;本次官方V2页面明确写Windows包管理器不受支持,不能继续照抄V1的scoop/choco建议。安装命令本轮未在新机执行。

配置边界

  • 项目服务配置为opencode.json(c)或.opencode/opencode.json(c);全局为~/.config/opencode/opencode.json(c)。
  • 终端界面的主题、快捷键等使用全局cli.json,不是服务配置。不要将两类设置放进同一文件。
  • V2原生MCP配置在mcp.servers下;优先按官方MCP文档使用管理命令和正常OAuth登录,密钥用环境变量,不要写进示例或仓库。
  • 配置变化支持监视和重载,可用/reload;正常配置修改不要求重启服务。服务故障和配置生效是两类问题。

模型与费用

通过/connect连接支持的供应商;自定义兼容端点、本地模型和供应商认证方式按官方对应指南配置。软件开源不等于每个模型免费,Go订阅、Console及第三方API分别计费,当前价格见站内价格页。

来源

迁移前备份配置和重要会话;本页不再引用未经核实的“beta升级必然清空数据”作为现行结论。