cx2cc-connect

一个可执行文件，把本机的 Claude Code 接入 cx2cc 服务。
不需要 Tailscale、cc-switch，也不需要配置 SSH 或开放任何入站端口。

下载

Windows x64 2.9 MB · 双击安装-install.bat 下载 → macOS 5.4 MB · Apple 芯片 & Intel 下载 →

SHA-256（校验文件）
windows ea186ac0dce4b2a1082bd4166a5fbea1590cc37b56b0f4ad0e993e5faf36077c
macos f40263dfa74f62bf86dc16bd8873245a1c9d6f63aad5563d421de99b97e22812

还需要一份凭据。 程序本身不含任何密钥，所以可以放心传播；连接凭据由分发者单独提供，形式是一个 cx2cc-connect.json 文件，或一行 cx2cc1. 开头的激活码。没有它程序会直接报错退出。请向给你这个链接的人索取。

安装

Windows：解压后双击 安装-install.bat。没有凭据文件时它会提示你粘贴激活码。

macOS：解压后 右键点击 双击安装.command → 打开。二进制未签名，直接双击会被 Gatekeeper 拦下，走右键「打开」可以放行。

不要双击 bin/ 里的文件——无扩展名的二进制会被 Finder 当成文本文档打开，提示「文本编码 Unicode (UTF-8) 不适用」，那不是文件损坏。

装完必须重启 Claude Code。 它只在进程启动时读取配置，正在运行的会话仍然用旧设置——这不是安装失败。关掉重开，或新开一个终端运行 claude。

常用命令

命令	作用
`install`	设置环境变量、接管 Claude Code 配置、保存凭据、注册开机自启、打通隧道
`status`	隧道状态、订阅剩余用量、上游账号池
`uninstall`	还原所有改动、删除凭据、停止隧道
`run`	前台运行隧道，排查问题时用它看日志

# Windows
& "$env:LOCALAPPDATA\cx2cc-connect\cx2cc-connect.exe" status

# macOS
"$HOME/Library/Application Support/cx2cc-connect/cx2cc-connect" status

它改了什么

安装会接管 ~/.claude/settings.json 里的三个 ANTHROPIC_* 键—— 因为 Claude Code 读这个文件的优先级高于 shell 环境变量，只改环境变量的话隧道通了也不会被用上。原值有完整备份， uninstall 精确还原，其余内容（模型映射、hooks、权限）一律不动。

本地端口默认 18901，被占用时会自动向上扫描换一个空闲端口，并同步更新配置，不需要手工干预。

连不上时

输出关键字	处理
`reset by peer`	本机代理以 TUN/透明模式拦截了连接，给提示中的地址加直连(DIRECT)规则，或临时关闭 TUN
`timeout` / `refused`	出站 22 端口被网络或本机防火墙封锁
`unable to authenticate`	凭据已失效，向分发者索取新的
`host key mismatch`	中继身份与凭据不符，不要忽略，请联系分发者

隧道断开后会自动重连（指数退避），无需人工干预。压缩包内的 README.md 有完整说明，AGENT-SETUP.md 是给 AI 助手照着执行的操作手册。

交给 AI 助手装

把压缩包解压后，对你的 Claude Code 说这一句即可：

解压这个压缩包，读取其中的 AGENT-SETUP.md，按它执行安装并验证。