SDK 与客户端
Claude Code 接入指南(待验证)
配置 Claude Code 的网关地址与凭据,并按验收步骤检查连接。
准备
待验证。 本文配置已对照客户端文档与仓库示例,生产线路的端到端验收仍待完成。完成验收后再更新本状态。
准备已安装的 Claude Code CLI、iRouter 密钥,以及管理员确认支持 Claude Code 的 Anthropic Messages 模型与线路。使用 claude --version 记录客户端版本。
配置
安装与更新请使用客户端官方文档的说明。先完成环境准备,设置 iRouter 密钥,并保留已有客户端配置。
在启动 Claude Code 的终端设置网关地址和 Bearer 凭据,并将 <model-id> 替换为实际可用的模型 ID。Claude Code 使用网关根地址。
export ANTHROPIC_BASE_URL='https://gateway.irouter.io'
export ANTHROPIC_AUTH_TOKEN="$IROUTER_API_KEY"
export IROUTER_MODEL='<model-id>'
claude --model "$IROUTER_MODEL"其中 IROUTER_API_KEY 是事先保存在本机环境中的 iRouter 密钥。PowerShell 使用以下写法。
$env:ANTHROPIC_BASE_URL = 'https://gateway.irouter.io'
$env:ANTHROPIC_AUTH_TOKEN = $env:IROUTER_API_KEY
$env:IROUTER_MODEL = '<model-id>'
claude --model $env:IROUTER_MODEL验证
在 CLI 中使用 /status 核对地址和认证方式,然后发送一条简短消息。确认能够收到回复,并在 iRouter 用量明细核对模型与调用记录。线路验收还需要覆盖流式响应、工具调用及多轮会话,并记录客户端版本和模型 ID。
排查
认证失败时,检查启动进程是否继承了环境变量,以及既有登录或托管设置是否与网关配置冲突。模型或协议错误时,请管理员核对该线路的 Messages 接口和 Claude Code 兼容性。诊断记录中保留状态码与请求标识,凭据保存在本机。
参考
客户端环境变量、Bearer 认证和状态核对方法见官方网关指南。Claude Code 网关接入