# 快速开始

## 前置要求

- 有效的 XCodeCLI API 密钥
- macOS / Linux: `curl` 和 `bash`
- Windows: PowerShell 5.1+

## 一键安装配置（推荐）

运行一条命令，自动安装并配置全部三个工具：

::: code-group

```bash [macOS / Linux]
API_KEY='你的密钥' bash -c "$(curl -fsSL https://gitea.sususu.cf/sususu/xcodecli-shells/raw/branch/main/setup.sh)"
```

```powershell [Windows]
$key='你的密钥'; iwr -useb https://gitea.sususu.cf/sususu/xcodecli-shells/raw/branch/main/setup.ps1 | iex
```

:::

脚本会自动：

1. 检测 Node.js / Bun 包管理器，缺失时引导安装 Bun
2. 显示三个工具的安装状态
3. 依次安装并配置 Claude Code、Gemini CLI、Codex
4. 显示最终配置结果

<div class="tip custom-block" style="padding-top: 8px">
将命令中的 <code>你的密钥</code> 替换为你的 API 密钥
</div>

## 单独配置某个工具

如果只需要配置其中一个工具，可以使用单独的脚本：

### Claude Code

::: code-group

```bash [macOS / Linux]
API_KEY='你的密钥' bash -c "$(curl -fsSL https://gitea.sususu.cf/sususu/xcodecli-shells/raw/branch/main/ClaudeCode/setup-claude-code.sh)"
```

```powershell [Windows]
$key='你的密钥'; iwr -useb https://gitea.sususu.cf/sususu/xcodecli-shells/raw/branch/main/ClaudeCode/setup-claude-code.ps1 | iex
```

:::

### Gemini CLI

::: code-group

```bash [macOS / Linux]
API_KEY='你的密钥' bash -c "$(curl -fsSL https://gitea.sususu.cf/sususu/xcodecli-shells/raw/branch/main/GeminiCLI/setup-gemini.sh)"
```

```powershell [Windows]
$key='你的密钥'; iwr -useb https://gitea.sususu.cf/sususu/xcodecli-shells/raw/branch/main/GeminiCLI/setup-gemini.ps1 | iex
```

:::

### Codex

::: code-group

```bash [macOS / Linux]
API_KEY='你的密钥' bash -c "$(curl -fsSL https://gitea.sususu.cf/sususu/xcodecli-shells/raw/branch/main/codex/setup-codex.sh)"
```

```powershell [Windows]
$key='你的密钥'; iwr -useb https://gitea.sususu.cf/sususu/xcodecli-shells/raw/branch/main/codex/setup-codex.ps1 | iex
```

:::