OpenCode 安装指南 —— 开源 AI 编程助手

什么是 OpenCode？

OpenCode 是一个开源的 AI 编程助手（AI Coding Agent），由 Anomaly 团队开发。它可以在终端（TUI）、桌面应用和 IDE 扩展中使用，帮助开发者高效地编写、理解和维护代码。

截至 2026 年 7 月，OpenCode 在 GitHub 上拥有超过 160,000 星标，900+ 贡献者和 13,000+ 次提交，每月有超过 750 万开发者在使用。

核心特性

• LSP 支持：自动加载对应语言的 LSP 服务器，为 LLM 提供代码智能
• 多会话并行：同一项目可同时启动多个 agent 并行工作
• 分享链接：可将任意会话生成分享链接，方便团队参考和 debugging
• GitHub Copilot：支持使用 GitHub 账号登录，使用 Copilot 额度
• ChatGPT Plus/Pro：支持使用 OpenAI 账号，使用 Plus 或 Pro 额度
• 任意模型：通过 Models.dev 支持 75+ LLM 提供商，包括本地模型
• 全平台支持：macOS、Linux、Windows，支持终端/桌面/IDE 多种形态
• 隐私优先：不会存储任何代码或上下文数据

安装方式

方式一：一键脚本安装（推荐）

适用于 macOS 和 Linux 用户，最简单快捷的安装方式：

curl -fsSL https://opencode.ai/install | bash

方式二：Node.js 包管理器

如果你已经安装了 Node.js，可以通过以下方式安装：

npm

npm install -g opencode-ai

pnpm

pnpm install -g opencode-ai

yarn

yarn global add opencode-ai

bun

bun install -g opencode-ai

方式三：Homebrew（macOS / Linux）

brew install anomalyco/tap/opencode

推荐使用 OpenCode 官方 tap 以获取最新版本。注意：Homebrew 官方公式 brew install opencode 由 Homebrew 团队维护，更新频率较低。

方式四：Windows 安装

推荐在 Windows 上使用 WSL（Windows Subsystem for Linux） 以获得最佳体验和完整的终端功能兼容性。此外还支持以下方式：

Chocolatey

choco install opencode

Scoop

scoop install opencode

npm

npm install -g opencode-ai

Docker

docker run -it --rm ghcr.io/anomalyco/opencode

也可以从 GitHub Releases 页面下载桌面版安装程序。

方式五：Arch Linux

sudo pacman -S opencode    # 稳定版\nparu -S opencode-bin       # AUR 最新版

初始化配置

1. 配置模型提供商

OpenCode 支持任意 LLM 提供商。如果你刚接触 LLM，推荐使用 OpenCode Zen，它是官方精选并测试验证过的模型集合。

在终端中运行：

opencode

然后输入 /connect 命令，选择 opencode 提供商，前往 opencode.ai/auth 注册并获取 API Key。

你也可以选择其他提供商，如 OpenAI、Anthropic、Google Gemini 等。查看全部支持的提供商。

2. 初始化项目

进入你的项目目录，运行 OpenCode：

cd /path/to/project\nopencode

输入 /init 命令，OpenCode 会自动分析项目结构并创建 AGENTS.md 文件。建议将此文件提交到 Git，它帮助 OpenCode 理解项目结构和编码规范。

基础使用

提问与探索代码

你可以向 OpenCode 提问任何关于代码库的问题：

这个项目中认证是如何实现的？@src/auth/index.ts

使用 @ 键可以快速模糊搜索项目中的文件。

计划模式（Plan Mode）

按下 Tab 键切换到计划模式，此时 OpenCode 只会给出实现方案而不会修改代码。确认方案满意后，再切回构建模式（Build Mode）让 OpenCode 实际执行。

撤销更改

如果 OpenCode 的改动不符合预期，可以用 /undo 命令撤销，甚至可以多次撤销。用 /redo 命令可以恢复被撤销的更改。

分享会话

使用 /share 命令可以生成当前会话的可分享链接，方便与团队成员讨论或保存参考。

终端要求

推荐使用以下现代终端模拟器：

• WezTerm（跨平台）
• Alacritty（跨平台）
• Ghostty（Linux / macOS）
• Kitty（Linux / macOS）

总结

OpenCode 是一款功能强大且完全开源免费的 AI 编程助手。无论是日常编码、代码审查、项目重构还是学习新技术，它都能显著提升开发效率。安装便捷、隐私优先、模型灵活，值得每一位开发者尝试。

更多详情请访问 OpenCode 官网 或 GitHub 仓库。