OpenCode 开源 AI 编码助手安装与使用指南
OpenCode 是一款开源 AI 编码助手,支持终端、桌面及 IDE 扩展。详细介绍其安装方法,包括一键脚本、包管理器(npm/brew)、Docker 及手动下载。重点讲解 LLM API 密钥配置与项目初始化流程。实战部分涵盖代码理解、功能开发(Plan/Build 模式)、修改回滚及团队协作分享技巧。同时提供主题、快捷键等个性化定制方案,并列出常见问题排查指南,帮助开发者快速上手提升效率。

OpenCode 是一款开源 AI 编码助手,支持终端、桌面及 IDE 扩展。详细介绍其安装方法,包括一键脚本、包管理器(npm/brew)、Docker 及手动下载。重点讲解 LLM API 密钥配置与项目初始化流程。实战部分涵盖代码理解、功能开发(Plan/Build 模式)、修改回滚及团队协作分享技巧。同时提供主题、快捷键等个性化定制方案,并列出常见问题排查指南,帮助开发者快速上手提升效率。

OpenCode 是一款开源 AI 编码助手,支持终端、桌面应用和 IDE 扩展三种形态。本文介绍其安装前的准备工作、全场景安装指南、配置初始化以及实战使用技巧。
在开始安装前,有两个基础准备工作必须完成:
OpenCode 的终端交互功能(TUI)对终端模拟器有一定要求。官方推荐的现代终端模拟器包括:
OpenCode 依赖大语言模型(LLM),需提前准备好 API 密钥:
打开终端,输入以下命令:
curl -fsSL https://opencode.ai/install | bash
注意事项:
适合已安装 Node.js(v16+)的用户:
| 包管理器 | 安装命令 |
|---|---|
| npm | npm install -g opencode-ai |
| Bun | bun install -g opencode-ai |
| pnpm | pnpm install -g opencode-ai |
| Yarn | yarn global add opencode-ai |
brew install opencodebrew install anomalyco/tap/opencodeparu -S opencode-bin
scoop install opencodechoco install opencodemise use -g github:anomalyco/opencodedocker run -it --rm ghcr.io/anomalyco/opencode
注意:Docker 方式重启后配置会重置,适合临时测试。
访问 GitHub Releases 页面下载对应系统的二进制文件,解压后将目录添加到 PATH 环境变量中。
/connect 命令;https://opencode.ai/auth 登录并获取 API 密钥;opencode 启动 TUI;/init 分析项目结构;AGENTS.md 文件并提交到 Git 仓库。使用 @ 键快速定位文件,提供上下文精准提问。例如:
How is authentication handled in @packages/functions/src/api/index.ts
Tab 键切换到 Plan 模式,先生成实现计划;直接给出明确指令,如修复语法错误或添加认证中间件。
使用 /undo 撤销修改,/redo 恢复修改,支持多次连续操作。
输入 /share 生成对话链接,发送给同事查看交互过程或继续协作。
/config theme 更换主题;~/.config/opencode/config.toml 中的 [keybinds] 部分;/config formatter 适配项目规范;[commands] 部分简化重复操作。/connect 重试。OpenCode 是一款灵活易用的开源 AI 编码助手。通过正确配置 API 密钥和初始化项目,结合 Plan/Build 模式及常用指令,可显著提升开发效率。作为开源项目,欢迎前往 GitHub 仓库提交 Issue 或 PR。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online