Claude Code 常见报错与解决
下面是用中转站接入 Claude Code 时最常见的问题。大多数和网络、残留的旧配置有关;先确认接口地址是 https://api.t7api.com,末尾没有 /v1。
启动和登录
| 现象 | 原因 | 解决 |
|---|---|---|
第一次运行 claude 提示 Unable to connect to Anthropic services | Claude Code 第一次启动会先检查能否连上 Anthropic 官方,国内网络连不上 | 运行 一键配置命令,它会跳过这个检查;手动配过的也可以运行,原有配置会保留 |
Windows 运行 irm https://t7api.com/cc.ps1 | iex 报错,提示无法建立安全通道 | 较老的 Windows 默认没开 TLS 1.2 | 先运行 [Net.ServicePointManager]::SecurityProtocol = 'Tls12' 再运行那行命令;还不行用 接入教程 里的整段粘贴版 |
| 还是要求登录 Anthropic 账号 | 配置没生效:JSON 写错,或有残留的官方登录 | 检查 settings.json 只有一对最外层大括号;在 Claude Code 里 /logout 后重启 |
/status 显示的不是本站地址,或提示 Detected a custom API key | 电脑里还留着以前别家中转的 ANTHROPIC_API_KEY 等环境变量 | 再运行一次一键配置命令,它会清掉旧变量;macOS / Linux 还要删掉 ~/.zshrc、~/.bashrc 里 ANTHROPIC_ 开头的行 |
| VS Code 插件仍要求登录 | 插件的登录检查读不到 settings.json 的 env | 在 VS Code 设置里加 claudeCode.environmentVariables,见 配置教程 |
请求出错
| 现象 | 原因 | 解决 |
|---|---|---|
401 / 令牌无效 | 密钥复制错了,或已被删除 | 到本站「API 密钥」重新复制,注意前后不要带空格 |
| 额度不足 / 余额不足 | 账户余额或这个密钥的额度上限用完了 | 到「钱包」用微信或支付宝充值,或调高该密钥的上限 |
429 / 请求过于频繁 | 触发限流 | 稍等再试 |
| 无可用渠道 / model not found | 用了本站没开放的模型 | /model 换成 模型价格 页里有的模型 |
| 连接超时 | 地址写错或网络问题 | 地址必须是 https://api.t7api.com,末尾不要带 /v1 |
ECONNREFUSED,但浏览器能打开网站 | 本机代理或防火墙拦住了命令行 | 设置环境变量 HTTPS_PROXY 指向你的代理,比如 http://127.0.0.1:7890;或把本站设为直连 |
安装问题
npm 无法识别、禁止运行脚本、claude native binary not installed、No suitable shell found 等安装阶段的问题,见 Claude Code 国内安装教程。
还解决不了
发邮件到 t7api@outlook.com,写明本站用户名和问题现象,最好附截图。本站「使用日志」里能看到每次请求的模型、tokens 和扣费,排查时一起附上更快。