CLI 命令行
OpenCode CLI 提供命令行访问 OpenCode 功能。默认情况下，运行 opencode 会启动终端用户界面（TUI）。
opencode传递命令进行程序化交互：
opencode run "解释 JavaScript 中的闭包是如何工作的"TUI 参数
| 参数 | 简写 | 用途 |
|---|---|---|
--continue | -c | 恢复上一个会话 |
--session | -s | 指定会话 ID |
--prompt | — | 提供初始提示 |
--model | -m | 设置模型（provider/model） |
--agent | — | 选择 Agent |
命令
run
以非交互模式执行 OpenCode：
opencode run [message..]参数：
--continue,-c：恢复上一个会话--model,-m：设置模型--file,-f：附加文件--format：输出为default或json
auth
管理凭证：
opencode auth login # 配置 API 密钥
opencode auth list # 显示 Provider
opencode auth logout # 删除凭证models
列出可用模型：
opencode models [provider]
opencode models --refresh # 更新缓存列表
opencode models --verbose # 显示费用session
管理会话：
opencode session list
opencode session list --format jsonserve
启动无头 HTTP 服务器：
opencode serve --port 4096web
启动带 Web 界面的服务器：
opencode web --port 4096agent
管理 Agent：
opencode agent create # 创建自定义 Agent
opencode agent list # 列出 Agentmcp
管理 MCP 服务器：
opencode mcp add # 添加服务器
opencode mcp list # 显示服务器
opencode mcp auth # 认证
opencode mcp debug # 调试stats
显示使用统计：
opencode stats --days 30
opencode stats --modelsupgrade
更新 OpenCode：
opencode upgrade # 最新版本
opencode upgrade v0.1.48 # 指定版本全局参数
| 参数 | 简写 | 用途 |
|---|---|---|
--help | -h | 显示帮助 |
--version | -v | 打印版本 |
--print-logs | — | 输出日志到 stderr |
--log-level | — | 设置级别（DEBUG, INFO, WARN, ERROR） |
环境变量
核心配置
| 变量 | 用途 |
|---|---|
OPENCODE_CONFIG | 配置文件路径 |
OPENCODE_CONFIG_DIR | 配置目录 |
OPENCODE_CONFIG_CONTENT | 内联 JSON 配置 |
功能
| 变量 | 用途 |
|---|---|
OPENCODE_DISABLE_AUTOUPDATE | 禁用更新 |
OPENCODE_ENABLE_EXPERIMENTAL_MODELS | 启用实验性模型 |
OPENCODE_DISABLE_AUTOCOMPACT | 禁用压缩 |