前言OpenCode 是一款开源的 AI 编码代理AI coding agent提供终端 CLI、桌面应用和 IDE 扩展三种形态。本文手把手教你在 macOS / Linux / Windows 上安装 OpenCode CLI讲清安装前的前置条件并重点介绍它强大的插件Plugin生态——插件能做什么、去哪里找、到底怎么装。官网OpenCode | The open source AI coding agent 官方文档Intro | AI coding agent built for the terminal一、安装前的准备工作前置条件在开始安装前请先确认以下条件现代终端模拟器例如 WezTerm、Alacritty、Ghostty、Kitty 等。Windows 用户建议使用 WSL。Node.js可选如果用 npm 方式安装需要 Node.js v18。至少一个 LLM 提供商的 API KeyOpenCode 本身不绑定模型需要你提供模型访问方式。官方推荐使用 OpenCode ZenZen | OpenCode网络环境安装脚本与 npm 安装都需要访问外网国内用户可先设置 npm 镜像源加速。如果你用 npm 安装可先执行下面命令换源加速npm config set registry https://registry.npmmirror.com二、安装 OpenCode CLI多平台方法一官方一键安装脚本脚本会自动识别你的系统与架构并把二进制加入 PATHcurl -fsSL https://opencode.ai/install | bash方法二Node.js 包管理器npm / Bun / pnpm / Yarn补充用 npm 安装前先配好 Node.js 环境建议装到 D 盘如果你选择用npm或 pnpm / yarn / bun方式来安装 OpenCode就必须先装好 Node.js官方要求 v18 及以上推荐直接用 LTS 版。这里最关键的两点是到官网下载并且把 Node.js 安装到 D 盘避免占用日益紧张的系统 C 盘空间。1Node.js 官方下载地址打开 Node.js 官网中文下载页Node.js — 下载 Node.js® 选择LTS长期支持版下的Windows 安装包.msi例如node-v20.xx.x-x64.msi。2安装到 D 盘而不是 C 盘双击运行下载好的 .msi 安装包在安装向导里把安装目录Destination Folder从默认的C:\Program Files\nodejs\改成 D 盘路径例如D:\Dev\nodejs\安装界面记得勾选“Add to PATH”加入环境变量。安装完成后建议再把 npm 的全局包目录和缓存目录也一起改到 D 盘重新打开一个终端执行npm config set prefix D:\Dev\nodejs\npm-global npm config set cache D:\Dev\nodejs\npm-cache3验证 Node.js 与 npm 是否安装成功重新打开一个新的终端让 PATH 生效输入node -v npm -v能分别打印出版本号例如v20.x.x与10.x.x就说明环境已经装好此时再回到上面的 npm 命令安装 OpenCode 即可。npm install -g opencode-ai bun install -g opencode-ai pnpm install -g opencode-ai yarn global add opencode-ai方法三HomebrewmacOS / Linuxbrew install anomalyco/tap/opencode官方推荐使用 OpenCode tap 以获取最新版本。方法四Arch Linuxsudo pacman -S opencode # 稳定版 paru -S opencode-bin # AUR 最新版方法五Windows官方推荐使用 WSL 获得最佳体验Windows (WSL) | OpenCode也可用原生包管理器choco install opencode scoop install opencode npm install -g opencode-ai方法六Dockerdocker run -it --rm ghcr.io/anomalyco/opencode方法七桌面版Betabrew install --cask opencode-desktop或从下载页获取OpenCode | Download验证安装opencode --version能输出版本号即安装成功。三、配置模型与初始化在 TUI 中运行/connect选择 opencode然后前往 OpenAuth 登录、复制 API Key 并粘贴即可。也可以配置其他提供商Providers | OpenCode进入项目目录并启动cd /path/to/project opencode /init/init会分析项目并生成 AGENTS.md官方建议提交到 Git帮助 OpenCode 理解项目结构与规范。常用命令与用法Slash 命令 / CLI 命令OpenCode 的命令分为两类一类是在交互式界面TUI中以/开头的 Slash 命令另一类是在终端中直接执行的 CLI 命令。下面分别整理。1TUI 内的 Slash 命令进入 opencode 界面后输入/即可触发部分命令带ctrlx快捷键/init分析当前项目并生成或更新 AGENTS.md 文件初始化项目最常用。/connect添加模型提供商并配置 API Key。/models列出并切换可用模型。/new别名/clear新建一个会话。/sessions别名/resume、/continue查看并切换历史会话。/compact别名/summarize压缩当前会话上下文节省 Token。/undo//redo撤销 / 重做上一步操作包含文件改动依赖 Git 仓库。/share//unshare分享 / 取消分享当前会话。/editor调用外部编辑器编写提示词。/export把当前对话导出为 Markdown。/theme切换界面主题。/thinking显示或隐藏模型的思考过程。/help查看帮助。/exit别名/quit、/q退出。2Agent智能体用法切换主智能体在 TUI 中按Tab/ShiftTab。内置 build默认可读写文件、执行命令与 plan只读用于分析与规划两个主智能体。调用子智能体在消息中用名称提及例如explore、general、scout。管理智能体在终端执行opencode agent create创建自定义智能体opencode agent list列出全部智能体。3常用 CLI 命令在终端中执行opencode启动 TUI 交互界面。opencode run 你的指令非交互模式执行一条指令后退出。opencode auth login配置模型提供商的登录凭证。opencode models列出当前可用的模型。opencode mcp add/opencode mcp list添加 / 查看 MCP 服务器。opencode session list列出历史会话。opencode stats查看 Token 用量与费用统计。opencode upgrade升级到最新版本。opencode --version查看当前版本。小提示在消息中输入文件路径可引用项目文件以!开头可直接执行 shell 命令并把输出加入对话。例如explore 找出所有写入 users 表的代码路径 !git status以上命令均整理自 OpenCode 官方文档具体以官方最新版本为准。四、OpenCode 的插件系统插件Plugin是 OpenCode 最强大的扩展能力它允许你通过挂钩hook各种事件来扩展或改变 OpenCode 的默认行为——添加新功能、对接外部服务、注入上下文甚至给 AI 添加自定义工具。插件官方文档Plugins | OpenCode插件生态总览含全部插件与地址Ecosystem | OpenCode4.1 插件的两种安装方式方式 A从本地文件加载。把 .js / .ts 插件文件放进插件目录启动时会自动加载.opencode/plugins/ # 项目级插件 ~/.config/opencode/plugins/ # 全局插件方式 B从 npm 加载。在配置文件 opencode.json 中声明包名即可{ $schema: https://opencode.ai/config.json, plugin: [opencode-wakatime, opencode-notify] }npm 插件会在启动时由 Bun 自动安装依赖缓存在 ~/.cache/opencode/node_modules/。支持普通包与作用域包如 scope/plugin。4.2 插件加载顺序全局配置 ~/.config/opencode/opencode.json项目配置 opencode.json全局插件目录 ~/.config/opencode/plugins/项目插件目录 .opencode/plugins/4.3 插件推荐附地址OmOOh My OpenCode即 oh-my-opencodeOmO 是当前 OpenCode 生态里一个功能比较全面的增强插件作者把 AmpCode、Claude Code 中最好用的能力搬了过来并做了加强相当于把 OpenCode 直接升级成一个多智能体Multi-Agent开发主要特性后台并行智能体主代理 Sisyphus 负责统筹会像真实开发团队一样并行派出子代理——Hephaestus自主深度执行、Oracle架构 / 调试、Librarian查官方文档与开源实现、Explore极速代码库检索等主代理上下文不再被塞爆。预置 LSP / AST 工具重构、重命名、诊断、AST 感知的代码搜索都更精准、更安全改代码不再蒙着眼睛。内置 MCP开箱即用的 websearchExa、context7官方文档、grep_appGitHub 代码搜索。Claude Code 兼容层支持 Command、Agent、Skill、MCP以及 PreToolUse / PostToolUse / UserPromptSubmit / Stop 等 Hook。魔法关键词在提示词里加上ulwultrawork即可自动触发并行智能体、后台任务与深度探索并且不干完不罢休。贴心小功能TODO 强制完成半途而废会被拉回来继续做、注释检查避免 AI 堆砌无意义注释、会话记忆等。项目地址GitHub - code-yeongyu/oh-my-openagent: OmO: Just type mass ulw keyword with your prompt. Now you are the master of graph engineering. · GitHub安装方式与上面 4.1 一致把oh-my-opencode加入opencode.json的plugin数组即可官方也建议直接让 AI 代理按仓库说明自动完成安装与配置。opencode-notify——任务完成时发送原生系统通知GitHub - kdcokenny/opencode-notify: Native OS notifications for OpenCode – know when tasks complete · GitHubopencode-wakatime——用 WakaTime 统计你的编码时长GitHub - angristan/opencode-wakatime: Track Opencode usage with Wakatime · GitHubopencode-morph-fast-apply——借助 Morph 让代码编辑快 10 倍GitHub - JRedeker/opencode-morph-fast-apply: OpenCode plugin for Morph Fast Apply - 10x faster code editing with lazy edit markers. No MCP server needed. · GitHubopencode-dynamic-context-pruning——裁剪过期的工具输出节省 TokenGitHub - Tarquinen/opencode-dynamic-context-pruning: Dynamic context pruning plugin for OpenCode - intelligently manages conversation context to optimize token usage · GitHubopencode-supermemory——跨会话的持久记忆GitHub - supermemoryai/opencode-supermemory: Supermemory plugin for OpenCode · GitHuboh-my-opencode——后台代理 预置 LSP/AST/MCP 工具兼容 Claude CodeGitHub - code-yeongyu/oh-my-openagent: OmO: Just type mass ulw keyword with your prompt. Now you are the master of graph engineering. · GitHubopencode-openai-codex-auth——直接用你的 ChatGPT Plus/Pro 订阅而非 API 计费GitHub - numman-ali/opencode-openai-codex-auth: OAuth authentication plugin for personal coding assistance with ChatGPT Plus/Pro subscriptions - uses OpenAIs official authentication method · GitHubopencode-gemini-auth——复用已有的 Gemini 套餐GitHub - jenslys/opencode-gemini-auth: Gemini auth plugin for opencode · GitHubopencode-firecrawl——网页抓取、爬取与搜索GitHub - firecrawl/opencode-firecrawl · GitHubopencode-websearch-cited——为支持的模型加入原生联网搜索带引用GitHub - ghoulr/opencode-websearch-cited: An OpenCode plugin that provides LLM cited web search. · GitHubopencode-pty——让 AI 在 PTY 中运行后台进程并发送交互输入GitHub - shekohex/opencode-pty: OpenCode plugin for interactive PTY management - run background processes, send input, read output with regex filtering · GitHubopencode-vibeguard——在调用 LLM 前对密钥/隐私信息做脱敏GitHub - inkdust2021/opencode-vibeguard: VibeGuard for opencode · GitHubopencode-worktree——零成本的 git worktree 工作流GitHub - kdcokenny/opencode-worktree: Zero-friction git worktrees for OpenCode. Auto-spawns terminals, syncs files, cleans up on exit. · GitHubopencode-md-table-formatter——清理 LLM 生成的 Markdown 表格GitHub - franlol/opencode-md-table-formatter: Markdown table formatter plugin for OpenCode with concealment mode support. · GitHubopencode-type-inject——读取文件时自动注入 TypeScript/Svelte 类型GitHub - nick-vi/type-inject: TypeScript type context for AI coding assistants. Auto-injects type signatures on reads, reports type errors on writes, and provides type lookup tools. · GitHubopenspoon/subtask2——把 /commands 扩展为强大的编排系统GitHub - spoons-and-mirrors/subtask2: A stronger opencode /command handler · GitHub五、相关链接汇总官网首页OpenCode | The open source AI coding agent官方文档简介 / 安装Intro | AI coding agent built for the terminal官方下载页OpenCode | Download插件文档Plugins | OpenCode插件生态总览Ecosystem | OpenCodeWindows WSL 指南Windows (WSL) | OpenCode提供商目录Providers | OpenCodeGitHub 仓库GitHub - anomalyco/opencode: The open source coding agent. · GitHubGitHub ReleasesReleases · anomalyco/opencode · GitHub小结安装 OpenCode CLI 只需一条命令即可完成真正让 OpenCode 变强的是它的插件生态。建议先装好 opencode-notify、opencode-wakatime 等基础插件再按需加入 fast-apply、上下文裁剪、持久记忆等进阶插件打造属于你自己的 AI 编程工作流。说明本文安装指令与插件信息整理自 OpenCode 官方网站与官方文档插件地址均来自官方生态页工具更新较快具体命令请以官方文档最新版本为准。