Entropic Echo

主题

外接兼容与接入说明 ​

本页作为外接兼容总入口，统一说明第三方客户端、IDE、网关、自定义前端接入 Entropic Echo 时的共性规则。具体请求头示例见 外接调用 User-Agent 说明。

适用场景 ​

以下情况都建议先看本页，再看对应客户端页面：

  • 通过 JetBrains、Trae、OpenClaw 等客户端外接 Claude / Codex / 国产模型
  • 使用自定义 Base URL 将官方插件接到 Entropic Echo 站点
  • 已填 API Key，但仍出现 403 block、401、模型不可用
  • 想确认协议、User-Agent、模型名应该怎么对应

接入前先确认 ​

开始配置前，先把这几项对应好：

项目需要确认什么
协议客户端要走 Anthropic Messages、OpenAI Responses，还是其他兼容协议
Base URLClaude 类通常不带 /v1，Codex / Grok 类通常带 /v1
请求头外接场景通常需要补对应的 User-Agent
模型填写准确的模型 ID，以 控制台 可用模型为准

如果有任一项对不上，最常见的结果就是：

  • 403 block / 403 Forbidden
  • 401 Unauthorized
  • 模型列表为空

按模型类型填写 ​

接入类型常见协议Base URL模型填写建议补充说明
Claude 外接Anthropic Messageshttps://api.amadeus.mom按客户端要求填写 Claude 模型名需要 Claude CLI 风格 User-Agent
Codex 外接OpenAI Responseshttps://api.amadeus.mom/v1填写可用的 GPT / Codex 模型需要 Codex CLI 风格 User-Agent
Grok 外接 / MCPOpenAI Responseshttps://api.amadeus.mom/v1填写 Grok 模型 IDgrok-search-mcp 读取的是 GROK_* 环境变量
国产模型外接视客户端而定按接入方案填写以 控制台 模型 ID 为准建议使用浏览器型 User-Agent

详细请求头示例见 外接调用 User-Agent 说明。

通用接入流程 ​

第一步：先用 CC Switch 配好基础环境 ​

默认先在 CC Switch 统一配置 中配置好，确认：

  1. Key 可用
  2. model 没有填错

如果客户端支持直接读取本机 Claude / Codex 配置，通常到这一步就已经省掉一半手工配置。

第二步：按接入类型填写 Base URL ​

类型正确写法
Claude 类https://api.amadeus.mom
Codex / Grok 类https://api.amadeus.mom/v1

最常见错误是：

  • 把 Claude 的地址误写成带 /v1
  • 把 Codex 的地址误写成不带 /v1

第三步：补齐 Header 或使用原生插件 ​

如果客户端支持自定义 Header，按接入类型补对应 User-Agent。 如果客户端使用的是官方 Claude / Codex 插件，且只改 Base URL，通常可直接沿用插件自带请求头。

第四步：确认模型与上下文能力 ​

长上下文、缓存、搜索、工具调用通常不是"只换个地址"就自动生效，还要看：

  • 客户端是否真的把相关字段传出
  • 本地配置是否把默认值覆盖掉了

例如：

常见排查顺序 ​

403 block / 403 Forbidden ​

按顺序检查：

  1. Base URL 是否带错 /v1
  2. User-Agent 是否缺失或填成了别的模型类型
  3. 客户端是否真的把 Header 发出去了

401 Unauthorized ​

优先检查：

  1. Key 是否仍有效
  2. 是否存在旧 OAuth 状态覆盖 API Key
  3. IDE 插件、MCP 或环境变量是否覆盖了本地配置

相关说明：

1M 上下文没生效 ​

优先检查：

  1. 客户端是否有单独的上下文参数
  2. 本地配置文件中是否仍沿用默认压缩阈值

相关页面 ​

页面用途
CC Switch 统一配置统一配置入口
外接调用 User-Agent 说明各类型请求头示例
Claude Code 配置参考缓存、环境变量
Codex CLI 配置参考1M 上下文与手动配置