常见问题 FAQ

关于服务

你们和官方 Anthropic / OpenAI 是什么关系？

Shuro 是第三方 API 中转服务，跟 Anthropic / OpenAI 没有官方合作关系。我们通过合规的 API 转发为国内用户提供低延迟访问。

同一个 key 能用 Claude 也能用 GPT 吗？

可以。Shuro 一把 key 同时支持 Anthropic Messages API (/v1/messages) 和 OpenAI Chat Completions API (/v1/chat/completions) 双协议。

缓存命中率跟官方一样吗？

不保证一致，Shuro 上的实际命中率尚未实测。

待验证（TODO/VERIFY）

以下内容基于旧平台实测（2026-06），尚未在 Shuro 复测，仅供参考：号池架构天然会拉低命中率（不同账号缓存不共享），旧平台实测中转命中率在 40-80% 之间，官方稳定 90%+。

详见 提示缓存优化。

数据安全 / 隐私？

• 我们不存储对话内容
• 仅日志记录 token 用量、状态码、请求时间
• 不与第三方共享你的 prompt
• 建议敏感数据自行脱敏

（TODO/VERIFY：Shuro 服务条款页面待确认）

关于价格

怎么收费？

按 token 用量 × 分组倍率 × 模型倍率。分组倍率：Claude 分组 0.45X、Codex 分组 0.05X、AWS 分组 0.6X、默认分组 1X。具体以 控制台价格表 为准。

缓存读取怎么算？

按"缓存读取"单价计费（通常是 input 价的 10%）。这就是为什么有效缓存能省 5-10× 钱。

Subagent 调用收费吗？

收。Claude Code 内部的 subagent / 后台调用一样按 token 计费。所以建议把 Haiku 用于 subagent（模型倍率 Haiku 0.5 vs Opus 2.5，约便宜 5 倍，具体见价格表）。

关于配置

base_url 要不要带 /v1？

看客户端：

客户端	带 /v1 ?
Claude Code	❌ 不带
Codex CLI	✅ 带
Cursor	✅ 带
Cline (Anthropic 模式)	❌ 不带
Cline (OpenAI 模式)	✅ 带
OpenCode (Anthropic)	❌ 不带
OpenCode (OpenAI)	✅ 带

规律：Anthropic 协议不带，OpenAI 协议带。

环境变量名是什么？

客户端	环境变量
Claude Code	ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN
Codex CLI	OPENAI_API_KEY（或 ~/.codex/auth.json）
OpenAI SDK	OPENAI_API_KEY + OPENAI_BASE_URL
Anthropic SDK	ANTHROPIC_API_KEY + ANTHROPIC_BASE_URL

多个客户端能共用一把 key 吗？

能，且推荐。一把 key 同时给 Claude Code / Codex / Cursor / Cline 用，简化管理。

关于错误

一直 retry 怎么办？

旧平台上最常见的原因是 Opus + [1m] beta 头组合触发上游报错（改 model: "claude-opus-4-7"、去掉 [1m] 可绕过）。Shuro 的 Claude 模型目录标注原生 1M 上下文，是否仍需/仍忌 [1m] 头待验证（TODO/VERIFY）。详见 retry 死循环。

install.sh 显示 ✅ 但找不到 claude 命令？

安装阶段下载失败的假成功。详见 安装下载失败，改用 npm 路线最稳。

504 / 网关超时？

上游响应超 10s。改用更快的模型（Haiku）或延长 API_TIMEOUT_MS 环境变量。

关于安装

Node.js 版本要求？

Claude Code 和 Codex CLI 都要 Node.js ≥ 18。Ubuntu 22.04 默认 nodejs 12 太老，需要从 NodeSource 装新版：

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

Windows 用 WSL 还是原生？

原生 Windows	WSL
✅ 操作直观	✅ Linux 工具齐
❌ 路径处理偶尔有坑	❌ 需要 WSL2
Cursor / VS Code 推荐	Claude Code / Codex 推荐

公司机器没 npm 安装权限怎么办？

把 npm prefix 改到用户目录：

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"
npm install -g @anthropic-ai/claude-code

不用 sudo 就能装。

关于使用

怎么省钱？

1. 用 Haiku 做 subagent / 简单任务
2. 用 /compact 在长对话中压缩历史
3. 不要把 ANTHROPIC_DEFAULT_HAIKU_MODEL 改成 Opus
4. 利用 prompt cache（同一系统提示 5 分钟内重复用）
5. 切换到 Sonnet 4.6 替代 Opus（部分任务质量相近）

详见 提示缓存优化 + 模型选择策略。

/usage 怎么看？

Claude Code 交互模式里输入 /usage，会显示当前会话的 token 拆分（input / output / cache_read / cache_write）+ 各模型成本。

我能直接用 Anthropic 官方账号吗？

完全可以。Claude Code 默认走 OAuth 登录 Anthropic 账号。如果你有 Max 订阅，命中率更高、稳定性更好。Shuro 中转是补充，不是替代。

还没找到答案？

• 错误代码对照表
• 选择客户端
• （TODO/VERIFY：Shuro 反馈渠道待确认）