Claude Code 第三方 API 直连配置

本页说明如何直接配置 Claude Code。需要通过桌面应用统一管理 Claude 和 Codex 服务商时，请使用 CC Switch 教程。

开始前

• 安装 Claude Code，并确认 claude 命令可以运行。
• 创建一个允许使用目标 Claude 模型的 Relyven Key。
• 客户端要求填写模型时，从控制台复制准确的模型 ID。

配置第三方 API

export ANTHROPIC_BASE_URL=https://api.relyven.com
export ANTHROPIC_AUTH_TOKEN="$RELYVEN_API_KEY"
claude

Base URL 填写服务根地址，不要添加 /v1。Claude Code 会自行拼接 Anthropic Messages 路径。

请把 Key 放在环境变量或密钥管理器中，不要写入代码仓库、截图或共享提示词。

验证连接

新建 Claude Code 会话，先发起一次简短请求，再让它读取一个小型本地项目并触发工具调用。文本回复只能证明基础生成成功，不能证明工具事件正常。

切换已有长会话前，先备份客户端配置。第一次验证使用新会话，避免旧服务商状态影响结果。

Relyven 不主动改写支持的 system、tools、thinking、cache_control、max_tokens 和流式字段；具体组合仍以所选模型实际支持为准。

常见问题

结果	检查项
401	ANTHROPIC_AUTH_TOKEN 和 Base URL
403	当前 Key 的模型权限
400	请求字段、模型能力、上下文上限和客户端版本
429	余额、Key 限额和 retry-after
文本正常但工具失败	工具 Schema 和 Anthropic 事件类型
修改后未生效	新开终端并新建 Claude Code 会话

原始接口示例见 Anthropic Messages，通用错误见 API 错误码与排障。