GitHub 64k Star 神器！OpenCode 5 分钟上手指南：开源免费，Claude Code 平替！

Ne0inhk

26 Mar 2026 — 6 min read

OpenCode，开源版 Claude Code。

6.4 万 GitHub Stars（昨天还是 6.1 万），100 万月活开发者，75+ 模型。

昨天写了 Anthropic 封杀第三方工具、OpenAI 主动开门的事。

今天出一篇 OpenCode 教程，5 分钟上手。

01｜安装

三种方式，按需选择。

桌面客户端（新手推荐）

不习惯命令行？直接下载桌面版。

你可以理解为带 GUI 界面的 Claude Code，操作简单，新手友好。

打开 opencode.ai/download，macOS、Windows、Linux 版本都有。

下载安装包，双击，打开就能用。

macOS 用户也可以 brew install --cask opencode-desktop。

桌面版目前是 Beta，但日常使用没问题。

类似于 Cursor 的 Agent 模式，纯对话交互，你只需要告诉 AI 做什么。

命令行 CLI

已经用习惯了 Claude Code 这类 CLI，想体验 OpenCode，可以用这种方式。

按系统选择安装命令。

macOS 和 Linux：

# 官方脚本（推荐） curl -fsSL https://opencode.ai/install | bash # Homebrew（macOS/Linux 都行） brew install opencode # 或者用 OpenCode 官方 tap，更新更快 brew install anomalyco/tap/opencode

Windows：

# Scoop（推荐） scoop bucket add extras scoop install extras/opencode # Chocolatey choco install opencode

已经有 Node.js 的话，也可以用下面这个通用的。

npm install -g opencode-ai # 或 pnpm / yarn / bun 都行

装完重启终端（很重要），然后验证。

opencode --version

能看到版本号就成功了。

用法和 Claude Code 一样，opencode 启动，对话就行。

IDE 插件

VS Code、Cursor、Windsurf、都有官方插件。

扩展商店搜 OpenCode，装完后 Cmd+Esc（Mac）或 Ctrl+Esc（Windows/Linux）唤起。

02｜连接模型

模型选择，OpenCode 的王牌功能。

不需要你任何订阅，直接用。

目前 OpenCode 内置了 5 个免费模型，据说是限时开放，且用且珍惜。

GPT-5 Nano
GLM-4.7（智谱，推荐）
MiniMax M2.1（MiniMax，推荐）
Grok Code Fast 1（xAI）
Big Pickle（神秘模型）

用桌面客户端的直接在对话框左下角选择。

CLI 输入 /models 切换模型，或者 /connect 切换 API 提供商。

有 ChatGPT 或 Claude 订阅的，还能直接 OAuth 授权（需 v1.1.11+），在 OpenCode 里爽用 OpenAI 和 Claude 的模型。

03｜初始化项目

打开你的项目目录。

桌面版直接拖文件夹进去，命令行 cd 到目录后运行 opencode。

第一次进新项目，运行一下 /init。

OpenCode 会扫描项目结构，自动生成 AGENTS.md 文件，类似 Claude Code 的 CLAUDE.md 或 Cursor 的 .cursorrules。

这个文件告诉 AI 你的代码风格、框架选型、目录结构，以后每次对话都会参考它。

还可以把 AGENTS.md 提交到 Git。团队协作时大家用的是同一份「项目说明书」。

04｜两种模式：Plan 和 Build

这是 Agentic Coding 的核心设计，OpenCode 自然也不例外。

按 Tab 键切换，左下角会显示当前模式。

「Plan 模式」只读。

AI 只分析、规划，不改动任何文件。适合复杂需求，先让 AI 出方案。

「Build 模式」是默认模式。

AI 可以读写文件、执行命令，真正干活。

不论是新项目，还是新增功能，修 Bug，一律推荐「先规划，后执行」。

谁用谁说好（Claude Code 也一样，切换快捷键是 Shift+Tab）。

切到 Plan 模式，输入需求，让 AI 生成实施步骤
确认方案没问题，按 Tab 切回 Build 模式
输入 执行，AI 开始写代码

这个流程能避免 AI 直接上手导致的误操作。复杂功能一定要先规划！

05｜开始对话

直接输入你想让 AI 做的事。

引用文件、调用 subagent 用 @。

输入 @ 后会弹出搜索框，文件和 subagent 都能搜到。

小细节，支持添加图片，直接拖拽进去就可以。

可以把设计稿、截图、报错信息直接拖进对话框。

AI 能看懂图片内容，按照 UI 写页面、根据报错截图定位问题。

06｜常用命令

输入 / 弹出命令列表。

/init：初始化项目，生成 AGENTS.md，重要且好用！
/review：review 未提交的代码改动。
/models：切换模型。
/connect：连接新的 API 提供商。
/undo：撤销上一步修改（快捷键 Ctrl+x u）。
/redo：重做（快捷键 Ctrl+x r）。
/share：分享当前对话，生成链接。
/compact：压缩对话历史，释放上下文空间。
/session：管理和切换历史会话，类似于 Claude Code 里的 /resume。
/mcp：管理 MCP。
/agents：切换 Agent。

07｜配置文件

以上足够用起来了。

但如果你想更加自定义，编辑 ~/.config/opencode/opencode.json 就行。

{   "$schema": "https://opencode.ai/config.json",   "model": "opencode/glm-4.7",   "default_agent": "build",   "theme": "opencode" }

也可以在项目根目录放一个 opencode.json，项目级配置会覆盖全局配置。

今天先讲这些。

后面会继续写进阶篇：自定义命令、MCP 扩展、Skills 技能、oh-my-opencode 插件等等。

有问题留言。

我是木易，Top2 + 美国 Top10 CS 硕，现在是 AI 产品经理。

关注「AI信息Gap」，让 AI 成为你的外挂。