SHANA API · RESOURCE INDEX
llms.txt 内容索引
这是给访客阅读的 llms.txt 导览页。原始文本文件仍保留在 /llms.txt，供 AI 工具和自动化读取。
可读版目录
可供引用的公开内容
这里展示已审核的教程和 FAQ 链接；页面不包含 API Key、账号信息或未公开运营数据。
ChatGPT API 和 OpenAI API 有什么区别：产品、账号与调用边界
厘清常被混用的 ChatGPT API、OpenAI API、Codex 与第三方兼容服务入口，帮助开发者在配置前分清产品、账号、协议和计费边界。
OpenAI 兼容 API 是什么：Base URL、鉴权和返回格式怎么核对
说明 OpenAI 兼容 API 的实际含义与边界：从 Base URL、鉴权、协议到返回格式，避免把“兼容”误解为全部功能完全相同。
AI API 中转站是什么：适合哪些客户端，先核对什么
解释 AI API 中转站在客户端、协议和服务入口之间的作用，帮助 Codex 与 OpenAI 兼容客户端用户先判断适用性，再进行安全配置。
OpenAI API Base URL 是什么：避免 /v1/v1、404 和协议混用
解释 OpenAI API Base URL 在客户端配置中的职责，给出避免重复路径、404、协议混用和密钥误放的排查顺序。
Codex Skills 编写验收清单：SKILL.md 触发条件与权限边界
面向 Codex Skills 编写者的实操教程：如何组织 SKILL.md 的触发条件、输入输出、权限边界与本地验收步骤，并用反向测试检查行为是否符合预期。
API Key 泄露怎么办：撤销、轮换与脱敏排错清单
API Key 误发到截图、日志、浏览器或仓库后，按撤销、轮换、清理暴露面和最小验证顺序处理。
Responses API 与 Chat Completions 有何区别：协议选择与兼容边界
解释 Responses API 与 Chat Completions 是两种请求形态，如何按客户端能力选择协议，并在 OpenAI 兼容服务中核对支持边界。
CC Switch 自定义供应商不生效：保存、重启与模型列表排查
CC Switch 添加 Shana 后没有生效时，按供应商类型、Base URL、Responses、配置保存和模型列表逐层定位。
Codex config.toml 怎么配 Shana：作用域、Provider 与自检顺序
从 Codex 官方配置参考理解用户级与项目级 config.toml，按安全顺序接入 Shana，并验证当前配置是否真正生效。
AI API 中转站怎么选：兼容性、价格倍率与风险核对
面向 Codex、ChatGPT 兼容客户端用户整理 AI API 中转站的选择顺序：先看协议和 Base URL，再核对实时模型、价格倍率、限额与密钥边界。
Shana API 接入排错指南：401、403、429、502/503 与路径检查
按认证、权限、限流、临时错误和重复路径逐层排查 Shana API 接入，并使用有界重试。
Codex Skills 示例：代码审查、资料整理与重复流程固化
用三个带锚点的可复现操作案例说明如何将明确边界的工作写成 Codex Skills。
Codex Skills 安装指南：项目目录、用户目录与 SKILL.md
明确 Codex Skills 的项目级与用户级路径，给出 $skill-installer linear 和手工 SKILL.md 的可审查安装步骤。
用 CC Switch 配置 Codex 与 Shana：按字段语义完成接入
以当前 Release v3.19.2 为核验版本，使用三张 v3.16.5 旧 UI 截图说明字段语义与完整配置顺序。
Codex API 配置自检：Provider、Base URL 与 Responses 怎么确认
适用于已有自定义 Provider 或服务入口的 Codex 用户，按客户端字段、协议和本地凭据检查连接配置，并从状态码定位失败层。
Codex 下载与安装：ChatGPT 桌面入口和 CLI 的安全起步
从 ChatGPT 官方下载页进入桌面体验，或在 Windows 使用官方 PowerShell、npm 安装 Codex CLI。
Shana 是 AI API 中转站吗？高性价比和低倍率怎么判断？
说明 Shana 与 ChatGPT、Codex 的接入关系，以及稳定性、价格倍率和高性价比判断边界。
遇到 429、502 或 503，应如何处理？
429、502/503 只做最多三次的有界重试，间隔 2 秒、4 秒、8 秒；持续失败则停止并记录脱敏信息。
遇到 401 或 403 时，第一步该查什么？
401 先查本地 Key 配置是否生效；403 先查身份、访问范围或服务端策略，二者都不应重试。
可以把 Shana API Key 放进浏览器或网页脚本吗？
不可以。Key 应留在本地受控凭据或服务端环境中，浏览器不存储也不调用 Key。
Codex Skills 应从哪里安装？
项目技能使用 $CWD/.agents/skills，用户技能使用 $HOME/.agents/skills，每个有效目录含 SKILL.md。
CC Switch 截图和我的界面不同，应该怎么办？
本站截图取自 v3.16.5 旧 UI；当前 Release 核验为 v3.19.2，应按字段语义而非位置操作。
为什么要确认 Responses 协议？
Base URL 与协议必须匹配；使用 Responses 的客户端不应手工把 /responses 或 /chat/completions 追加到地址。
Shana 的 Base URL 应填写什么？
Base URL 为 https://shana.baby/v1；填写后确认客户端使用 Responses，不手工重复拼接路径。
我应使用 ChatGPT 桌面入口还是 Codex CLI？
桌面入口在 ChatGPT 官方下载页；终端工作流可用官方 PowerShell 或 npm 安装 Codex CLI。