ACORG docs

主题

macOS 环境 ​

1. 安装 nvm ​

按 nvm 官方 README 安装:

bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh | bash

上面的脚本版本来自 nvm 官方 README（2026-09-23 核对）；将来安装时请先查看官方 README的当前示例。重新打开终端,或按安装脚本提示加载 ~/.zshrc / ~/.bashrc 后验证:

bash
nvm --version

2. 可选：设置 nvm 下载镜像 ​

如果访问 Node.js 官方下载源较慢，可先设置 nvm 镜像；网络正常时直接跳到下一步。此时还没有安装 Node.js，不要运行 npm config。

bash
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

如需长期生效,把 NVM_NODEJS_ORG_MIRROR 写入 ~/.zshrc:

bash
echo 'export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node' >> ~/.zshrc
source ~/.zshrc

3. 安装 Node.js 24 LTS ​

bash
nvm install 24
nvm use 24
nvm alias default 24
node -v
npm -v

如果项目明确要求 Node.js 22,把命令中的 24 替换为 22。如果项目有 .nvmrc、.node-version 或 engines.node,请优先遵循项目配置,详见版本选择说明。

只有 Node.js 和 npm 都安装成功、且访问默认 npm registry 较慢时，再按需设置 npm 镜像：

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

需要恢复官方源时运行 npm config set registry https://registry.npmjs.org。

下一步 ​

继续安装 Codex 与 Claude Code。需要 Python 脚本、MCP 或自动化时,再参考安装 Python 3.12.x。