Skip to main content

​
为什么需要环境配置

在使用 CC-Switch 或手动配置 CLI 工具之前，需要确保你的系统环境已正确安装和初始化
如果环境未正确配置，可能导致 CLI 工具无法正常运行或配置失败

​
配置步骤

​
步骤一：安装 Node.js

Claude Code、Codex 和 Gemini 需要 Node.js v18 或更高版本
如果您已安装 Node.js 18 或更高版本，可跳过本步骤需要更详细的安装教程？参考 菜鸟教程 - Node.js 安装配置
方法一：使用 Homebrew（推荐）
# 更新 Homebrew
brew update
# 安装 Node.js
brew install node
方法二：官网下载
  1. 访问 Node.js 官网
  2. 下载 LTS 版本的 .pkg 安装包
  3. 运行安装程序并按照提示完成安装

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

验证安装： 
node --version && npm --version
应该显示 Node.js 和 npm 的版本号 检查全局包： 
npm list -g --depth=0
正常情况：
  • 显示已安装的全局包列表（没有任何内容也没关系）
异常情况：
  • 如果提示「命令未找到」，说明 Node.js 未正确安装或未添加到环境变量

​
下一步

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

使用 CC-Switch

使用图形界面管理 CLI 配置

手动安装 CLI

手动安装和配置 CLI