Claude Code（终端）

通过配置文件在电脑上安装和接入 Claude Code CLI（命令行工具）。

Claude 走 Anthropic 协议，ANTHROPIC_BASE_URL 填 https://aicode.cat，不要加 /v1。密钥写在 ANTHROPIC_AUTH_TOKEN，不要写进 ANTHROPIC_API_KEY（脚本里会把 ANTHROPIC_API_KEY 留空）。

先到创建 API Key 拿一把 Key。模型名以主站控制台为准。

按系统分步的旧页仍保留深链：Windows、macOS、Linux / WSL2。

遇到问题可以把本页内容和报错截图交给 AI 助手，按它给的命令排查；仍不行先看常见报错。

macOS

1. 安装 Node.js

先确认电脑上有 Homebrew。没有的话，打开官网复制那一行安装命令即可。

WARNING

安装 Homebrew 时有一部分资源在海外，需要能访问外网（例如开 TUN 代理）。

复制 Homebrew 安装命令

装好之后用 Homebrew 安装 Node.js（已经装过可以跳过）：

bash

brew install node

用 Homebrew 安装 Node

验证安装：

bash

node --version

macOS 检查 Node 版本

WARNING

Node.js 必须是 18 及以上。版本过低时，可以先让 AI 给你收集系统信息的命令，再按它的指引升级。

2. 安装 Claude Code CLI

新建终端，执行：

bash

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

macOS 安装 Claude Code

3. 创建配置文件

把 在这里替换成你的_API_KEY 换成密钥页里的 Key，新建终端执行：

bash

# 目标目录：~/.claude
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_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"

用下面命令核对配置，一定要替换 API Key，且 ANTHROPIC_BASE_URL 是 https://aicode.cat（不要 /v1）：

bash

cat "$HOME/.claude/settings.json"

macOS 核对 settings.json

4. 验证安装

重新打开终端或 IDE，运行：

bash

claude

如果遇到下面的提示，选第一个 Yes，回车。

macOS 授权当前文件夹

在对话框里输入「您好！」。能正常回复即配置成功。调用记录到密钥页查看。

macOS 验证对话

Linux

1. 安装 Node.js

Debian / Ubuntu 可用（已经装过可以跳过）：

bash

curl -fsSL https://deb.nodesource.com/setup_lts.x | bash -
apt-get install -y nodejs

验证安装：

bash

node --version

Linux 检查 Node 版本

WARNING

Node.js 必须是 18 及以上。版本过低时，可以先让 AI 给你收集系统信息的命令，再按它的指引升级。

2. 安装 Claude Code CLI

bash

npm install -g @anthropic-ai/claude-code

Linux 安装 Claude Code

若只提示可以升级 npm，忽略即可。其它报错可以问 AI，或看常见报错。

3. 创建配置文件

把 在这里替换成你的_API_KEY 换成你的 Key，新建终端执行：

bash

# 目标目录：~/.claude
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_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"

核对配置：

bash

cat "$HOME/.claude/settings.json"

ANTHROPIC_BASE_URL 必须是 https://aicode.cat（不要 /v1）。

Linux 核对 settings.json

4. 验证安装

重新打开终端或 IDE，运行：

bash

claude

如果遇到授权提示，选第一个 Yes，回车。

授权当前文件夹

在对话框里输入 hi。能正常回复即配置成功。失败先看常见报错。

Linux 验证对话

以下是 Windows

Windows

1. 安装 Node.js / Git

前往 Node.js 官网下载并安装 LTS 版本（已经装过可以跳过）。

验证安装：

powershell

node --version

出现类似下面的版本号，说明 Node 已经装好：

Windows 检查 Node 版本

WARNING

Node.js 必须是 18 及以上。版本过低时，可以先让 AI 给你收集系统信息的命令，再按它的指引升级。

前往 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/

Windows 安装 Claude Code

如果遇到「在此系统上禁止运行脚本」：

以 管理员身份 运行 PowerShell
执行：Set-ExecutionPolicy Unrestricted
输入 Y 确认后重试安装命令

3. 创建配置文件

Key 在用户仪表盘密钥页创建。把 在这里替换成你的_API_KEY 换成你的 Key，在 PowerShell 里执行：

powershell

# 目标目录：C:\Users\<you>\.claude
$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_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"

ANTHROPIC_BASE_URL 必须是 https://aicode.cat（不要 /v1）。

Windows 写入 settings.json

4. 验证安装

重新打开 PowerShell 或者 IDE，运行：

powershell

claude

如果遇到下面的提示，选第一个 Yes，回车。这是在授权 Claude Code 读写并执行当前文件夹里的代码。

Windows 授权当前文件夹

在对话框里输入「您好！」。能正常回复即配置成功。调用记录到密钥页查看。

Windows 验证对话

常见问题

1. 无法连接到 Anthropic 服务

错误类似：Unable to connect to Anthropic services / Failed to connect to api.anthropic.com。

无法连接到 Anthropic 服务

在 ~/.claude.json（Windows 是 C:\Users\<你的用户名>\.claude.json）里加上：

json

"hasCompletedOnboarding": true,

注意这行末尾有逗号；如果加在 JSON 中间，逗号按 JSON 规则补齐。文件里如果已经有其它字段，不要整文件覆盖。

在 .claude.json 里打开 hasCompletedOnboarding

Invalid API key · Please run /login

环境变量没配对。按前面的脚本重写配置，重点检查：

ANTHROPIC_AUTH_TOKEN（完整 Key，不是 ANTHROPIC_API_KEY）
ANTHROPIC_BASE_URL 为 https://aicode.cat（不要 /v1）

改完后新开终端或彻底重启 IDE 再运行 claude。

3. 401 `{"error":"Invalid API key"}`

401 Invalid API key

Key 填错了。到密钥页重新生成一把，再按前面的教程重写 ANTHROPIC_AUTH_TOKEN。

Claude Code（终端） ​

macOS ​

1. 安装 Node.js ​

2. 安装 Claude Code CLI ​

3. 创建配置文件 ​

4. 验证安装 ​

Linux ​

1. 安装 Node.js ​

2. 安装 Claude Code CLI ​

3. 创建配置文件 ​

4. 验证安装 ​

Windows ​

1. 安装 Node.js / Git ​

2. 安装 Claude Code CLI ​

3. 创建配置文件 ​

4. 验证安装 ​

常见问题 ​

1. 无法连接到 Anthropic 服务 ​

2. 无效的 API 密钥 · 请运行 /login ​

3. 401 {"error":"Invalid API key"} ​

Claude Code（终端）

macOS

1. 安装 Node.js

2. 安装 Claude Code CLI

3. 创建配置文件

4. 验证安装

Linux

1. 安装 Node.js

2. 安装 Claude Code CLI

3. 创建配置文件

4. 验证安装

Windows

1. 安装 Node.js / Git

2. 安装 Claude Code CLI

3. 创建配置文件

4. 验证安装

常见问题

1. 无法连接到 Anthropic 服务

2. 无效的 API 密钥 · 请运行 /login

3. 401 `{"error":"Invalid API key"}`