进阶 opencode.ai 2026-11-11 16:13:22 · 18 阅读

第2章 CLI 命令行接口使用指南

Intro在项目目录中运行 CLI 以打开全屏终端界面: Terminalopencode 指定目录以在其他项目中工作: Terminalopencode ~/code/my-project 推荐的终端:

Ghostty WezTerm Alacritty Kitty

Truecolor 支持能呈现主题最准确的色彩;若终端不支持,则使用现有色板的近似值进行渲染。

使用 opencode run 可直接提交提示词,而无需打开交互式界面。它专为脚本、CI 任务及其他需要直接在终端获取模型输出的工作流设计。 Terminalopencode run "Explain this repository"

使用 opencode mini 启动 OpenCode 的最小化交互界面,替代全屏 TUI。 Terminalopencode mini 运行 opencode mini --help 可查看其会话、模型、Agent、提示词及回放选项。

默认情况下,OpenCode 会为当前用户账号发现或启动一个共享的后台服务器。所有本地 OpenCode 客户端都连接至该服务器,由其管理会话、配置、集成、权限及工具执行。 使用 --standalone 以私有服务器模式运行,或使用 --server 连接指定服务器 URL: Terminalopencode --standalone opencode --server http://localhost:4096 若希望 CLI 命令默认使用私有服务器而非启动共享服务,请禁用共享服务: Terminalopencode service set disabled true opencode 此举将停止正在运行的后台服务。--server 仍可用于连接显式指定的服务器;opencode service start 仍可显式启动共享服务。若需恢复自动服务模式,运行 opencode service unset disabled。 配对功能依赖共享服务,在禁用状态下不可用。 共享服务的故障排查请参阅 Troubleshooting,服务器端点请参阅 API 参考。

打印特定本地路径以便其他工具使用: Terminalopencode debug paths db sqlite3 "$(opencode debug paths db)" 可选的选择器接受 db、home、data、config、cache、state、tmp、bin、log 或 repos,仅打印路径及换行符。数据库路径遵循发布渠道设置及 OPENCODE_DB 环境变量;相对数据库覆盖路径将在 data 目录下解析,而 :memory: 则原样输出。此命令不会启动服务器或打开数据库。 省略选择器可查看所有路径及其标签: Terminalopencode debug paths

预览将被删除的文件和安装项: Terminalopencode uninstall --dry-run 运行 opencode uninstall 确认卸载。OpenCode 会先停止已注册的后台服务和持久终端,再删除共享于各 OpenCode 版本和渠道的全局缓存目录。会话数据、配置及状态永不会被删除。

--force (-f) 选项跳过确认流程;适用于非交互式的卸载场景。 通过包管理器安装时,卸载过程使用检测到的包管理器处理。通过 Curl 安装时,会打印出用于手动删除可执行文件的最终命令。

评论 (0)