Chatbox 添加代理支持

简介

Chatbox 是一款跨平台 AI 聊天客户端，支持 Windows、macOS、Linux 和网页端。它通过统一接口接入多种大模型，为你提供高效的对话管理、提示词模板和本地数据存储，让 AI 使用更私密、更顺手。本页将带你快速上手。（Chatbox 当前收录版本 以本页标注为准，适用 win/x64 环境，适合需要「Chatbox 添加代理支持」的用户与团队直接使用。）

为什么需要为 Chatbox 添加代理支持

Chatbox 是一款开源的桌面端 AI 聊天客户端，通过调用 OpenAI、Claude 等第三方 API 提供对话能力。在部分地区或公司网络环境下，直接访问这些接口可能受阻，导致请求超时、连接被重置。此时为 Chatbox 添加代理支持，让所有 API 请求经由本地或远程代理转发，是恢复通信最直接的方案。

核心操作：在设置中配置代理

打开 Windows 版 Chatbox，进入「设置」面板，找到网络或代理相关选项（不同构建版本入口略有差异）。常见配置方式有两种：

• HTTP/HTTPS 代理：填写代理地址，例如本机 Clash 默认端口 http://127.0.0.1:7890，适用于大多数代理工具。
• SOCKS5 代理：若你的代理工具仅提供 SOCKS5 协议，填入 socks5://127.0.0.1:1080 形式的地址。

保存后发送一条测试消息，若返回正常回复，说明代理已生效。若失败，请先确认代理软件本身能访问目标 API 域名。

通过环境变量全局生效

部分用户反馈设置界面未找到代理项，此时可借助环境变量实现 Chatbox 添加代理支持。右键「此电脑 → 属性 → 高级系统设置 → 环境变量」，新建用户变量：

• HTTP_PROXY = http://127.0.0.1:7890
• HTTPS_PROXY = http://127.0.0.1:7890

配置完成后完全退出并重启 Chatbox，进程才会读取新变量。该方法对基于 Electron 的应用普遍有效。

使用建议

优先使用本地代理工具（Clash、v2rayN 等）并开启「全局模式」或「规则模式中放行 API 域名」，避免代理节点频繁切换导致流式响应中断。若同时使用多个 API 提供商，建议为每个提供商单独测试一次连通性。项目开源地址为 github.com/Bin-Huang/chatbox，遇到疑难可查阅 Issues 中关于 proxy 的历史讨论。

注意事项

配置代理后，API Key 仍由 Chatbox 本地保存并直发给服务端，代理仅转发流量，请勿使用不可信的公共代理。若代理工具关闭，记得同步移除环境变量，否则 Chatbox 将无法连接任何接口。

核心功能

• 下载前展示真实文件名「Chatbox」、版本 以页面为准、文件大小 以页面为准，以及适用平台 win/x64，便于逐项核对后再获取。
• 本站提供已校验的下载通道（quark 网盘，提取码随页面展示），并保留官方站点入口作为备用来源。
• 能力覆盖：github_project|开源项目,ai|AI 项目，可按需选取对应功能模块。

使用场景

• 需要在本机部署或重装 Chatbox（当前版本），并希望先核对版本与文件信息再获取的场景。
• 处理「Chatbox 添加代理支持」相关需求、希望一次性拿到可核对文件与步骤时。
• 需要在多台设备使用同一 Chatbox 版本（当前版本），便于统一环境与后续排查时。

安装与校验

• 获取前先核对文件名、文件大小与版本号（本页：Chatbox / 以页面为准 / 以页面为准），逐项比对后再继续。
• 通过本页「quark 网盘」通道转存到自己的网盘后再取回文件，可避免直接下载中断造成的文件不完整。
• 解压后先确认 Chatbox 主程序能否正常启动，再决定是否替换原有版本。
• 如遇安全软件拦截，请先确认来源为本页收录渠道，再决定是否放行。