体验中心
体验中国电信星辰大模型效果
| Agent | 现象 | 原因 | 解决办法 |
|---|---|---|---|
| 通用 | no available worker matches the requested model | 模型名称拼错 | 核对模型 ID:Xing4.0-29B-A4B、TeleChat3-438B-A24B、Xing4.1-Preview 大小写、数字、标点都不能错 |
| 401 Unauthorized 或 Authentication failed | API Key 错误或过期 | 回控制台重新确认 API Key,重新写入环境变量 | |
| 两个模型 API Key 混用报错 | 两个模型的地址和 API Key 不通用 | 分别申请,分别配置,不能把 29B 或285B 的 API Key 填到 438B 的配置中 | |
| 连接超时 / 无法访问 / 404 | API 地址填错或网络不通 | 核对地址是否为 https://api-maas.teleai.com.cn/v1 | |
| 请求返回 429 Too Many Requests | 短时间内请求过于频繁,被限流 | 等几秒后重试;持续出现就减少同时打开的会话数 | |
| 手打模型 ID 缩写报错 | 必须完整填写 Xing4.0-29B-A4B / TeleChat3-438B-A24B / Xing4.1-Preview | 复制完整模型id,粘贴模型名称至对应位置 | |
| Claude Code | npm 不是内部或外部命令(Windows) | Node.js 没装好或没重启终端 | 重装 Node.js(LTS 版),安装后关掉终端重新打开 |
| claude 不是内部或外部命令 | Claude Code 没装好或环境变量没生效 | 重新执行 npm install -g @anthropic-ai/claude-code;Win 确认注册表写入后新开终端 | |
| 配了环境变量但不生效(Windows) | 写入注册表后在旧终端不生效 | 关掉当前终端,重新打开一个新的 | |
| claude -p 验证模式下不支持连接测试 | CLI 验证模式限制 | 退出后重新启动 | |
| Win 提示 "程序'claude.exe'无法运行:拒绝访问" | Windows 权限问题 | 增加 sudo 前缀 | |
| OpenCode | 旧版本可能有兼容性问题 | 版本过低 | 升级到 ≥ v1.14.24 |
| v2 beta 安装命令不对 | v2 新命令名不同 | 用 opencode2 而非 opencode | |
| 模型 ID 不能自定义修改 | 只支持特定模型 ID | 只填 Xing4.0-29B-A4B / TeleChat3-438B-A24B / Xing4.1-Preview | |
| Codex | 0.80 版本 wire_api 兼容性问题 | API 协议变更 | 改为 "chat" |
| Windows 安装 PATH 不生效 | 进程间 PATH 不同步 | 关闭当前窗口重新打开 |