Skip to content

Claude Code(终端) ​

通过配置文件在电脑上安装和接入 Claude Code CLI。

  • 协议与地址: Anthropic 协议,ANTHROPIC_BASE_URL 填 https://aicode.cat(不要加 /v1)。
  • 密钥字段: 填在 ANTHROPIC_AUTH_TOKEN(不要写成 ANTHROPIC_API_KEY)。
  • 前置准备: 先到 创建 API Key 拿一把绑定了 Claude 分组的 Key。

macOS / Linux ​

1. 安装 Node.js(需 18+) ​

已经装过 Node.js 18+ 可直接跳到第 2 步。

  • macOS: 先安装 Homebrew(部分海外资源需开启 TUN 代理),再安装 Node.js:

    复制 Homebrew 安装命令

    Bash
    brew install node
    node --version
  • Linux(Debian / Ubuntu):

    Bash
    curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
    sudo apt-get install -y nodejs
    node --version

2. 安装 Claude Code CLI ​

Bash
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com/

安装 Claude Code

3. 创建配置文件 ​

把 在这里替换成你的_API_KEY 换成 密钥页 里的 Key,在终端执行:

命令行写入
dir="$HOME/.claude"
settingsFile="$dir/settings.json"
claudeJsonFile="$HOME/.claude.json"

mkdir -p "$dir"

# 1. 写入 settings.json(API 配置)
cat > "$settingsFile" << 'EOF'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "在这里替换成你的_API_KEY",
    "ANTHROPIC_BASE_URL": "https://aicode.cat"
  }
}
EOF

# 2. 写入 .claude.json(跳过首次登录引导,位于用户根目录)
cat > "$claudeJsonFile" << 'EOF'
{
  "hasCompletedOnboarding": true
}
EOF

echo "配置完成!"
echo "  - settings.json: $settingsFile"
echo "  - .claude.json: $claudeJsonFile"
手动:~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "在这里替换成你的_API_KEY",
    "ANTHROPIC_BASE_URL": "https://aicode.cat"
  }
}
手动:~/.claude.json
{
  "hasCompletedOnboarding": true
}

核对配置(只显示 Key 是否已设置,不把密钥打到终端):

Bash
grep -q '"ANTHROPIC_AUTH_TOKEN"' "$HOME/.claude/settings.json" && echo 'ANTHROPIC_AUTH_TOKEN=<已设置>'
grep 'ANTHROPIC_BASE_URL' "$HOME/.claude/settings.json"

核对 settings.json

4. 验证安装 ​

重新打开终端或 IDE,进入项目目录运行:

Bash
claude

弹出文件夹信任提示时,选第一个 Yes, proceed 回车:

授权当前文件夹

输入 hi 或「您好!」,能正常回复即配置成功。

验证对话

Windows ​

1. 安装 Node.js(需 18+)与 Git ​

  1. 前往 Node.js 官网 下载安装 LTS 版本,装完在 PowerShell 执行 node --version 确认版本 ≥ 18。
  2. 前往 Git 官网 下载安装 Git for Windows(一路下一步即可)。

下载 Git for Windows

2. 安装 Claude Code CLI ​

按 Win + R 输入 powershell 打开 PowerShell,执行:

PowerShell
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com/

Windows 安装 Claude Code

若提示「在此系统上禁止运行脚本」,以管理员身份运行 PowerShell,执行 Set-ExecutionPolicy Unrestricted 并输入 Y 确认,再重新安装。

3. 创建配置文件 ​

把 在这里替换成你的_API_KEY 换成你的 Key,在 PowerShell 执行:

命令行写入
$dir = Join-Path $env:USERPROFILE ".claude"
$settingsFile = Join-Path $dir "settings.json"
$claudeJsonFile = Join-Path $env:USERPROFILE ".claude.json"

New-Item -ItemType Directory -Path $dir -Force | Out-Null

# 1. 写入 settings.json(API 配置)
$settingsJson = @'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "在这里替换成你的_API_KEY",
    "ANTHROPIC_BASE_URL": "https://aicode.cat"
  }
}
'@
[System.IO.File]::WriteAllText($settingsFile, $settingsJson, (New-Object System.Text.UTF8Encoding($false)))

