主题
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:
Bashbrew install node node --versionLinux(Debian / Ubuntu):
Bashcurl -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/
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"
4. 验证安装
重新打开终端或 IDE,进入项目目录运行:
Bash
claude弹出文件夹信任提示时,选第一个 Yes, proceed 回车:

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

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

2. 安装 Claude Code CLI
按 Win + R 输入 powershell 打开 PowerShell,执行:
PowerShell
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com/
若提示「在此系统上禁止运行脚本」,以管理员身份运行 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。

4. 验证安装
重新打开 PowerShell 或 IDE,运行:
PowerShell
claude弹出文件夹信任提示时,选第一个 Yes, proceed 回车:

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

常见问题
1. 无法连接到 Anthropic 服务(Unable to connect to Anthropic services)

原因是缺少跳过首次登录引导的字段。在 ~/.claude.json(Windows 为 C:\Users\<你的用户名>\.claude.json)里补上:
JSON
"hasCompletedOnboarding": true,如果文件里已有其它字段,按 JSON 语法补好逗号,不要清空原有内容。

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

- 确认字段名是
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 工具可显著省额度。