OpenCode上手初体验！

月伴飞鱼2026-02-102026-02-10

OpenCode 是一款开源智能体，可助力你搭配任意 AI 模型编写并运行代码。

它支持终端界面、桌面应用程序以及集成开发环境（IDE）扩展三种使用形式。

使用 curl 安装：

1	curl -fsSL https://opencode.ai/install \| bash

通过下面的命令查看版本：

1
2
3

opencode --version
或者
opencode -v

如果不想使用 CLI 版本，也可以通过 OpenCode 的下面命令启动一个 Web 版本 App：

# 启动 Web 界面
opencode web

# 指定端口和主机
opencode web --port 4096 --hostname 0.0.0.0

通过 IDE 插件

在 IDE 的应用商店搜索 opencode，安装即可。

支持的主要斜杠命令和功能：

命令类别	命令	功能说明
连接与设置	/connect	新增LLM提供商（如Anthropic、OpenAI）
	/models	列出并切换可用的AI模型
	/themes	切换终端界面的主题
	/help	显示帮助对话框
对话管理	/new	开始一个新的对话
	/sessions	列出所有历史对话并切换
	/compact	压缩当前对话内容，以节省上下文窗口
	/export	将会话记录导出到文件
	/share	生成当前对话的分享链接
编辑与撤销	/undo	撤销上一条 AI 消息及其带来的所有文件更改
	/redo	重做已撤销的更改
	/editor	打开外部编辑器
项目与代理	/init	初始化项目，扫描并生成 AGENTS.md 文件，帮助AI理解项目结构
	/agents	切换或管理AI代理（如 Plan/Build 模式）
	/review	审查未提交的代码更改
	/mcp	管理模型上下文协议（Model Context Protocol）
其他	/exit	退出 OpenCode 应用程序

添加 LLM Provider

通过 /connect 命令直接添加，也可以先输入 /models 查看所有支持的模型。

支持通过 API keys 的方法直接添加，也支持通过第三方网页授权的方式添加。

初始化

进入到项目目录中。

运行 opencode。

使用下面命令，初始化 opencode 项目。

/init

这个命令会让 OpenCode 分析你的项目，然后在项目的根目录创建一个 AGENTS.md 的文件。

这个文件有助于帮助 OpenCode 了解项目结构和已使用的编码风格。

Plan & Build 模式

OpenCode 支持通过直接拖拽图片到终端作为提示词。

OpenCode 支持2种模式，Plan 和 Build，默认是 Build 模式。

2种模式通过 TAB 键进行切换。

Plan 模式只会产生方案的计划，Build 会执行 Plan 的方案，最终执行代码修改。

官方建议先使用 Plan 模式来创建计划，用户通过 Review 来不停迭代 Plan 直至没有问题，再通过 Build 模式执行计划。

当然也可以通过 Build 模式直接构建，跳过 Plan 过程。

解释代码

通过 @ 关键词模糊搜索项目文件，支持 tab 自动补全文件。

1	How is authentication handled in @packages/functions/src/api/index.ts