5分钟装好 OpenCode：终端 AI 编程助手的完整安装与上手指南
5分钟装好 OpenCode：终端 AI 编程助手的完整安装与上手指南
【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode
OpenCode 是一个开源免费的终端 AI 编程代理：它运行在命令行里，能读取你的代码库、按指令修改文件，并接入多家大模型服务商。本文面向第一次接触它的开发者，覆盖从安装、验证到跑通第一个任务的全过程。
📌 30秒速览
- OpenCode 是跑在终端里的开源 AI 编程助手，支持 macOS、主流 Linux 和 Windows（推荐 WSL2）。
- 最快安装只需一条 curl 脚本命令，也可用 npm、Homebrew、Scoop 等包管理器。
- 装完先运行
opencode auth login配置模型密钥，再启动交互界面。 - 内置 build（可写）与 plan（只读）两个代理，按 Tab 键切换。
安装前检查清单
- 系统：macOS 10.15+、主流 Linux 发行版，或 Windows 10+（建议 WSL2）。
- 网络：需要能访问模型服务商（如 Anthropic、OpenAI），并准备好对应的 API Key。
- 磁盘：几百 MB 可用空间即可，无额外运行时依赖。
- 装过 0.1.x 之前的旧版本时，先卸载再装新版，避免命令冲突。
选一条适合你的安装路径
一键脚本：最快跑起来
适合想立刻上手的新手。脚本自动识别系统架构、下载最新版本并加入 PATH。
curl -fsSL https://opencode.ai/install | bash包管理器：长期维护更省心
适合习惯用工具管理环境的开发者，后续升级统一走包管理器的升级命令。
npm i -g opencode-ai@latestmacOS 用户也可以走 Homebrew：
brew install anomalyco/tap/opencode源码构建：面向二次开发
适合想读代码或改功能的人，前提是已安装 Bun。
git clone https://gitcode.com/GitHub_Trending/openc/opencode cd opencode && bun install| 安装方式 | 适合人群 | 日常升级方式 |
|---|---|---|
| curl 脚本 | 想最快开始体验的新手 | 重跑同一条 curl 命令 |
| npm / brew / scoop | 日常开发、团队统一环境 | 包管理器自带升级命令 |
| 源码构建 | 二次开发、贡献代码 | 拉取更新后重新构建 |
验证安装：看到什么算成功
先确认命令已就位并输出版本号：
opencode --version看到形如0.1.x的版本号即为成功；如果提示 command not found，重开一个终端再试，仍不行就手动把安装目录加进 PATH。
安装失败速查
- 提示权限不足：脚本默认装到用户目录（
~/.local/bin或~/.opencode/bin），一般不需要 sudo；报权限错误时可设置OPENCODE_INSTALL_DIR指向可写目录。 - 旧版本冲突：清理 0.1.x 之前的安装后重装。
完成初始配置
- 配置模型密钥。登录一次后密钥会存到
~/.local/share/opencode/auth.json，每次启动自动加载，不用反复输入。
opencode auth login按交互提示选择服务商并粘贴密钥即可。API Key 就是服务商发给你的那串凭证字符串。
- 确认密钥生效。下面命令会列出
provider/model形式的可用模型，输出里包含你刚登录的服务商就算通过。
opencode models- 建一份项目级配置（可选）。在项目根目录新建
opencode.json，可固定默认模型等设置，字段写法可参考 packages/opencode/ 中的相关说明。
第一次实战：10分钟拿到第一个结果
先用非交互模式验证整条链路，它能跳过界面直接输出答案：
opencode run "Explain the use of context in Go"打印出回答后，进入日常用法——在任意项目目录启动交互界面：
cd 你的项目目录 opencode在 TUI（终端里的交互界面）中直接输入需求即可。按 Tab 键可在 build 与 plan 两个代理间切换：build 拥有改文件等完整权限，plan 是只读的，适合先让它摸清陌生代码库再动手。
进阶选项：常用命令速查
| 命令 | 作用 |
|---|---|
opencode | 启动终端交互界面 |
opencode run "问题" | 非交互单次提问，适合写进脚本 |
opencode models --refresh | 刷新缓存的模型列表 |
opencode auth list | 查看已登录的服务商 |
opencode serve | 启动无头服务，配合run --attach复用，省去冷启动 |
模型怎么挑：重构、长上下文任务选代码能力强的模型；简单问答选便宜快速的，省额度。
OpenCode 仍在快速迭代，用安装时对应的命令升级到最新版即可，脚本方式如下：
curl -fsSL https://opencode.ai/install | bash更多配置字段与自定义 agent 写法，可查阅仓库内的 packages/web/src/content/docs/ 文档源。
【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考