Skip to content

Claude Code 配置指南

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

快速安装与配置

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

bash
API_KEY='你的密钥' bash -c "$(curl -fsSL https://gitea.sususu.cf/sususu/xcodecli-shells/raw/branch/main/ClaudeCode/setup-claude-code.sh)"
powershell
$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 密钥。

⚠️ 配置完成后请重启终端

脚本会自动配置环境变量(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

XCodeCLI API Router