OpenCode 1.18.23 下载安装与使用指南（桌面版/命令版/IDE插件）

OpenCode 是做什么的

OpenCode 是一款免费开源的 AI 编程助手，支持在终端、桌面应用或 IDE 中通过自然语言描述需求，自动完成读写文件、执行命令、修改代码等操作。它不绑定特定模型厂商，内置免费模型可直接使用，也支持接入 DeepSeek 等国内大模型和本地模型，代码数据默认保存在本机，隐私性较好。

OpenCode 提供三种使用形态：终端命令行（适合习惯终端的开发者）、桌面端应用（适合偏好图形界面的用户）和 IDE 插件（适合常用 VS Code 等编辑器的用户）。目前最新版本支持 Windows、macOS、Linux 三个平台。

OpenCode 安装包下载方式

OpenCode安装包下载：OpenCode桌面版（源自官网，Windows+macOS+Linux）夸克网盘下载

OpenCode 安装步骤

Windows 安装 OpenCode

1）安装桌面版

Windows 平台推荐使用桌面版，下载 exe 安装包后双击启动。OpenCode 默认安装到 C 盘，整个安装过程无需手动干预，耐心等待即可。安装完成后，桌面会添加 OpenCode 快捷启动图标，同时界面会自动弹出。

2）安装命令版

Windows 用户若已安装 Node.js，可执行以下命令安装：

npm i -g opencode-ai@latest --registry=https://registry.npmmirror.com

也可以使用包管理器安装（scoop install opencode 或 choco install opencode）。安装完成后在命令行输入 opencode 即可启动 TUI 界面。

macOS 安装 OpenCode

1）安装桌面版

根据芯片类型（Apple/Intel）选择对应安装包，下载完成后双击 dmg 文件，将 OpenCode 图标拖入”应用程序”文件夹即可完成安装。

2）安装命令版

在终端执行：

brew install opencode

装完输入 opencode 即可启动 TUI 界面。使用 brew 安装的后续可直接执行 brew upgrade opencode 升级到最新版。

Linux 安装 OpenCode

1）安装桌面版

Debian/Ubuntu 用户下载 deb 包后执行 sudo dpkg -i opencode-desktop.deb 安装；Fedora 等使用 rpm 包的系统执行 sudo rpm -ivh opencode-desktop.rpm 安装。

2）安装命令版

在终端执行：

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

脚本会自动下载并安装，不需要 root 权限，装完后 opencode 位于用户目录下。重新打开终端输入 opencode 即可启动。Arch 系用户也可以执行 sudo pacman -S opencode 安装。

OpenCode 配置模型与基础使用

OpenCode 内置了免费模型，安装后无需配置即可直接体验。想换更强模型时，在模型选择界面直接选中要用的提供商即可，如 DeepSeek 就在列表中。需要 API Key 的按界面提示填入后即可使用。想用本地模型的用户，先在电脑上装好 Ollama 并下载一个模型（比如 llama3），然后在 OpenCode 的模型列表里选择本地模型即可，完全离线使用。

桌面版打开界面后选择项目文件夹；命令版在项目根目录打开终端输入 opencode 回车即可，AI 能读取整个项目的文件结构。描述需求时说得越具体越好，想指定文件时输入 @ 加文件名把文件加进对话。OpenCode 支持多会话并行，写新功能、修 bug、重构可分开进行，互不干扰。

OpenCode 还可作为 IDE 扩展集成到 VS Code、Cursor 等中。注意扩展本身不包含命令行工具，需先装好 opencode 命令版。装好后在 VS Code 扩展市场搜索 OpenCode 点击 Install，之后点击 VS Code 上的 OpenCode 按钮或输入 opencode 即可使用【图15】。