Claude API 反向代理中继脚本：本地 127.0.0.1:8787 端口，多客户端共享一个 Anthropic Key，统一鉴权限流日志，零依赖，适合 IDE/SDK 共用。
Claude API 反向代理中继脚本是一个跑在你本机的 Node.js 小工具。它在 127.0.0.1:8787 监听一个本地端口，把所有外部客户端的请求统一转发到 Anthropic 官方接口。多台电脑、多 IDE、多个 SDK 共享同一个 Anthropic Key，再也不用到处粘贴。
核心特性
多客户端共享：所有外部应用统一走本地中继，Anthropic Key 只在中继机器上配置一次
统一鉴权：客户端使用本地
relay_key，不再接触真实 Key，避免泄漏零依赖：Node.js 18+ 内置
fetch，不依赖任何 npm 包限流与日志：每次请求打印
[METHOD URL] code X ms，排查问题更直观一键切换上游：修改
upstreamBase即可换成任意兼容端点
目录结构
server.js：主服务，纯 Node.js 18+ 标准库实现start-relay.bat：Windows 一键启动脚本，配置 Key 与端口client-test.js：客户端连通性测试脚本config.example.json：配置模板，便于复制成正式配置package.json：声明文件，可选
三分钟跑起来
安装 Node.js 18+：https://nodejs.org 下载 LTS 版本
编辑
start-relay.bat，把UPSTREAM_KEY=YOUR_ANTHROPIC_KEY_HERE改成你自己的 Anthropic API Key（sk-ant-api03-...开头）双击
start-relay.bat，看到listening http://127.0.0.1:8787就成功了另开终端运行
node client-test.js，应能看到 Claude 的回复内容
客户端接入示例
curl 调用
curl -X POST http://127.0.0.1:8787/v1/messages \
-H "Authorization: Bearer local-dev-key-2026" \
-H "Content-Type: application/json" \
-d "{"model":"claude-3-5-sonnet-20241022","max_tokens":512,"messages":[{"role":"user","content":"hi"}]}"Python (anthropic SDK)
import anthropic
client = anthropic.Anthropic(
base_url="http://127.0.0.1:8787",
api_key="local-dev-key-2026", # 本地中继的 Key，不是 Anthropic 的
)
msg = client.messages.create(
model="claude-3-5-sonnet-20241022",
max_tokens=512,
messages=[{"role": "user", "content": "hi"}],
)
print(msg.content[0].text)Node.js (@anthropic-ai/sdk)
import Anthropic from '@anthropic-ai/sdk';
const client = new Anthropic({
baseURL: 'http://127.0.0.1:8787',
apiKey: 'local-dev-key-2026',
});常见问题
启动提示 UPSTREAM_KEY 未设置？ 编辑
start-relay.bat，把YOUR_ANTHROPIC_KEY_HERE替换为真实 Key客户端返回 401 invalid relay_key？ 客户端传的 Authorization 必须是
Bearer local-dev-key-2026，默认 relay key 在start-relay.bat的RELAY_KEY=处修改怎样改端口？ 编辑
start-relay.bat，把RELAY_PORT=8787改成你想要的端口（例如 9000）怎样用第三方中继（非官方 Anthropic）？ 修改
UPSTREAM_BASE=https://你的中继域名，注意第三方中转可能需要不同的 Header，按其文档调整server.js里的x-api-key/anthropic-version字段如何开机自启？ 把
start-relay.bat的快捷方式放到%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup怎样查看请求日志？ 所有
[METHOD URL]格式的日志直接在终端显示；高级用户可以重定向到文件：start-relay.bat > relay.log 2>&1
安全提示
relay_key仅用于本地访问控制，不要在公网开放 8787 端口如要公网部署，必须加 HTTPS（建议 Nginx + Let's Encrypt）
UPSTREAM_KEY相当于你的 Anthropic 账号密码，务必妥善保管
版权声明
1. 本站文字内容为原创编撰或者网络搜集整理，受著作权保护，禁止未经授权批量采集转载。
2. 本站分享的各类源码、AI大模型、程序工具仅作技术科普部署教程使用，不直接存储原版版权文件。
3. 所有第三方资源的知识产权、开源协议、商用授权规则均归原开发团队所有。
4. 使用者下载、部署、二次开发必须严格遵守国家著作权相关法律法规，以及资源官方许可协议，如需商业运营，务必向版权方申请合法授权。
5. 因用户私自商用、违规分发资源造成的法律纠纷与经济损失，全部由使用者自行承担，本站不承担连带责任。
