主题
快速开始
这是所有客户端的统一入口。你只需要完成 4 步:确认地址格式、创建令牌、选择客户端路径、完成第一次验证。
一句话规则
地址由请求格式决定:Claude / Anthropic 不带 /v1;Codex / OpenAI 带 /v1。模型 ID 始终以模型广场为准。
第 1 步:确认地址格式
| 接入类型 | 协议 | Base URL |
|---|---|---|
| Claude Code / Anthropic SDK | Anthropic Messages | https://api.entropicecho.com |
| Codex CLI / Codex App / OpenAI SDK | OpenAI Responses | https://api.entropicecho.com/v1 |
| CC Switch 中的 Claude / Anthropic 格式 | Anthropic Messages | https://api.entropicecho.com |
| CC Switch 中的 Codex / OpenAI 格式 | OpenAI Responses | https://api.entropicecho.com/v1 |
| Cherry Studio / ChatBox 等客户端 | OpenAI 兼容 | https://api.entropicecho.com/v1 |
不要在 Base URL 后继续追加 /v1/responses、/chat/completions 或其他接口路径。
第 2 步:创建令牌
按 创建令牌 完成唯一一次创建。快速开始不再重复字段、额度和安全规则;这里只保留两个必要判断:
- 分组必须包含目标模型,否则先更换分组。
- 只复制一次的
sk-令牌,保存到密码管理器。
第 3 步:选择客户端路径
| 你的场景 | 推荐路径 | 教程 |
|---|---|---|
| 在 VS Code / Cursor 里写代码 | EntropicEcho 扩展 | VS Code 扩展 |
| 习惯 Cursor / Copilot 的 AI 编辑器 | Devin Desktop + Devin BYOK | Devin BYOK |
| Claude Code 日常开发 | CC Switch | Claude Code |
| Codex CLI 或只使用 GPT 官方模型 | CC Switch | Codex CLI 与 App |
| DeepSeek Harness 可视化工作区 | OpenAI Responses | DeepSeek Harness |
| Codex App 使用第三方模型 | Codex++ | Codex++ |
| OpenClaw / IDE / 网关 | 配置中心 + UA 规则 | 外接兼容 |
| Cherry Studio、ChatBox 等客户端 | OpenAI 兼容地址 | 第三方客户端 |
| 应用或后端集成 | SDK | 通用 SDK |
需要图形化切换供应商时,从 CC Switch 开始;需要手动排障或自动化时,看 客户端手动配置 或 Codex 手动配置。
第 4 步:完成最小验证
配置后完全退出并重启客户端,发送这条只读请求:
text
请只读说明当前工作区的目录结构,不要修改任何文件。1
通过标准:
- 客户端正常返回结果。
- 控制台出现新用量。
- 实际模型与配置中的模型 ID 完全一致。
失败时按固定顺序检查:
- Base URL 是否符合当前格式。
- 模型 ID 是否来自模型广场,拼写和后缀是否正确。
- 令牌是否有效、有余额,且没有多余空格或
Bearer前缀。 - CC Switch 的 路由总开关 和当前 Coding Agent 开关是否开启。
- 是否有旧环境变量、IDE 插件、MCP 或 OAuth 状态覆盖新配置。
- 外接场景是否携带了对应
User-Agent。
继续排查时进入 报错档案。