2026最新OpenCode下载、安装、配置模型一篇搞定（超详细，包含所有平台）

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

OpenCode 是一款免费开源的 AI 编程助手（AI agent），帮助程序员在终端、IDE 或桌面应用里写代码。你用自然语言描述需求，OpenCode 自动读写文件、执行命令、修改代码，相当于一个住在你电脑里的 AI 程序员。

本文系统讲解 OpenCode 的下载、安装、配置模型和 AI 编程的完整过程，全程实测，保证大家不会踩坑。

同类 AI 编程工具不少，先看看 OpenCode 和几款主流工具的区别：

工具 开源/收费 运行形态 特点
OpenCode 免费开源 终端+IDE+桌面 可接 75+ 家模型，隐私优先，不绑定单一厂商
Claude Code 闭源，需 Claude 账号 终端 Anthropic 官方出品，只能用 Claude 模型
Codex CLI 闭源，需 OpenAI 账号 终端 OpenAI 官方出品，只能用 GPT 模型
Cursor 闭源，免费+付费 独立 IDE 完整 AI 编辑器，开箱即用但模型绑定较紧

相比之下，OpenCode 的核心优势是免费、开源、模型自由选择：Claude、GPT、Gemini、DeepSeek、本地模型都可以接，不想被某一家模型或工具绑定的开发者用它更合适。

OpenCode版本介绍

OpenCode 两种使用形态，分别是桌面版和命令版：

对比项 桌面版 命令版（终端版）
运行方式 独立窗口应用，像普通软件一样打开 在终端里以全屏 TUI 界面运行
安装方式 下载 exe/dmg 安装包，双击安装 命令行安装（scoop/choco/npm/brew）
适合人群 不习惯命令行的新手、普通用户 常驻终端的开发者，喜欢键盘流操作
功能 与命令版完全一致 与桌面版完全一致

两个版本功能和配置完全一样，选哪个纯看使用习惯。另外还有第三种形态，就是作为 VS Code 扩展，装好后直接在编辑器里使用，属于补充选择。

下载OpenCode

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

OpenCode 支持 Windows、macOS、Linux 三个平台，每个平台都有桌面版和命令版两种选择，下面分开讲。

Windows安装OpenCode

1）安装桌面版

Windows 平台推荐用桌面版，安装过程非常简单：
1）下载 exe 安装包双击启动：


2）OpenCode 默认安装到 C 盘，整个安装过程无需我们插手，耐心等待即可：


3）安装完成后，电脑桌面会添加 OpenCode 的快捷启动图标，同时 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 图标和"应用程序"文件夹。把 OpenCode 图标直接拖进"应用程序"文件夹，等待复制完成，桌面版就装好了。

2）安装命令版

在终端执行 brew install opencode，装完输入 opencode 即可启动 TUI 界面。用 brew 安装的好处是后续可以直接执行 brew upgrade opencode 升级到最新版。

Linux安装OpenCode

Linux 平台推荐优先用命令版，最省事。

1）安装桌面版

Debian/Ubuntu 用户下载 deb 包后执行 sudo dpkg -i opencode-desktop.deb 安装，装完在应用菜单里找到 OpenCode 启动；Fedora 等使用 rpm 包的系统执行 sudo rpm -ivh opencode-desktop.rpm 安装。

2）安装命令版

在终端执行 curl -fsSL https://opencode.ai/install | bash 一键安装，脚本会自动下载并安装，不需要 root 权限，装完后 opencode 位于用户目录下。安装完成后重新打开一个终端，输入 opencode 即可启动 TUI 界面。Arch 系用户也可以执行 sudo pacman -S opencode 安装。

OpenCode配置模型

OpenCode 本身不包含 AI 模型，配置模型是安装后的第一步，也是使用前的必要步骤。整个配置过程很简单：选提供商、填 API Key，两步完成。

1）选择模型提供商

启动 OpenCode 后，进入模型选择界面，支持 OpenAI、Anthropic（Claude）、Google（Gemini）、DeepSeek 等 75 多家提供商，国内用户常用的 DeepSeek 也在列表里，直接选中即可。

2）填写 API Key

选中提供商后，按提示填入对应的 API Key，Key 需要到对应模型提供商的开放平台注册获取（比如 DeepSeek 在 DeepSeek 开放平台申请，OpenAI 在 OpenAI 平台申请）。

3）使用免费模型

如果暂时没有 API Key，可以先不填，直接用 OpenCode 内置的免费模型体验，等熟悉了再换更强或更合适的模型。

OpenCode基础使用

1）启动并打开项目

桌面版打开界面后选择项目文件夹：


使用命令版的，在项目根目录打开终端，输入 opencode 回车，AI 就能看到整个项目的文件结构。在哪个目录启动，OpenCode 就"住在"哪个项目里，可以读文件、改代码、跑命令

2）描述需求

把需求直接打字发过去，说得越具体越好，比如"帮我编写一个 C 语言程序，功能是输出 hello world"。


想指定文件时，输入 @ 加文件名把文件加进对话，AI 会优先读取这些文件，回答更准确。

3）多会话并行

OpenCode 支持同时开多个会话，写新功能、修 bug、重构分开进行，互不干扰，想切换直接在会话列表点一下。

OpenCode IDE扩展

OpenCode 除了终端版和桌面版，还可以作为 IDE 的扩展，集成到 VS Code、Cursor 等里使用：装好后，直接在 IDE 里打开 OpenCode，选中代码就能让它处理，不用在终端和编辑器之间来回切换。

OpenCode 支持的 IDE 很广，VS Code 以及它的主流分支 Cursor、Windsurf、VSCodium 都可以，其他支持终端的 IDE 也能用。这里以 VSCode 为例。

注意，扩展本身不包含命令行工具，在 VS Code 里安装 OpenCode 之前，要先参照上文把 opencode 命令版装好（Windows 上 npm、scoop、choco 任选其一）。

在 VS Code 的扩展市场里搜索 OpenCode，选第一个，点击 Install 即可：


装好扩展后，直接点击 VS Code 界面上的 OpenCode 按钮（通常在活动栏或侧边栏）：


在集成终端里输入 opencode 回车即可启动 OpenCode，用法和终端版完全一样，描述需求、让 AI 改代码、检查改动，不需要额外学习成本。

OpenCode新手注意事项

1）终端版和桌面版是同一套工具，只是界面不同：终端版在命令行里以全屏 TUI 方式运行，桌面版是独立窗口应用，功能和配置完全一致，不喜欢敲命令就选桌面版。

2）Windows 用户用 npm 装完 opencode 后，在 IDE 的集成终端里运行 opencode 可能会提示"无法加载 opencode.ps1，因为在此系统上禁止运行脚本"。这是 Windows 默认的安全策略在拦截脚本，不是 opencode 的问题。执行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser重新打开终端就能正常使用了。

3）国内用户用 npm 安装 opencode 时经常遇到下载慢或卡住的问题，因为 npm 默认源在国外。解决办法是换成国内镜像源：

总结

到这里，OpenCode 的下载、安装和配置模型就全部讲完了。OpenCode 是免费开源的 AI 编程助手，支持终端、桌面、IDE 扩展三种形态，Windows、macOS、Linux 全覆盖。

安装 OpenCode，Windows 用户下载桌面版 exe 最省事，最关键的一步是配置模型：内置免费模型可以直接体验，接 DeepSeek、Claude、GPT 等 75 多家提供商填 API Key 即可，配本地模型还能完全离线使用。

对新手来说，建议先用自带免费模型或 DeepSeek 上手，熟悉"用自然语言让 AI 写代码"的用法，再按需接入更强的模型。