xcodecli-shells/docs/guide/claude-code.md

Claude Code 配置指南

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

快速安装与配置

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

::: code-group

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

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

:::

请将命令中的 你的密钥 替换为你的实际 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 (位于用户主目录下)

配置内容示例：

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

常见问题

• Q: 安装后无法使用？
  • A: 请确保已重新打开终端。Claude Code 使用原生安装器，无需 Node.js。如果问题仍存在，检查 ~/.local/bin 是否在 PATH 中。
• Q: 权限错误？
  • A: Claude Code 原生安装器会安装到用户目录 (~/.local/bin)，通常不需要 sudo。