在一个 Web 页面中,管理多台服务器上的 Claude Code 会话。
远程处理会话,保留历史切换供应商,集中管理官方 OAuth Token 与订阅用量。
简体中文 · English
快速开始 · 首次使用指南 · 项目主页 · 打开网页客户端 · 下载
界面示例;实际样式以当前版本为准。
把家里的电脑、工作站或远程服务器添加到同一个网页,在服务器之间切换、按项目浏览会话。可以新建 Claude Code 会话、继续已有对话、查看流式回复和工具过程,并处理审批与提问;手机浏览器也能使用。
每台服务器分别运行 CC Remote 后台,会话在对应服务器上执行,关闭网页不会停止后台任务。远程访问前,需要先配置好可达的网络地址、HTTPS 和访问令牌;使用独立网页连接多台服务器时,还需要允许该网页的来源。
连接方式见首次使用指南,多服务器与 HTTPS 配置见独立网页前端。
直接读取服务器上的 CC-Switch 配置,在新建会话时选择供应商,也可以为已有 Claude Code 会话更换供应商。切换时保留原会话 ID 和历史,停止旧进程;继续发送消息时自动按新供应商配置恢复会话,无需重新创建对话。
每个会话可以使用自己的供应商,也可以设置新会话的默认供应商。正在执行任务时,切换前会要求确认中断;切换后不会自动重发上一条请求。
配置与使用方式见供应商选择与切换。
集中添加、重命名、更换或删除多个官方账号的 OAuth Token,并像选择供应商一样为会话选择账号。Token 可通过 claude setup-token 获取,保存在对应服务器上;会话继续使用服务器原有的模型、插件、Hooks、MCP 和权限配置。
查看各账号的 5 小时 / 每周订阅额度、重置时间与用量历史,了解哪些账号还有可用额度。后台定期采集,关闭网页或客户端后仍会继续;Windows 托盘也能直接查看账号额度。
添加方法见OAuth 令牌配置,额度与历史说明见订阅用量监控。
- 终端与网页接力:在项目里运行
ccr开始 Claude Code 会话,按Ctrl+]断开后任务继续运行;在网页处理任务,回来再用ccr接入。 - Windows 桌面客户端:通过独立标签页同时连接多台服务器,提供前进、后退、刷新和应用内更新;内置托盘可悬停查看用量。
- 手机与 PWA:从手机查看进度、回复消息和处理审批,也可将网页安装为 PWA。
- Codex 会话:支持新建托管会话、读取本机历史并导入继续,具体范围见下方对照表。
CC Remote 是自托管工具。会话使用服务器上的 CLI 与配置运行,模型请求发往你选择的提供方。
| 你想做什么 | 使用方式 |
|---|---|
| Windows 客户端和用量托盘 | 下方 Windows 完整安装,支持 x64 |
| Linux / macOS 或 Windows ARM64 宿主 | 安装后台,使用它自带的网页 |
| 在手机上接着处理任务 | 先安装宿主,再按手机连接指南配置网络 |
| 用同一个网页连接多台宿主 | 打开公共网页客户端,先阅读连接要求 |
网页客户端需要连接你自己的、正在运行的宿主;公共页面不提供云端计算或预置账号。默认监听地址只允许本机访问。
在运行宿主的同一个系统账户下,按需安装并登录 Claude Code 或 Codex CLI。只使用其中一个时,安装对应 CLI 即可。
claude auth login # 使用 Claude Code
codex login # 使用 CodexWindows x64:后台 + 桌面客户端 + 内置托盘(PowerShell 5.1 / 7):
irm https://github.com/huanfeng/cc-remote/releases/latest/download/install-desktop.ps1 | iexLinux / macOS:后台 + 网页界面:
curl -fsSL https://github.com/huanfeng/cc-remote/releases/latest/download/install.sh | shWindows 仅安装后台(x64 / ARM64)
irm https://github.com/huanfeng/cc-remote/releases/latest/download/install.ps1 | iex安装脚本下载最新正式版、校验 SHA256、注册并启动当前用户的后台服务,同时创建 ccr 命令。安装后找不到 ccr 时,新开一个终端即可。
Windows 客户端:点击托盘图标或从开始菜单打开 CC Remote,在「本机服务」中连接。
浏览器:打开 http://127.0.0.1:8787,按首次使用指南读取本机访问令牌并连接。然后点「新建」,选择 Claude Code 或 Codex,以及宿主上已有的项目目录。
Claude Code 终端接力:在项目目录运行:
cd your-project
ccr
# Ctrl+] 断开,任务继续运行;再次运行 ccr 接回。本机跑通后,再连接手机:局域网访问、远程访问与连接排查。
| 能力 | Claude Code | Codex |
|---|---|---|
| 网页 / 桌面客户端新建托管会话 | 支持 | 支持 |
| 流式回复、工具过程、审批与提问 | 支持 | 支持 |
| 读取本机历史并导入继续 | 支持 | 支持 |
ccr 终端与网页接力、网页终端视图 |
支持 | 暂不支持 |
| 官方订阅额度 | 支持的官方登录 / OAuth 账号 | 本机官方登录账号 |
后台支持 Windows、Linux、macOS;原生客户端发布包和图形化悬停托盘目前提供 Windows x64。订阅额度由提供方实际返回,API Key / 第三方配置不保证有订阅读数。更多边界见 Codex、订阅监控和已知限制。
ccr 和 cc-remote 是同一个入口,以下用短名称:
ccr # 选择当前项目会话,没有则新建
ccr ls # 浏览并接入最近的终端会话
ccr --resume <会话ID> # 恢复 Claude Code 会话
ccr -c # 继续当前目录最近的 Claude Code 会话
ccr status # 查看后台状态
ccr logs -f # 查看后台日志
ccr update # 仅更新命令行与后台列表支持上下键、编号加回车、/ 筛选、r 刷新和 q / Esc 退出。完整用法见使用说明。
更新客户端和托盘:签名正式版会自动检查更新,可从「… → 关于与更新」、设置或托盘中下载安装。也可以重新执行 Windows 完整安装命令;配置、账号与历史会保留。ccr update 单独更新命令行与后台。详见桌面应用。
| 我想…… | 阅读 |
|---|---|
| 从安装到完成第一个任务 | 首次使用指南 |
| 用手机连接、找到令牌、排查连不上 | 连接与排查 |
| 学会会话、审批、附件与文件查看 | 使用说明 |
| 使用 Codex 或继续原生历史 | Codex 指南 |
| 保留会话切换供应商、配置官方 OAuth Token | 供应商配置 |
| 查看多账号额度和历史 | 订阅监控 |
| 使用桌面客户端、托盘与本机路径菜单 | 桌面应用 |
| 配置代理、模型、服务环境或监听地址 | 配置说明 |
| 部署独立网页、配置 HTTPS 或反向代理 | 独立网页 · 安全说明 |
| 手动下载、更新或卸载 | 发布与安装 |
| 从源码构建、开发或贡献 | 开发指南 · 架构 |
手机能直接打开本机的 127.0.0.1:8787 吗? 不能,手机上的 127.0.0.1 指向手机自己。请使用宿主电脑的局域网地址或配置好的远程地址,见连接指南。
关掉浏览器或断开终端,任务还在吗? 只要宿主及其会话进程仍在运行,任务就会继续。Ctrl+] 是断开终端;停止任务请在会话中使用停止操作。
终端能用,服务里却报错? 后台服务不加载 shell 配置,CLI 路径、账号与代理环境可能不同。按连接与环境排查检查。
访问令牌拥有在宿主上执行代码的权限。默认仅监听本机;局域网 HTTP 是明文连接,远程访问请配置可信网络或 HTTPS,并妥善保管令牌。见安全说明。
使用中遇到问题,请在 Issues 提供版本、系统、复现步骤和去除敏感信息的日志;功能建议和改进也欢迎提交。开发前请阅读开发指南。
如果 CC Remote 帮你把任务从工位带到了手机上,欢迎分享项目地址,或点一个 Star,让更多使用 Claude Code / Codex 的人找到它。

