上手

四步,开始对话

选一个你习惯的安装方式,接上模型,然后在任意仓库里输入 opencode。

安装 CLI

任选其一。npm 包会在安装后挑选对应平台的原生二进制。

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

连接模型

在 TUI 里输入 /connect,选一个提供商并完成登录。想用自己的端点,就在配置里加一个 OpenAI 兼容的 provider。

# 在会话里
/connect

在项目里启动

进入仓库再启动,它会以当前目录作为工作区,自动读取项目配置、规则文件和可用的语言服务器。

cd ~/code/my-app
opencode

接到浏览器或手机

想把当前会话换个屏幕继续,用 pair 生成一次性链接,五分钟内有效。

opencode pair
项目配置

让它在你的仓库里守规矩

把这份文件放进仓库根目录,团队成员会拿到同一套默认模型、权限和扩展。

{
  "$schema": "https://opencode.ai/config.json",
  "model": "provider/model-id",
  "default_agent": "build",
  "permissions": {
    "edit": "ask",
    "bash": "ask"
  }
}
遇到问题

三个最常用的自检动作

服务状态

opencode service status 看后台服务是否健康;卡住时用 opencode service restart。

接口连通

opencode api get /api/info 直接打一次 API,能区分是界面问题还是服务问题。

日志

日志在 ~/.local/share/opencode/log/opencode.log,加 OPENCODE_LOG_LEVEL=DEBUG 复现一次。

还有疑问?

常见问题、三端差异和授权方式都整理好了。

看问答 →