OpenCode 安装与使用完全指南：开源 AI 编程助手

什么是 OpenCode？

OpenCode 是一个开源的 AI 编程助手，专为终端设计。它完全开源（MIT 许可证），在 GitHub 上拥有超过 95K 星标。与 Claude Code、Cursor 等商业产品不同，OpenCode 不绑定任何特定 AI 提供商，支持 75+ 种 AI 模型。

核心特点

• 100% 开源：MIT 许可证，完全免费
• 多模型支持：Anthropic、OpenAI、Google、Ollama 本地模型、GitHub Copilot 等
• 提供商无关：不绑定任何特定 AI 服务商
• 终端优先：由 Neovim 用户和 terminal.shop 创作者打造
• 开箱即用的 LSP 支持：语言服务器协议集成
• 客户端/服务器架构：支持远程控制
• 桌面应用：提供 macOS、Windows、Linux 桌面版

与 Claude Code 的区别

系统要求

• Node.js: 版本 18 或更高（使用 npm/bun/pnpm 安装时）
• 操作系统: macOS / Linux / Windows
• 终端: 支持现代 TUI 的终端模拟器

安装方法

方法一：一键安装（推荐）

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

方法二：包管理器安装

npm / bun / pnpm / yarn

# npm
npm i -g opencode-ai@latest

# bun
bun install -g opencode-ai

# pnpm
pnpm add -g opencode-ai

# yarn
yarn global add opencode-ai

macOS / Linux (Homebrew)

brew install opencode

Windows (Scoop)

scoop bucket add extras
scoop install extras/opencode

Windows (Chocolatey)

choco install opencode

Arch Linux

paru -S opencode-bin

mise (跨平台)

mise use -g opencode

Nix

# 稳定版
nix run nixpkgs#opencode

# 最新开发版
nix run github:sst/opencode

注意：安装前请先移除 0.1.x 之前的旧版本。

桌面应用安装（BETA）

OpenCode 也提供桌面应用程序。

下载地址

macOS Homebrew 安装

brew install --cask opencode-desktop

下载地址：opencode.ai/download

自定义安装目录

安装脚本按以下优先级选择安装路径：

1. $OPENCODE_INSTALL_DIR – 自定义安装目录
2. $XDG_BIN_DIR – XDG 基础目录规范路径
3. $HOME/bin – 标准用户二进制目录
4. $HOME/.opencode/bin – 默认回退路径

# 示例：自定义安装路径
OPENCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://opencode.ai/install | bash

# 示例：使用 XDG 规范
XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://opencode.ai/install | bash

快速开始

启动 OpenCode

在你的项目目录中运行：

opencode

基本操作

连接 AI 提供商

/connect

使用此命令连接你选择的 AI 提供商。

内置 Agent

OpenCode 包含两个内置 Agent，可以使用 Tab 键切换：

1. Build Agent（默认）

• 完全访问权限的开发 Agent
• 适用于开发工作
• 可以编辑文件、运行命令

2. Plan Agent

• 只读 Agent，用于分析和代码探索
• 默认拒绝文件编辑
• 运行 bash 命令前会请求许可
• 非常适合探索陌生代码库或规划变更

3. General Subagent

• 用于复杂搜索和多步骤任务
• 在消息中使用 @general 调用
• 内部使用

使用示例

代码生成

帮我写一个 React 的 useDebounce hook

代码审查

审查这个函数的性能问题

代码探索

这个项目的架构是怎样的？

重构

把这个类重构为函数式组件

配置文件

OpenCode 的配置文件位于：

~/.opencode/config.json

基本配置示例

{
  "provider": "anthropic",
  "model": "claude-sonnet-4-6",
  "apiKey": "your-api-key"
}

使用本地模型（Ollama）

{
  "provider": "ollama",
  "model": "llama3.2",
  "baseUrl": "http://localhost:11434"
}

支持的 AI 模型

OpenCode 支持 75+ 种 AI 模型：

常用命令

架构说明

OpenCode 采用客户端/服务器架构：

┌─────────────────┐
│   TUI Frontend  │  ← 终端界面
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│   OpenCode      │
│    Server       │  ← 核心引擎
└────────┬────────┘
         │
    ┌────┴────┬──────────┐
    ▼         ▼          ▼
┌───────┐ ┌───────┐ ┌─────────┐
│Claude│ │OpenAI │ │ Ollama  │
└───────┘ └───────┘ └─────────┘

这种架构允许：

• 远程控制（如从移动应用）
• TUI 前端只是多种可能的客户端之一
• 灵活的部署方式

常见问题

Q: OpenCode 完全免费吗？

是的，OpenCode 是 100% 开源的，使用 MIT 许可证。但你选择的 AI 提供商可能会收取 API 费用。

Q: 推荐使用什么模型？

推荐使用 OpenCode Zen 提供的模型，或者使用本地 Ollama 模型以保护隐私。

Q: 如何在项目中使用？

只需在项目根目录运行 opencode，它会自动识别项目结构。

Q: 支持哪些编程语言？

OpenCode 支持所有主流编程语言，并通过 LSP 提供智能代码分析。

相关链接

• 官方网站: https://opencode.ai
• GitHub 仓库: https://github.com/sst/opencode
• 文档: https://opencode.ai/docs
• CLI 参考: https://opencode.ai/docs/cli
• Discord 社区: https://opencode.ai/discord
• 下载桌面版: https://opencode.ai/download

总结

OpenCode 是一个强大的开源 AI 编程助手，它的核心优势在于：

1. 完全开源免费 – 无需订阅费用
2. 提供商无关 – 可自由选择 AI 模型
3. 终端优先 – 为开发者打造的最佳体验
4. 隐私保护 – 支持本地模型

如果你正在寻找 Cursor、Copilot 或 Claude Code 的开源替代方案，OpenCode 绝对值得一试！