Lanjunex · 客户端接入 · 更新于 2026-10-29

Claude Code 如何接入 Lanjunex API 中转

本教程使用 Claude Code CLI 的网关配置，将 Claude 请求发往 Lanjunex 的 Anthropic Messages 兼容接口。关键是使用根地址、本站 Key 和当前授权的 Claude 模型；无需覆盖整份客户端配置。

地址与协议：ANTHROPIC_BASE_URL=https://lanjunex.com，客户端请求 /v1/messages。Base URL 不加 /v1，也不填写完整 /messages 路径。本教程适用于 CLI；其他客户端请查看完整接入指南。

运行前准备

安装对应 CLI，并先在终端运行版本命令。以下命令面向 macOS / Linux 的 Bash 或 Zsh，隐藏输入 Key 使用 Python 3；先确认 python3 --version 可用。Windows 可先使用CC Switch 导入入口，不要把本页 Shell 命令直接粘进 PowerShell。
进入API Key 页面创建或选择有效 Key，检查其额度、过期时间与访问限制。Key 是本站密钥，不是网页登录密码或其他平台的 Key；请勿放进仓库、截图或公开聊天。
在模型广场查看精确 Model ID 与协议，再确认所用 Key 的实际授权目录。下面的型号是示例，不保证每把 Key 都开放；运行前替换为当前获准、支持该协议的型号。
选一个允许客户端读取的工作目录再启动。首次验证只发送简单文字，不要直接把私有项目交给新连接；后续文件、工具权限由你逐项决定。

运行 claude --version 确认 CLI 已安装；安装方式参考Claude Code 官方安装说明。

临时配置并启动

先把命令里的 claude-sonnet-5 替换成当前 Key 获准的 Claude Messages 型号。粘贴整段后，按隐藏提示输入 Key；Key 不会作为命令字面量写入 Shell 历史。

(
  LANJUNEX_API_KEY="$(python3 -c 'import getpass; print(getpass.getpass("Lanjunex API Key: "))')" || exit 1
  test -n "$LANJUNEX_API_KEY" || exit 1
  export LANJUNEX_API_KEY
  unset ANTHROPIC_API_KEY
  export ANTHROPIC_BASE_URL='https://lanjunex.com'
  export ANTHROPIC_AUTH_TOKEN="$LANJUNEX_API_KEY"
  claude --model 'claude-sonnet-5'
)

ANTHROPIC_AUTH_TOKEN 以 Bearer 方式传入本站 Key；清除子 Shell 的 ANTHROPIC_API_KEY 是为了避免两种凭据冲突。启动后先运行 /status，确认显示的 Anthropic base URL 为 https://lanjunex.com、鉴权来源是本次环境变量，再发送消息。

已有 Claude settings 的 env 或托管设置可能影响实际连接；如果 /status 显示其他地址，先检查你原有设置，勿继续发送任务。后台 Agent 和其他客户端需要单独配置。

核对结果与费用

发送一次“只回复 OK”，等待完整结束，再到用量记录核对时间、模型、输入输出与费用，并在余额收支核对账本。启动成功或看到部分流式文字不等于任务完整成功。模型调用会按实际用量计费；不要仅凭回复长度估算金额。

超时或断流时先查用量和已收到的内容，再决定是否重试；不要反复发送同一个任务。核对配置和创建 Key 本身不产生模型调用费用。

退出与恢复原连接

在 Claude Code 中运行 /exit。命令最外层括号创建的子 Shell 随之结束，本段设置的地址与凭据不会留在父终端；原有登录和配置文件没有被这段命令覆盖。按原启动方式重新打开客户端，并用 /status 核对原连接。

若你另外通过 CC Switch 切换过线路，需在 CC Switch 选择原线路后重新启动；若另外修改过 settings 或 Shell 启动文件，则恢复那些改动。停止使用某把本站 Key 时到密钥页单独停用；退出 CLI 不会撤销 Key。

按具体错误排查

错误	先检查什么
401 / INVALID_API_KEY	是否输入本站有效 Key，是否停用，客户端是否读到了正确鉴权来源。不要把完整 Key 放进报错截图。
404 / 模型不存在	复制精确 Model ID，确认 Key 授权与协议；检查是否重复添加了 /v1 或填了完整接口路径。
403 / INSUFFICIENT_BALANCE	核对账户余额；API_KEY_EXPIRED / ACCESS_DENIED 则分别检查过期、IP 与账号权限，不能一概当作余额问题。
429 / quota / usage limit	核对 Key 额度、周期限额与并发。有 Retry-After 时按提示等待，降低并发。
400 / 参数或协议不兼容	确认版本、所选协议和模型；保留脱敏 message、code 和请求标识，勿通过随意删除必填参数反复重试。
502 / 503 / 超时或断流	先查用量、结束原因与部分结果。稍后重试或主动选择其他获准模型，不连续重放。
TLS / 连接错误	核对 HTTPS 地址与本机网络；不要关闭证书验证。

完整错误语义见错误码指南；模型拒答见拒答说明。联系客服提供时间和时区、客户端版本、模型、接口路径、脱敏错误与请求标识，不提供完整 Key。

配置依据

参数依据 Claude Code 官方网关连接说明。