OpenCode安装指南

OpenCode是一款专为终端打造的开源AI编程助手，支持多模型灵活切换，可远程驱动，为开发工作流提供高效支持。

核心优势

OpenCode具有以下核心优势：

• 完全开源透明，代码可见，无供应商锁定风险。
• 支持Anthropic、OpenAI、Google等主流AI模型，可灵活切换。
• 针对终端环境深度优化，为Vim/Neovim用户提供专属体验。
• 采用远程驱动架构，支持客户端/服务器分离部署。

环境准备

系统兼容性检查

在安装OpenCode前，请确保你的系统满足以下要求：

• 操作系统：Linux、macOS或Windows。
• CPU架构：x86_64或arm64。
• 运行环境：Bun运行时环境（推荐）或Node.js 18+版本。

依赖项安装

根据你的操作系统，执行以下命令安装必要依赖：

• Linux（Debian/Ubuntu）：

sudo apt-get update && sudo apt-get install -y curl

• macOS：

brew install curl

• Windows（使用Chocolatey）：

choco install curl

分步安装

方案一：一键脚本安装

这是推荐的快速安装方式，适用于大多数用户。 🔧 请执行以下命令：

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

如需自定义安装位置，可使用环境变量控制：

OPENCODE_HOME=/usr/local/bin curl -fsSL https://opencode.ai/install | bash

注意：安装脚本会自动识别系统类型和CPU架构，下载并配置适合的二进制文件。

方案二：源码编译安装

适用于开发者和技术爱好者，可体验最新功能或进行二次开发。 🔧 请执行以下命令：

git clone https://gitcode.com/GitHub_Trending/openc/opencode
cd opencode
bun install
bun build

注意：编译前确保已安装Bun运行时或Node.js 18+。

功能验证

版本检查

安装完成后，验证OpenCode是否成功安装： 🔧 请执行以下命令：

opencode --version

若输出版本号信息，则表示安装成功。

启动应用

启动OpenCode开始使用： 🔧 请执行以下命令：

opencode

首次启动时，系统会引导你完成AI模型服务提供商选择、API访问密钥配置和个性化使用偏好设置。

进阶技巧

环境变量配置

如果安装后无法识别opencode命令，需手动将安装目录添加到系统PATH：

• Bash/Zsh终端用户：

export PATH=$HOME/.opencode/bin:$PATH

• Fish Shell用户：

fish_add_path $HOME/.opencode/bin

为使配置永久生效，可将上述命令添加到对应的shell配置文件中。

版本管理

OpenCode支持多版本管理，可安装特定版本进行测试或回滚：

# 安装特定版本
npm install -g opencode-ai@1.2.3

卸载与重装

如需卸载OpenCode，执行以下命令：

npm uninstall -g opencode-ai
rm -rf $HOME/.opencode

然后可根据需要重新安装。

离线部署

OpenCode支持通过本地二进制文件进行离线部署，具体步骤可参考官方文档。

安装完成后，OpenCode将为你的编程工作流带来高效的AI辅助功能。你可以探索不同的AI模型配置，以获得最佳的编程体验。