Qwen Studio Browser Gateway

English

非官方的仅限 localhost 的网关，通过手动授权的 chat.qwen.ai web 会话，为 Claude Code 提供一个不受信任的 Qwen 3.8 Max 专家意见。这不是官方 Qwen API，不是主要代理，也不是保证正确回答的来源。用户在每个主机上手动登录；项目不传输 cookies/tokens，不绕过 CAPTCHA/MFA，也不允许 Qwen 访问 shell、文件系统或本地 tools。

流程

Claude Code
  └─ MCP ask_qwen_expert
       └─ http://127.0.0.1:8798/v1/expert
            └─ FIFO, active = 1
                 └─ CDP http://127.0.0.1:9333
                      └─ одна видимая вкладка https://chat.qwen.ai
                           └─ точная Qwen3.8-Max

每次 Send 之前，网关都会选择并确认 qwen3.8-max / Qwen3.8-Max。模型不匹配、未知的 DOM、challenge、未登录或远程 endpoint 都会以错误结束。Send 之后，浏览器生成不会自动重复。

Related MCP server: cc-in-codex

要求

• Node.js 22+；

• 带图形界面的 Chrome/Chromium；

• Linux 用于现成的 systemd user templates（Node.js 网关本身可移植）；

• 自己的 Qwen 账户，并有权使用 web 服务。

安装

npm ci
npm run check
npm run build
npm test

创建私有配置：

install -d -m 700 ~/.config/qwen-studio-browser-gateway
cp .env.example ~/.config/qwen-studio-browser-gateway/server.env
chmod 600 ~/.config/qwen-studio-browser-gateway/server.env

编辑 server.env：

• 设置本地的 QWEN_BROWSER_EXECUTABLE_PATH；

• 为此主机生成一个新的随机 QWEN_LOCAL_API_KEY；

• 不要更改 loopback endpoints；

• 使用前在实时 UI 中确认当前最强模型的 ID/label。

不要提交 server.env 和 browser profile。

手动登录

启动一个独立浏览器：

set -a
source ~/.config/qwen-studio-browser-gateway/server.env
set +a
./start-qwen-browser.sh

在打开的窗口中自行登录 https://chat.qwen.ai。CAPTCHA 和 MFA 只能由用户完成。保持一个 Qwen 标签页打开。

在另一个终端中启动网关：

set -a
source ~/.config/qwen-studio-browser-gateway/server.env
set +a
node dist/cli.js serve

对于常驻 Linux user service，请使用 systemd/ 中的模板和 docs/setup.md 中的说明。

安全冒烟测试

这些请求不会启动生成：

node dist/cli.js browser doctor
curl -fsS -H "Authorization: Bearer $QWEN_LOCAL_API_KEY" \
  http://127.0.0.1:8798/health
curl -fsS -H "Authorization: Bearer $QWEN_LOCAL_API_KEY" \
  http://127.0.0.1:8798/v1/models
node dist/cli.js mcp install-config

POST /v1/expert 和 POST /v1/chat/completions 会执行真实的 web 生成，并可能消耗配额。

Claude Code MCP

在 npm run build 之后执行：

node dist/cli.js mcp install-config

该命令会打印带有当前 Node.js 和 dist/cli.js 路径的可移植 JSON。将 qwen-expert 对象添加到 Claude Code 的 MCP 配置中。MCP 只公开 ask_qwen_expert；回答始终标记为 advisory，并且必须独立验证。

安全边界

• HTTP 和 CDP 只接受 loopback endpoints。

• QWEN_WEB_URL 只接受 origin https://chat.qwen.ai。

• 本地 API key 是必需的。

• Prompt 不被记录；screenshots 默认关闭。

• 一个标签页和一条 FIFO 队列可防止响应混淆。

• Qwen 不会获得可执行 tools 或本地文件。

• 本项目不用于绕过网站限制或实现大规模自动化。

更多信息：AGENTS.md、docs/architecture.md、docs/security.md、docs/troubleshooting.md。