“一篇面向 Windows 用户的完整安装指南：从打开 PowerShell、配置执行策略，到安装 Git、Node.js、Opencode、VS Code、Miniconda 和 Pandoc。”

Windows 用户从零配置 AI 生产力工具链

这篇文章适合第一次在 Windows 上搭建 AI 辅助写作、编程、数据分析和文档处理环境的用户。完成后，你会拥有一套比较完整的本地工作流：终端负责执行命令，Git 负责版本管理，Node.js 支撑 Opencode 运行，VS Code 负责编辑文件，Miniconda 管理 Python 数据分析环境，Pandoc 负责文档格式转换。

如果你之前没有使用过命令行，不用担心。下面的步骤会从最基础的 PowerShell 开始，每一步都给出验证命令。建议按顺序完成，不要跳步。

安装清单

工具	作用	Windows 安装方式
PowerShell	Windows 内置命令行环境，用来输入和执行命令	系统自带
Git	版本控制工具，记录文件修改，支持回退与协作	官网下载 .exe
Node.js + npm	JavaScript 运行环境；npm 是包管理器，也是安装 Opencode 的基础	官网下载 .msi
Opencode	终端中的 AI 助手，可读写文件、执行命令、辅助完成工作流	npm install -g opencode-ai
VS Code	代码与文本编辑器，用来查看和编辑 AI 生成的文件	官网下载 .exe
Miniconda	Python 环境管理工具，适合数据分析和自动化任务	官网下载 .exe
Pandoc	文档格式转换工具，可将 Markdown 转为 Word、PDF、HTML 等	官网下载 .msi
Skills 扩展包	为支持 Skills 的 AI 工具补充文档、表格、演示、网页抓取等能力	按对应工具的扩展说明安装

注：Xcode 命令行工具和 Homebrew 主要面向 macOS，Windows 用户不需要安装。

第一步：打开 PowerShell

PowerShell 是 Windows 内置的命令窗口。你在这里输入文字命令，电脑会按命令执行对应操作。

方法一：开始菜单搜索

1. 点击屏幕左下角的 Windows 图标，或按键盘上的 Windows 键。
2. 输入 PowerShell。
3. 在搜索结果中点击 “Windows PowerShell”。
4. 窗口打开后，就可以输入命令了。

你看到的提示符通常类似下面这样：

PS C:\Users\你的用户名>

方法二：右键开始按钮

1. 右键点击左下角 Windows 图标。
2. Windows 11 通常选择 “Windows 终端”；Windows 10 通常选择 “Windows PowerShell”。
3. 窗口弹出后，就进入了命令行环境。

Windows 11 的终端界面更新一些，支持标签页；Windows 10 的 PowerShell 窗口看起来朴素一些，但本文中的命令都可以正常使用。

PowerShell 基本操作

操作	说明
输入命令后按 Enter	执行命令
Ctrl + C	取消正在运行的命令
方向键 ↑	调出上一条命令，避免重复输入
右键窗口空白处	在旧版 PowerShell 中粘贴文本

Windows 10 的旧版 PowerShell 可能不支持 Ctrl + V 粘贴，这时右键窗口空白处即可粘贴。Windows 11 的 Windows 终端通常已经支持 Ctrl + V。

第二步：设置 PowerShell 执行策略

Windows 为了安全，默认可能禁止运行外部脚本文件。很多通过 npm 安装的命令行工具会生成 .ps1 脚本。如果不调整执行策略，后面运行 Opencode 等工具时可能会遇到“无法加载文件”的错误。

打开 PowerShell，输入：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

如果系统询问是否更改执行策略，输入：

Y

然后按 Enter 确认。

验证是否设置成功：

Get-ExecutionPolicy

如果返回：

RemoteSigned

说明设置成功。

第三步：安装 Git

打开浏览器，访问 Git 官方下载页：

https://git-scm.com/downloads/win

浏览器会下载一个 .exe 安装文件，文件名通常类似 Git-2.xx.x-64-bit.exe。

安装时大部分选项保持默认即可，但有一步很重要：当出现 “Adjusting your PATH environment” 页面时，选择：

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

这一步决定你能否在 PowerShell 中直接使用 git 命令。如果选错，后续工具可能找不到 Git。

安装完成后，关闭当前 PowerShell，重新打开一个新窗口。然后输入：

git --version

看到类似下面的输出，就说明 Git 安装成功：

git version 2.54.0.windows.1

如果提示 'git' 不是内部或外部命令，先确认是否已经关闭并重新打开 PowerShell。如果仍然不行，重新运行 Git 安装程序，在 PATH 选项页选择上面提到的第二个选项。

第四步：配置 Git 用户信息

Git 需要知道提交记录来自谁。打开 PowerShell，依次执行下面两条命令，把示例内容替换成你自己的名字和邮箱：

git config --global user.name "你的名字"

git config --global user.email "你的邮箱@example.com"

这两条命令执行后没有输出是正常的。没有报错，就表示保存成功。

查看配置：

git config --global --list

你应该能看到类似：

user.name=你的名字
user.email=你的邮箱

第五步：安装 Node.js

Node.js 是 JavaScript 运行环境。它会附带安装 npm，也就是 Node Package Manager。后面安装 Opencode 时会用到 npm。

打开浏览器，访问 Node.js 下载页：

https://nodejs.org/en/download

选择 LTS 版本，下载 Windows Installer，也就是 .msi 文件。

安装步骤：

1. 双击下载好的 .msi 文件。
2. 点击 “Next”。
3. 勾选 “I accept the terms in the License Agreement”。
4. 安装路径保持默认，例如 C:\Program Files\nodejs\。
5. 功能选择页面保持默认，确认 “Add to PATH” 已选中。
6. 点击 “Install”，按提示完成安装。

