C. CLI 命令参考
💡 一句话总结：
opencode命令行工具的所有命令和选项
命令速览
| 命令 | 功能 |
|---|---|
opencode | 启动 TUI 交互界面 |
opencode run | 非交互模式执行任务 |
opencode serve | 启动无头服务器 |
opencode web | 启动 Web 界面 |
opencode attach | 连接远程服务器 |
opencode auth | 认证管理 |
opencode models | 列出可用模型 |
opencode agent | Agent 管理 |
opencode mcp | MCP 服务器管理 |
opencode stats | 使用统计 |
opencode export | 导出会话 |
opencode import | 导入会话 |
opencode upgrade | 升级版本 |
opencode uninstall | 卸载 OpenCode |
opencode
启动 TUI 交互界面。
bash
opencode [project]选项：
| 选项 | 短选项 | 说明 |
|---|---|---|
--continue | -c | 继续上次会话 |
--session | -s | 指定会话 ID |
--prompt | - | 初始提示语 |
--model | -m | 指定模型 |
--agent | - | 指定 Agent |
示例：
bash
# 启动 TUI
opencode
# 带初始提示语启动
opencode --prompt "帮我分析这个项目的代码结构"
# 使用特定模型
opencode -m anthropic/claude-sonnet-4
# 继续上次会话
opencode -copencode run
非交互模式执行任务。
bash
opencode run [message..]选项：
| 选项 | 说明 |
|---|---|
--command | 要执行的命令 |
--continue | 继续上次会话 |
--session | 指定会话 ID |
--share | 分享会话 |
--model | 指定模型 |
--agent | 指定 Agent |
--file | 附加文件 |
--format | 输出格式 |
示例：
bash
# 基本使用
opencode run "修复 src/main.ts 中的类型错误"
# 附加文件
opencode run -f src/main.ts -f package.json "Analyze this project"
# JSON 格式输出
opencode run --format json "List all TypeScript files"
# 自动分享会话
opencode run --share "Generate project documentation"opencode serve
启动无头服务器模式。
bash
opencode serve选项：
| 选项 | 说明 |
|---|---|
--port | 监听端口 |
--hostname | 监听地址 |
--mdns | 启用 mDNS 发现 |
--cors | 允许的 CORS 源 |
opencode auth
管理认证和 API Key。
bash
opencode auth <subcommand>子命令：
| 子命令 | 功能 |
|---|---|
login | 登录（交互式选择提供商） |
list / ls | 列出已认证的提供商 |
logout | 登出提供商 |
opencode models
列出可用模型。
bash
opencode models [provider]选项：
| 选项 | 说明 |
|---|---|
--refresh | 刷新模型缓存 |
--verbose | 显示详细信息 |
opencode upgrade
升级到最新版本或指定版本。
bash
opencode upgrade [target]选项：
| 选项 | 短选项 | 说明 |
|---|---|---|
--method | -m | 安装方式 |
示例：
bash
# 升级到最新
opencode upgrade
# 升级到指定版本
opencode upgrade v1.0.5opencode uninstall
卸载 OpenCode。
bash
opencode uninstall选项：
| 选项 | 短选项 | 说明 |
|---|---|---|
--keep-config | -c | 保留配置文件 |
--keep-data | -d | 保留会话数据 |
--dry-run | - | 只显示将删除的内容 |
--force | -f | 跳过确认提示 |
全局选项
所有命令都支持以下全局选项：
| 选项 | 短选项 | 说明 |
|---|---|---|
--help | -h | 显示帮助 |
--version | -v | 显示版本号 |
--print-logs | - | 打印日志到 stderr |
--log-level | - | 日志级别 |
环境变量
| 变量 | 说明 |
|---|---|
OPENCODE_CONFIG | 配置文件路径 |
OPENCODE_API_KEY | API Key |
ANTHROPIC_API_KEY | Anthropic API Key |
OPENAI_API_KEY | OpenAI API Key |
DEEPSEEK_API_KEY | DeepSeek API Key |
📚 更多完整模板：Prompt 模板库