windows/mac小白装AI工具前,基础环境安装

场景

现在很多 AI 工具都依赖 Node 和 Python。

你去看它们的安装说明， npm install xxx、npx xxx、pip install xxx。老手一眼就知道这是在用 Node 或 Python；小白看到这几行，基本就卡住了：这命令在哪敲？为什么提示找不到？我电脑是不是少装了什么？

这篇只解决一件事：把基础环境装好。

后面按 Windows 和 macOS 分开写。环境没问题后，再用 npm 安装一个 AI CLI 工具 opencode 试一下。

技术简介

Node.js 是 JavaScript 运行环境，npm 是跟着 Node 一起装的包管理工具。很多 AI Web UI、MCP 工具、命令行工具都靠它安装。

Python 是 AI 项目里最常见的运行环境。

实操

Windows：检查和安装

打开 PowerShell。开始菜单搜索 PowerShell，点开。

检查 Node：

node -vnpm -v

如果看到类似这样：

v22.22.310.9.8

Node 就不用装。

检查 Python：

python --versionpy --version

看到 Python 3 开头，就算 Python 有了

Python 3.12.10

如果 Node 没有，下载这个安装包：

https://nodejs.org/dist/v22.22.3/node-v22.22.3-x64.msi

打开后一路 Next / Install / Finish。中间如果看到 Tools for Native Modules，不用勾。

如果 Python 没有，下载这个安装包：

https://www.python.org/ftp/python/3.12.10/python-3.12.10-amd64.exe

打开后第一页左下角一定勾选：

Add python.exe to PATH

然后点 Install Now，后面一路同意。

装完关掉 PowerShell，重新打开，再跑一遍检查命令：

node -vnpm -vpython --version

macOS：检查和安装

打开终端。访达 → 应用程序 → 实用工具 → 终端。

先看芯片：

uname -m

输出 arm64，就是 M 芯片；输出 x86_64，就是 Intel 芯片。

检查 Node：

node -vnpm -v

有输出，Node 就不用装。

检查 Python：

python3 --version

看到 Python 3 开头，Python 就不用装。

macOS 的 Node 安装包是通用 pkg，M 芯片和 Intel 芯片都用这个：

https://nodejs.org/dist/v22.22.3/node-v22.22.3.pkg

macOS 的 Python 3.12.10 也是 universal2 安装包，M 芯片和 Intel 芯片都用这个：

https://www.python.org/ftp/python/3.12.10/python-3.12.10-macos11.pkg

安装就是打开 pkg，一路 继续 / 同意 / 安装。

装完重新打开终端，再跑一遍：

node -vnpm -vpython3 --version

pip 国内加速：改成阿里云镜像源

后面装 Python 包时会经常用到 pip install xxx。国内直接连 PyPI 经常慢，我一般先把 pip 源改成阿里云。

Windows 在 PowerShell 里执行：

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/pip config get global.index-url

macOS 在终端里执行：

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/pip config get global.index-url

第二条命令输出这个地址，就说明生效：

https://mirrors.aliyun.com/pypi/simple/

以后再执行 pip install xxx，默认就会走阿里云镜像源，速度会稳一点。

小试牛刀：安装 opencode

环境好了，拿 opencode 试一下。它现在有桌面版，也有终端版。

桌面版下载页在这里：

https://opencode.ai/zh/download

如果你只是想用图形界面，可以直接下载桌面版。这里我还是用 npm 装一遍终端版，因为它刚好能验证 Node 和 npm 是否真的可用。

国内直接用 npm 装经常慢，先把 npm 镜像源改成 npmmirror：

npm config set registry https://registry.npmmirror.comnpm config get registry

第二条应该输出：

https://registry.npmmirror.com/

安装 opencode 终端版：

npm install -g opencode-ai

检查是否装好：

opencode --help

能看到帮助信息，就说明 CLI 装好了。

进入你要操作的项目目录，再启动：

opencode

按终端提示走。能看到 opencode 的终端界面，环境这一步就算跑通。

收尾总结

以后再看到 npm install xxx、npx xxx、pip install xxx，就可以直接复制安装了。