客户端接入总览

安装 Node.js（如尚未安装）

Claude Code 需要 Node.js 18 或更高版本。先检查已安装的版本：

node -v

如果显示的版本 ≥ 18.0.0，请直接跳到下一步。否则任选一种方式安装：

• 从 nodejs.org 下载官方安装包（推荐 LTS 版本）；
• 或使用 Homebrew：

brew install node

创建 API 密钥

打开 控制台 → 令牌 页，点击「添加令牌」，取一个易记的名称。Opus / Sonnet / Haiku / Fable 5.1 的「分组」可选 claude kiro 或 满血稳定claude；Fable 5 仅限 满血稳定claude，创建后复制 sk- 开头的完整密钥。

安装 Claude Code 客户端

在终端中运行全局安装命令：

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

安装包会在 PATH 中注册 claude 命令。如果安装后找不到该命令，请重启终端。网络超时可改用国内镜像，见下方常见问题。

创建 settings.json

客户端从 ~/.claude/settings.json 读取配置。如果 ~/.claude/ 目录尚不存在，先运行一次 claude 让它自动创建（首次启动的登录提示可直接 Ctrl+C 退出），然后写入以下内容：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://cc.yzzt.top",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

将 YOUR_API_KEY 替换为步骤 2 复制的密钥。建议收紧文件权限：

chmod 600 ~/.claude/settings.json

启动

重启终端以加载新配置，然后进入任意项目目录启动：

claude

看到欢迎横幅和提示符即接入成功。大功告成！

安装 Git Bash（推荐）

建议在 Git Bash 中运行 Claude Code——它提供类 Unix 的 Shell 环境，比 CMD 或 PowerShell 更可靠地处理路径和引号。

• 下载 Git for Windows，使用默认选项安装。

安装 Node.js（如尚未安装）

打开 PowerShell 或 Git Bash 运行：

node -v

如果显示的版本 ≥ 18.0.0 则已就绪。否则从 nodejs.org 下载 Windows 安装包（LTS，.msi），使用默认选项安装。

创建 API 密钥

打开 控制台 → 令牌 页，点击「添加令牌」。Opus / Sonnet / Haiku / Fable 5.1 的「分组」可选 claude kiro 或 满血稳定claude；Fable 5 仅限 满血稳定claude，创建后复制 sk- 开头的完整密钥。

安装 Claude Code 客户端

在 PowerShell、命令提示符或 Git Bash 中运行：

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

安装后请关闭并重新打开终端。网络超时可改用国内镜像，见下方常见问题。

创建 settings.json

Windows 上配置文件位于 C:\Users\<你的用户名>\.claude\settings.json。如果 .claude 文件夹尚不存在，先运行一次 claude 让它自动创建，然后写入：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://cc.yzzt.top",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

将 YOUR_API_KEY 替换为步骤 3 的密钥。

启动

重启终端，进入任意项目目录运行：

claude

看到欢迎横幅和提示符即接入成功。

安装 Node.js（如尚未安装）

Claude Code 需要 Node.js 18 或更高版本。先检查：

node -v

如果 ≥ 18.0.0 请跳到下一步。否则按发行版安装：

# Ubuntu / Debian
sudo apt update && sudo apt install -y nodejs npm
# CentOS / RHEL / Fedora
sudo dnf install -y nodejs npm
# Arch Linux
sudo pacman -S nodejs npm

如以上均不适用，从 nodejs.org 下载官方二进制包（LTS）。

创建 API 密钥

打开 控制台 → 令牌 页，点击「添加令牌」。Opus / Sonnet / Haiku / Fable 5.1 的「分组」可选 claude kiro 或 满血稳定claude；Fable 5 仅限 满血稳定claude，创建后复制 sk- 开头的完整密钥。

安装 Claude Code 客户端

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

如遇 EACCES 权限错误，可加 sudo 前缀，或配置 npm 全局前缀到你有权限的目录。

创建 settings.json

客户端从 ~/.claude/settings.json 读取配置。如果目录尚不存在，先运行一次 claude 自动创建，然后写入：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://cc.yzzt.top",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

将 YOUR_API_KEY 替换为步骤 2 的密钥，并收紧权限：

chmod 600 ~/.claude/settings.json

启动

打开新的 Shell 以加载配置，然后运行：

claude

看到欢迎横幅和提示符即接入成功。