本指南将手把手带你将 OpenCode 完整安装到 F 盘，并配置好 DeepSeek 最新 V4 Pro 和 V4 Flash 模型，不占用 C 盘空间。包括电脑没有 Node.js。

---

目录

1. 准备工作 1.1 安装 Node.js 到 F 盘 1.2 配置 npm 全局路径到 F 盘 1.3 获取 DeepSeek API Key

2. 安装 OpenCode

3. 将数据目录全部迁移到 F 盘

4. 连接 DeepSeek 模型

5. 在 VS Code 中使用

6. 日常使用与模型切换

7. 常见问题

---

1. 准备工作

1.1 安装 Node.js 到 F 盘

如果电脑上还没有 Node.js，请按以下步骤安装：

1. 前往 Node.js 官网 下载 LTS 版本（如 20.x）的 Windows 安装包 (.msi)。

2. 运行安装程序，在 “Destination Folder” 步骤点击 Change…，将路径改为 F:\Nodejs（或其他你喜欢的 F 盘路径）。

3. 其余步骤保持默认，一路 Next 完成安装。

安装完成后，按 Win + R 输入 cmd 回车，执行 node -v 和 npm -v 确认安装成功。

1.2 配置 npm 全局路径到 F 盘

为了让 OpenCode 本体也安装在 F 盘，我们需要修改 npm 的全局安装位置。

以管理员身份打开命令提示符（CMD），依次执行：

mkdir F:\OpenCode\bin
npm config set prefix "F:\OpenCode\bin"

然后将这个路径添加到系统环境变量 Path 中：

1. 执行 rundll32 sysdm.cpl,EditEnvironmentVariables 打开环境变量窗口。

2. 在 用户变量 或 系统变量 中找到 Path，双击编辑。

3. 点击 新建，输入 F:\OpenCode\bin，确定保存。

4. 关闭当前 CMD 并重新打开，使修改生效。

1.3 获取 DeepSeek API Key

1. 访问 DeepSeek 开放平台 登录并创建 API Key。

2. 复制保存好这个 Key，稍后会用到。

---

2. 安装 OpenCode

在新的 CMD 窗口中执行（确保 npm 全局路径已生效）：

npm install -g opencode-ai@latest

等待安装完成，执行以下命令验证：

opencode --version

若显示出类似 1.14.28 的版本号，则安装成功。

---

3. 将数据目录全部迁移到 F 盘

OpenCode 默认会将配置、凭据、缓存存放在 C 盘用户目录下。为了彻底避免占用 C 盘，我们需要通过环境变量重定向这些目录。

3.1 创建 F 盘下的目标目录

mkdir F:\OpenCode\config
mkdir F:\OpenCode\data
mkdir F:\OpenCode\cache

3.2 设置环境变量

仍以管理员身份在 CMD 中执行：

setx XDG_CONFIG_HOME "F:\OpenCode\config"
setx XDG_DATA_HOME   "F:\OpenCode\data"
setx XDG_CACHE_HOME  "F:\OpenCode\cache"

3.3 设置 API Key 环境变量（推荐）

为了安全，不把 Key 写在配置文件里：

setx DEEPSEEK_API_KEY "你的API-Key"

设置完以上所有环境变量后，必须关闭当前 CMD 并重新打开，才能生效。

---

4. 连接 DeepSeek 模型

现在你的 OpenCode 已经完全“落户”在 F 盘，但还需要告诉它用哪个模型。

1. 在新的 CMD 中，进入任意项目目录（或直接启动）：

   cd /d D:\你的项目路径
   opencode

2. 在 OpenCode 的交互框中，输入引导式配置命令：

   /connect

3. 按照提示操作：

   • 选择提供商：搜索并选择 deepseek

   • 输入 API Key：粘贴你刚才准备好的 Key

   • 选择模型：在弹出的列表中选择 DeepSeek-V4-Pro（默认用于复杂任务）或 DeepSeek-V4-Flash（更快）

4. 完成！现在你的 API Key 已安全存储在 F:\OpenCode\data\opencode\auth.json，模型配置也已就绪。

---

5. 在 VS Code 中使用

OpenCode 和 VS Code 的集成非常顺滑，无需单独配置。

1. 在 VS Code 中打开你的项目文件夹。

2. 按 `Ctrl + `` 打开内置终端。

3. 在终端中输入 opencode 并回车。

4. 首次使用时，OpenCode 会自动提示安装 VS Code 扩展，点击“安装”即可。 如果未出现提示，可手动在扩展市场搜索 OpenCode 安装。

成功后，你会看到侧边栏出现 OpenCode 对话面板。 常用快捷键：

• 快速打开/聚焦：Ctrl + Esc

• 新建会话：Ctrl + Shift + Esc

---

6. 日常使用与模型切换

启动方式

• 在项目目录内启动：终端中先 cd 到项目根目录，再执行 opencode。

• 指定目录启动：opencode D:\其他项目路径

切换模型

在对话中输入 /models，即可随时在 DeepSeek-V4-Pro 和 DeepSeek-V4-Flash 之间切换。

查看帮助

输入 /help 可列出所有可用命令和功能。

---

7. 常见问题

1） 安装时报网络超时或 WSL 警告

• 请使用 npm 安装法（本指南第 2 节），不要用 curl ... | bash。npm 安装稳定且不依赖 WSL。

2） 配置时报 Unrecognized keys: providers, models

• 表明你手动修改了 opencode.json 但格式不符合规范。 解决方法：删除 F 盘下的 opencode.json 文件，然后使用 /connect 命令重新配置，这是最安全的方式。

3） 为什么凭据文件还在 C 盘？

• 你可能只设置了 XDG_CONFIG_HOME，却忘了设置 XDG_DATA_HOME。 请重新执行第 3 节，将三个环境变量都设置好，然后重启终端，再次执行 /connect。

4） 使用一段时间后 C 盘又满了？

• 可能是旧缓存未删除。确认新缓存已在 F 盘后，可手动清理 C 盘旧目录：

  • %USERPROFILE%\.config\opencode

  • %USERPROFILE%\.local\share\opencode

  • %USERPROFILE%\.cache\opencode

5） 如何彻底卸载？

1. 删除环境变量：XDG_CONFIG_HOME、XDG_DATA_HOME、XDG_CACHE_HOME 和 DEEPSEEK_API_KEY。

2. 删除 F:\OpenCode 文件夹。

3. 从 Path 中移除 F:\OpenCode\bin。

4. 删除 %USERPROFILE% 下可能残留的旧数据目录。