> ## Documentation Index
> Fetch the complete documentation index at: https://docs.llmeasy.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# 常见问题

> 关于 LLMEasy 账号、计费、用量和接入的常见问题。

## AI Coding 工具 FAQ

这些页面面向搜索 Claude Code、Codex、Cursor、Cline 等 AI Coding 工具配置和概念的开发者。它们先解释工具本身，再说明 API Key、Base URL、协议和用量观察如何与 LLMEasy 相关。

* [Claude Code 是什么？它是如何工作的？](/zh/faq/claude-code/what-is-claude-code)
* [Claude Code 和 Claude Desktop 有什么区别？](/zh/faq/claude-code/claude-code-vs-claude-desktop)
* [Claude Code 和 Cursor 哪个更适合本地开发？](/zh/faq/claude-code/claude-code-vs-cursor)
* [Claude Code 是用 Claude.ai 账号还是 API Key？](/zh/faq/claude-code/claude-account-or-api-key)
* [如何在 Claude Code 中配置 API Key 和 Base URL？](/zh/faq/claude-code/api-key-base-url)
* [Claude Code 中的 CLAUDE.md 是什么？应该怎么写？](/zh/faq/claude-code/claude-md)
* [如何在 Claude Code 中切换 Sonnet 和 Opus？](/zh/faq/claude-code/switch-sonnet-opus)
* [Claude Code 权限和 hooks 是什么？](/zh/faq/claude-code/permissions-and-hooks)
* [Claude Code token 为什么消耗很多？如何降低成本？](/zh/faq/token-cost/claude-code-token-usage)
* [Claude Desktop 如何配置 MCP？](/zh/faq/claude-desktop/mcp)
* [Claude Desktop 如何接入第三方模型？](/zh/faq/claude-desktop/third-party-models)
* [Claude Desktop Cowork 和 Code Gateway 有什么区别？](/zh/faq/claude-desktop/cowork-code-gateway)
* [Codex CLI 是什么？](/zh/faq/codex/what-is-codex-cli)
* [Codex CLI、Codex App 和 Codex Web 有什么区别？](/zh/faq/codex/codex-cli-vs-app-vs-web)
* [如何配置 Codex CLI 的 config.toml？](/zh/faq/codex/config-toml)
* [Codex CLI 中 model\_provider、base\_url 和 wire\_api 是什么？](/zh/faq/codex/model-provider-base-url-wire-api)
* [Codex CLI 中 review\_model 和 reasoning\_effort 是什么？](/zh/faq/codex/review-model-reasoning-effort)
* [Codex CLI 中的 AGENTS.md 是什么？应该怎么写？](/zh/faq/codex/agents-md)
* [Codex CLI sandbox 和 approval mode 是什么？](/zh/faq/codex/sandbox-approval)
* [为什么在 Codex 的 API 模式无法使用 GPT-5.5？](/zh/faq/codex/gpt-5.5-api-mode)
* [如何在使用第三方 API 的同时保留 Codex 登录态？](/zh/faq/codex/official-login-third-party-api)
* [Cursor 如何配置自定义 OpenAI API Key 和 Base URL？](/zh/faq/cursor/custom-openai-api)
* [Cursor Rules、AGENTS.md 和 .cursorignore 是什么？](/zh/faq/cursor/rules-agents-cursorignore)
* [Cursor 如何配置 MCP？](/zh/faq/cursor/mcp)
* [Cline 如何配置 OpenAI-compatible API？](/zh/faq/cline/openai-compatible-api)
* [OpenAI-compatible API 和 Anthropic-compatible API 有什么区别？](/zh/faq/concepts/openai-compatible-vs-anthropic-compatible)
* [Claude Code 和 Codex CLI 有什么区别？](/zh/faq/concepts/claude-code-vs-codex-cli)
* [MCP 和 API Key / Base URL 有什么区别？](/zh/faq/concepts/mcp-vs-api-key-base-url)

## 账号与计费

<AccordionGroup>
  <Accordion title="LLMEasy 是如何计费的？">
    LLMEasy 按实际消耗的 token 量计费，与 Anthropic / OpenAI 官方定价保持一致，不额外收取溢价。注册即获得 \$3 体验额度，无需绑卡。

    具体定价请参考<a href={"https://www.llmeasy.ru/#"}>定价页面</a>。
  </Accordion>

  <Accordion title="注册后可以退款吗？">
    充值金额支持退款，体验额度不支持退款。如有退款需求，请联系客服处理。
  </Accordion>

  <Accordion title="是否可以同时在多个工具中使用同一个 API Key？">
    可以。同一个 API Key 可以同时在 Claude Code、Codex、Cursor 等多个工具中使用，额度共享。
  </Accordion>

  <Accordion title="如何查看用量？">
    登录控制台后，在账户管理页面可以查看当前用量和消费记录。
  </Accordion>
</AccordionGroup>

## 接入与配置

