在 Cloudflare Workers 运行私有 API 示例
将密钥与教学页面分开，使用无服务器请求处理。
准备 Cloudflare 账户、Node.js 和 API 密钥，将 worker.mjs、wrangler.jsonc 下载到独立示例目录。本例供私有终端客户端使用，以共享访问令牌保护，并非公开浏览器聊天服务，也尚未作为本站功能部署。
1. 理解请求路径
客户端请求 Worker 的 /api/message；Worker 检查访问令牌、验证短提示词，添加服务端 Claude 密钥后调用 Messages API，再返回响应。Claude 密钥和示例私有令牌都不能放入浏览器代码。公开产品需独立用户认证与强制配额。
2. 配置本地测试
在示例目录将 Wrangler 安装为开发依赖，替换 wrangler.jsonc 中的模型占位符。用编辑器创建 .dev.vars，填写 ANTHROPIC_API_KEY 与较长随机 DEMO_ACCESS_TOKEN，并从版本管理排除。需要时增加 ANTHROPIC_WORKSPACE_ID。Wrangler 在本地读取这些密钥。
npm install --save-dev wrangler@latest
npx wrangler dev3. 从终端调用本地端点
在调用终端中将 DEMO_ACCESS_TOKEN 设置为相同的本地密钥，再执行请求。本地 Worker 仍会调用真实 Claude API 并消耗额度。无认证应返回 401，空提示词为 400，缺配置为 503。示例限制输入字节、提示长度、输出 token 及上游时间。
curl --fail-with-body http://localhost:8787/api/message \
-H "Authorization: Bearer $DEMO_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
--data '{"prompt":"Explain Workers in one sentence."}'4. 有准备地部署
上线时通过 Wrangler secret put 的交互输入配置 ANTHROPIC_API_KEY 与 DEMO_ACCESS_TOKEN，不放进 vars。确认模型和可选工作区后，再按需 deploy。保持示例私有，监测用量并设置账户支出限制。付费端点公开前应加入更强认证与用户配额；本手册不会自动部署。
npx wrangler secret put ANTHROPIC_API_KEY
npx wrangler secret put DEMO_ACCESS_TOKEN
# If required: npx wrangler secret put ANTHROPIC_WORKSPACE_ID
npx wrangler deploy下载示例文件
教学示例的模型输出可能不同。请按前置条件操作并核验结果，页面本身不发送 API 请求。
练习与自检
启动本地 Worker，先验证无授权 401、错误输入 400，再尝试真实模型请求。
完成后，花一点时间检查：
阅读官方原始资料
CLI 操作已对照官方文档核查；API 示例通过模拟响应测试。未登录产品账户进行完整实机演示。