Cc Desk Tunnel — Development skill for Claude Code

CC Desk Tunnel（CC 桌面隧道）

**简体中文** | [English](README.en.md)

用桌面客户端驱动云端的 Claude Code，经反向隧道在你的 Windows 本机执行。

Claude Code（简称 CC）运行在一台 Linux 服务器上；项目代码、编译器和各种工具都留在 Windows 本机。CC Desk Tunnel 把两端接起来：服务器上是一个容器，Windows 上是一个桌面客户端，Claude 通过一条加密的反向 SSH 通道在你的电脑上读写文件、执行命令。

[下载](https://github.com/sun168567/cc-desk-tunnel/releases/latest) · [快速开始](#快速开始) · [安全须知](#安全须知) · [文档](#文档) · 许可：[Apache-2.0](LICENSE)

[!WARNING] **本项目主要由 AI 编写**，由个人维护，没有经过专业的安全审计，可能存在尚未发现的缺陷。它会让一台服务器获得在你电脑上执行命令的能力，使用前请读完[安全须知](#安全须知)和[账号须知](#账号须知)，并自行评估风险。

本项目与 Anthropic 没有隶属或合作关系。“Claude”“Claude Code”是 Anthropic 的商标。

解决什么问题

常见做法	麻烦在哪	用 CC Desk Tunnel
把项目搬到服务器上，让 Claude Code 在那里开发	要在服务器上重装一遍工具链；编译、测试吃配置，得买高配机器；用不了本机的编辑器、模拟器和各种桌面软件	项目和工具链留在本机，命令在本机执行；服务器只跑 Claude Code，低配即可
用远程桌面或 SSH 终端操作服务器上的 CLI	画面延迟、中文输入和复制粘贴别扭，长输出难以翻阅	本机的桌面应用，原生的输入、滚动和复制
直接使用命令行界面	多个项目和会话不好管理，工具调用和思考过程挤在一屏滚动的文字里	按项目分组的会话列表，过程折叠成摘要、可逐级展开

工作方式


• Windows 主动连出，不需要公网 IP，也不需要开放任何入站端口。
• 每次连接临时生成 SSH 密钥，断开即销毁；Windows 上不安装常驻服务。
• 项目只是官方 Agent SDK 与未修改的官方 Claude Code 之上的一层胶水：不改 CLI 本体，不替换它的工具、审批和上下文管理。会话与长期记忆由云端的 Claude Code 自己保存。

本仓库公开客户端、服务端以及构建、部署脚本的全部自有源码，不另设闭源功能。**这不意味着 Claude Code 也被本项目开源**：官方 CLI 与 Agent SDK 由官方渠道安装，仍按 Anthropic 的条款使用；随包的第三方组件各自遵循其许可，详见 [NOTICE](NOTICE)。

功能

项目与会话	按 Windows 文件夹分组；新建、改名、删除、搜索、分叉；从任意一条自己的消息“编辑重发”
对话过程	流式回复、思考摘要、工具调用的入参与结果；运行中追加消息、随时停止
原生控制	模型、推理强度、审批模式、上下文占用与主动压缩、Claude Code 常用设置；需要时打开内嵌的原生终端
账号与用量	在客户端里登录 / 退出云端的 Claude 账号，查看额度、重置时间和调用统计
定时任务	到点向指定会话或新会话发送预设提示词，也可以直接让 Claude 帮你设置
省心	托盘后台、记住凭据与自动登录、未发送内容按会话保存
一键升级	服务端跟踪发布页；在客户端里点一下即可升级服务端和客户端，不必登录服务器

快速开始

需要：一台有公网 IP 或域名的 Linux 服务器（x86_64，推荐 Ubuntu，已安装 Docker），和一台 Windows 10 / 11 x64 电脑。

**服务器不需要高配。** 编译、测试和各种开发工具都在 Windows 本机运行，服务器上只有 Claude Code 和一个轻量的代理服务，2 核 1 GB 内存的入门