环境配置

为什么需要环境配置

在使用 CC-Switch 或手动配置 CLI 工具之前，需要确保你的系统环境已正确安装和初始化

如果环境未正确配置，可能导致 CLI 工具无法正常运行或配置失败

配置步骤

步骤一：安装 Node.js

Claude Code、Codex 和 Gemini 需要 Node.js v18 或更高版本

如果您已安装 Node.js 18 或更高版本，可跳过本步骤需要更详细的安装教程？参考菜鸟教程 - Node.js 安装配置

macOS
Windows
Linux

方法一：使用 Homebrew（推荐）

# 更新 Homebrew
brew update
# 安装 Node.js
brew install node

方法二：官网下载

访问 Node.js 官网
下载 LTS 版本的 .pkg 安装包
运行安装程序并按照提示完成安装

方法一：使用官方安装包（推荐）

访问 Node.js 官网
下载 LTS 版本的 Windows Installer .msi
运行安装程序，按默认设置完成安装
安装程序会自动添加到 PATH 环境变量

方法二：使用包管理器使用 Winget（Windows 11 或 Windows 10 自带）：

winget install OpenJS.NodeJS.LTS

使用 Chocolatey：

choco install nodejs-lts

使用 Scoop：

scoop install nodejs-lts

Ubuntu/Debian：

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

其他发行版请参考 Node.js 官方文档

步骤二：确认环境已就绪

验证安装：

node --version && npm --version

应该显示 Node.js 和 npm 的版本号 检查全局包：

npm list -g --depth=0

正常情况：

显示已安装的全局包列表（没有任何内容也没关系）

异常情况：

如果提示「命令未找到」，说明 Node.js 未正确安装或未添加到环境变量

下一步

Node.js 环境配置完成后，你可以：

使用 CC-Switch

使用图形界面管理 CLI 配置

手动安装 CLI

手动安装和配置 CLI

快速开始

CLI 配置

常见问题

为什么需要环境配置

配置步骤

步骤一：安装 Node.js

步骤二：确认环境已就绪

下一步

使用 CC-Switch

手动安装 CLI

​为什么需要环境配置

​配置步骤

​步骤一：安装 Node.js

​步骤二：确认环境已就绪

​下一步

使用 CC-Switch

手动安装 CLI

为什么需要环境配置

配置步骤

步骤一：安装 Node.js

步骤二：确认环境已就绪

下一步