配置 Claude Code

Kitcoding 支持在 Claude Code 中使用。

前置条件

已 创建 API 令牌，推荐分组：Claude特价-缓存优化 或 VIP。

💡 推荐：使用 cc-switch 图形化配置

如果不希望手动编辑命令行和配置文件，推荐使用图形化工具 cc-switch ——可一键安装 CLI 并自动完成配置，最为便捷。

下方的手动配置适用于希望直接管理配置文件的用户。两种方式任选其一即可。

一、安装

推荐用原生安装

Anthropic 官方现已首推原生安装脚本，npm 已降级为备选方式。原生安装自带后台自动更新。

原生 (macOS/Linux/WSL)

curl -fsSL https://claude.ai/install.sh | bash

原生 (Windows PowerShell)

irm https://claude.ai/install.ps1 | iex

Homebrew

brew install --cask claude-code

WinGet

winget install Anthropic.ClaudeCode

npm (备选)

# 需要 Node.js 18+；官方已不再首推，自动更新需手动
npm install -g @anthropic-ai/claude-code

验证安装

claude --version 或 claude doctor 可检查安装状态。

二、生成配置目录

安装后先运行一次 claude，让用户目录下生成 .claude 配置目录（后续才好写配置）。

三、配置 settings.json

打开 Claude Code 配置目录：

• Windows：Win + R 输入 %userprofile%\.claude
• macOS：访达 Command + Shift + G 输入 ~/.claude

如果目录里没有 settings.json，手动创建，写入：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://kitcoding.com",
    "ANTHROPIC_AUTH_TOKEN": "你的-kitcoding-令牌",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

把 ANTHROPIC_AUTH_TOKEN 替换为已创建的令牌（见 创建 API 令牌）。

AUTH_TOKEN 与 API_KEY 不可共存

Claude Code 有两个鉴权变量，二选一，不能共存：

• ANTHROPIC_AUTH_TOKEN —— 接 Kitcoding 等中转站时使用此项。
• ANTHROPIC_API_KEY —— 仅标准 Anthropic 官方接口用。

⚠️ ANTHROPIC_API_KEY 的优先级高于 Anthropic 官网登录态——只要此变量存在，Claude Code 即不再使用官网登录账号。接中转站时若误填了 API_KEY，可能出现鉴权混乱，请确认使用的是 AUTH_TOKEN。

多接入点切换

• v1.0.61+ 的 Claude Code 支持 --settings <文件> 参数，可加载不同的 settings.json，方便在多个中转站/账号间切换。
• 更便捷的做法是使用 cc-switch 图形化管理（见页尾）。

四、验证

终端运行 claude，出现对话界面并能正常回复即配置成功。

用 cc-switch 配置（可选捷径）

如果不希望手动编辑命令和配置文件，cc-switch（v3.16.0+）可在图形界面中一键安装 CLI 并完成配置，自动写入上述 settings.json，因此选择此路径则无需手动执行第一至三步。详见 cc-switch 文档。