选择安装方式

根据你的操作系统和偏好，决定是使用桌面版（BETA）还是通过脚本安装命令行版本。新手推荐从Releases页面下载桌面版，体验更直观。

桌面版下载链接：https://opencode.ai/download 或项目的Releases页面。

安装OpenCode

如果选择命令行版本，请按照README提示运行安装脚本。注意先卸载旧于0.1.x的版本。安装脚本会按优先级选择安装目录（如$HOME/bin）。

可以提前设置环境变量`$OPENCODEINSTALLDIR`来自定义安装目录。

验证安装

打开终端，输入`opencode`或`opencode --version`（取决于安装方式），确认命令可以执行且无报错。

首次运行与界面熟悉

在终端中输入`opencode`启动程序。花几分钟观察TUI（终端用户界面）的布局，了解输入框、聊天区域、状态信息的位置。

与默认智能体（build）对话

在输入框中尝试向OpenCode提问，例如：“请帮我解释一下当前目录下package.json文件的内容。” 观察它的回答和可能的操作。

切换智能体（Tab键）

在输入框按`Tab`键，将智能体从默认的`build`切换到`plan`。注意状态栏的提示变化。`plan`是只读模式，更适合安全地探索代码。

理解智能体差异

分别用`build`和`plan`智能体对同一个项目目录进行探索。尝试让`plan`智能体分析代码结构，再切换回`build`智能体尝试让它修改某个文件（谨慎操作），体会两者的权限区别。

`plan`智能体在运行bash命令或编辑文件前会请求许可，这是安全探索陌生代码库的好方法。

使用@general子智能体

在消息中输入`@general`来调用通用子智能体，尝试给它一个多步骤任务，例如：“@general 请帮我搜索当前项目中所有关于‘用户认证’的函数，并总结它们的调用关系。”

配置初步了解

访问项目文档（链接通常在README中），快速浏览配置部分，了解如何设置AI模型提供商（如OpenAI、Claude等）或本地模型。虽然初次使用可以不配置，但需要知道有这个能力。

实战小项目

找一个你自己熟悉的或简单的代码仓库（可以是一个小的个人项目），用OpenCode的`plan`智能体来“理解”这个项目，让它为你生成一份项目概述。

尝试简单开发任务

在一个安全的环境（如项目副本）中，使用`build`智能体，让它帮你完成一个非常小的开发任务，例如：“在README末尾添加一个使用示例章节”或“修复一个简单的拼写错误”。

回顾与总结

思考OpenCode在你工作流中可能扮演的角色：是代码探索工具、编写助手，还是调试伙伴？记录下你感觉最有用和最不顺手的地方。