把你的 GLM 编码套餐，接进所有 AI 编程工具。
一个跑在自己电脑上的小工具：智谱 Z.AI / Bigmodel 的编码套餐（个人套餐 / 体验套餐） 本来只能在官方客户端里用，ZCode Proxy 在本机把它变成标准的 OpenAI / Anthropic 接口， 于是 Claude Code、Codex、Silly Tavern ……都能直接用上你的套餐额度。
- 🧩 一个地址，三种格式 —— OpenAI、Anthropic、Responses（Codex 专用）接口都在本机
127.0.0.1:8080上，工具认哪种就给它哪种。 - 🖥️ 带图形面板 —— 终端启动就是一块可视化面板（也可纯后台运行），启动、登录、看日志点点就行，还能用手机管理。
- 📱 安卓 App —— 手机上启动/停止代理、看实时日志、切换服务商，出门在外也好用。
- 💬 自带网页聊天 —— 打开
/webui就是一个本地 ChatGPT 风格聊天页，随手测试模型。 - 🌙 闲时通道 & 套餐秒抢（可选）—— 错峰时段的免费额度通道、限量体验套餐自动领取，都是内置功能。
- 🔌 套餐内 MCP 反代 —— ZCode 官方插件 MCP（天眼查 / Wind / 同花顺 iFinD…）中继到本机
/mcp/*（需 coding-plan 登录，GET /mcp查看列表）；自带网页聊天还能外挂你自己的 MCP 服务器给模型当工具用。 - 🪟 全平台 —— Windows / macOS / Linux 一份代码直接跑，也能编译成单文件程序或 Docker 部署。
第 1 步：从GitHub Releases下载最新版本的exe
没错，这就完了，就是这么简单
启动后进入终端控制面板（这就是主界面）：
面板四块卡：登录与设置（服务商 / 套餐 / 登录）、套餐用量（余量占比条 + 重置倒计时，按 r 或点 Refresh 刷新）、代理服务（启动停止 / 当前配置）、日志（每个请求一行，实时滚动）。按 s 启动代理，看到 Status: running 就绪了。
用不惯键盘快捷键？面板上的按钮支持鼠标点击。想让它在后台静默运行？
zcode-proxy.exe --cli serve。
| 按键 | 作用 |
|---|---|
| s | 启动 / 停止代理 |
| l | 登录当前服务商（打开浏览器授权） |
| L | bigmodel 粘贴登录（回退模式；l 登录本身就免回调，无头可用） |
| o | 退出登录 |
| p / t | 切换服务商（Z.AI ↔ 智谱）/ 套餐（coding-plan ↔ start-plan） |
| r | 刷新套餐用量 |
| ↑↓ / PgUp / g | 滚动日志 / 回到底部 |
| c | 清屏日志 |
| q | 退出面板 |
代理启动后，本机地址就是 http://127.0.0.1:8080。你的工具只需要改两样东西：接口地址和模型名。
关于「API Key」：如果你在配置里设置过 auth.proxyApiKey（或环境变量 ZCODE_PROXY_API_KEY），工具里就填同一个值；没设置的话随便填（如 sk-1234），本机自用不校验。
Claude Code（点开看配置）
# macOS / Linux
export ANTHROPIC_BASE_URL=http://127.0.0.1:8080
export ANTHROPIC_AUTH_TOKEN=sk-1234
export ANTHROPIC_MODEL=glm-4.7
claude# Windows PowerShell
$env:ANTHROPIC_BASE_URL = "http://127.0.0.1:8080"
$env:ANTHROPIC_AUTH_TOKEN = "sk-1234"
$env:ANTHROPIC_MODEL = "glm-4.7"
claudeCodex CLI（走 Responses 接口）
编辑 ~/.codex/config.toml：
model_provider = "zcode"
model = "glm-5.3"
[model_providers.zcode]
name = "ZCode Proxy"
base_url = "http://127.0.0.1:8080/v1"
wire_api = "responses"
env_key = "ZCODE_API_KEY" # 任意非空值即可，除非你设置了代理密钥其他 OpenAI 兼容工具（Cherry Studio、Kilo Code、Cline、LobeChat…）
在工具的"自定义提供商 / Custom Provider"里填：
| 设置项 | 值 |
|---|---|
| API 地址 (Base URL) | http://127.0.0.1:8080/v1 |
| API Key | 你的代理密钥（没设就随便填） |
| 模型 | glm-4.7、glm-5.3、glm-4.6v 等，见下方模型表 |
Anthropic 格式的工具（如某些 Claude 客户端）地址填 http://127.0.0.1:8080，路径 /v1/messages 代理会自动接。
想先手动试一下？打开 http://127.0.0.1:8080/webui 就有自带聊天页；或者用 curl：
curl http://127.0.0.1:8080/v1/chat/completions -H "Content-Type: application/json" -d '{
"model": "glm-5.3-flash",
"messages": [{"role": "user", "content": "你好！"}]
}'从 GitHub Releases 下载最新的 apk 安装即可。
App 与电脑版功能对应：一键启动代理、扫码级简单配置、实时日志、切换服务商与套餐、亮暗双主题。
| 主页 | 日志 | 设置 | 暗色主题 |
|---|---|---|---|
 |
 |
 |
 |
手机和电脑跑的是同一套核心：App 内置了完整的代理引擎，手机本身就是一个独立的代理服务器，局域网内的电脑也可以连手机上的代理地址一起用。
Docker 部署
# 在宿主机上用固定加密种子登录（两种服务商都免本机回调：链接在任何设备打开即可，登录自动完成）
ZCODE_PROXY_CREDENTIAL_SECRET="一串只有你知道的口令" \
bun run src/index.ts auth login zai
docker run -d --name zcode-proxy -p 8080:8080 \
-v "$(pwd)/config.yaml:/data/config.yaml:ro" \
-v "$(HOME)/.zcode-proxy/credentials.json:/home/bun/.zcode-proxy/credentials.json:ro" \
-e ZCODE_PROXY_CREDENTIAL_SECRET="一串只有你知道的口令" \
ghcr.io/tridefender/zcode-proxy:latest镜像多架构（amd64 / arm64），以 bun 用户运行。compose 写法：
services:
zcode-proxy:
image: ghcr.io/tridefender/zcode-proxy:latest
ports: ["8080:8080"]
volumes:
- ./config.yaml:/data/config.yaml:ro
- ./credentials.json:/home/bun/.zcode-proxy/credentials.json:ro
environment:
ZCODE_PROXY_CREDENTIAL_SECRET: "一串只有你知道的口令"
restart: unless-stopped可调的配置与环境变量（改不改都能跑）
配置文件是项目根目录的 config.yaml（首次启动自动生成，完整注释见 config.example.yaml），环境变量优先级更高。常用的：
| 环境变量 | 默认 | 说明 |
|---|---|---|
ZCODE_PROXY_PORT |
8080 |
监听端口 |
ZCODE_PROXY_API_KEY |
无 | 客户端访问代理用的密钥（不设=不校验） |
ZCODE_PROVIDER |
zai |
服务商 zai / bigmodel |
ZCODE_PROXY_CONFIG |
config.yaml |
配置文件路径 |
ZCODE_PROXY_CREDENTIAL_SECRET |
机器相关 | 登录凭据的加密种子（跨机器迁移/Docker 时需要固定它） |
ZCODE_LOG_FORMAT |
桌面表格 | 设为 compact 可得到单行日志（适合窄屏） |
ZCODE_PANEL_ENABLED |
关 | 设为 1/true 后，无界面的 serve 模式（含 Docker）额外启动一个本机 Web 面板 |
ZCODE_PANEL_TOKEN |
无 | 面板的访问令牌，开启面板时必填（不填则面板不启动，避免裸奔的控制接口） |
ZCODE_PANEL_PORT |
8090 |
面板端口（只监听 127.0.0.1） |
ZCODE_UPDATE_CHECK |
开 | 设为 off/0 关闭启动时的「有新版」检查（只提示，不自动更新） |
ZCODE_UPDATE_SKIP |
无 | 逗号分隔要忽略的版本，如 v4.7.6,v4.7.7 |
套餐类型（plan: coding-plan 个人套餐 / start-plan 体验套餐）在面板里按 t 切换，会写回 config.yaml。
服务器这类没有 TUI 的场景，可以让浏览器来看：设 ZCODE_PANEL_ENABLED=1、ZCODE_PANEL_TOKEN=<一段你自己的随机串> 后启动，再用 SSH 端口转发打开 http://127.0.0.1:8090 —— 能看状态和额度、切服务商/套餐、登录登出、看实时日志和 MCP 列表。面板只绑回环、每次调 API 都要带 token，没有 token 不启动；命令走进程内分发，不会再额外开一个控制端口。面板上的「Stop proxy」只停代理，进程本身仍能正常退出（SIGTERM/SIGINT 和面板的 shutdown 都会先清掉后台定时器——自动领取、验证码池——再退出）；在面板里登出会同时清掉运行中的凭据并停掉代理，避免登出后新请求还继续花旧账号的额度。
有新版提示：serve 和 TUI 启动时会异步向 GitHub 查一次 latest release，最多多打一行日志（TUI 里按 u 可手动重查），不阻塞启动、不影响代理；离线、被挡、限流或返回格式变了都一律静默忽略。手动检查总会给你明确答复（「已是最新」或「检查不可用」）。容器里镜像是不可变的，所以提示给的是当前运行时的拉取命令（Docker 为 docker compose pull && docker compose up -d，Podman 为 podman compose pull && podman compose up -d；认不出运行时则只说「拉取新镜像后重建容器」），而不是自己去替换文件（release 目前也没有校验和，所以不做自动下载替换）。不想让它查就设 ZCODE_UPDATE_CHECK=off，某个版本太吵可以 ZCODE_UPDATE_SKIP=v4.7.6 忽略。
Docker 里怎么连面板：面板只监听容器自己的 127.0.0.1，所以默认 bridge 网络下 -p 8080:8080 映射不出来，只补一个 -p 8090:8090 也连不上（端口映射到的是容器的非回环地址）。Linux 服务器上用 host 网络，让容器直接用宿主机回环：
services:
zcode-proxy:
# 保留现有 image / volumes / restart 等配置
network_mode: host # host 模式下删掉原来的 ports:
environment:
ZCODE_PROXY_CREDENTIAL_SECRET: "一串只有你知道的口令"
ZCODE_PANEL_ENABLED: "1"
ZCODE_PANEL_TOKEN: "${ZCODE_PANEL_TOKEN:?请先在 .env 里设置面板 token}"
ZCODE_PANEL_PORT: "8090"然后在本机建一条只转发的隧道（-N 不开 shell）：
ssh -N -L 8090:127.0.0.1:8090 user@host再打开 http://127.0.0.1:8090。host 网络下代理主端口也直接占用宿主机端口，安全组/防火墙照旧按原来放行 8080，不要对外放行 8090。
进阶功能：闲时通道 & 套餐自动领取
闲时通道 (/async/*) —— 凌晨等错峰时段官方释放的免费算力通道。请求先排队领票，轮到了自动发给模型（适合不着急的批量任务）。config.yaml 里 async.enabled: true 打开；注意它一次性、不带会话记忆，多轮对话要把历史放进请求里。
周末/体验套餐自动领取 (claim) —— 默认开启。代理每 5 分钟探测一次官方的限量套餐活动页，上新瞬间自动帮你抢（claim.enabled: false 可关闭）。手动抢：bun run src/index.ts claim。
额度显示 (quota) —— 登录后面板会自动查一次额度，之后按 r 手动刷新。数据来自上游两个额度平面：体验/积分制套餐的积分桶（billing/balance，剩余 / 总额、到期时间），以及个人编码套餐的用量窗口（/api/monitor/usage/quota/limit，与官方用量面板同源，5 小时 / 周窗口的剩余额度与重置时间——上游 number 不是可与剩余比较的总量，所以与 CLI/TUI 一致只显示剩余，只有上游给出百分比时才画比例条）。命令行直接查：bun run src/index.ts quota（对应 HTTP 接口 GET /quota）。注意上游网关对频繁查询有限速，所以面板不做定时轮询。
代理会把下面这些模型挂在 /v1/models 上（模型列表只是展示，其他模型名也会照常转发）：
| 模型 | 上下文 | 最大输出 |
|---|---|---|
glm-4.5-air |
131K | 96K |
glm-4.6 |
200K | 131K |
glm-4.6v（视觉） |
131K | 32K |
glm-4.7 |
200K | 131K |
glm-5 / glm-5-turbo |
200K | 64K |
glm-5v-turbo（视觉） |
200K | 131K |
glm-5.1 |
200K | 64K |
glm-5.2 |
1M | 128K |
glm-5.3 / glm-5.3-flash |
1M | 128K |
启动就退出，提示 Not logged in？
先登录：bun run src/index.ts auth login zai（或 bigmodel）。登录一次即可，凭据加密保存。
端口 8080 被占了？
环境变量换一个：ZCODE_PROXY_PORT=8081 bun run src/index.ts，或改 config.yaml 的 server.port。
工具一直连不上 / 401？
如果你设置过 ZCODE_PROXY_API_KEY，工具里必须填同一个值；不设置则免密。注意密钥开启后除 /webui 外所有路由（包括 /health）都要带密钥。
换电脑 / 重装系统后要重新登录吗？
要。凭据加密时绑定了本机信息。跨机器迁移可以两边都设 ZCODE_PROXY_CREDENTIAL_SECRET 为同一个值再登录/拷贝 ~/.zcode-proxy/credentials.json。
服务器上没有浏览器怎么登录？
直接登录即可：bun run src/index.ts auth login zai（或 bigmodel）。登录链接在任何设备的浏览器打开都行，授权后本机自动完成（无需回调页面）。若想手动交换，也有粘贴模式：auth login bigmodel --paste，把跳转后的完整网址粘回来即可。
它在后台到底做了什么？ 它就是一个"翻译官 + 传话员"：把你的工具发出的标准请求翻译成官方客户端的同款请求转发上去，再把回复原样翻译回来。所有流量都只在你本机和官方服务器之间，不经过任何第三方。
bun test # 跑测试
bun x tsc --noEmit # 类型检查
bun run dev # 开发模式启动面板架构与实现细节见 src/ 下各源码文件内的注释。
本代理完全本地运行：无遥测、无分析、无任何形式的外发报告。你的使用数据、设备信息与配置不会离开本机；debug/dump 日志会自动脱敏 API key、JWT 与 proxy key。
MIT