claude-api · Claude API 开发参考

构建 Claude 驱动应用的权威参考 skill:模型 ID 与价格、请求参数、流式输出、工具调用、MCP、智能体、提示缓存、token 计数、模型迁移,全部以 skill 内文档为准而非依赖记忆。
覆盖 Python / TypeScript / Java / Go / Ruby / C# / PHP 多语言 SDK 与 cURL;附带 migrate、prompt-audit、upgrade、cost-optimize、build-eval 等子命令工作流。
调用示例:在聊天框中说"用 Python 写一个调用 Claude 的流式对话示例"。
产品详解
定位
claude-api 是用 Claude API / Anthropic SDK 构建 LLM 应用的参考手册型 skill:回答"调用代码怎么写"以及"迁移、审计、优化怎么做"。核心纪律是"不靠记忆写 SDK 用法"——函数名、参数、模型 ID 全部以 skill 内各语言文档为准,过期记忆先查证再写。
核心能力
- 模型与价格:内置模型表(默认
claude-opus-5-5;含各模型上下文窗口与输入/输出价格,如 Opus 5.5 为 $4/$20 每百万 token);也可用 Models API 实时查询模型能力。 - API 漂移对照:thinking 配置、工具类型版本、参数命名等高频变更点对照表,写代码前先核对。
- 调用面选型:单次调用 / 工作流 / 手动循环 / Tool Runner / Managed Agents 四档,按"谁提供运行框架、谁负责部署"划分选型。
- 语言专属文档:Python、TypeScript、Java、Go、Ruby、C#、PHP 与 cURL 原始 HTTP,各有独立参考目录。
- 子命令工作流:
migrate(模型迁移)、prompt-audit(提示词审计)、upgrade(SDK 大版本升级)、cost-optimize(成本优化)、build-eval(构建评测集)、hillclimb(迭代优化)。 - 认证解析:
ANTHROPIC_API_KEY→ant auth login凭证等多来源自动解析。
工作流程
- 扫描目标文件/需求,确认语言与提供方(非 Anthropic 项目会先停下来确认)
- 读取对应语言的参考文档
- 按文档编写调用代码,编译/运行验证
- 子命令模式:识别子命令后按其专属指南逐步执行
输入与输出
| 输入 | 说明 |
|---|---|
| 需求描述或目标文件 | 必填 |
| 编程语言 | 可推断,不明则询问 |
| 子命令 | 选填,如 migrate、cost-optimize |
输出:SDK 调用代码、迁移/审计/成本优化报告。
与相邻 skill 的区别
- mcp-builder:构建 MCP 服务器的指南(为 LLM 生产外部工具)。
- claude-api(本):用 Claude API 构建应用的参考手册(消费 LLM 能力)。两者互补:MCP server 是 claude-api 应用可接入的工具来源之一。
适用场景
- 新项目接入 Claude API,查证多语言 SDK 写法
- 旧代码迁移到新模型(breaking change 清单)
- 提示词审计:清理为旧模型写的过时写法
- 成本优化:缓存、effort 等级、模型选型的省钱杠杆排序
使用前准备
- 需自备 Anthropic API key(环境变量
ANTHROPIC_API_KEY)或用ant auth login登录;未配置 key 时先运行ant auth status确认凭证来源。 - API 调用按量计费,模型价格见 skill 内价格表;
build-eval、hillclimb等会真实消耗 token,执行前需确认预算。
claude-api 隶属于 Aiglade Skill 库。在 Aiglade 聊天框中用自然语言描述需求即可调用。