# 2. 写入 .claude.json(跳过首次登录引导,位于用户根目录)
$claudeJson = @'
{
  "hasCompletedOnboarding": true
}
'@
[System.IO.File]::WriteAllText($claudeJsonFile, $claudeJson, (New-Object System.Text.UTF8Encoding($false)))

Write-Host "配置完成!"
Write-Host "  - settings.json: $settingsFile"
Write-Host "  - .claude.json: $claudeJsonFile"
手动:settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "在这里替换成你的_API_KEY",
    "ANTHROPIC_BASE_URL": "https://aicode.cat"
  }
}
手动:.claude.json
{
  "hasCompletedOnboarding": true
}

手动方式的文件路径:C:\Users\<你的用户名>\.claude\settings.json 和 C:\Users\<你的用户名>\.claude.json。

Windows 写入配置

4. 验证安装 ​

重新打开 PowerShell 或 IDE,运行:

PowerShell
claude

弹出文件夹信任提示时,选第一个 Yes, proceed 回车:

Windows 授权当前文件夹

输入「您好!」,能正常回复即配置成功。

Windows 验证对话

常见问题 ​

1. 无法连接到 Anthropic 服务(Unable to connect to Anthropic services) ​

无法连接到 Anthropic 服务

原因是缺少跳过首次登录引导的字段。在 ~/.claude.json(Windows 为 C:\Users\<你的用户名>\.claude.json)里补上:

JSON
"hasCompletedOnboarding": true,

如果文件里已有其它字段,按 JSON 语法补好逗号,不要清空原有内容。

在 .claude.json 里打开 hasCompletedOnboarding

2. Invalid API key · Please run /login 或 401 Invalid API key ​

Invalid API key · Please run /login

  • 确认字段名是 ANTHROPIC_AUTH_TOKEN(不是 ANTHROPIC_API_KEY),且没有同时设置冲突的 ANTHROPIC_API_KEY 环境变量。
  • 确认 ANTHROPIC_BASE_URL 是 https://aicode.cat(不要带 /v1)。
  • 到 密钥页 点击复制图标拿完整 Key,重写配置后新开终端再运行 claude。

3. 手动打开配置目录与防坑提示 ​

  • Windows(CMD): start "" "%USERPROFILE%\.claude"(用记事本手动新建时,先在资源管理器「查看」里勾选「文件扩展名」,防止保存成 settings.json.txt)
  • macOS(终端): mkdir -p "$HOME/.claude" && open "$HOME/.claude"(访达按 Command + Shift + . 显示隐藏文件)
  • 改完必重启: 每次改完配置,先按 Ctrl + C 退出再重新运行 claude。

4. VS Code 插件版提示官方登录 ​

VS Code 里的 Claude Code 扩展共用同一套 CLI 配置。若插件仍弹出官方登录框,在 .claude 目录下新建或编辑 config.json,写入任意非空占位值即可(实际鉴权仍走 settings.json):

JSON
{
  "primaryApiKey": "AiCodeCat"
}

保存后彻底退出并重启 VS Code。

5. 请求超时、自动重试或空回复 ​

  • 504 Gateway time-out:单次任务太重。等 1~2 分钟发一句「继续」,并把大任务拆小。
  • 522 Connection timed out:瞬时网络波动,不要改配置,等 1~2 分钟重试。
  • API returned an empty or malformed response (HTTP 200):重试一次;若连续只回 No response requested,退出重开新会话。
  • Last error: unknown 自动重试:本地网络或代理波动;连续重试仍失败时运行 claude --debug 排查。

6. 常用命令与省额度技巧 ​

命令作用
claude在当前目录启动交互会话
claude -c继续当前目录最近一次会话
claude -r <会话ID>恢复指定历史会话
claude -p "总结报错"单次问答后直接退出(支持管道输入)
claude --model sonnet指定本次会话使用的模型
claude mcp管理 MCP 工具服务器
claude --debug开启调试日志排查连接问题

为什么账单里会有 Haiku 等小模型? Claude Code 生成会话标题、压缩上下文或调用内置 Explore 子代理时,会自动用便宜的小模型打辅助,属正常机制。保持同一会话连续工作(命中缓存)、关闭不用的 MCP 工具可显著省额度。