EntropicEcho

在 VS Code 编辑器标签页中连接 EntropicEcho 账户，管理 Codex / Claude Code 的中转配置，查看余额、Token 用量和账单。

安装

1. 在 VS Code 扩展菜单中选择 从 VSIX 安装，安装 entropic-echo-0.2.6.vsix。
2. 安装需要使用的客户端：Codex（openai.chatgpt）或 Claude Code（anthropic.claude-code），不必两个都装。工作台提供安装入口。
3. 点击状态栏 Entropic Echo，或执行命令 Entropic Echo: 打开工作台。首次安装会自动打开编辑器标签页。
4. 使用中转站账号登录，在 客户端配置 中选择线路、启用模型，点击 应用并重载。

本扩展是账户与配置管理工具，不替代 Codex 或 Claude Code 的对话、工具调用和代码编辑功能。

本扩展并非 OpenAI、Anthropic 或 Microsoft 官方扩展。Codex 配置中的 OpenAI 供应商显示名称不改变实际中转地址。

四个独立页面

页面在标签页内切换，不会把所有内容堆在一个滚动页面里。

模型配置

Codex

• 从账户当前线路同步模型，不按 gpt- 前缀过滤。Qwen、DeepSeek、Claude 等模型 ID 也可以加入目录。
• 默认只展示可选模型和启用状态；展开 高级设置 后调整显示名称、上下文 Token 预算和推理档位。
• 登录、切换线路和刷新账户时自动同步模型，不需要额外维护或手动导入模型库。
• 应用时生成 model-catalogs/entropic-echo.json，通过 model_catalog_json 加载。
• 中转线路必须提供兼容的 Responses API，且模型需要支持客户端要求的工具调用。加入选择列表并不代表所有上游功能都兼容。
• 站点只返回模型 ID 时，新模型使用 128,000 Token 的本地初始预算，这不是上游规格声明。请按照线路实际支持能力修改；设置更大不会扩展上游模型的真实能力。
• 为保证每个模型的预算生效，应用时清除全局 model_context_window、model_auto_compact_token_limit、model_reasoning_effort 和默认 profile 覆盖；已有 profiles、MCP 和其他配置表仍保留。项目级配置或启动参数仍可能覆盖用户级配置。

Claude Code

• 独立设置 Opus、Sonnet、Haiku、Fable 四个模型槽位。
• 写入 ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_FABLE_MODEL。
• 默认使用 Sonnet 槽位，写入默认模型 ANTHROPIC_MODEL、服务地址和调用令牌，不再额外展示第五个模型选择框。
• 四个下拉框直接使用当前线路的所有模型，不受 Codex 模型启用状态影响。
• 四槽位需要支持这些变量的 Claude Code 版本。
• Claude Code 页面不再展示通用模型库或上下文编辑器。扩展没有写入未经支持的上下文变量，也不宣称修改了 Claude Code 的实际上下文上限。

模型档案按账户和线路分别保存在本机 VS Code 扩展状态中，刷新模型列表会保留已有参数。

Remote SSH 安装

如果服务器仅部署 new-api，不需要在那里运行本扩展。本扩展安装在用于编程的 VS Code 工作区环境中。

远程编程时，先在本机 VS Code 使用 Remote - SSH 连接服务器并打开项目；再在这个远程窗口中执行 从 VSIX 安装，选择安装包。安装后检查扩展列表中的 SSH: 服务器名称 分组，并使用 Developer: Show Running Extensions 确认运行位置。

Codex / Claude Code 也需要在对应工作环境中安装。当前版本按 workspace 扩展运行，Codex 配置写入当前扩展宿主的配置目录，而不是 new-api 容器。远程写入与重载仍需在实际 Remote SSH 窗口验收。

自动重载

应用和恢复配置后，扩展会查找当前客户端已注册的独立重启命令；可用时直接调用。

如果没有可用命令，或独立重启失败，将自动执行 重启扩展宿主；宿主不提供该入口时才自动重载窗口。确认框会提前说明可能中断正在运行的扩展任务。重载后自动恢复 Entropic Echo 标签页，不需要用户自行寻找重启命令。

配置与隐私

安装包内的 PRIVACY.md 提供完整扩展数据说明，THIRD_PARTY_NOTICES.txt 提供第三方组件许可。

• 登录密码只用于建立会话，不持久保存。
• 登录会话和扩展管理的调用令牌保存在 VS Code SecretStorage 中。
• 为使客户端能够读取凭据，Codex 的调用密钥仍会写入其 auth.json，Claude Code 的调用密钥仍会写入 claudeCode.environmentVariables 用户设置。配置和备份包含敏感信息，不要提交到代码仓库或分享给他人。
• Codex 首次接入前的配置、认证文件及同名模型目录保存在 .entropic-echo/baseline.json。重复应用不会覆盖接入前基线，恢复后清除该备份；原本不存在的文件会恢复为不存在。
• Claude Code 接入前的环境变量保存在 SecretStorage 中，恢复时写回。
• 应用配置会为当前客户端创建或复用账户调用令牌。恢复配置和退出登录会尝试撤销对应令牌；网络失败时应在控制台确认撤销状态。
• 操作针对当前扩展宿主。Remote SSH 窗口中请确认客户端扩展安装位置和 entropicEcho.codexHome，配置不会自动复制到另一台机器。

设置

金额根据站点计价单位和汇率换算；时间范围根据配置时区统计。

开发

故障排查

• 客户端显示“未安装”：检查扩展是否安装在当前工作环境，尤其是 Remote SSH 的远程分组。
• 新安装后显示旧界面：确认扩展版本，并完成编辑器提示的更新重载。
• 切换服务器仍已登录：同一编辑器可能复用 SecretStorage 会话；更换服务器不等同于退出登录。
• 配置后模型不可用：确认线路协议及客户端能力，模型出现在目录不代表上游兼容。
• 联系提供安装包的维护者时，请提供版本、操作系统、编辑器名称、复现步骤和脱敏错误；不要发送密钥或完整配置文件。目前尚未公布专用支持入口。

本地验证

npm install
npm run check
npm run test:ui
npm run package

npm run dev 启动浏览器预览，使用独立示例数据，不会登录账户、创建真实令牌或改动客户端配置。

Codex 目录兼容性可用 node scripts/verify-codex.mjs <已安装的 bin/codex.js 路径> 验证；此检查使用隔离的 CODEX_HOME，只读取模型目录，不发起模型生成请求。