起首说个事

你有莫得思过这样一个问题——

将来有一天，写代码会不会变得跟言语同样浅易？你说"帮我写个设想器"，AI哗哗哗就给你整出来了？

别笑，这事儿正在发生。

客岁Claude Code一出来，通盘斥地者圈皆炸了——AI不是"帮你写代码"，而是"替你写代码"。你只需要在把握看着，偶尔说一句"这里改一下"就行。

但Claude Code有个问题：收费。

于是开源社区坐不住了。一个叫OpenCode的式样横空出世，GitHub上狂揽15万颗星，成了本年最火的开源AI编程助手。

最要津的是——它免费。

纷乱的事情说三遍，免费，免费，免费。大模子免费使用，这是一个好音讯。

况且，它能接进你电脑上可能也曾装了的 VSCode（一个免费的代码剪辑器，你不错剖判成"写代码的Word"）。

今天这篇，便是手把手教你把OpenCode装进VSCode。不讲谣言，全是大口语，你随着点就行。

一、OpenCode是个啥？说东说念主话

你不错把OpenCode思象成一个住在你电脑里的AI设施员。

装好以后这个花样：

你怒放VSCode（便是阿谁写代码的软件），在把握开个小窗口，跟它说：

"帮我写个网页，长这样……"

"这段代码太慢了，优化一下"

"这个功能有bug，修一下"

它咔咔咔就给你干了。

况且它的几个特色很竟然：

自带免费模子：无须用钱，开箱即用。内置了智谱GLM、MiniMax这些国产AI

也能接付费模子：若是你思用更强的AI（比如Claude、GPT），插个API Key就行

不啻VSCode能用：大呼行、桌面软件、网页版皆行，你爱用哪种用哪种

开源：代码全公开，不会被谁卡脖子

一句话归来：一个开源、免费、能接多样AI模子的编程助手，你勾搭它写代码就结束。

二、第一步：装OpenCode的大呼行器具

别被"大呼行"三个字吓到。其实便是怒放一个黑窗口，复制一滑大呼，回车。

这是前提——VSCode插件依赖这个底层器具，必须先装。

要领一：一滑大呼管制（保举，统共电脑通用）

Windows用户先怒放WSL（背面会讲是啥），Mac和Linux用户径直怒放终局：

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

敲完回车，等它跑完。电脑会自动下载装配包，放到正确的位置。你啥也无须管。

要领二：用npm装（需要Node.js 18+）

若是你电脑上也曾有Node.js（一种编程运行环境），也不错用这行：

npm install -g opencode-ai

要领三：Mac用户不错用Homebrew

brew install anomalyco/tap/opencode

Windows用户卓绝肃肃

Windows用户历害残暴通过WSL来装。

WSL是什么？浅易说便是Windows里装一个"迷你Linux系统"，许多AI编程器具在Linux环境下跑得最顺。

装好WSL后，在WSL终局里实践上头"要领一"的大呼就行。

若是你头铁思在原生Windows下硬装，也不是不可，但容易踩坑。

考据装没装好

装完之后，跑这行大呼：

opencode --version

若是出来一个版块号（比如 v1.14.48 这样的），恭喜，装好了。

三、第二步：把OpenCode插件装进VSCode

VSCode便是微软出的一款免费代码剪辑器，全球斥地者用得最多的阿谁。若是你还没装，先去官网（code.visualstudio.com）下下来，免费。

最省事的要领：自动装配

怒放VSCode，按 Ctrl + ~（键盘左上角Esc底下阿谁键）怒放内置终局——便是VSCode内部阿谁黑窗口。

然后输入：

opencode

回车。OpenCode会自动检测到你在VSCode里，自动帮你装好插件。就这样浅易。

⚠️ 记取：一定要在VSCode内部的终局运行，不是在Windows系统终局或Mac的寥落终局里。否则它认不出你在用VSCode。

备选决议：手动装配

若是你以为自动装配不靠谱，也不错手动来：

在VSCode里按快捷键 Ctrl+Shift+X，亚搏体育怒放推广商店（便是插件的"欺诈商店"）

搜索 "OpenCode"

认准发布者是 sst-dev 的阿谁，点装配

别装错了！插件商店里好几个名字带"OpenCode"的，官方的发布者是 sst-dev。

若是你可爱用大呼行装：

code --install-extension sst-dev.opencode

装完重启VSCode，完事。

四、配置AI模子：用免费的照旧用我方的？

OpenCode最爽的少许是：它内置了免费模子，你无须用钱就能用。

装配完径直就能开工，不需要填任何API Key。内置的GLM 4.7、MiniMax 2.1这些国产模子，关于泛泛写代码、改bug完全够用。

