My Docs

Appearance

Claude Code 配置教程 ​

本教程使用兼容接口将 Claude Code 接入服务。

1. 创建 API 密钥 ​

登录 控制台，在「API 密钥」中创建或选择密钥，并将密钥分组设置为 Claude Code 逆向 分组。

WARNING

请使用自己的 API 密钥。不要把真实密钥粘贴到文档、代码仓库、截图或公开聊天中；如已泄露，请立即在控制台删除并重新创建。

2. 创建或编辑 settings.json ​

配置文件位置：

系统路径
Windows%USERPROFILE%\.claude\settings.json
macOS / Linux~/.claude/settings.json

如果 .claude 目录或 settings.json 不存在，先创建它们。然后将以下内容写入文件，并将 YOUR_API_KEY 替换为你自己的 Claude Code 逆向分组密钥：

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://blackaicoding.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

如果文件已包含其他设置，请将上面的 env 字段合并到现有 JSON 中，不要重复创建两个 env 字段。

自动配置（Windows） ​

下载 Claude Code Windows 配置脚本（.bat）

双击脚本，或在命令提示符中运行：

bat
configure-claude-code.bat

脚本会要求输入 API 密钥，自动创建或更新 %USERPROFILE%\.claude\settings.json。已有的其他 JSON 设置会被保留，只更新 Claude Code 所需的 env 字段。

自动配置（macOS / Linux） ​

下载 macOS / Linux 配置脚本（.sh）

在下载目录运行：

bash
chmod +x configure-claude-code.sh
./configure-claude-code.sh

脚本会安全提示输入 API Key，自动创建或合并 ~/.claude/settings.json。需要 Node.js 或 Python 3 之一来处理已有 JSON 配置。

3. 启动 Claude Code ​

保存文件后，重新打开终端并运行：

bash
claude

Claude Code 会读取上述环境变量并使用该接口。

常见问题 ​

提示认证失败 ​

检查密钥是否完整复制、密钥分组是否选择 Claude Code 逆向，然后完全退出并重新启动 Claude Code。

Windows 上找不到配置文件 ​

在资源管理器地址栏输入 %USERPROFILE%\.claude。若目录不存在，手动新建 .claude 文件夹，再新建 settings.json。

macOS 上如何打开配置目录？ ​

在终端中执行：

bash
mkdir -p ~/.claude
open ~/.claude

Linux 可以用下面的命令创建目录：

bash
mkdir -p ~/.claude