> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rayinai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 环境配置

> 配置 CLI 工具运行环境

## 为什么需要环境配置

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

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

## 配置步骤

### 步骤一：安装 Node.js

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

<Info>
  **如果您已安装 Node.js 18 或更高版本，可跳过本步骤**

  需要更详细的安装教程？参考 [菜鸟教程 - Node.js 安装配置](https://www.runoob.com/nodejs/nodejs-install-setup.html)
</Info>

<Tabs>
  <Tab title="macOS">
    **方法一：使用 Homebrew（推荐）**

    ```bash theme={null}
    # 更新 Homebrew
    brew update
    # 安装 Node.js
    brew install node
    ```

    **方法二：官网下载**

    1. 访问 [Node.js 官网](https://nodejs.org)
    2. 下载 LTS 版本的 `.pkg` 安装包
    3. 运行安装程序并按照提示完成安装
  </Tab>

  <Tab title="Windows">
    **方法一：使用官方安装包（推荐）**

    1. 访问 [Node.js 官网](https://nodejs.org)
    2. 下载 LTS 版本的 Windows Installer `.msi`
    3. 运行安装程序，按默认设置完成安装
    4. 安装程序会自动添加到 PATH 环境变量

    **方法二：使用包管理器**

    使用 Winget（Windows 11 或 Windows 10 自带）：

    ```powershell theme={null}
    winget install OpenJS.NodeJS.LTS
    ```

    使用 Chocolatey：

    ```powershell theme={null}
    choco install nodejs-lts
    ```

    使用 Scoop：

    ```powershell theme={null}
    scoop install nodejs-lts
    ```
  </Tab>

  <Tab title="Linux">
    **Ubuntu/Debian：**

    ```bash theme={null}
    curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
    sudo apt-get install -y nodejs
    ```

    **其他发行版**请参考 [Node.js 官方文档](https://nodejs.org/en/download/package-manager)
  </Tab>
</Tabs>

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

**验证安装：**

```bash theme={null}
node --version && npm --version
```

应该显示 Node.js 和 npm 的版本号

**检查全局包：**

```bash theme={null}
npm list -g --depth=0
```

**正常情况：**

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

**异常情况：**

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

## 下一步

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

<CardGroup cols={2}>
  <Card title="使用 CC-Switch" icon="toggle-on" href="/cc-switch/usage">
    使用图形界面管理 CLI 配置
  </Card>

  <Card title="手动安装 CLI" icon="terminal" href="/claude-code/introduction">
    手动安装和配置 CLI
  </Card>
</CardGroup>