OpenCode TUI 使用指南与命令行参数详解

想象一下，你面对一个陌生的代码库，几千个文件、几万行代码，你想搞清楚某个功能是怎么工作的，却越看越懵——这大概是每个程序员的日常。

今天给你介绍 OpenCode，一个能在终端里和你直接对话的 AI 编程助手。不像那些冷冰冰的 IDE 插件，它更像一个真的懂你代码的伙伴，有问必答。

这篇文章会介绍 OpenCode 的主要用法：TUI（终端界面） 以及 CLI（命令行）参数。新手看完能上手，老手能发现更多高级玩法。

TUI 入门

1.1 启动

装好 OpenCode 后，在项目目录里直接运行：

opencode

会弹出一个漂亮的终端界面，OpenCode 会自动分析当前目录的代码结构，然后你就可以开始问问题了。

也可以指定项目路径：

opencode /path/to/your/project

进入后，这样问 AI：

Give me a quick summary of the codebase.

它就会给你一个清晰的概述。

1.2 引用文件

用@符号可以直接引用文件，OpenCode 会帮你模糊搜索：

How is auth handled in @packages/functions/src/api/index.ts?

文件内容会自动加入对话上下文，AI 就能针对性地回答。

1.3 执行命令

以 ! 开头的消息会作为 shell 命令执行：

!ls -la

命令输出会返回给 AI，这样它就能根据实际项目状态来回答你的问题。

TUI 进阶——斜杠命令

输入/加命令名可以快速执行操作：

会话管理

• /new或/clear：开新会话；
• /sessions或/resume：查看历史会话，继续之前的；
• /undo：撤销最后一条消息（包括文件修改，需要 Git）；
• /redo：恢复被撤销的操作。

有意思的是，/undo和/redo底层用的是 Git 来管理文件改动，所以不用担心 AI 改坏你的代码——随时可以后悔。

分享与导出

/share可以生成公开链接，让别人查看你们的对话过程。代码审查、教学演示都很方便。不想分享了就运行/unshare。

/export会把对话导出成 Markdown，在你的默认编辑器里打开。记得设置 EDITOR 环境变量：

# Linux/macOS
export EDITOR="code --wait"

# Windows PowerShell
$env:EDITOR = "code --wait"

VS Code 这类编辑器需要--wait参数才能正常工作。

CLI 命令行参数

不带参数运行 opencode 默认启动 TUI，但 CLI 模式更适合脚本化和自动化。

opencode run

直接传提示词，不需要启动完整 TUI：

opencode run "Explain how closures work in JavaScript"

常用参数：

可以连接到已启动的 opencode serve 实例，避免每次都重启 MCP 服务器：

# 终端 1：启动服务
opencode serve

# 终端 2：运行命令
opencode run --attach http://localhost:4096 "Explain async/await"

opencode serve / web

serve 启动无界面的 HTTP 服务器：

opencode serve --port 4096 --hostname 0.0.0.0

web 启动服务器并打开浏览器：

opencode web

适合团队共享、在远程服务器上运行、或者集成到其他工具。设置 OPENCODE_SERVER_PASSWORD 可以启用认证。

opencode attach

把本地 TUI 连接到远程后端：

opencode attach http://10.20.30.40:4096

opencode session

管理会话：

opencode session list
opencode session list --max-count 5  # 最近 5 个
opencode session list --format json

opencode stats

查看 token 用量和费用：

opencode stats --days 30    # 最近 30 天
opencode stats --models 3   # 前 3 个模型

opencode models

列出可用模型：

opencode models
opencode models anthropic   # 按提供商筛选
opencode models --refresh   # 刷新缓存
opencode models --verbose   # 详细输出

opencode auth

管理 API 凭据：

opencode auth login   # 登录新提供商
opencode auth list    # 列出凭据
opencode auth ls      # 简写
opencode auth logout  # 登出

opencode mcp

管理 MCP 服务器：

opencode mcp add              # 添加
opencode mcp list             # 列出
opencode mcp auth [name]      # OAuth 认证
opencode mcp logout [name]    # 移除凭据
opencode mcp debug <name>     # 调试

opencode agent

自定义代理：

opencode agent create   # 创建新代理
opencode agent list    # 列出可用代理

opencode github

GitHub 集成：

opencode github install    # 安装代理
opencode github run --event pull_request --token $GITHUB_TOKEN

opencode export / import

数据迁移：

opencode export [sessionID]        # 导出
opencode import session.json        # 从文件导入
opencode import https://opncd.ai/s/abc123  # 从链接导入

全局标志

环境变量

常用配置

实验性功能

服务器配置

实战技巧

快速了解新项目

启动 TUI 后直接问：

Give me a quick summary of the codebase.
What are the main technologies used?
Where should I start reading to understand the authentication flow?

继续之前的任务

opencode run --continue "继续刚才的任务"
opencode run --session ses_abc123 "继续"

自动化脚本

#!/bin/bash
for file in *.ts; do
    opencode run "Explain this file: $file"
done

团队协作

# 启动共享后端
opencode serve --port 4096

# 团队成员连接
opencode attach http://your-server:4096

结语

OpenCode 不只是一个 AI 编程工具，它更像一个懂你代码的伙伴。TUI 让你像聊天一样自然地协作，CLI 给了你完全的控制权。

现在你可以：

1. 在终端里和 AI 对话，让它帮你看代码；
2. 用斜杠命令快速操作；
3. 把 AI 能力集成到工作流；
4. 通过分享积累团队知识。

想深入了解，直接运行opencode --help或者在 TUI 里输入/help。

以上关于OpenCode TUI 使用指南与命令行参数详解的文章就介绍到这了，更多相关内容请搜索码云笔记以前的文章或继续浏览下面的相关文章，希望大家以后多多支持码云笔记。