这个项目有什么用
opencode 是一个开源的 AI 编码代理(coding agent),官方描述为「The open source AI coding agent」。它把「让 AI 参与写代码、读代码、改代码」这件事做成一个可以本地安装、在终端里直接调用的工具,而不是绑定在某个编辑器插件或网页界面里。
从 README 提供的信息看,它主要解决两类问题:
- 把 AI 助手带进真实项目目录:通过内置的 build 代理直接对代码库进行开发性修改,替代在聊天窗口和编辑器之间来回复制粘贴的手工操作。
- 在动代码之前先看懂代码:内置的 plan 代理是只读的,默认拒绝文件编辑、执行 bash 命令前会请求许可,适合在不熟悉的代码库里先做分析和方案规划。
典型使用场景
- 接手一个陌生仓库,想先让 AI 通读结构、梳理改动思路,再决定怎么动手。
- 日常开发中让 AI 直接在工作目录里完成修改,省去手动搬运代码片段的步骤。
- 需要跨多步检索、复杂搜索的任务,可以调用内置的 general 子代理来处理。
适合希望把 AI 编码能力放在本地终端、并且在意开源与可自行部署的开发者;对只想在 IDE 里点按钮补全代码的用户,它未必是最省事的选择。
核心特性
- 双内置代理,用 Tab 键切换:build 是默认的全权限开发代理;plan 是只读代理,默认拒绝文件编辑,运行 bash 命令前会询问许可,适合探索不熟悉的代码库或规划改动。
- general 子代理:用于复杂搜索和多步骤任务,属于内部使用,可在消息中通过
@general调用。 - 多种安装方式:提供一键安装脚本,也支持 npm、bun、pnpm、yarn、Homebrew、pacman、AUR、mise、Nix 等渠道,覆盖 macOS、Linux 及跨平台包管理场景。
- 提供桌面应用(BETA):除命令行外还有桌面版本,可从官网下载页获取,macOS 上也可用 Homebrew cask 安装。
- 多语言文档入口:README 顶部列出简体中文、繁體中文、日本語、한국어 等二十余种语言的文档入口,配置细节统一指向官方 docs。
怎么安装
前提条件:README 未明确列出所需的运行时版本或系统依赖,官方文档未说明。若使用包管理器方式,需要先具备对应的包管理工具(npm/bun/pnpm/yarn、Homebrew、pacman、mise、Nix 等)。
- 最省事的方式是执行官方安装脚本:
# YOLO curl -fsSL https://opencode.ai/v2/install | bash该脚本会把 OpenCode 安装到
$HOME/.opencode/bin。 - 如果习惯用 Node 生态的包管理器,可全局安装 CLI:
npm i -g @opencode/cli@latest # or bun/pnpm/yarn - macOS 与 Linux 用户可用 Homebrew,README 推荐 tap 版本(始终保持最新):
brew install anomalyco/tap/opencode-v2 # macOS and Linux (recommended, always up to date)也可使用官方 brew formula,但更新频率较低:
brew install opencode # macOS and Linux (official brew formula, updated less) - Arch Linux 用户可从稳定版或 AUR 测试版中选择:
sudo pacman -S opencode # Arch Linux (Stable) paru -S opencode-beta # Arch Linux (Latest from AUR) - 跨平台工具链用户可用 mise 或 Nix:
mise use -g opencode # Any OS nix run github:anomalyco/opencode # Nix - 如需桌面应用(BETA),从 opencode.ai/download 下载,macOS 也可用:
# macOS (Homebrew) brew install --cask opencode-desktop
怎么使用
README 没有给出完整的命令行调用示例,最基础的用法是安装完成后在项目目录中启动 OpenCode,然后用 Tab 键在内置代理之间切换:默认进入 build 代理做开发性修改,切到 plan 代理则进行只读分析。
常见进阶用法与配置项:
- 用 plan 代理做前置调研:在不熟悉的代码库里先切到 plan,它默认拒绝文件编辑、执行 bash 前会请求许可,适合先摸清结构再动手。
- 调用 general 子代理:面对复杂搜索或多步骤任务时,在消息中使用
@general交给子代理处理。 - 查阅官方文档:关于代理配置、模型接入等更细的配置项,README 统一指向 opencode.ai/docs,具体参数以官方文档为准,本文不代为推测。
适用场景与注意事项
适合的场景:希望以开源方式在本地终端使用 AI 编码代理的开发者;需要「先只读分析、再动手修改」这种分阶段工作流的团队;已经习惯 Homebrew、npm、Nix 等包管理方式、希望一条命令完成安装的用户。
需要留意的点:
- 许可证:项目采用 MIT 协议,商用与二次分发相对宽松,但仍建议以仓库中的 LICENSE 文件为准。
- 联网与模型服务:作为 AI 编码代理,实际使用必然依赖模型服务,README 未说明默认模型来源、是否需要自备 API Key,官方文档未说明,使用前请查阅 docs。
- 桌面端仍为 BETA:README 明确标注桌面应用处于测试阶段,稳定性预期应相应降低。
- 命名与归属:如果你在做与 OpenCode 相关的项目并在名称中使用 “opencode”(例如 “opencode-dashboard”、”opencode-mobile”),README 要求在 README 中注明该项目并非由 OpenCode 团队构建、与其无任何关联。
- 安装脚本风险:一键脚本通过
curl | bash方式执行,属于常见但需自行评估的做法。
项目地址
- 仓库地址:https://github.com/anomalyco/opencode
- 项目主页:https://opencode.ai
- 作者/组织:anomalyco
- 开源协议:MIT
- 社区:Discord | X.com
opencode 把 AI 编码代理做成了可本地安装的开源工具,内置 build 与 plan 两种权限不同的代理,安装渠道覆盖主流包管理器,是否适合你的工作流,取决于你对终端式 AI 协作方式的接受程度。
















iphone duo wireless charging 5天前0
iphone duo wireless charging