# Claude Code 配置指南

Claude Code 是 Anthropic 推出的 AI 编码助手。通过 XCodeCLI，你可以将其连接到自定义 API 端点。

## 快速安装与配置

使用下面的单一行命令即可自动完成安装和配置。

::: 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='你的密钥'; $f="$env:TEMP\xc.ps1";iwr -useb https://gitea.sususu.cf/sususu/xcodecli-shells/raw/branch/main/ClaudeCode/setup-claude-code.ps1 -OutFile $f;& $f
```

:::

> 请将命令中的 `你的密钥` 替换为你的实际 API 密钥。
::: warning ⚠️ 配置完成后请重启终端
脚本会自动配置环境变量（`ANTHROPIC_AUTH_TOKEN` 等），但需要**重启终端**才能生效。

- **macOS / Linux**：重新打开终端，或执行 `source ~/.zshrc`（或 `source ~/.bashrc`）
- **Windows**：重新打开 PowerShell 窗口

如果不重启，Claude Code 首次启动时可能无法读取 API 密钥。
:::

## 手动配置说明

如果你想手动配置，Claude Code 的配置文件位于：

- **macOS / Linux**: `~/.claude/settings.json`
- **Windows**: `~/.claude/settings.json` (位于用户主目录下)

配置内容示例：

```json
{
  "apiBaseUrl": "https://api2.xcodecli.com",
  "apiKey": "sk-your-key-here"
}
```

## 常见问题

- **Q: 安装后无法使用？**
  - A: 请确保已重新打开终端。Claude Code 通过 npm 安装，需要 Node.js >= 20。如果问题仍存在，检查 Node.js 和 npm 全局目录是否在 PATH 中。
- **Q: 权限错误？**
  - A: 使用 npm 安装时，建议通过 fnm 管理 Node.js，避免全局安装需要 `sudo`。
