服务状态
opencode service status 看后台服务是否健康;卡住时用 opencode service restart。
选一个你习惯的安装方式,接上模型,然后在任意仓库里输入 opencode。
任选其一。npm 包会在安装后挑选对应平台的原生二进制。
curl -fsSL https://opencode.ai/v2/install | bash
brew install anomalyco/tap/opencode-v2
npm install -g @opencode/cli
bun install -g --trust @opencode/cli
pnpm add -g --allow-build=@opencode/cli @opencode/cli
在 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 复现一次。
常见问题、三端差异和授权方式都整理好了。