先当中转排错：Claude Code 报错 80% 是 Key、分组、额度，不是 MCP。按“状态码 → 控制台 → 最小请求复现 → 客户端”的顺序排查，比反复重装快得多。
1. 快速排查顺序
- 记下完整报错和 HTTP 状态码，终端日志先截屏保留。
- 登录词元控制台，核对三件事：Key 是否有效、密钥分组是否包含该模型、余额是否充足。
- 用一条最小 curl 请求复现，绕开 Claude Code 本身，确认问题在中转侧还是客户端侧：
curl https://www.gpt345.com/v1/messages -H "x-api-key: sk-你的词元Key" -H "anthropic-version: 2023-06-01" -H "content-type: application/json" -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'curl 能通而 Claude Code 不通，问题在客户端配置；curl 也报错，按状态码查中转侧。
2. 启动失败与闪退
- 环境变量只对当前终端生效，新开终端要重新 export；Windows 用户注意系统变量与 PowerShell 会话的区别。
- ANTHROPIC_BASE_URL 填
https://www.gpt345.com，不要自己加/v1，SDK 会自动拼接。 - 启动后 20 秒内退出：抓退出码和最后一条 HTTP 记录，通常是 Key 缺字或 Base URL 拼错，不要反复重装 CLI。
- 升级 CLI 后第一次报错，先确认 base_url 没被默认值改回官方入口。
3. 状态码与对照表
| 状态码 | 含义 | 处理 |
|---|---|---|
| 401 | Key 缺字、格式不对或不是 Bearer/x-api-key 头 | 重新复制完整 Key，检查请求头字段名 |
| 403 | 当前分组没有这个模型 | 换分组，或换该分组可用的模型 ID |
| 429 | 额度耗尽或并发超限 | 充值或降低并发，退避后重试 |
| 529 / 5xx | 上游繁忙 | 缩短上下文，换时间窗再试，不要立刻重试 |
429 不是封号：先看控制台余额和用量曲线，再看是不是并行会话太多。
4. 模型与权限
5. 响应缓慢与超时
- 首字慢：换一条短请求对比，排除网络和线路；国内网络建议直连，不要套代理。
- 生成慢：输出上限设得太大，max_tokens 按需给。
- VSCode 内 60 秒超时是插件默认值，处理方式见VSCode 超时实战。
6. 日志与求助
求助前准备好四样信息：发生时间点、模型 ID、HTTP 状态码、控制台对应的 request ID。客服 QQ 49098022 或 Telegram 群组。不要把完整 Key 和整段仓库代码贴进群。
7. 常见问题
官网能用，中转不能？
两套凭证。官网登录态和中转 Key 不互通，词元只认本站 Key。
换了新 Key 还是 401？
确认复制时没带空格、请求头字段是 x-api-key 或 Authorization: Bearer，且 Key 属于当前分组。
提示 model not found？
模型 ID 拼写和分组权限二选一出问题。先到模型广场核对 ID 原文，再查分组。