3.2 CLI命令行接口

界面 第三章：界面操作

OpenCode CLI支持非交互模式和多种管理命令，适合脚本化和自动化场景。

基本命令

# 启动TUI（默认）
opencode

# 非交互模式执行
opencode run "解释JavaScript中的闭包"

# 指定模型
opencode -m anthropic/claude-opus-4-20250514

主要CLI命令

命令说明
opencode启动TUI界面
opencode run "提示"非交互执行
opencode agent管理代理
opencode auth管理认证
opencode models查看模型
opencode session管理会话
opencode serve启动API服务
opencode web启动Web界面
opencode mcp管理MCP服务器
opencode upgrade更新版本
opencode uninstall卸载

常用标志

# 指定模型
opencode -m anthropic/claude-sonnet-4-20250514

# 继续会话
opencode -c session-id

# 显示版本
opencode --version

# 显示帮助
opencode --help

# 日志级别
opencode --log-level debug

# 打印日志
opencode --print-logs

非交互模式

# 简单查询
opencode run "什么是TypeScript？"

# 指定模型
opencode run -m openai/gpt-4o "生成一个React组件"

# 管道输入
echo "解释这段代码" | opencode run

# 与文件结合
cat package.json | opencode run "分析这个项目的依赖"

代理管理

# 创建代理
opencode agent create

# 列出代理
opencode agent list

# 删除代理
opencode agent delete my-agent

会话管理

# 列出会话
opencode session list

# 继续会话
opencode -c abc123

# 导出会话
opencode session export abc123

模型管理

# 查看所有模型
opencode models

# 查看特定提供商
opencode models anthropic

# 刷新列表
opencode models --refresh

脚本示例

#!/bin/bash
# 自动代码审查脚本

DIFF=$(git diff --staged)
if [ -n "$DIFF" ]; then
  echo "$DIFF" | opencode run "审查这些代码更改，指出潜在问题"
fi

下一步

接下来了解OpenCode的Web界面。