OpenCode 安装教程开源终端 AI 编程助手从零上手一句话简介OpenCode 是一款 100% 开源的 AI 编程 Agent直接跑在终端里支持 75 模型供应商能理解整个代码库、自主完成多文件编辑和命令执行。本文带你从零完成安装与配置。 目录一、OpenCode 是什么二、环境要求三、安装 OpenCode四、验证安装五、首次配置连接 AI 模型六、快速上手七、升级与卸载八、常见问题 FAQ九、参考资料一、OpenCode 是什么OpenCode 是由 SSTanomalyco团队打造的开源 AI 编程 Agent你可以把它理解为“开源版 Claude Code”但它有几个独特优势特性说明100% 开源代码完全开源GitHub 星标数十万社区活跃模型中立不绑定任何厂商支持 Anthropic、OpenAI、Gemini、DeepSeek 等 75 供应商也支持本地模型终端优先基于 Go Bubble Tea 构建的丝滑 TUI终端界面启动快、占用低本地优先代码与对话数据默认保存在本地️多形态提供终端 TUI、桌面应用Desktop App、IDE 扩展三种使用方式它能做的事情远不止“补全代码”读懂项目 → 规划任务 → 修改多个文件 → 运行命令 → 生成测试一条龙完成。二、环境要求在开始之前请确认你的环境满足以下条件1. 操作系统✅ macOS✅ Linux✅ Windows推荐使用 WSL或使用桌面版 / Scoop 安装2. 终端TUI 使用建议官方推荐使用现代终端模拟器以获得最佳渲染效果WezTerm跨平台Alacritty跨平台GhosttyLinux / macOSKittyLinux / macOS3. Node.js仅 npm 安装方式需要如果选择 npm / bun 方式安装需要Node.js ≥ 18推荐 20node-v# 确认版本 ≥ 18 使用官方一键脚本、Homebrew、Scoop 等方式安装则无需Node.js。4. API Key准备一个你打算使用的 LLM 提供商的 API Key如 Anthropic、OpenAI、DeepSeek、阿里云百炼、火山方舟等。三、安装 OpenCode方式一官方一键脚本⭐ 最推荐macOS / Linux一行命令搞定不依赖 Node.jscurl-fsSLhttps://opencode.ai/install|bash安装完成后重新打开终端即可使用。方式二HomebrewmacOS / Linuxbrewinstallsst/tap/opencode方式三npm / bun / pnpm / yarn前端开发者友好# npmnpminstall-gopencode-ai# bunbuninstall-gopencode-ai# pnpmpnpmadd-gopencode-ai方式四Windows 用户Scoopscoop bucket add extras scoop install extras/opencodeChocolateychoco install opencodeWSL 方案推荐给重度终端用户在 WSL Ubuntu 中按“方式一”执行 curl 脚本即可。方式五桌面应用Desktop App不习惯命令行的同学可以直接下载桌面版访问官网下载页https://opencode.ai/download页面会自动识别你的操作系统点击Download下载安装包安装后登录并配置模型即可使用方式六Docker容器化部署dockerrun-it--rm\-v$(pwd):/app\ghcr.io/anomalyco/opencode:latest⚠️ 具体镜像 tag 以官方文档为准Docker 方式适合在隔离环境中体验。四、验证安装打开新的终端窗口执行opencode--version如果输出了版本号如v1.x.x说明安装成功 五、首次配置连接 AI 模型OpenCode 的模型 ID 统一采用provider_id/model_id格式如anthropic/claude-sonnet-4-5。配置模型有三种方式方式一交互式登录最简单在终端运行opencode auth login按提示选择你的 AI 提供商Anthropic / OpenAI 等输入 API Key 或完成浏览器 OAuth 登录即可。也可以在 OpenCode 界面内输入/connect命令来管理供应商。方式二配置文件最灵活配置文件位置系统路径macOS / Linux~/.config/opencode/opencode.jsonWindowsC:\Users\用户名\.config\opencode\opencode.json项目级配置也可以放在项目根目录的opencode.json中。示例自定义 OpenAI 兼容供应商{$schema:https://opencode.ai/config.json,provider:{my-provider:{npm:ai-sdk/openai-compatible,name:My Provider,options:{baseURL:https://your-api-endpoint/v1,apiKey:{env:MY_API_KEY}},models:{my-model:{name:My Model}}}},model:my-provider/my-model} 建议把 API Key 放到环境变量中如{env:MY_API_KEY}避免明文写进配置文件。方式三指定模型启动opencode--modelanthropic/claude-sonnet-4-5六、快速上手1. 进入项目目录并启动cdyour-project opencode启动后进入 TUI 界面直接用自然语言对话即可例如“帮我分析这个项目的整体架构并给 README 写一段简介。”2. 常用操作速查操作快捷键 / 命令切换模型/models连接供应商/connect切换 Agent 模式Tab新建会话CtrlN查看帮助/help3. 两种核心模式Plan 模式只规划不动手先输出方案供你确认适合复杂任务Build 模式直接读写文件、执行命令干活模式✅ 最佳实践先用 Plan 模式让 AI 出方案确认无误后再切到 Build 模式执行。七、升级与卸载升级# curl 脚本安装的重新执行一遍脚本即可curl-fsSLhttps://opencode.ai/install|bash# npm 安装的npminstall-gopencode-ailatest# Homebrew 安装的brew upgrade opencode卸载# npmnpmuninstall-gopencode-ai# Homebrewbrew uninstall opencode# 清理配置可选rm-rf~/.config/opencode八、常见问题 FAQQ1opencode: command not found怎么办重新打开终端或检查安装路径是否在PATH中curl 脚本安装的通常在~/.opencode/bin需确认已写入 shell 配置。Q2npm 安装时报权限错误EACCES使用sudo npm install -g opencode-ai或更好的方式是配置 npm 全局目录到用户目录 / 改用官方 curl 脚本。Q3终端界面显示乱码更换为官方推荐的现代终端WezTerm / Ghostty / Alacritty / Kitty。Q4国内网络访问模型 API 受限可在opencode.json中配置国内供应商DeepSeek、阿里云百炼、火山方舟、MiniMax 等均支持 OpenAI 兼容接口填入对应的baseURL和 API Key 即可。Q5如何查看支持的模型列表在 TUI 中输入/models或参考 models.dev。九、参考资料 官网https://opencode.ai 官方文档https://opencode.ai/docs GitHubhttps://github.com/anomalyco/opencode 模型库https://models.dev✍️写在最后OpenCode 不会替代你的编程能力但它能把重复性的“脏活累活”接管过去。如果你是终端重度用户或者想找一个不绑定厂商、完全开源的 AI 编程助手OpenCode 值得一试。觉得有用的话欢迎点赞 收藏 ⭐ 转发 我们下期见