1、先安装node

具体安装参见 https://www.jianshu.com/p/e89a9e1829bf

2、安装opencode

硬件配置建议
内存：最低4GB，推荐8GB以上
存储空间：至少500MB可用空间
网络连接：稳定的互联网访问

# 使用npm安装
npm install -g opencode-ai

安装后验证

# 查看版本信息
opencode --version

查看版本信息

3、安装opencode插件oh-my-opencode

npm install -g oh-my-opencode

项目初始化，在~/.config/opencode 目录下运行

oh-my-opencode install

项目初始化

选择安装配置选项后，安装成功，里面的模型都选择No

选择安装配置选项

检查opencode.json文件是否已自动添加插件信息

opencode已添加oh-my-opencode插件

安装代码结构分析工具AST

AST

4、配置离线大模型

在~/.config/opencode/opencode.json 这个主配置文件添加如下配置（若不存在则自行创建）：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "myprovider": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "qwen3-coder-flash",
      "options": {
        "baseURL": "http://localhost:6006/v1"
      },
      "models": {
        "qwen3-coder-flash": {
          "name": "qwen3-coder-flash"
        }
      }
    }
  }
}

5、opencode安装和配置的路径

全局安装目录

~/.config/opencode             # 软件安装目录
├── bun.lock                   # 依赖锁定文件
├── node_modules/              # 依赖包
├── opencode.json              # 主配置文件
├── package.json               # 依赖声明
├── AGENTS.md                  # Agent 行为规范
└── skills/                    # 技能目录
    ├── explore/
    ├── ...
    └── doc/

项目级安装目录

<项目目录>/.opencode/
├── .gitignore
├── bun.lock
├── node_modules/
│   └── @opencode-ai/
└── package.json

数据和日志目录

~/.local/share/opencode/
├── bin/               # CLI 二进制文件
├── log/               # 日志文件
├── opencode.db        # SQLite 类型的数据库（主数据）
├── opencode.db-shm    # SQLite 类型的共享内存
├── opencode.db-wal    # SQLite 的WAL 日志
├── snapshot/          # 快照备份
├── storage/           # 存储数据
│   ├── migration
│   └── session_diff
└── tool-output/       # 工具输出缓存