Waihub Docs

手动配置 Claude Code ​

参考页面里的做法，Claude Code 更适合通过配置目录下的 settings.json 进行手动接入。将 Waihub 接入时，重点是把认证 token 和请求地址指向 Waihub。

提示

如果你不想手工维护 settings.json，仍然建议优先走 CC-Switch。只有在你明确需要手动控制配置文件时，再使用本页方法。

配置前准备 ​

  • Waihub 生成的 API Key
  • Waihub 提供的 Claude 兼容地址
  • Claude Code 要使用的模型名，例如 claude-sonnet-4-6

第一步：打开 Claude Code 配置目录 ​

根据系统选择对应命令，打开 Claude Code 的配置目录。

bash
start "" "%USERPROFILE%\\.claude"

第二步：创建 settings.json ​

在该目录下手动创建 settings.json，写入类似下面的内容：

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://waihub.top",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

第三步：填写 API Key 与地址 ​

其中：

  • ANTHROPIC_AUTH_TOKEN 填你在 Waihub 后台生成的 ApiKey
  • ANTHROPIC_BASE_URL 填 Waihub 实际提供的 Claude 渠道地址

如果 Waihub 后续提供多个 Claude 渠道，也建议按不同渠道分别记录清楚地址，避免混淆。

注意

这里填写的是 Claude 渠道的地址，不要误填成 OpenAI 或 Gemini 的兼容地址。地址填错时，最常见的报错就是 401 或 404。

第四步：启动 Claude Code 验证 ​

保存文件后，在终端运行：

bash
claude

发起一轮简单对话，确认配置是否生效。

排查方向 ​

如果配置后无法调用，优先检查：

  1. settings.json 是否放在 ~/.claude 目录下
  2. ANTHROPIC_BASE_URL 是否填写为 Waihub 的完整地址
  3. API Key 是否已启用且没有复制空格
  4. 修改配置后是否重新启动了 claude

Waihub Documentation

Copyright © 2026 Waihub