Claude Code 接入 302API:原生接口与模型配置
配置 API 地址、Key 和默认模型,按平台启动 Claude Code,并在控制台核对调用与费用。
维护说明:2026-10-16 已核对本站接口文档与客户端官方配置文档;本页没有新增客户端付费调用测试。客户端升级可能改变行为,请先记录版本,再用小任务核对调用记录。
1. 准备 Key 和客户端
从 302API 控制台创建 Key,保存在本地环境变量 API302_KEY。这是本站密钥,不是 claude.ai 的订阅凭证。已安装客户端可运行 claude --version 记录版本;尚未安装请按 Claude Code 官方安装文档操作。
2. 设置原生接口和默认模型
macOS / Linux 在将要启动 Claude Code 的同一个终端执行:
export ANTHROPIC_BASE_URL="https://api.302api.com"
export ANTHROPIC_API_KEY="$API302_KEY"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5"
claude --model claude-sonnet-5-5Windows PowerShell:
$env:ANTHROPIC_BASE_URL = "https://api.302api.com"
$env:ANTHROPIC_API_KEY = $env:API302_KEY
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-5-5"
claude --model claude-sonnet-5-5地址填主域名,不在 ANTHROPIC_BASE_URL 后添加 /v1/messages。模型映射用于约束主任务和后台任务所用型号;不要只设置界面当前选择的一个模型。
如需持久化,将地址和模型映射合并进已有 ~/.claude/settings.json 的 env 对象;不要覆盖整个原配置文件。Key 留在系统环境变量或你已有的密钥管理方式中。
3. 确认调用真的经过本站
首次启动若提示使用检测到的 API Key,请确认使用本站 Key。会话中用 /model 核对当前模型,再发一条短问题。该操作会计费,准备好预算再执行。
然后到本站控制台核对模型 ID、请求时间、状态、输入/缓存/输出 Token 和结算金额。仅打开客户端、出现登录成功或显示模型名称,都不足以证明请求已成功。
缓存的写入和命中不是同一价格,详见 Sonnet 价格与缓存说明。原生请求格式见 API 文档。
常见配置问题
401 / 认证失败
检查 Key 是否有效、环境变量是否在当前进程可见,是否仍有旧的 ANTHROPIC_AUTH_TOKEN 或其他认证配置干扰。不要把完整 Key 发到聊天或公开日志。
403 / 后台任务模型不可用
检查三个默认模型映射及准确 ID,确认 Key 的模型范围。客户端更新后也要留意新引入的默认后台型号。
404 / 地址不对
检查 Base URL 使用 https://api.302api.com,完整原生请求由客户端拼接 /v1/messages。
有输出但调用记录不完整
等待请求结束并核对请求编号与结算状态;思考和工具调用会增加用量。异常时保留脱敏错误与客户端版本后联系本站。