OpenCode 完整安装指南3 分钟在终端跑起开源 AI 编程助手【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencodeOpenCode 安装本身只有两条命令的事。它是一个开源的 AI 编程代理coding agent跑在你的终端里负责读写代码、执行命令、管理会话并且模型可以自选——Anthropic、OpenAI、Google 或本地模型都接。装完之后你在任意项目目录敲一个词就能把重复的编码工作交给它。⚡ 三分钟跑起来最快路径是官方安装脚本。它会检测你的系统和架构下载对应的二进制装进~/.opencode/bin并帮你写好 PATH。curl -fsSL https://opencode.ai/install | bash等十几秒看到下载完成的提示就好。接着打开新终端在项目目录执行opencode预期看到 TUI 界面弹出说明安装链路全部通了。 安装方式怎么选先对照这张表决定走哪条路再往下翻详细步骤。方式适用系统核心命令适合谁官方安装脚本Linux / macOS / Windows (WSL)curl -fsSL https://opencode.ai/install \| bash绝大多数人想最快可用npm / bun / pnpm任意装了 Node 的系统npm i -g opencode-ailatest依赖用 JS 包管理器管的人HomebrewmacOS / Linuxbrew install anomalyco/tap/opencodeMac 和 Linux 用户要持续自动更新发行版包管理器Arch 等sudo pacman -S opencode系统级集成、走 APT 风格管理的人mise / nix任意系统mise use -g opencode多版本工具链、可复现环境桌面应用BetamacOS / Windows / Linux直接下载安装包不想碰终端的用户源码运行任意需 Bun 1.3git clonebun dev开发者、贡献者 各方式详细操作一键安装脚本脚本按OPENCODE_INSTALL_DIR→XDG_BIN_DIR→~/bin→~/.opencode/bin的顺序决定装哪默认落在最后一档属于用户级安装不需要 root 权限。curl -fsSL https://opencode.ai/install | bash执行后终端会打印版本号二进制出现在~/.opencode/bin/opencode。要装到系统级目录或指定版本把参数拼在前面OPENCODE_INSTALL_DIR/usr/local/bin curl -fsSL https://opencode.ai/install | bash curl -fsSL https://opencode.ai/install | bash -s -- --version 1.0.180npm / bun / pnpm / yarn把 OpenCode 当作一个全局 npm 包来装好处是和项目依赖走同一套更新机制。npm i -g opencode-ailatest装完全局PATH里会多出opencode命令直接可用。bun、pnpm、yarn 用户把命令换成bun add -g、pnpm add -g、yarn global add即可效果相同。HomebrewmacOS 和 Linux 上推荐用 tap 源公式更新勤基本始终跟得上最新版本。brew install anomalyco/tap/opencode几分钟后brew list opencode能列出安装内容即成功。其他包管理器与桌面版Arch 有稳定仓库和 AUR 两条路sudo pacman -S opencode paru -S opencode-bin桌面应用目前是 Beta按平台下载安装包即可macOS 用.dmg区分 Apple Silicon 和 IntelWindows 用.exeLinux 有.deb、.rpm、.AppImage三种。macOS 用户也可以直接brew install --cask opencode-desktop。从源码运行想跑最新代码或者提交 PR走这条路线。前提只有两个Bun 1.3和 Git。git clone https://gitcode.com/GitHub_Trending/openc/opencode cd opencode bun install bun devbun dev会直接在当前终端拉起 TUI等价于装好的opencode命令只是走本地代码。要针对别的目录运行追加参数即可bun dev directory。想出一个独立可执行文件./packages/opencode/script/build.ts --single产物在packages/opencode/dist/opencode-平台/bin/opencode拷走就能用。✅ 首次启动自检装完别急着开项目先做三步最小配置。第一步确认版本。opencode --version打印出语义化版本号即安装成功。第二步接入一个模型。进入 TUI 后按提示完成首次配置选择供应商、粘贴 API Key或者直接连本地模型。第三步发一句测试。随便让它读一个文件能正常返回说明模型链路通了。到这一步就可以开工了更多配置项见 packages/docs/essentials/settings.mdx。️ 平台兼容一览平台x64arm64备注macOS支持支持推荐Rosetta 下会自动按 arm64 取包Linux支持支持Alpine / musl 环境自动切换 musl 构建Windows支持WSL—原生走桌面应用CLI 建议在 WSL 内用桌面应用BetamacOS / Windows 全支持macOS 全支持Linux 提供 deb / rpm / AppImage不支持的组合比如 Linux 32 位脚本会直接报错退出不会装出坏包。 排错指南问装好了却提示opencode: command not found脚本默认把二进制放进~/.opencode/bin这个目录还没进你的 PATH。把下面一行加进 shell 配置文件再开新终端echo export PATH$HOME/.opencode/bin:$PATH ~/.bashrc source ~/.bashrczsh 用户把~/.bashrc换成~/.zshrc。问装的时候报端口或权限冲突或者行为怪异多半是 0.1.x 之前的旧版本残留先卸载再重装npm uninstall -g opencode-ai curl -fsSL https://opencode.ai/install | bash问公司终端不让动 shell 配置文件能装吗可以安装时加--no-modify-path脚本就不会碰你的 rc 文件之后 PATH 由你自己配curl -fsSL https://opencode.ai/install | bash -s -- --no-modify-path问装到哪个目录我能控制吗能OPENCODE_INSTALL_DIR优先级最高直接指过去就行OPENCODE_INSTALL_DIR/opt/opencode curl -fsSL https://opencode.ai/install | bash问跑起来之后选哪个模型没有标准答案。长上下文和复杂推理选旗舰模型日常小改动选便宜的快模型即可模型随时可切不绑定供应商。 收尾普通开发者一键脚本足矣别在选型上花时间。macOS / Linux 用户走 Homebrew tap 源更新省心。Node 栈团队npm i -g opencode-ailatest和现有工具链统一管理。想尝鲜的贡献者git clone下来跑bun dev直接站在最新代码上。下一步进入你的第一个项目目录执行opencode配好一个 API Key把今天最烦手的那段活儿丢给它。【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考