跳到主要内容

Claude Code 配置

Orbit AI API 团队2026/07/11约 3 分钟阅读

本页是手动配置 Claude Code 的替代方案。优先推荐使用 AI Toolbox 的 Claude Code 教程，可通过图形界面管理供应商、模型和密钥。

1. 确认 Claude Code 已安装​

先完成 环境检查，再在终端执行：

claude --version

命令能返回版本号后继续。首次启动 claude 后会创建用户级配置目录。

2. 打开 Claude Code 配置目录​

  1. 按下 Win + R，输入以下内容并回车：
%USERPROFILE%\.claude
截图位置：Windows 运行窗口与 Claude 配置目录展示 Win + R、目录路径和 .claude 文件夹内容。
  1. 目录中如没有 settings.json，请手动创建后打开。settings.json 是 Claude Code 的主要用户级配置文件，可配置中转站地址、API Key，以及 hooks、plugins 等功能。

Linux 用户可在终端使用以下路径：

~/.claude

3. 写入 settings.json​

将以下内容写入 settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://orbitaiapi.site",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

Claude Code 使用 Anthropic 兼容格式，因此 Base URL 填主站地址，不要填写 OpenAI 兼容使用的 /v1 地址。

回顾 创建 API Key，在控制台创建可用于 Claude Code 的令牌，并将上方 YOUR_API_KEY 替换为实际 Key。不要将真实 API Key 提交到代码仓库或截图中。

4. 启动测试​

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

claude

进入交互界面后进行对话测试，能收到回复即表示配置成功。

:::danger 重要

如果配置完成后仍提示需要登录或无法连接到 Anthropic 服务，请先检查 settings.json 格式、API Key、Base URL 和令牌可用状态。进一步排查见 Claude Code 无法连接到 Anthropic 服务。

:::