免 API Token 使用大模型 - 通过浏览器登录方式免费使用 ChatGPT、Claude、Gemini、DeepSeek、千问国际版、千问国内版、豆包、Kimi、智谱清言、Grok、小米 MiMo、Manus 等 AI 模型。

本项目通过已开启远程调试的 Chrome 完成各平台 Web 登录、保存会话，并对外提供 OpenAI 兼容的 HTTP 接口（GET /v1/models、POST /v1/chat/completions）。

首句为能力概述；实际已接入、可登录的 Web 站点以下表为准（与 src/cli/login.ts 中 ALL_PROVIDER_IDS 一致，当前共 13 个）。登录时把 <id> 传给 pnpm run login -- <id> 或 make login PROVIDER=<id>。

• Node.js ≥ 20

• pnpm（安装）；本仓库用 packageManager 固定版本，可用 Corepack：corepack enable

• 本机可运行的 Google Chrome / Chromium（用于登录与部分「聊天走浏览器」路径）

• 远程调试的 Chrome（--remote-debugging-port）。推荐用本仓库脚本启动，会单独指定 user-data-dir（默认 ~/.zero-token/chrome-debug-profile），避免和日常自用的 Chrome 个人资料冲突。macOS 下使用应用包内的可执行文件，比通过 open --args 更稳定。命令示例：

  make chrome-debug
  # 无窗口，仍开 CDP（需扫码/网页登录时不要用无头，改用有界面：make chrome-debug）：
  make chrome-debug-headless
  # 与 make 的静默不同：终端会打印使用说明，且 Chrome 的「DevTools listening…」会出现时：
  bash scripts/start-chrome-debug.sh
  # 无头、且终端见说明时：
  CHROME_HEADLESS=1 bash scripts/start-chrome-debug.sh

  make chrome-debug / make chrome-debug-headless 在内部均设置 CHROME_DEBUG_QUIET=1，不刷屏；需要排查时可手动运行脚本。脚本可用 CHROME_DEBUG_PORT、CHROME_USER_DATA_DIR 覆盖默认端口与用户目录；无头通过 CHROME_HEADLESS=1 或 make chrome-debug-headless。连接端点用 BROWSER_CDP_URL（默认 http://127.0.0.1:9222）。

  若不用脚本，可手写启动，例如（仅示意，不分离用户目录）：

  /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222

git clone https://github.com/linuxhsj/zero-token.git
cd zero-token
make install
make chrome-debug
make login-all
# 启动服务
make start

在已开远程调试的 Chrome 中打开目标站点并登录，然后执行（以 chatgpt-web 为例）：

make login PROVIDER=chatgpt-web

凭据默认写入 ~/.zero-token/credentials.json（可用 ZERO_TOKEN_DATA_DIR 改目录）。

启动网关：

make start
# 或指定端口
PORT=3001 make start

健康检查：

make health

Makefile 只是对 pnpm / 脚本的薄封装，可直接用等价命令：

也可在项目根目录用与脚本相同入口：node --import tsx src/cli/login.ts <id|all>、node --import tsx src/server.ts（启动前建议仍通过 pnpm install 安装依赖）。

依次尝试登录全部已支持的 Web 提供方（与上表及 ALL_PROVIDER_IDS 一致，当前共 13 个）。每个站点仍需你在浏览器中完成该站的登录/授权流程；某一站失败会记录错误并继续下一站，结束时会打印成功/失败汇总。

make login-all
# 等价: pnpm run login -- all

服务默认监听 http://127.0.0.1:3000（可用 PORT 修改）。以下路径与 OpenAI Chat Completions 用法一致，便于用任意支持自定义 baseURL 的客户端接入。

鉴权：若设置了环境变量 ZERO_TOKEN_API_KEY，则请求需带 Authorization: Bearer <与之一致的密钥>，否则返回 401。

模型 id：必须为 提供方/模型 形式（与 GET /v1/models 中每条 id 一致），例如 grok-web/grok-2、chatgpt-web/gpt-4、deepseek-web/deepseek-chat。

user 字段（与 OpenAI 相同，可选）：对 qwen-cn-web，网关会按同一 user 同一会话复用千问浏览器/接口侧的 session_id（多轮在能解析到 req_id / parent_req 时还会带上续写）。对 doubao-web 会按同一 user 复用豆包返回的 conversation_id（Samantha 多轮）。不填时进程内会落到默认键，多客户端会共享同一条上游会话，建议为每个终端会话设稳定 user id。

非流式（stream 省略或 false）：

curl -sS "http://127.0.0.1:3000/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ZERO_TOKEN_API_KEY" \
  -d '{
    "model": "grok-web/grok-2",
    "messages": [{ "role": "user", "content": "你好" }]
  }'

未设置 ZERO_TOKEN_API_KEY 时可去掉 Authorization 行。

流式（"stream": true，响应为 SSE，data: {...} 行后接 data: [DONE]）：

curl -N -sS "http://127.0.0.1:3000/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ZERO_TOKEN_API_KEY" \
  -d '{
    "model": "grok-web/grok-2",
    "messages": [{ "role": "user", "content": "你好" }],
    "stream": true
  }'

工具调用（tools）：请求体可带与 OpenAI Chat Completions 相同形态的 tools（仅 type: "function"），parameters 为 JSON Schema 对象。网关将工具定义写入对上游网页模型的 tool_json 提示，并把模型在回复中给出的 fenced tool_json 代码块解析为一次工具调用。响应中助手消息为 OpenAI 兼容的 tool_calls（非流式为完整 JSON；流式在结束前输出带 tool_calls 的 delta 与 finish_reason: "tool_calls"）。多轮时请在 messages 中依序带上 assistant 的 tool_calls 与 role: "tool" 的工具结果。tool_choice: "none" 可关闭本次请求的工具。perplexity-web / doubao-web 不注入工具提示。若使用 浏览器内对话 路径（gemini-web / grok 默认的 CDP，且未将 ZERO_TOKEN_CHAT_VIA_BROWSER=0），不支持 tools，需改为纯流式后重试；chatgpt-web 默认走本仓库流式，可配合 tools（仍受各站风控与模型能力限制）。

拉取模型列表：

curl -sS "http://127.0.0.1:3000/v1/models" \
  -H "Authorization: Bearer $ZERO_TOKEN_API_KEY" | jq .

在代码里用 OpenAI 官方 SDK 指向本机（将 apiKey 与网关侧 ZERO_TOKEN_API_KEY 对齐；若未设网关密钥可填任意非空字符串，以通过客户端校验。需安装 SDK：pnpm add openai）：

import OpenAI from "openai";

const openai = new OpenAI({
  apiKey: process.env.ZERO_TOKEN_API_KEY ?? "unused",
  baseURL: "http://127.0.0.1:3000/v1",
});

const r = await openai.chat.completions.create({
  model: "grok-web/grok-2",
  messages: [{ role: "user", content: "你好" }],
});

其它兼容 OpenAI 的 CLI/应用（如部分 IDE 插件、LiteLLM 等）在配置中把 Base URL 填为 http://127.0.0.1:3000/v1 即可，模型名使用 GET /v1/models 返回的 id。

make typecheck
# 等价: pnpm run typecheck

以 MIT License 发布。上游或自研扩展若再分发，请同时遵守其各自许可证。