CC Desk Tunnel：在 VPS 跑 Claude Code 并直接操作本机 Windows 项目

本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：

我的帖子已经打上开源推广标签： 是
我的开源项目完整开源，无未开源部分： 是
我的开源项目已链接认可 LINUX DO 社区： 是
我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是
以上选择我承诺是永久有效的，接受社区和佬友监督： 是

以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出

各位佬你们好，这里分享一个自己折腾出来的小工具，叫 CC Desk Tunnel。

我之前模型一直都用的OAI pro20x拼车，最近一个月实在不怎么太平，降智、降额度各种问题层出不穷，并且苦于gpt逆天的防御编程和蜗牛般的速度久矣。最近实在忍不住斗胆开了一个claude号，用过opus5.5后惊为天人。但是因为众所周知的claude封号问题，我自己不敢使用CPA反代，也不敢在自己本地电脑直接安装claude code，于是想到了将claude code搬到vps上运行的解决方案，不用折腾本地电脑的运行环境，不用担惊受怕哪里没设置好。并且丢到vps上跑也确实挺省事的。

体验了几天后，发现远程桌面使用claude code实在是太麻烦了，需要vps有一定的配置，还需要来回搬运项目代码。这还没完，如果碰到调试部署任务，本地的一些内网环境在vps上根本不存在，只能先用claude开发完拷贝回本机，再让codex调试，这体验简直了。
因此我想到了一个想法，有没有办法让Claude Code 放在远程服务器上跑，但项目、编译器、编辑器这些都继续留在 Windows。希望claude能直接在本机干活，使用体验就像本机软件一样，点开、选项目、开聊，不用一直挂着远程桌面，也不用在两台机器之间来回同步代码？如果进一步，还能给Cli美化一下，套个app壳子不就更好了？
于是就有了本项目的想法。

仓库：cc-desk-tunnel

安装包：GitHub Releases

效果示意截图

结构原理

Linux 服务器： Docker 里跑未修改的官方 Claude Code。模型请求从服务器发出，原生会话与登录也保存在服务器的持久数据目录。
Windows 本机： 桌面客户端，负责聊天、项目和设置界面。本机的文件读写、编译、测试。
控制消息WSS通道： 将本机APP中的会话提问等操作发送到远端Claude Code上执行，并将Claude Code的运行情况实时回传给本机显示。
frp + OpenSSH通道： 将本机Windows的命令执行能力挂载到远端Claude Code上，使得其能直接通过命令操作本机。

如果你本来就习惯在自己的 VPS 上跑 CC，又不喜欢远程桌面或者终端，本项目能恰好提供一个中间桥梁：运行端还是那台服务器，操作起来更接近本机桌面。

功能简介

基本的coding agent软件功能，如建立项目，在项目下建会话；会话可以搜索、改名、删除、分叉等。
美观的查看看流式回复、思考摘要和工具入参、结果、中途干预等。可以理解为CLI的UI美化版。
模型、推理强度、审批模式、上下文占用和主动压缩，以及部分 Claude Code 设置。
从客户端走官方授权登录、退出，查看用量；另外有草稿保存、托盘和定时发送提示词。

安全提醒

项目为Vibe Coding为主 仅是个人项目，主要靠AI编写，不够成熟，不能保证安全性，是否接受需要佬们自行判断。

服务器安全 服务器一定要是自己控制、可信的。连上以后，它就能直接操作你的本地电脑。

报毒问题 frpc这类主流隧道工具因为经常被滥用，可能被归成远控或风险软件，我自己开发测试时也遇到过杀毒软件报毒。如果担心风险，也可以自己从源码编译使用。

不保证账号不被封 虽然CLI 在服务器，模型请求也从服务器出去，理论上就是原生的外网运行环境；但是claude封号原因非常复杂，很难说这种方式就能保证账号不被封，并且封号也可能与IP干净程度、支付方式等有关。建议优先选择允许使用地区的、IP比较干净的VPS。

也在此欢迎大家给出参考意见。