Skip to content

配置 Claude Code

Kitcoding 支持在 Claude Code 中使用。

前置条件

创建 API 令牌推荐分组:Claude特价-缓存优化VIP

💡 新手推荐:用 cc-switch 一键搞定

不想碰命令行和配置文件?推荐用图形化工具 cc-switch ——它能帮你一键安装 CLI 并自动填好配置,是最省心的方式。

下方的手动配置适合想搞清楚原理、或不想装额外工具的用户。两条路二选一即可。

一、安装

推荐用原生安装

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

bash
curl -fsSL https://claude.ai/install.sh | bash
powershell
irm https://claude.ai/install.ps1 | iex
bash
brew install --cask claude-code
powershell
winget install Anthropic.ClaudeCode
bash
# 需要 Node.js 18+;官方已不再首推,自动更新需手动
npm install -g @anthropic-ai/claude-code

验证安装

claude --versionclaude doctor 可检查安装状态。

二、生成配置目录

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

三、配置 settings.json

打开 Claude Code 配置目录:

  • WindowsWin + R 输入 %userprofile%\.claude
  • macOS:访达 Command + Shift + G 输入 ~/.claude

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

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 文档