在 Claude Code 中配置 Sub2API

将 Sub2API 设置为 Claude Code 的 API 后端，通过环境变量或 CC-Switch 工具快速完成配置。

Claude Code 是 Anthropic 推出的终端 AI 编程助手。你可以将 Sub2API 配置为 Claude Code 的 API 后端，从而通过 Sub2API 访问 Claude 模型以及其他支持的模型。本文介绍两种配置方式：环境变量法和 CC-Switch 工具法。

前置条件

• 已安装 Claude Code
• 已获取 Sub2API API Key（详见 创建 API Key）

配置方式

环境变量配置

通过设置环境变量将 Sub2API 指定为 Claude Code 的 API 后端：

export ANTHROPIC_API_KEY="your_sub2api_key"
export ANTHROPIC_BASE_URL="https://sub2api.ruilinlu.com"

设置完成后，直接运行 claude 命令即可使用 Sub2API：

# 检查版本
claude --version

# 进入交互模式
claude

Claude Code 调用的是 Claude 模型。在 Sub2API 中，Claude 模型的名称可能与官方名称不同。

建议先查看 Claude 模型列表 了解 Sub2API 中可用的 Claude 模型名称及对应关系。

CC-Switch 工具配置

如果你使用 CC-Switch 工具管理 Claude Code 配置，可以参考 CC-Switch 配置指南 快速完成设置。

CC-Switch 可以帮你：

• 一键切换不同的 API 后端
• 管理多个 API Key
• 快速测试连接状态

验证连接

配置完成后，执行以下命令验证是否正常工作：

# 检查 Claude Code 版本
claude --version

# 发送简单提示词测试
claude "你好，请介绍一下自己"

故障排查

提示 401 认证失败

• 确认 ANTHROPIC_API_KEY 已正确设置为 Sub2API API Key
• 参考 401 错误排查

模型不可用错误

• 确认请求的 Claude 模型名称在 Sub2API 中可用
• 查看 Claude 模型列表 获取正确的模型名称

提示无法连接 API

• 确认 ANTHROPIC_BASE_URL 已设置为 https://sub2api.ruilinlu.com
• 参考 Base URL 配置