参考资料
-
官方网站
https://opencode.ai/zh
安装方法
Linux
- 安装Node.js - 开源、跨平台的 JavaScript 运行时环境
- 命令行执行
npm i -g opencode-ai
- 注意: 虽然桌面客户端有Linux版, 但是是x86的, 是提供给Ubuntu等带图形界面的操作系统的
Windows
如果通过本地Docker部署了OpenCode,则可以通过命令 opencode web --hostname "0.0.0.0" --port 30000 在容器内启动web服务端(注意容器需要放通端口),然后在主机上通过浏览器http://localhost:30000/来访问,不需要安装下面的桌面客户端,功能是完全一样的
-
安装桌面版
OpenCode | 下载
基本配置
- 在OpenCode工作目录下创建文件opencode.json写入
{"$schema": "https://opencode.ai/config.json","provider": {"myprovider": {"npm": "@ai-sdk/openai-compatible","name": "volcengine","options": {"baseURL": "https://ark.cn-beijing.volces.com/api/v3","apiKey": "个人api密钥"},"models": {"模型接入端点名(在opencode中的命名,即显示的模型名称)": {"name": "模型接入端点名(实际名称)"}}}}
}
使用方式
web
- 在安装了opencode的环境中执行
opencode web --hostname "0.0.0.0" --port 访问端口
- 在浏览器中访问http://安装了opencode的环境的ip:访问端口
-
opencode web启动时存在两个进程,这是正常现象
![]()
启动命令：opencode web --hostname 0.0.0.0 --port 30000│▼
┌─────────────────────────────────────────────────────────┐
│ 进程 1 (PID 89846) - Node.js 包装器 │
│ node /root/.nvm/.../bin/opencode │
│ 作用：CLI 入口、参数解析、环境检查 │
└────────────────────┬────────────────────────────────────┘│ fork/spawn▼
┌─────────────────────────────────────────────────────────┐
│ 进程 2 (PID 89854) - 实际服务进程 │
│ .../opencode-linux-x64/bin/opencode │
│ 作用：运行 Web 服务器、处理请求、核心业务逻辑 │
└─────────────────────────────────────────────────────────┘
命令行
-
直接在安装了opencode的环境的控制台中执行opencode
注意首次使用需要选择自己配置的model,如ep-20260212220417-ltpnt
辅助插件
VSCode
- OpenCode Beta - 管理session历史记录
任务流管理
-
GITHUB主页
oh-my-opencode/README.zh-cn.md at dev · code-yeongyu/oh-my-opencode · GitHub
-
安装命令,在opencode中输入(此为其官方推荐安装方式)
按照以下说明安装和配置 oh-my-opencode：
https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/docs/guide/installation.md
- 注意
-
如果安装时长时间卡住,则用npx oh-my-opencode install 命令手动安装
-
需要配置额外的模型,可以让ai配置成和opencode一样的(提示词:修改oh-my-opencode中所有模型配置使其使用和/mnt/workspace/opencode.json中的配置一致;将oh-my-opencode的sisyphus模式所使用模型也切换为和/mnt/workspace/opencode.json中配置的一致)
模型定义文件中的格式为 "model": "myprovider/ep-20260212220417-ltpnt", 其中myprovider时opencode配置中provider中的key,以及ep-20260212220417-ltpnt为models中的key
-
不同模式间按TAB切换
-
此插件开启后,如果使用了opencode web,则需要重启opencode web,才能看到新模式生效
-