OpenCode配置及使用

参考资料

安装方法

Linux

  1. 安装Node.js - 开源、跨平台的 JavaScript 运行时环境
# Download and install nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
# in lieu of restarting the shell
\. "$HOME/.nvm/nvm.sh"
# Download and install Node.js:
nvm install 24
# Verify the Node.js version:
node -v # Should print "v24.13.1".
# Verify npm version:
npm -v # Should print "11.8.0".
  1. 命令行执行
npm i -g opencode-ai

Windows

如果通过本地Docker部署了OpenCode,则可以通过命令 opencode web --hostname "0.0.0.0" --port 30000 在容器内启动web服务端(注意容器需要放通端口),然后在主机上通过浏览器http://localhost:30000/来访问,不需要安装下面的桌面客户端,功能是完全一样的

基本配置

  • 在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

此处方法针对的是没有暴露公网ip仅提供了ssh连接方式的服务端

  1. 在安装了opencode的远端环境中执行(比如华为云开发环境,serve表示不启动浏览器,如果用web会直接启动本地浏览器)
opencode serve --port 50080 --hostname 0.0.0.0

image

  1. 在本地机器的控制台窗口上执行(这里的配置使用的是VS Code连接华为云开发者空间自动生成的),保持这个命令行窗口不要关闭
ssh -4 -vvv -N -F C:/Users/用户名/.devenv/.ssh/config devenvc_h7tqki.42d920d8580f4be1a335a1f66bdbc979.0 -o IPQoS=none -o TCPKeepAlive=yes -o ServerAliveInterval=60 -o ServerAliveCountMax=3 -L 50080:localhost:50080

image

  1. 在浏览器中访问http://localhost:50080/

image

命令行

  • 直接在安装了opencode的环境的控制台中执行opencode

    注意首次使用需要选择自己配置的model,如ep-20260212220417-ltpnt

辅助插件

VSCode

  • OpenCode Beta - 管理session历史记录

任务流管理

此插件可以强化agent的计划生成和执行能力,包含自动编排agent,将任务划分为多子agent执行,深度分析代码仓等功能.
注意:由于此插件加入了大量提示词,相对于使用原版opencode,使用后会话响应会慢一些以及消耗更多的token.

按照以下说明安装和配置 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,才能看到新模式生效

基本命令

以安装了 oh-my-opencode 插件之后为例

命令

命令 功能
/init 初始化项目，生成 AGENTS.md
/connect 连接或切换 AI 模型
/model 选择模型
/new 创建新会话
/undo 撤销修改
/redo 重做操作
/terminal 显示或隐藏终端
/agent 选择智能体
/mcp 开启或关闭 MCP（Model Context Protocol）

快捷键

快捷键 功能
Tab 切换模式
Ctrl + P 打开命令面板
Ctrl + C 退出 OpenCode
posted @ 2026-02-26 14:53  JaydenChu  阅读(2415)  评论(0)    收藏  举报