OpenCode: OpenCode第一次使用
最后更新：2026-08-31
安装和配置完成后，让我们开始第一次使用 OpenCode。
1. 你将学到
- 启动 OpenCode 并进入 TUI
- 第一次对话体验
- 让 AI 分析代码
- 让 AI 修改代码
- 撤销操作
2. 启动 OpenCode
进入你的项目目录，运行：
BASH
cd my-project
opencode
你会看到 TUI 界面，底部是输入框，上方是对话区域。
3. 第一次对话
在输入框中输入：
TEXT
📖 仅展示
帮我快速总结这个项目的结构
OpenCode 会读取项目文件，分析后给出项目结构概述。
示例输出：
TEXT
📖 仅展示
这是一个 Node.js 项目，主要结构如下：
- src/ - 源代码目录
- index.ts - 入口文件
- routes/ - 路由模块
- utils/ - 工具函数
- tests/ - 测试文件
- package.json - 项目配置
4. 引用文件分析
使用 @ 引用项目中的文件：
TEXT
📖 仅展示
这个项目的认证逻辑是如何实现的？查看 @src/auth/index.ts
特点：
- 支持模糊搜索文件路径
- 自动读取文件内容
- 无需手动复制代码
5. 让 AI 修改代码
下达修改指令：
TEXT
📖 仅展示
将 src/utils/format.ts 中的所有 var 声明替换为 const 或 let
OpenCode 会：
- 读取文件内容
- 识别所有 var 声明
- 根据上下文判断使用 const 还是 let
- 直接修改文件
6. 执行命令
使用 ! 前缀执行 Shell 命令：
TEXT
📖 仅展示
!npm test
执行结果会自动加入对话上下文，AI 可以根据结果进行下一步操作。
7. 撤销操作
如果 AI 的修改不符合预期，可以撤销：
TEXT
📖 仅展示
/undo
这会：
- 撤销上一条消息
- 回滚代码修改
重做操作：
TEXT
📖 仅展示
/redo
重要提示： 撤销功能依赖 Git。建议项目开启 Git 版本控制。
8. 切换模型
如果当前模型效果不好，可以切换：
TEXT
📖 仅展示
/model
从列表中选择其他模型，按 Enter 确认。
9. 会话管理
(1) 新建会话
TEXT
📖 仅展示
/new
(2) 查看历史会话
TEXT
📖 仅展示
/sessions
(3) 继续上次会话
BASH
opencode --continue
10. 退出 OpenCode
TEXT
📖 仅展示
/exit
或使用快捷键 Ctrl + X → Q。
❓ 常见问题
Q 第一次使用应该选什么模型？
A 推荐 OpenCode Zen 的免费模型先体验，确认流程跑通后再根据需要切换到更强的付费模型。
Q AI 修改了代码但不正确怎么办？
A 立即使用 /undo 撤销。建议重要操作前先 git commit，这样即使 undo 失败也能通过 Git 回退。
Q Alice 让 OpenCode 写了一个函数，Bob 让它修改了配置文件，谁的风险更低？
A Bob 的风险更低。修改配置文件影响范围有限，而新写函数可能影响整个代码逻辑。但两人都应该在操作前确认 Git 已提交。
Q 非交互模式怎么用？
A 使用
opencode run "你的问题" 命令，直接返回结果，不进入 TUI。适合快速提问和脚本集成。📖 小节
- 进入项目目录后运行
opencode启动 - 用
@引用文件，用!执行命令 /undo撤销修改，/redo重做/model切换模型，/new新建会话- 重要操作前确保 Git 已提交
📝 作业
-
基础题：启动 OpenCode，让它分析你当前项目的结构。
-
进阶题：让 OpenCode 修改项目中的一个文件，然后用 /undo 撤销修改。
-
挑战题：使用非交互模式
opencode run完成一次代码分析，并将结果重定向到文件。
