简介：很多开发者安装 OpenCode 会遇到两个痛点：C盘爆满、npm 下载超时卡死。本文记录一套一劳永逸、永久生效的 Windows 安装配置方案，全程自定义D盘安装路径、配置全局npm国内镜像，附带OpenCode核心常用命令实操，适配所有编程工具调用，新手可无脑复刻。

适用系统：Windows10 / Windows11

安装方式：NPM 全局命令行安装（通用性最强、适配所有开发环境）

一、前置准备：安装 Node.js

OpenCode 命令行版本依赖 Node.js 环境，需提前安装：

1. 官网下载：https://nodejs.org/（推荐长期稳定版 LTS）

2. 安装时默认勾选 Add to PATH（自动配置环境变量）

3. 安装完成后，打开 PowerShell 验证：

node -v
npm -v
输出版本号即代表环境就绪

二、核心配置1：NPM 全局路径迁移到 D盘（解决C盘占用）

npm 默认全局安装路径在C盘，长期安装工具会导致系统盘臃肿，本次永久修改全局安装、缓存路径至D盘。

操作步骤（PowerShell 任意权限即可）

1、在D盘创建自定义存放目录

mkdir D:\node_global
mkdir D:\node_cache

2、配置npm全局路径与缓存路径

npm config set prefix "D:\node_global"
npm config set cache "D:\node_cache"

3、验证配置是否生效

npm config get prefix

✅ 输出 D:\node_global 即为配置成功

4、手动配置系统环境变量

• 右键「此电脑」→ 属性 → 高级系统设置 → 环境变量

• 编辑用户变量中的 Path，新增路径：D:\node_global

• 全部保存，关闭所有终端并重新打开（必做，否则不生效）

三、核心配置2：配置永久全局NPM国内镜像源

默认官方源下载速度极慢、易超时，配置全局永久淘宝镜像源，所有项目、所有编程工具（VSCode、IDE、终端）调用npm均自动生效。

1、设置国内镜像源（一键永久生效）

npm config set registry https://registry.npmmirror.com/

2、验证镜像源

npm config get registry

✅ 输出 https://registry.npmmirror.com/ 即配置完成

配置优势：全局生效、永久有效，无需为单个项目单独配置，所有npm install、脚手架工具均走国内高速通道。

【备用指令】切回官方源（后续需要时使用）

npm config set registry https://registry.npmjs.org/

四、安装 OpenCode 全局工具

前置配置全部完成后，再安装OpenCode，会自动安装到D盘自定义目录，且下载速度拉满。

全局安装命令

npm install -g opencode-ai

安装完成验证

opencode --version

输出版本号代表安装成功，程序实际安装路径：D:\node_global\node_modules\opencode-ai

五、OpenCode 启动方式

所有终端（CMD/PowerShell/VSCode终端）均可直接启动

1. 直接进入交互式主界面：opencode

2. 快速问答模式：opencode ask 你的问题

3. 项目对话模式：opencode chat

六、OpenCode 核心高频命令（实操必备）

进入主交互界面后，无需重复输入指令，直接使用内置命令，适配日常开发90%场景：

分类	命令	说明
项目核心命令	/init	项目初始化（必用），扫描目录、识别技术栈
文件操作	/open 文件名	打开本地文件进行编辑分析
	/save	保存当前修改的代码
	/list	查看当前项目所有文件
	/run	直接运行当前代码文件
代码优化	/debug	自动排查代码报错、修复BUG
	/refactor	一键重构代码、规范格式
	/test	自动生成对应单元测试用例
会话管理	/new	新建代码文件、初始化项目模板
	/clear	清空当前对话记录
	/help	查看全部内置命令
	/exit	退出OpenCode交互界面

1. 项目核心命令（最重要）

/init：项目初始化（必用命令）

• 自动扫描项目目录、识别技术栈、生成项目配置文件

• 让AI读懂你的项目结构、代码规范，后续修改代码更精准

• 进阶用法：/init 描述项目技术栈（如Python+FastAPI后端项目）

2. 文件与运行命令

• /open 文件名：打开本地文件进行编辑分析

• /save：保存当前修改的代码

• /list：查看当前项目所有文件

• /run：直接运行当前代码文件

• /debug：自动排查代码报错、修复BUG

3. 代码优化命令

• /refactor：一键重构代码、精简冗余逻辑、规范代码格式

• /test：自动生成对应单元测试用例

4. 基础会话命令

• /new：新建代码文件、初始化项目模板

• /clear：清空当前对话记录

• /help：查看全部内置命令

• /exit：退出OpenCode交互界面

七、全套最佳使用流程（新手必看）

1、终端 cd 进入你的项目文件夹

2、输入 opencode 进入主界面

3、首次使用输入 /init 初始化项目

4、直接对话或使用各类命令完成编码、调试、重构工作

八、全局配置总结（核心亮点）

1. 所有npm全局包默认安装至D盘，彻底杜绝C盘占用

2. 所有开发工具、所有项目统一使用国内镜像，永久高速下载

3. OpenCode搭配/init命令，实现AI辅助全流程开发，适配日常编码需求

九、常见问题排查

• 提示 command not found：关闭所有终端，重新打开即可（环境变量未生效）

• 下载卡顿：重新执行镜像配置命令，确认镜像源地址正确

• 初始化项目识别不准：手动补充项目技术栈描述，重新执行/init

---