ZCode2API 是开发者 angusdevgo 以 MIT 协议开源的一个 Node.js 服务，作者把它做成了单文件网关（Node 22+、零 npm 依赖，Docker 镜像约 60MB），属于典型的开源软件。它架在智谱 ZCode 客户端与你的应用之间，把客户端专属的 GLM-5.3 / GLM-5.3-Flash 额度通道对外暴露成标准 API，让 Claude Code、ChatBox、NextChat、LobeChat、Open WebUI 这类 AI 应用不必改造就能直连。上游如实复刻 ZCode 客户端对 zcode.z.ai 的请求，端点、鉴权、指纹、system 提示词均来自对客户端行为的逆向分析，公开仓库已脱敏。
场景痛点
在 ZCode 客户端之外调用 GLM 额度并不容易：官方链路只走自己的鉴权，这类AI工具默认对接 Anthropic 或 OpenAI 两家协议，逐个适配成本高；手上若有多个本人注册的账号、不同周期活动额度与新号礼包，分散在客户端里没有统一出口，更谈不上按余额、成功率自动选号。不少开发工具的作者只能自己包一层代理，这个托管在 GitHub 的开源项目把这件事做成了现成的开源软件网关，省掉了重复造轮子的功夫，也是值得收藏的工具推荐。
主要功能特点
账号管理
- 登录即纳管 —— 设备授权流 / 粘贴 Token 两种方式；登录成功自动识别身份（手机号 / 邮箱 / 国内国际归属）、自动领取可用额度
- 额度总览 —— 按套餐类型与模型实时聚合（周期活动额度 / 新号注册礼包 / 付费套餐），进度条 + 临期预警
- 手动权重 —— 每个账号 0~20 的调度权重：高的多吃额度，0 = 暂停（冻结额度）；实际权重 = 自动分 × 手动权重
- 身份自动识别 —— 用 OAuth access_token 反查官方客户档案，免手填
- 指纹隔离 —— 每账号独立派生 device_id / session_id，多号不共享设备痕迹
- 隐私模式 —— 一键脱敏邮箱 / 手机号 / 昵称，截图分享不泄密
反代网关（对外 /v1）
- 双协议 ——
POST /v1/messages（Anthropic，Claude Code 等直连）+POST /v1/chat/completions（OpenAI，任意主流工具直连）+GET /v1/models - 协议双向转换 —— system 合并、tool 消息、stop 参数、usage 字段全量映射；客户端无感
- 流式支持 —— Anthropic 路径原生 SSE 透传
- 多密钥分发 —— 每把密钥独立设有效期、总 token 配额、模型白名单、IP 白名单；
zck_前缀，库里只存哈希，完整 key 只显示一次 - 全量审计 —— 每次调用记密钥、来源 IP、UA、模型、Token（入/出/缓存）、延迟与命中账号
调度与容错
- 加权随机选号 ——
余额占比 + 闲置补偿 + 成功率三因子 × 手动权重，Top-N 截断 + 防惊群 - 会话粘性 —— 同会话 30 分钟滚动续期固定同号（保 prompt cache 命中），失败自动解绑换号，成功跟随
- 差异化冷却 —— 风控 10 分钟 / 限流首犯 90 秒 / 惯犯 30 分钟 / 上游 5xx 60 秒；连败熔断指数翻倍封顶 6 小时；全冷却时最早恢复者兜底
- 周末额度自动抢领 —— 周五 18:00（北京）起每 10 分钟自动试领，开闸即抢、抢到即停，不再错过限量名额
- 在线调参 —— 全部调度参数面板可改、热生效、持久化，无需重启
安全与运营
- IP 管控 —— 全局黑/白名单（IPv4/IPv6 CIDR），拦截审计保留 500 条（IP / 路径 / UA / 原因）
- openMode 防裸奔 —— 删光密钥只放行
127.0.0.1，外部一律 401 - 用量统计 —— 14 天趋势图、按模型 / 密钥 / 账号聚合、今日 Token、缓存命中率
- 面板即运维 —— 五页单页应用（仪表盘 / 账号 / 密钥 / 统计 / 安全），由网关自身伺服，无需额外部署前端
账号池纳管与额度聚合
支持设备授权流登录，也允许直接粘贴客户端 Token；登录后自动识别账号身份并拉取可用额度，按套餐类型与模型把周期活动额度、新号礼包、付费套餐聚合成进度条，临期额度单独预警。每账号可设 0 到 20 的手动调度权重，置 0 即冻结；设备指纹与会话 ID 按账号独立派生，多号不共享痕迹，适合自托管环境长期运行。
双协议反代与多密钥分发
下游暴露 Anthropic 与 OpenAI 双端点，面向大语言模型与AI应用。Anthropic 走原生 SSE 透传，OpenAI 返回整体 JSON；system 合并、tool 消息、stop 参数、usage 字段双向映射。每把 zck_ 密钥可独立设有效期、配额、模型与 IP 白名单，库内只存 SHA-256 哈希。
加权调度与会话粘性
选号公式为「余额占比×10 + 闲置补偿 + 成功率×3」再乘手动权重，Top-N 截断后加权随机；同一会话 30 分钟滚动续期固定同号，保住 prompt cache 命中，失败自动解绑换号。差异化冷却把风控、限流首犯、惯犯、上游 5xx 分别落到 10 分钟、90 秒、30 分钟、60 秒，连败熔断指数翻倍封顶 6 小时，是一款省心的效率工具。
3012 风控与 system 透传
上游对 system 提示词做内容指纹校验，只接受官方那份 10703 字符原文，否则返回 3012。网关把官方三段 system 原样透传，应用自己的 system 指令降级为一块插入首条 user 消息，这是项目能跑通的核心。指纹档案取自客户端 3.16.3，上游升级后若再遇 3012 需重新抓取，项目不做额度增强。
安全审计与 Web 面板
全局支持 IPv4/IPv6 CIDR 形式的 IP 黑/白名单，拦截审计保留 500 条；删光密钥时进入 openMode，只放行 127.0.0.1，外部一律 401。每次调用记录密钥、来源 IP、UA、模型、token 与命中账号，但不记录对话内容，符合隐私保护基本要求。Web 面板由网关自身伺服，五页单页应用覆盖仪表盘、账号、密钥、统计与安全。
部署方式与升级路径
推荐 Docker Compose 跑在 1 核 1G 起的服务器上；单容器端口绑 127.0.0.1，公网走 nginx 加 TLS 反代，关 proxy_buffering 保 SSE。裸机直接 node zcgw-server.mjs 即可，零依赖。数据落在 ./data/，升级就是 git 加 rebuild，是一款轻量级实用软件。
项目地址
GitHub 访问
下载地址
https://pan.quark.cn/s/0c0d4a082ec9
https://www.guangyapan.com/s/1964163396137103366_aeWhI5wocgzRgCO6 （光鸭新用户注册福利：永久免费空间：所有新用户注册即可解锁 2TB 永久免费存储空间，无需额外任务或付费）
相关推荐
