ClaudeStore SDK 与客户端选择
如何为 ClaudeStore 选择合适的客户端：原生 Anthropic SDK、OpenAI 兼容 SDK、cURL，以及 Cursor / Claude Code 等 IDE 客户端。
Anthropic 原生: https://api3.claudestore.store. OpenAI 兼容: https://api3.claudestore.store/v1. 同一 API Key: 可以. IDE 客户端: Cursor / Claude Code.
怎么选
| 客户端 | 适用场景 | Base URL | 文档 |
|---|---|---|---|
| Anthropic SDK | 新项目、原生 tool use、原生流式事件、直接使用 Messages API | https://api3.claudestore.store | Python / TypeScript |
| OpenAI SDK | 已有 Chat Completions 代码、OpenAI 生态工具、低迁移成本 | https://api3.claudestore.store/v1 | OpenAI 兼容 |
| cURL | 快速验证、CI、shell 脚本、调试请求 payload | 取决于格式 | cURL 示例 |
| IDE 客户端 | Cursor、Claude Code、VS Code 中交互式编程 | 按各自指南 | Cursor / Claude Code |
快速规则
- Anthropic SDK 使用
https://api3.claudestore.store，不要加/v1。 - OpenAI SDK 使用
https://api3.claudestore.store/v1。 - 两个格式使用同样的模型 ID。请以
GET /v1/models返回的当前列表为准，例如claude-opus-5、claude-sonnet-5或claude-haiku-4.5。 - 同一个 ClaudeStore API Key 可以跨 SDK、cURL、Cursor 和 Claude Code 复用。
如果是全新 Claude 项目，通常原生 Anthropic 格式最直接。如果你的生产系统已经是 OpenAI SDK，保留现有调用方式通常迁移成本最低。
常见错误
- 在 Anthropic SDK 里加上
/v1。原生客户端应该使用不带后缀的域名。 - 在 OpenAI SDK 里使用裸域名。OpenAI 兼容客户端必须带
/v1。 - 把
/v1/messages和/v1/chat/completions两种格式混用。 - 把 API Key 暴露在浏览器前端，而不是放在服务端、edge function 或本地开发工具里。
- 继续沿用过时的模型名，而不是文档和 models 端点中的当前稳定 ID。