发起第一次 Claude API 请求
配置凭据、选择可访问模型,读懂实际响应。
需要 Claude Console 账户、API 权限和可用额度。在 Console 确认计费;即使套餐提供可领取 API 额度,桌面可用也不代表 API 已配置。下载示例需 Node.js 22+,HTTP 示例需 curl。
1. 将凭据保存在服务端
在 Console 创建密钥,存入本地环境变量或服务端 Secret,不放进公开页面、浏览器代码或提交文件。下载中包含 .env.example,在本地创建 .env 填写自己的密钥,并从版本管理排除。仅当密钥需要指定工作区时设置 ANTHROPIC_WORKSPACE_ID。
ANTHROPIC_API_KEY=YOUR_LOCAL_KEY
ANTHROPIC_MODEL=AN_ACCESSIBLE_MODEL_ID
# ANTHROPIC_WORKSPACE_ID=wrkspc_...2. 选择账户可访问的模型
从 Console 或 Models API 获取当前可用模型 ID,填入 ANTHROPIC_MODEL,不复制旧教程中已退役的模型。以下使用仍支持的 x-api-key 与 API 版本头;需要指定工作区的密钥另加 anthropic-workspace-id。
curl --fail-with-body https://api.anthropic.com/v1/models \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01"3. 发送简短消息
将 client.mjs 与 first-call.mjs 下载到同一目录,创建 .env 后运行下面命令。Node 读取环境文件,向 /v1/messages 发请求,打印文本块和用量。运行会实际消耗 API 额度;本站预览页面本身不会调用模型。
node --env-file=.env first-call.mjs4. 理解完整响应
content 是数组,不保证只有一个字符串。提取 text 块,检查 stop_reason,并记录 usage。end_turn 表示当前回合结束;max_tokens 表示截断;tool_use 需要下一章的工具回合。不能将错误当作正常空回答。
下载示例文件
教学示例的模型输出可能不同。请按前置条件操作并核验结果,页面本身不发送 API 请求。
练习与自检
从本地环境发送一条短请求,检查 usage 与 stop_reason,并清理临时记录中的密钥。
完成后,花一点时间检查:
阅读官方原始资料
CLI 操作已对照官方文档核查;API 示例通过模拟响应测试。未登录产品账户进行完整实机演示。