OpenCode 上手初体验：从安装到使用

wangruofeng
1,925 阅读11分钟

OpenCode

它是什么

官方介绍：

OpenCode is an open source agent that helps you write and run code with any AI model. It's available as a terminal-based interface, desktop app, or IDE extension.

OpenCode 是一款开源智能体，可助力你搭配任意 AI 模型编写并运行代码。它支持终端界面、桌面应用程序以及集成开发环境（IDE）扩展三种使用形式。

同时它内置免费模型，亦可接入任意服务商提供的各类模型，包括 Claude、GPT、Gemini 等。

一句话概括： OpenCode 是一个开源 AI 编码助手，以 CLI 为中心、强调“工程可控性”的 AI 编码工具，目标不是取代 IDE，而是让 大模型真正进入代码工程与研发流程，成为可组合、可审计、可自动化的一部分。

流行度如何？

GitHub 最新 Star ：68k ，你可能看到的大于这个数，因为他一直在变化。。。

trendshift.io/ 上 GitHub 趋势排名第一，可见流行程度

可以用来干些啥？

OpenCode 适合做所有“需要理解代码上下文，但不需要你立刻改代码”的事情。

换句话说：凡是“看代码、分析代码、总结代码、约束代码、生成文本”的工作，都是 OpenCode 的主战场。

应用场景举例

  • 管理多种 AI 模型（Claude、ChatGPT、Gemini、GLM-4.7等 75+ 模型）
  • 分析代码、解释代码、生成代码
  • 生成新功能、修改和优化项目
  • 自动 Code Review
  • 自动生成 Commit Message
  • PR / MR 总结与描述生成
  • 代码解释与知识沉淀
  • 架构 / 规范一致性检查
  • ...

如何安装

桌面端（Beta）

在 opencode.ai/download 直接下载安装即可

通过 CLI

官方提供了多种 CLI 的安装方式，例如 curl、pnm、bun、brew、paru

这里使用 curl 安装

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

通过下面的命令查看版本，我使用的是 1.1.19 版本

opencode --version
或者
opencode -v

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

# 启动 Web 界面
opencode web

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

启动成功后的效果如下，Web 版本内置了 5 个免费模型

通过 IDE 插件

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

安装后可以通过opencode在终端中运行即可开始使用。

使用指南

  • 快速启动：使用Cmd+Esc（Mac）或Ctrl+Esc（Windows/Linux）在分屏终端视图中打开 OpenCode，或者如果已有终端会话正在运行，则聚焦于该现有终端会话。

  • 新建会话：使用Cmd+Shift+Esc（Mac）或Ctrl+Shift+Esc（Windows/Linux）启动一个新的 OpenCode 终端会话，即使已有会话打开。您也可以点击用户界面中的 OpenCode 按钮。

  • 上下文感知：自动与 OpenCode 共享您当前的选择或选项卡。

  • 文件引用快捷键：使用Cmd+Option+K(Mac) 或Alt+Ctrl+K(Linux/Windows) 插入文件引用。例如，@File#L37-42.

下面是 cursor 安装后在 mac 上通过 Cmd+Esc快速启动的效果

如何使用

启动

终端直接输入 opencode 命令即可，如果 opencode 命令找不到，重新开一个新的 tab 执行即可

或者通过下面的命令重启终端

source ~/.bashrc  # 如果是bash终端
# 或
source ~/.zshrc   # 如果是zsh终端（Mac默认）

在它的终端界面（TUI）中，输入/命令，可以查看所有内置斜杠命令

下面这个表格汇总了它支持的主要斜杠命令和功能

命令类别命令功能说明
连接与设置/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 应用程序

选择 model

输入/models 查看所有支持的模型，模型名称支持模糊搜索，通过键盘上下箭头进行选择进行模型切换

官方 OpenCode Zen 提供了 4 个免费的模型可供使用

  • Big Pickle
  • GLM-4.7
  • Grok Code Fast 1
  • MiniMax M2.1

添加 LLM provider

通过 /connect 命令直接添加，也可以先输入 /models 查看所有支持的模型，输入 ctrl + a 可以添加其他模型提供商

支持通过 API keys 的方法直接添加，也支持通过第三方网页授权的方式添加，例如 GitHub Copilot 就是这样

这里添加一下 GitHub Copilot 测试，按照下面引导添加即可

添加完成，通过 /models 查看模型是可用，下面可以看到以 GitHub Copilot 的名称，下面展示了所有的模型

初始化

进入到项目目录中

cd /path/to/project

运行 opencode

opencode

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

/init

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

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

使用演示

case1: Plan & Build 模式

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

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

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

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

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

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

case2: 解释代码

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

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

case3: 撤销 & 重提交

通过 /undo 命令撤销上一次的提交，你可以通过 /undo 撤销多次，这个命令有点像在 IDE 编辑一部分代码后。

按下了撤销快捷键，例如 mac 上一般是 CMD + Z，连续按多次这个快捷键，可以撤销多次，相当于执行了多次 /undo 命令。

也可以通过 /redo 再次提交刚才撤销的提交

case4: 分享会话

通过 /share 命令将会话分享给你的团队，执行完命令，会直接将分享的链接拷贝到你的剪切板中，并在终端的右上角弹出提示“Share URL copied to clipboard！”

下面示例 URL：opncd.ai/share/e7xeu…

支持的命令选项

输入下面命令，查看所有支持的命令选项

opencode -h

oh-my-opencode

它是什么

官方介绍：

The Best Agent Harness. Meet Sisyphus: The Batteries-Included Agent that codes like you.

