Opencoda 安装

一、前言：OpenCode 是什么？为什么值得用？

1.1 OpenCode 简介

官网OpenCode | The open source AI coding agent

OpenCode 是一个开源的 AI 编程助手，支持：

✅ 在终端（CLI）中直接对话写代码，与ClaudeCodeCLI类似

✅ 在 VSCode 中辅助写代码

✅ 自动生成代码、重构代码、解释代码

✅ 不绑定平台、可自由扩展

✅ 对开发者非常友好

✅ 有很多免费的大模型可以使用，不收费不排队

1.2 本教程你能学到什么？

看完本文，你可以做到：

✔ 从 0 安装 Git

✔ 安装 Node.js（OpenCode 必需）

✔ 一行命令安装 OpenCode

✔ 在终端中直接用 OpenCode 写代码

✔ 在 VSCode 中使用 OpenCode 辅助开发

二、环境说明（很重要）

• 操作系统：Windows 10 / Windows 11

• 终端示例：PowerShell / CMD / VSCode Terminal

• Node.js 要求：≥ 18（强烈推荐 20 LTS）

三、第一步：安装 Git

3.1 为什么要安装 Git？

OpenCode 依赖 Git 环境，用于：

• 项目管理

• 代码上下文分析

• 工程结构识别

3.2 Git 下载地址

👉 官方网站
https://git-scm.com/

点击首页的 Download for Windows 即可自动下载。

3.3 Git 安装步骤（Windows） 双击安装包

1. 双击安装包

2. 一路 Next编辑器选择：

   1. 已装 VSCode 👉 选 Use Visual Studio Code

3. PATH 选项：

   1. ✅ Git from the command line and also from 3rd-party software

4. 其余全部默认

5. 点击 Install

3.4 验证 Git 是否安装成功

打开 命令提示符 / PowerShell，输入：

git --version

如果看到类似：

说明 Git 安装成功 ✅

四、第二步：安装 Node.js（必须）

4.1 为什么必须安装 Node.js？

OpenCode 是基于 Node.js 开发的 CLI 工具：

• Node 版本过低 → 无法运行

• 版本：大于Node 20

4.2 Node.js 下载地址

👉 官网
https://nodejs.org/

请选择：

4.3 Node.js 安装步骤（Windows）

确保 Node 版本 ≥ 20

1. 双击 .msi 安装包

2. 一路 Next

3. 勾选：

   • ✅ Automatically install the necessary tools

4. 等待安装完成

4.4 验证 Node.js 安装

⚠️ 一定要重新打开终端

node -v
npm -v

确保 Node 版本 ≥ 20

示例输出：

说明 Node.js 和 npm 均安装成功 ✅

五、第三步：安装 OpenCode（核心）

5.1 管理员启动终端（Window）

1. 按 Win + X

2. 选择 终端（管理员） 或 PowerShell（管理员）

5.2 使用 npm 全局安装 OpenCode

# 一键获取完整项目代码bash
npm install -g opencode-ai

安装过程可能 1~3 分钟，请耐心等待。

5.3 验证 OpenCode 是否安装成功

opencode --version

如果能输出版本号，例如：

说明安装成功 🎉

六、在终端中使用 OpenCode（CLI）

6.1 启动 OpenCode

在任意目录打开终端，输入：

opencode

你会进入 OpenCode 的交互界面。

6.2 终端中常见用法示例

1：Opencode切换模型

按住ctrl+P，选择Switch model可以进行模型切换

可以看到后面有Free的就是免费模型

2：Plan和Build模式的切换

在交互页面，按住tab键就可以切换Plan和Build模式

Plan模式不会修改你的文件和代码，只能阅读你的文件以及给你建议构思等等

Build模式可以进行文件和代码的修改，建议先用Plan模式构思好，再用Build模式执行

6.3 退出 OpenCode

和Claude code 类似输入

/exit

七、在 VSCode 中使用 OpenCode

7.1 安装插件

7.2 在 VSCode 中打开opencode

打开你的项目，在右上角可以看到opencode的logo

8.解决opencode使用Gemini兼容问题

首先要到这里：https://github.com/NoeFabris/opencode-antigravity-auth

下拉找到

安装这个插件

Install the opencode-antigravity-auth plugin and add the Antigravity model definitions to ~/.config/opencode/opencode.json by following: https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/dev/README.md

权限选择allow，如果安装到其他文件下，要复制文件到这个目录C:\Users\DELL.config\opencode\opencode.json

9.配置自己的模型API

# Windows:
C:\Users\DELL.config\opencode\opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  // Theme configuration
  "theme": "opencode",
  "model": "anthropic/claude-sonnet-4-5",
  "autoupdate": true,
}

可以参考github：https://github.com/ziho7/opencode-config

把自己的jiekou.ai的API填到下面三个位置，然后重启opencode即可。

都已经可以正常使用

10.安装oh-my-opencode

oh-my-opencode的github地址：https://github.com/code-yeongyu/oh-my-opencode

两种安装方式我们选第二种

还是使用我们的管理员终端安装oh-my-opencode

安装全部选择no

新增了一个oh-my-opencode.json文件，opencode.json文件最下面出现上图就表示已经安装完成。

可以参考github：https://github.com/ziho7/opencode-config

修改oh-my-opencode.json文件

然后要重启opencode。

Tips：出现下面的报错的解决方法：

说明文件下载错误：只需要将oh-my-opencode版本改为指定版本即可

将opencode.json最后一行的内容改为2.14.0即可正常打开oh-my-opencode。