快速结论

设置 ANTHROPIC_BASE_URL=https://api.sublyx.org、ANTHROPIC_API_KEY 和 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1，再用 claude -p 指定一个当前可用模型。这里的 Base URL 不带 /v1。

准备工作

  • 安装并确认 claude 命令可以运行。
  • 在 Sublyx 控制台创建独立 API Key。
  • 从 模型列表复制一个当前可用的 Claude 模型 ID。

具体配置

macOS、Linux 或兼容 Shell 可在当前终端执行：

export ANTHROPIC_BASE_URL=https://api.sublyx.org
export ANTHROPIC_API_KEY=your-sublyx-key
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

PowerShell 可使用：

$env:ANTHROPIC_BASE_URL = "https://api.sublyx.org"
$env:ANTHROPIC_API_KEY = "your-sublyx-key"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

这些设置默认只影响当前终端会话。需要长期使用时，应写入受保护的用户级环境配置，而不是项目仓库。

最小验证命令

claude -p "只回复 OK" --model YOUR_CLAUDE_MODEL_ID

若要先验证兼容接口本身，可按 Claude Messages API 指南发送最小 curl 请求。命令成功但交互模式失败时，再检查 Claude Code 的本地认证状态和环境变量。

常见错误

现象处理方法
Auth conflict只保留 ANTHROPIC_API_KEY，移除当前会话中冲突的 ANTHROPIC_AUTH_TOKEN。
401 Unauthorized检查 Key 是否正确、过期或已停用，并确认变量在同一终端生效。
unsupported model从模型列表复制准确 ID，不使用未确认的别名。
404确认 ANTHROPIC_BASE_URL 是 https://api.sublyx.org，不要追加 /v1。
insufficient balance检查账户余额，不要对同一请求持续重试。

安全说明

不要在命令历史、脚本、日志或仓库中硬编码真实 Key。为不同设备和项目创建不同 Key，便于撤销和审计；共享终端使用完后清除环境变量。更多接入参数见 Sublyx 文档，限流处理见 AI API 429 指南。

运行第一条 Claude Code 请求

创建 Key、确认模型 ID，并在当前终端完成最小验证。

查看接入文档选择 Claude 模型创建 API Key