最佳智能体开发框架。来认识 Sisyphus：一款开箱即用、编码风格与你如出一辙的智能体工具。

GitHub 地址 ：github.com/code-yeongy…

用大白话说，它是 OpenCode 的增强插件（类似 oh-my-zsh 对于 zsh 的增强），它为 OpenCode 添加了更多强大功能：

  • 多 AI 模型协作：可以同时调用多个 AI 模型协同工作
  • 智能体系统（Agents）：内置多个专业智能体（如 frontend-ui-ux-engineer、oracle 等）
  • 提示词优化：自动优化你给 AI 的指令
  • 后台任务管理：可以并行执行多个任务

简单理解：安装 oh-my-opencode 插件后，OpenCode 就从一个 AI 助手变成了一个完整的 AI 开发团队。

它有哪些智能体队友：

Tips: 下面这些智能体是官方推荐配置，要能调用，必须提前配置好，否则调用时还是只能使用默认的模型

  • Sisyphus (anthropic/claude-opus-4-5)：默认智能体。 OpenCode 的强大 AI 编排器。使用专业子智能体进行规划、委派和执行复杂任务，采用积极的并行执行策略。强调后台任务委派和 todo 驱动的工作流程。使用 Claude Opus 4.5 配合扩展思考（32k 预算）以获得最大推理能力。
  • oracle (openai/gpt-5.2)：架构、代码审查、策略。使用 GPT-5.2 进行出色的逻辑推理和深度分析。灵感来自 AmpCode。
  • librarian (opencode/glm-4.7-free)：多仓库分析、文档查找、实现示例。使用 GLM-4.7 Free 进行深度代码库理解和 GitHub 研究，提供基于证据的答案。灵感来自 AmpCode。
  • explore (opencode/grok-code、google/gemini-3-flash 或 anthropic/claude-haiku-4-5)：快速代码库探索和模式匹配。配置 Antigravity 认证时使用 Gemini 3 Flash，有 Claude max20 时使用 Haiku，否则使用 Grok。灵感来自 Claude Code。
  • frontend-ui-ux-engineer (google/gemini-3-pro-preview)：设计师转开发者。构建华丽的 UI。Gemini 擅长创造性的、美观的 UI 代码。
  • document-writer (google/gemini-3-flash)：技术写作专家。Gemini 是文字大师——写出流畅的散文。
  • multimodal-looker (google/gemini-3-flash)：视觉内容专家。分析 PDF、图像、图表以提取信息。

主智能体会自动调用这些，但你也可以显式调用它们：

让 @oracle 审查这个设计并提出架构
让 @librarian 看看这是如何实现的——为什么行为一直在变化？
让 @explore 查找这个功能的策略

用户评价

它让我取消了 Cursor 订阅。开源社区正在发生令人难以置信的事情。" - Arthur Guiot

"如果 Claude Code 能在 7 天内完成人类 3 个月的工作，那么 Sisyphus 只需 1 小时。它会持续工作直到任务完成。它是一个非常自律的智能体。" — B, 量化研究员

"用 Oh My Opencode 仅用一天就清理了 8000 个 eslint 警告" — Jacob Ferrari

"我使用 Ohmyopencode 和 ralph loop 在一夜之间将一个 45k 行的 tauri 应用转换成了 SaaS Web 应用。从访谈提示开始，要求它对问题进行评分和建议。看着它工作非常精彩，今早醒来发现网站基本上已经可以运行了！" - James Hargis

"用了 oh-my-opencode，你再也不会回头了" — d0t3ch

"我还没能准确表达出它为什么如此出色，但开发体验已经达到了一个完全不同的维度。" - 苔硯:こけすずり

"这个周末用 open code、oh my opencode 和 supermemory 来构建某种 minecraft/souls-like 怪物游戏。" "让它添加蹲伏动画，我去散个午后的步。[视频]" - MagiMetal

"你们应该把这个合并到核心代码并招募他。认真的。这真的非常非常非常好。" — Henning Kilset

"如果你能说服他的话就雇用 @yeon_gyu_kim，这个人彻底革新了 opencode。" — mysticaltech

"Oh My OpenCode 真的太疯狂了" - YouTube - Darren Builds AI

如何安装

1.直接通过 OpenCode 安装

你只需跟OpenCode说：帮我安装 oh-my-opencode 插件

他会思考 oh-my-opencode 是什么，搜索如何安装，然后再基于搜索到的资料进行自动安装

他会使用内置 Exa MCP 进行联网搜索，找到具体的安装步骤，下面是安装成功后效果

2.通过 CLI

我这里介绍通过 bun 工具来进行安装，其他方式可以参考 GitHub 官方文档

  1. 先安装 bun 工具
curl -fsSL https://bun.sh/install | bash

验证 bun 安装是否成功，输出版本号代表安装成功，我安装的版本是 1.3.6

安装 bun 完成后，重启你的终端（必须重启，环境变量才生效），执行以下命令：

bun -v

2. 再安装 oh-my-opencode

npx oh-my-opencode install

验证 oh-my-opencode 是否安装成功，输出版本号代表安装成功，我安装的版本是 2.13.2

oh-my-opencode -v

如何使用

oh-my-opencode 命令支持哪些选项，输入下面命令，查看所有支持的选项

oh-my-opencode -h

通过 opencode 命令重新打开，页面的模式指示部分的关键词变成 Sisyhus，执行模式变成 Planner-Sisyhus，代表插件加载成功

同时项目的根目录会创建一个名为 opencode.json 的配置

image.png

更多高级配置详细使用查看官方介绍：github.com/code-yeongy…

资源链接

avatar
文章
阅读
粉丝