主题
常见问题速查
按主题分组的高频问题。每条给一句话答案和深入阅读的链接，详细排查流程见《通用排错手册》。
1. 接入与配置
Q：API 地址应该填什么？ 填控制台或客户端接入页显示的接口地址，不要把控制台网址直接当 API 地址，也不要自行追加路径。概念解释见《模型、API 与客户端》。
Q：令牌和 API Key 是一回事吗？ 是。都是调用接口的凭据，格式类似 sk-xxxxxxxx。令牌要在控制台创建并选对分组，见《STJAPI 账户与网络设置》。
Q：客户端报 401 怎么办？ 按顺序检查：令牌是否复制完整、是否已过期或被撤销、当前客户端启用的是不是目标配置。多数 401 是复制不完整或用错了平台的令牌。
Q：报模型不存在（404）？ 模型名必须写接口提供的完整 ID，并确认令牌分组包含该模型。分组与模型不匹配是新手最常见的 404 原因。
Q：需要开代理吗？ STJAPI 国内外均可直连，不需要额外网络环境。如果必须用代理，把 ai.stjapi.com 加入直连规则，见《STJAPI 账户与网络设置》。
2. 客户端与工具
Q：Claude Code、Codex、Cursor 选哪个？ 看工作习惯：终端派选 Claude Code / Codex CLI，图形界面派选 Cursor，新手可以用 Codex 桌面版起步。对比见《AI 编程工具怎么选》。
Q：多个供应商的配置怎么管理？ 用 CC Switch 统一管理和一键切换，避免手动改配置文件。
Q：Agent 工具连不上或行为异常，先查什么？ 先确认调用链通不通（用一条最小请求验证），再查客户端配置。分层排错方法见《模型、API 与客户端》第 5 节。
Q：MCP 是什么，一定要配吗？ 不是必需品。MCP 给客户端扩展外部工具（数据库、文档库等），按需添加，见《Agent 与 MCP》；想把自己的内部能力做成 Server，见《实战：把一个查询能力做成 MCP Server》。
3. 模型与容量
Q：提示 "Selected model is at capacity" 是我配置错了吗？ 不是，这是服务端容量不足。等 1 到 3 分钟或切换模型重试，不要重装客户端，见《Codex 模型繁忙处理》。
Q：怎么挑一个能力相近的备用模型？ 按场景对照《主流模型对比与选型》第 2 节的表，并提前在分组里确认它可用。
Q：模型回答和官网演示差距大？ 演示往往选了最难的任务和最强的模型。先确认你的客户端用的是哪个版本，再用《主流模型对比与选型》第 3 节的实测法对比。
4. 成本与用量
Q：为什么消耗这么快？ 长上下文是大头：贴整个文件、整个日志、超长对话历史。先摘关键片段再发送，方法见《效率与省钱技巧》。
Q：怎么省钱？ 三件事收益最大：模型分级（简单任务用轻量模型）、利用缓存（重复前缀会被缓存，见《大模型缓存是什么》）、控制上下文（见《上下文管理实战》）。
Q：Token 是怎么算的？ 1 个英文单词约 1.3 个 token，1 个汉字约 1 到 2 个。输入和输出分开计费，详见《大语言模型是什么》第 2 节。
5. 安全与隐私
Q：把代码发给 AI 服务安全吗？ 取决于服务商条款和你的数据敏感度。公司代码、密钥、客户数据先脱敏或走本地方案，清单见《AI 使用安全清单》。
Q：令牌误发到群里/截图里了怎么办？ 立即到控制台撤销该令牌并创建新的，然后更新所有客户端配置。
Q：Agent 自动执行命令有风险吗？ 有。按任务给最小权限、关键操作人工确认、执行前留好 Git 回滚点，做法见《AI 使用安全清单》。
6. 学习路径
Q：完全零基础，从哪篇开始？ 从《新手从这里开始》进入，按四关路线走，见《从零到驾驭 AI：成长路径》。
Q：想开发自己的 AI 应用呢？ 先完成《第一个 AI 编程项目》建立手感，再进入《AI 应用开发》和《Agent 工程》专题。