<AccordionGroup>
  <Accordion title="LLMEasy 的 base_url 是什么？">
    LLMEasy 现在按协议区分两个地址：

    | 场景                                 | Base URL                    |
    | ---------------------------------- | --------------------------- |
    | Claude Code / `ANTHROPIC_BASE_URL` | `https://www.llmeasy.ru`    |
    | Codex / `OPENAI_BASE_URL` / 其他外部工具 | `https://www.llmeasy.ru/v1` |

    不再使用“一个地址适配所有协议”的写法。
  </Accordion>

  <Accordion title="接入 Claude Code 时需要指定模型吗？">
    取决于你的 API Key 分组。

    如果你使用 **Claude 分组**，只需配置 `ANTHROPIC_BASE_URL` 和 `ANTHROPIC_AUTH_TOKEN`，**不需要**设置模型变量。

    如果你使用 **GPT 分组**，则需要通过 `ANTHROPIC_DEFAULT_HAIKU_MODEL`、`ANTHROPIC_DEFAULT_SONNET_MODEL`、`ANTHROPIC_DEFAULT_OPUS_MODEL` 为 Claude Code 配置模型映射。模型 ID 请从<a href={"https://www.llmeasy.ru/pricing"}>模型广场</a>复制当前可用的 **GPT 分组**模型 ID。
  </Accordion>

  <Accordion title="接入 Codex 时需要指定模型吗？">
    需要在配置里填一个模型 ID，但这个模型 ID 应该从<a href={"https://www.llmeasy.ru/pricing"}>模型广场</a>复制 **GPT 分组**下当前可用的模型。

    详细配置参考[Codex 接入文档](/zh/ai-tools/codex)。
  </Accordion>

  <Accordion title="接入 Cursor 等其他工具时需要指定模型吗？">
    需要。Cursor、Cline、Zed、OpenClaw 等外部工具统一走 **GPT 分组**，模型名称请从<a href={"https://www.llmeasy.ru/pricing"}>模型广场</a>复制当前可用的 GPT 分组模型 ID。

    这些工具当前不应继续按 Anthropic / Claude 直连方式填写 Claude 系列固定模型名。

    详细配置参考 [Cursor 接入文档](/zh/ai-tools/cursor)。
  </Accordion>

  <Accordion title="OpenClaw 和其他外部工具需要额外 headers 吗？">
    通常不需要。

    根据我们核对到的官方文档，Cursor、Cline、Zed 等常见外部工具的默认接入说明都聚焦在 `Base URL`、API Key 和模型 ID。OpenCode 与 OpenClaw 虽然支持可选 `headers`，但官方文档的定位也是自定义 headers / custom auth needs，而不是 LLMEasy 默认接入的必填项。

    只有当工具官方文档，或你额外接入的上游网关、租户路由、审计、缓存服务明确要求额外 headers 时，再按对应文档补充。
  </Accordion>

  <Accordion title="配置后提示认证失败怎么办？">
    请检查以下几点：

    1. API Key 是否正确，没有多余空格
    2. Claude Code 是否使用 `https://www.llmeasy.ru`，Codex / 外部工具是否使用 `https://www.llmeasy.ru/v1`
    3. 是否存在旧的 `ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_BASE_URL`、`OPENAI_API_KEY` 或 `OPENAI_BASE_URL` 覆盖了配置
    4. 外部工具是否存在额外的官方接入要求，例如特定版本限制、模型白名单，或上游网关明确要求的额外 headers

    如仍有问题，请联系客服。
  </Accordion>
</AccordionGroup>

## 可靠性与限流

<AccordionGroup>
  <Accordion title="LLMEasy 是如何保证可靠性的？">
    LLMEasy 同时接入多家供应商，并通过以下机制保障稳定性：

    * **多源供应**：某个供应商故障时自动切换，不影响你的请求
    * **动态路由**：实时检测各链路状态，选择响应最快、成功率最高的路径
    * **精选旗舰**：围绕 Claude Code 与 Codex 生态集中保障核心链路的可用性
  </Accordion>

  <Accordion title="遇到限流或超时怎么办？">
    LLMEasy 的多源路由机制会自动处理单一供应商的限流和超时。如果你遇到持续的限流问题：

    1. 检查账户余额是否充足
    2. 适当增大工具的超时时间（建议设置 `API_TIMEOUT_MS=3000000`）
    3. 联系客服了解当前配额情况
  </Accordion>

  <Accordion title="LLMEasy 是否适合生产环境？">
    LLMEasy 主要面向 AI 编程工具的个人开发者场景（Claude Code、Codex 等）。对于大批量的生产环境 API 调用，建议结合实际情况评估。
  </Accordion>
</AccordionGroup>

## 隐私与安全

<AccordionGroup>
  <Accordion title="LLMEasy 会存储我的请求内容吗？">
    LLMEasy 作为 API 中转层处理请求，不会持久化存储用户的对话内容。详细的隐私条款请参考<a href={"https://www.llmeasy.ru/privacy"}>隐私政策</a>。
  </Accordion>

  <Accordion title="API Key 泄露了怎么办？">
    立即登录控制台，删除旧的 API Key 并重新生成一个。同时检查使用该 Key 的工具配置，替换为新 Key。
  </Accordion>
</AccordionGroup>