OpenCode 终端 AI 编程助手本地部署指南：3 条路径任选，新手 5 分钟上手

OpenCode 终端 AI 编程助手本地部署指南3 条路径任选新手 5 分钟上手【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencodeOpenCode 是一款专为终端打造的开源 AI 编程助手支持 Linux 与 macOS 系统。这篇部署指南覆盖一键脚本、包管理器和源码编译三种安装路径帮你跳过环境坑直接跑起来。动手前先选路再装不同使用习惯的人适合不同的装法。先对照下面两张表确定自己的路线后面的章节可以直接跳读。系统与环境要求检查项要求说明操作系统Linux 或 macOSWindows 用户可参考桌面应用章节Bun 运行时必须官方脚本和源码构建都基于 BunNode.js18 及以上包管理器方式安装时需要Bun 是一个快速的 JavaScript 运行时可以把它理解成更快的 Node。如果本机还没有先按 docs/development.mdx 的说法把开发环境搭好再回来继续。三条部署路径怎么选路径适合人群典型命令一键安装脚本只想尽快跑起来的新手curl -fsSL https://opencode.ai/install \| bash包管理器习惯用 npm / bun / pnpm / Homebrew 做版本管理npm i -g opencode-ailatest源码编译要体验最新功能或做二次开发bun install bun dev如果已经装过很旧的版本建议先卸载再装新的避免残留文件引发版本冲突——仓库在 README.md 中明确提示要移除 0.1.x 之前的版本。一键安装脚本三步跑通这是最省事的路线一条命令完成系统检测、架构适配和环境配置全程不需要人工干预。打开终端执行安装curl -fsSL https://opencode.ai/install | bash脚本会自动下载对应你系统架构的二进制文件并放到 PATH 可达的位置。等待依赖下载和配置完成无需任何输入。看到终端打印All checks have passed说明部署验证已通过。安装目录可以改吗可以。脚本按自定义目录 XDG 规范路径 用户目录的优先级决定落盘位置用环境变量就能干预优先级变量用途1$OPENCODE_INSTALL_DIR完全自定义安装目录例如系统级/usr/local/bin2$XDG_BIN_DIR遵循 XDG 基础目录规范一种 Linux/macOS 下的统一路径约定3默认用户目录两者都未设置时的兜底位置示例# 系统级安装需要相应权限 OPENCODE_INSTALL_DIR/usr/local/bin curl -fsSL https://opencode.ai/install | bash # 用户级安装 XDG_BIN_DIR$HOME/.local/bin curl -fsSL https://opencode.ai/install | bash包管理器安装跟着你现有的工具链走如果你的项目本来就用某个包管理器走同一条链路升级、卸载都更顺手。JavaScript 生态npm i -g opencode-ailatest bun add -g opencode-ailatest pnpm add -g opencode-ailatest三条命令效果一致任选其一。安装完成后直接在终端输入opencode即可启动 CLI。核心实现位于 packages/opencode/src/ 目录包含完整的命令行入口和 AI 交互逻辑。HomebrewmacOS / Linuxbrew install sst/tap/opencodeHomebrew 会自动处理依赖之后升级只需brew upgrade opencode桌面应用不想盯终端的选项喜欢图形界面的用户可以直接用桌面版包含会话列表、代码编辑区和实时状态反馈。CLI 与桌面版共享同一套核心代码库功能行为保持一致。各平台安装包可在项目 releases 页面获取支持 Windows、macOS、Linux平台安装包macOSApple Silicon / Intel.dmgWindows.exeLinux.deb/.rpm/.AppImage也可以用包管理器直接装# macOS brew install --cask opencode-desktop # Windows scoop bucket add extras scoop install extras/opencode-desktop如果你日常主力是 VS CodeOpenCode 也可以嵌在里面当 AI 侧边栏使用左边改代码、右边看 AI 的修改说明和 diff部署验证与首次启动配置装完先确认版本这条命令能同时验证装没装上和PATH 配没配对opencode --version能打印出版本号即部署成功。首次启动会引导你完成三项关键配置选择模型提供商——Anthropic、OpenAI、Google 或本地模型填写 API 密钥——去对应提供商的后台获取指定工作目录——OpenCode 默认操作的项目路径。之后想改配置配置文件在~/.opencode/config.json也可以直接执行opencode config edit源码编译给想改代码的人想尝鲜未发布的特性或者计划二次开发 AI 交互逻辑就走源码路线。克隆仓库git clone https://gitcode.com/GitHub_Trending/openc/opencode cd opencode安装依赖bun install构建参数集中在根目录的 package.json需要调整编译行为时改这里。以开发模式启动bun dev这条脚本实际是带着--conditionsbrowser条件去跑 packages/opencode/src/index.ts即 CLI 的主入口。上手技巧用 Tab 切换两种代理模式进入交互界面后按Tab键可以在两种内置代理模式之间切换模式权限典型用途构建模式build完整文件系统读写权限改代码、写项目默认模式计划模式plan只读分析陌生代码库、设计方案拒绝文件编辑执行 bash 命令前会先征求同意代理的核心逻辑实现在 packages/opencode/src/ 下README 中提及的src/agent/方向高级用户可结合配置文件自定义代理行为。另外还有一个general子代理用于复杂搜索和多步骤任务在消息里输入general即可调用。常见问题排查安装后遇到下面两种情况按表处理即可。问题原因解决步骤opencode: command not found安装目录不在 PATH 中1. 检查echo $PATH是否包含安装目录2. Bash/Zsh 追加echo export PATH$HOME/.opencode/bin:$PATH ~/.bashrc source ~/.bashrc3. Fish 用户执行fish_add_path $HOME/.opencode/bin启动报版本不兼容或行为异常旧版本残留文件干扰1. 卸载包管理器版本npm uninstall -g opencode-ai2. 清理残留rm -rf $HOME/.opencode3. 重新安装最新版两条路径的本质相同让当前可执行文件和当前配置文件属于同一个版本。小结OpenCode 的部署没有神秘门槛想快一条 curl 脚本五分钟内见结果想稳走 npm / bun / pnpm / Homebrew想改clone 下来bun dev就能跑。装好之后先用opencode --version验证再完成模型、密钥、目录三项配置就可以用 Tab 在构建与计划两种模式之间切换开始让 AI 帮你写代码了。【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考