若是你思用更强悍的模子（比如Claude或GPT），需要在式样文献夹下创建一个 opencode.json 文献，把API Key写进去：

{

"model": "anthropic/claude-sonnet-4-20250514"，

"provider": {

"anthropic": {

"apiKey": "这里填你的密钥"

}

}

}

看不懂不纷乱，说白了便是：思用免费的就径直用，思用更好的就去对应的AI网站苦求一个密钥，填进去就行。

模子厂商

怎么称号

要不要用钱

Anthropic（Claude）

claude-sonnet-4

要API Key

OpenAI（GPT）

gpt-4o

要API Key

Google（Gemini）

gemini-2.5-pro

要API Key

OpenCode自带免费模子

无须记

不要钱

智谱GLM

glm-4.7

不要钱

MiniMax

minimax-2.1

不要钱

五、常用快捷键：每天皆会用到的

装好之后，记取这几个快捷键，效果翻倍：

你要作念什么

Windows/Linux按这个

Mac按这个

怒放OpenCode对话窗口

Ctrl+Esc

Cmd+Esc

新建一个对话

Ctrl+Shift+Esc

Cmd+Shift+Esc

把面前文献丢给AI分析

Alt+Ctrl+K

Cmd+Option+K

怒放/关闭终局面板

Ctrl+J

Cmd+J

还有一个超好用的手段：在对话框里输入 @ 绚丽，不错快速援用你面前怒放的文献。比如你写 @登录页面.js#L37-42，AI就知说念你要它看这个文献的第37到42行。

六、怎么用？说几个骨子的场景

场景一：让AI帮你优化代码

你写了一段不太自信的代码，选中它，按快捷键，说一句"帮我优化一下这段代码的性能"。

AI扫一眼，咔咔给你改好，还会告诉你为什么这样改更好。

场景二：让AI帮衬写新功能

说一句"帮我写一个用户登录功能，邮箱+密码考据"，AI就能从零初始生成代码。

你不需要我方一滑一滑敲，改改参数就能用。

场景三：多任务同期干

OpenCode支柱同期开多个对话窗口。你不错在一个窗口里让AI作念代码审查，另一个窗口写测试用例，两个互不打扰，就像开了两个AI助手同期责任。

场景四：给AI定例矩

若是式样组有我方的编码轨范（比如"变量名要用英文""函数名首字母小写"），在式样根目次创建一个叫 AGENTS.md 的文献，把规矩写进去：

# 编码轨范

- 变量名用英文，别用拼音

- 函数名首字母小写

- 必须写在意

之后每次跟AI对话，它皆会自动谨守这些规矩。

七、碰到问题了？常见坑妥协决要领

插件没自动装

原因：OpenCode没认出你在VSCode里。

搜检三件事：

你是不是在VSCode的集成终局里敲的 opencode？（便是VSCode内部阿谁终局，不是外面单独怒放的）

试试在VSCode里按 Ctrl+Shift+P，搜"Shell Command: Install 'code' command in PATH"并实践，让VSCode注册到系统旅途里

搜检VSCode有莫得限制插件装配权限——若是在成就里写了白名单，要把 sst-dev.opencode 加进去

插件装上了但没响应

证据CLI装好了：opencode --version

重启VSCode

望望API密钥有莫得填对

竟然不可，怒放VSCode的匡助→切换斥地东说念主员器具，看Console面板有莫得报错信息

找不到官方插件

记取一个ID就够了：`sst-dev.opencode。径直在大呼行装：

code --install-extension sst-dev.opencode

这个完全不会错。

八、哪种用法最符合你？

OpenCode不独一VSCode插件这一种用法。我帮你排了个序：

用法

难度

符合谁

好在哪

大呼行版

浅易

可爱黑窗口的老手

最轻量，怒放就用

VSCode插件

中等

绝大广宽斥地者

写代码无须切窗口

桌面客户端

中等

不可爱VSCode的用户

寥落App，界面面子

云霄部署

较难

团队互助

众人一说念用

最保举的作念法：若是你泛泛用VSCode写代码，径直装插件版，无须瞻念望。

九、终末说几句

OpenCode最大的价值，用四个字综合便是——聘请解放。

你不错一分钱不花，用国产免费模子体验一把AI写代码的快感；也不错接上最强的Claude、GPT，去管制那些复杂的大式样。

AI编程器具这半年的进化速率，快得让东说念主头晕。但OpenCode这种开源决议的自制是：不会被任何一家公司绑死。今天接这个模子，翌日换阿谁模子，主动权长期在你手里。

花半个小时把这事管制，以后每天写代码的效果擢升，皆是这半小时的陈说。

你试过AI写代码吗？在VSCode里用的体验如何？褒贬区聊聊。

参考：OpenCode官方文档及社区教程亚搏(中国)一站式服务官方网站。