安装完成后，关闭当前 PowerShell，重新打开一个新窗口。验证 Node.js：

node --version

看到类似下面的输出即可：

v22.x.x

再验证 npm：

npm --version

看到类似下面的输出即可：

10.x.x

如果提示找不到 node 或 npm，先关闭 PowerShell 后重新打开。如果仍然不行，重新运行安装包，确认 “Add to PATH” 已选中。

第六步：安装 Opencode

确认 Node.js 和 npm 都安装成功后，在 PowerShell 中输入：

npm install -g opencode-ai

这条命令表示：用 npm 全局安装 opencode-ai 这个软件包。安装过程需要从网络下载文件，可能需要 1 到 5 分钟。看到命令提示符重新出现，就表示安装过程结束。

验证安装：

opencode --version

如果能看到版本号，说明安装成功。

常见问题：无法加载 .ps1 文件

如果看到类似下面的错误：

opencode : 无法加载文件 C:\Users\...\opencode.ps1，因为在此系统上禁止运行脚本。

说明 PowerShell 执行策略没有正确生效。重新执行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

然后关闭 PowerShell，重新打开，再运行：

opencode --version

常见问题：npm 安装超时或失败

如果安装时网络超时，可以指定官方 npm 源重试：

npm install -g opencode-ai --registry=https://registry.npmjs.org

第七步：安装 VS Code

VS Code 是后续查看、编辑代码和 Markdown 文件的主要工具。

打开官网：

https://code.visualstudio.com

点击 “Download for Windows”，下载 .exe 安装文件。

安装时建议勾选以下选项：

• 将 “通过 Code 打开” 添加到文件右键菜单。
• 将 “通过 Code 打开” 添加到目录右键菜单。
• 将 Code 注册为受支持文件类型的编辑器。
• 添加到 PATH。

安装完成后，可以在 PowerShell 中验证：

code --version

看到版本号说明安装成功。也可以直接在开始菜单搜索并打开 VS Code。

第八步：安装 Miniconda

Miniconda 是轻量级 Python 环境管理工具，适合数据分析、自动化脚本和隔离不同项目依赖。

打开 Miniconda 下载页：

https://docs.anaconda.com/miniconda/

下载 “Miniconda3 Windows 64-bit”，文件名通常类似：

Miniconda3-latest-Windows-x86_64.exe

安装建议：

1. 安装类型选择 “Just Me”。
2. 安装路径保持默认，例如 C:\Users\你的用户名\miniconda3。
3. “Add Miniconda3 to my PATH environment variable” 建议保持默认，不勾选。
4. “Register Miniconda3 as my default Python” 可以勾选。
5. 点击 “Install” 完成安装。

安装完成后，需要初始化 PowerShell：

conda init powershell

执行后关闭当前 PowerShell，重新打开一个新窗口。新窗口的提示符前面通常会出现：

(base) PS C:\Users\你的用户名>

这表示 conda 默认环境已经激活。

验证版本：

conda --version
python --version

如果提示 conda 不是可识别的命令：

1. 确认是否执行过 conda init powershell。
2. 确认是否关闭并重新打开 PowerShell。
3. 如果仍然不行，在开始菜单搜索 “Anaconda Prompt (miniconda3)”，用它运行 conda 命令也可以。

第九步：安装 Pandoc

Pandoc 是文档格式转换工具，可以把 Markdown 转换为 Word、PDF、HTML 等格式。写博客、写报告、整理文档时非常实用。

打开 Pandoc 安装页：

https://pandoc.org/installing.html

找到 Windows 部分，跳转到 GitHub 下载 .msi 安装包，文件名通常类似：

pandoc-3.x.x-windows-x86_64.msi

安装时保持默认选项即可。安装完成后，关闭并重新打开 PowerShell，输入：

pandoc --version

看到版本号输出，说明安装成功。

第十步：整理 Skills 扩展工作流

如果你使用的 AI 工具支持 Skills，可以把常用能力整理成独立技能包，例如：

• 文档处理：读取、改写、生成 Word 或 Markdown。
• 表格处理：分析 CSV、Excel，生成图表和统计摘要。
• 演示文稿：根据提纲生成 PPT。
• 网页抓取：从网页提取结构化内容。
• 数据分析：封装常用 Python、Stata 或 SQL 工作流。

Skills 的安装方式取决于具体工具。建议把技能文件统一放在一个固定目录，并在工具配置中引用该目录。这样后续迁移电脑或更新环境时，只需要同步这个目录即可。

一个简单的目录结构可以是：

ai-workflow/
  skills/
    documents/
      SKILL.md
    spreadsheets/
      SKILL.md
    web-research/
      SKILL.md
  projects/
  outputs/

后续你可以把常用提示词、脚本、模板和检查清单逐步沉淀进 skills/ 目录，让 AI 助手不只是“聊天”，而是逐渐变成一套可复用的工作系统。

最终检查清单

完成所有安装后，建议重新打开 PowerShell，并依次运行：

git --version
node --version
npm --version
opencode --version
code --version
conda --version
python --version
pandoc --version

如果每条命令都能返回版本号，说明 Windows 上的 AI 生产力工具链已经配置完成。

小结

这套环境的核心逻辑是：

• PowerShell 负责执行命令。
• Git 负责版本控制。
• Node.js 和 npm 负责安装并运行 Opencode。
• VS Code 负责编辑和管理文件。
• Miniconda 负责 Python 环境。
• Pandoc 负责文档格式转换。
• Skills 负责把重复工作沉淀为可复用能力。

第一次安装可能会觉得步骤多，但只要按顺序完成，并在每一步用版本号命令验证，就能快速定位问题。配置好之后，你就可以把写作、代码、数据分析、文档转换和自动化任务放进同一个稳定的工作流里了。