OpenCode 是一个开源的 AI 编程代理（AI coding agent），支持在终端（Terminal）、桌面应用和主流 IDE（如 VS Code）中与 AI 交互完成代码相关任务。

OpenCode 可以帮助我们理解代码库、编写新功能、重构代码、修复 Bug 等，大幅提升开发效率。

OpenCode 类似于 Claude 的 Code 模式或 Cursor 的 Agent 功能，但完全开源、隐私优先，支持多种大语言模型（LLM），并强调终端体验。

OpenCode 支持 75+ 家模型提供商，内置 GLM-4.7、MiniMax M2.1 等免费模型，可对接 OpenAI、Anthropic、Google 等商业模型，也能配置本地模型（如 Llama 3），按需适配轻量脚本、复杂架构等不同场景。

关键特性
两种内置 Agent 模式：

• Build 模式：全权限，可直接编辑文件、执行命令。
• Plan 模式：只读规划，默认拒绝编辑，需要确认。

工具集：bash 执行、文件读写、grep 搜索、LSP 诊断等。

上下文感知：自动分析项目结构，生成 AGENTS.md 指南。

分享与协作：一键生成会话分享链接。

一、OpenCode 环境安装

OpenCode 支持 macOS / Windows / Linux 多平台安装。

1.1 OpenCode CLI 安装方法

方法一：通用curl一键安装

通用一键安装脚本这是最简单的方法：

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

安装完成后，你应该能通过命令行运行：

opencode --version

如果输出类似 1.1.19 这种的版本号信息表示安装成功。

方法二：包管理器安装

macOS / Linux

brew install opencode

// 或者
npm install -g opencode-ai

// 安装成功验证
opencode --version

Windows

npm i -g opencode-ai

// 或
choco install opencode

// 或
scoop bucket add extras
scoop install extras/opencode

// 安装成功验证
opencode --version

OpenCode 是在终端运行的，我们可以使用默认系统自带的终端，也可以使用一些好用的现代化的终端工具：

• WezTerm, 跨平台
• Alacritty, 跨平台
• Ghostty, Linux 与 macOS
• Kitty, Linux 与 macOS

方法三：桌面应用安装

OpenCode 也提供桌面端应用，可直接从 发布页面 或 opencode.ai/download 下载。

方法四：Docker安装

最简单的安装方式是使用Docker，只需一条命令：
docker run -it --rm opencode-ai/opencode

// 安装成功验证
opencode --version

1.2 VSCode中集成OpenCode TUI

从vscode扩展中搜opencode，我们可以看到有三种不同的opencode，这个可根据需要自行选择。

VS Code 扩展的区别和联系：

四者之间的联系

1. 都依赖 OpenCode CLI - 三个扩展都需要先安装 opencode CLI 才能工作
2. 都是 OpenCode 的前端 - 本质都是调用同一个后端服务
3. 架构是 Client/Server - CLI 启动后端服务器，前端通过 HTTP 与之通信

使用推荐

• 想要官方稳定体验 → opencode (原有扩展)
• 想要最新功能 → OpenCode Beta (官方 Beta)
• 想要更好 UI 体验 → OpenCode GUI (社区版，功能更丰富但非官方)

二、启动与使用

启动 OpenCode 只需要终端输入启动命令：

opencode

首次启动会引导完成基础配置：

• 模型选择：默认展示可用模型列表，可直接选择标注 Free 的免费模型（如 MiniMax M2.1、GLM-4.7），无需 API Key 即可使用。
• 登录选项：可选择跳过登录，后续需对接商业模型时再配置 API Key，也可登录 Claude Code Pro 账号调用专属模型。

启动成功后进入 TUI 界面，即可开始使用核心功能。

我们可以在终端输入 /models 查看可用的免费模型：

弹出的查看，右边有 Free 字样的就是免费的：

2.1 配置 API 密钥与模型

如果你连接一个 AI 提供商的 API 密钥，例如 OpenAI 或 Anthropic Claude，运行：

opencode auth login

或者在终端启动后输入：
/connect

选择模型。按照提示登录并粘贴你的 API Key。

你也可以使用 Zen 模型集合（由 OpenCode 官方推荐、经过测试的高质量模型），省去自己管理多个外部账户的麻烦。

如果不想用了，可以使用以下命令退出：

/exit

2.2 基本使用

1）启动 OpenCode
进入你想处理的项目目录：

cd /path/to/your/project
opencode

如果有权限问题，可以使用：
sudo opencode

这会打开 OpenCode 的终端交互界面（TUI）。

2）项目初始化

在 OpenCode 界面中，运行：/init

这会生成一个 .opencode/ 文件夹，用于存储项目的向量化索引和自定义指令。

它会扫描当前目录的代码结构，并生成一个用于记录项目信息的 AGENTS.md 文件。

opencode-runoob-test 目录下可以看到 AGENTS.md 文件：

然后我们使用自然语言描述你的需求来发起任务：

在当前目录下创建一个登录页面

接下来大模型就会开始思考，并创建登录页面：

生成的文件：

提问解释代码
你可以直接用自然语言向 OpenCode 询问代码库细节：

• 文件 @index.html 包含哪些功能
• 其中 @ 用来引用项目里的文件路径。
  

日常交互

• 直接提问：例如 “解释 src/main.ts 中的认证逻辑”。
• 添加功能：描述需求，如 “添加用户注册 API，支持邮箱验证”。
• 切换模式：按 Tab 键切换 Plan/Build 模式（Plan 更安全，用于规划）。
• 撤销变更：/undo
• 重做：/redo
• 分享会话：/share

三、OpenCode 插件工具

3.1 oh-my-opencode

oh-my-opencode 是一个为 OpenCode设计的强大插件/扩展层。它将单个 AI 代理升级为一个多智能体协作团队，提供开箱即用的高级功能。

GitHub 仓库：https://github.com/code-yeongyu/oh-my-opencode

核心亮点包括：

• Sisyphus 主智能体：负责持续执行复杂任务，直至完成。
• 支持并行运行专业子智能体（如 Oracle 预言者、Librarian 文档专家、Frontend Engineer 前端工程师、Explore 探索者等）。
• 内置 LSP/AST 工具（代码重构）、MCP（模型调用插件，如搜索、文档检索）、钩子系统（25+ 种事件触发）。
• 多模型调度：自动分配任务给最适合的模型（例如 Gemini 处理前端、Claude 处理规划）。
• 关键词触发完整自动化（如 ultrawork 或 ulw），支持后台任务、Todo 强制执行、上下文注入等。
• 完全兼容 Claude Code 工作流，强调高性能、自动化和可定制性。

安装：推荐让 OpenCode 自动完成安装，复制以下提示并粘贴到你的 OpenCode 对话框：

按照以下说明安装和配置 oh-my-opencode：
https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/docs/guide/installation.md

安装后，默认开箱即用，无需额外配置即可体验大部分功能。

基本触发：在 OpenCode 的提示词中加入关键词 ultrawork（或简写 ulw），例如：

ultrawork: 请帮我实现一个 React 组件，支持暗黑模式。

这会激活完整模式：Sisyphus 主智能体接管，自动分配子任务给专业代理，并行执行（后台映射代码库、深度探索、自动重构等），直至任务 100% 完成。

四、参考地址

1. 官方网址：https://opencode.ai/
2. GitHub 仓库：https://github.com/anomalyco/opencode
3. 文档：https://opencode.ai/docs
4. 菜鸟教程：opencode入门教程