# 快速开始

## 1. 安装 Bun

```bash
# macOS / Linux
curl -fsSL https://bun.sh/install | bash

# macOS (Homebrew)
brew install bun

# Windows (PowerShell)
powershell -c "irm bun.sh/install.ps1 | iex"
```

> 精简版 Linux 如提示 `unzip is required`，先运行 `apt update && apt install -y unzip`

## 2. 安装依赖并配置

```bash
bun install
cp .env.example .env
# 编辑 .env 填入你的 API Key，详见「环境变量」文档
```

环境变量的完整说明请参考 [环境变量配置](./env-vars.md)。

## 3. 启动

### macOS / Linux

```bash
./bin/gaster-code                          # 交互 TUI 模式
./bin/gaster-code -p "your prompt here"    # 无头模式
./bin/gaster-code --help                   # 查看所有选项
```

### Windows

> **前置要求**：必须安装 [Git for Windows](https://git-scm.com/download/win)

```powershell
# PowerShell / cmd 直接调用 Bun
bun --env-file=.env ./src/entrypoints/cli.tsx

# 或在 Git Bash 中运行
./bin/gaster-code
```

## 4. 全局使用（可选）

将 `bin/` 加入 PATH 后可在任意目录启动，详见 [全局使用指南](./global-usage.md)：

```bash
export PATH="$HOME/path/to/gaster-code/bin:$PATH"
```

## 5. 降级模式

如果 Ink TUI 出现问题，可以使用降级 Recovery CLI 模式：

```bash
CLAUDE_CODE_FORCE_RECOVERY_CLI=1 ./bin/gaster-code
```
