开始使用

安装、检查，然后开始

安装后若找不到命令，请打开新终端。安装会保留配对、配置和槽位登录，验证固定摘要的辅助程序；调整 PATH 时会保留备份。安装和就绪检查都不调用模型、不上传项目文件。检查可能需要等待所选槽位准备好。

网关开放时，安装会保存独立的私有连接密钥和 HTTPS 地址。ccfleet local 在你的电脑上启动原版 Claude Code，文件、工具、设置和历史在本地；支持的模型请求经过网关和你选中的自己的槽位。已配对但还没有网关配置的电脑，运行 ccfleet gateway setup 即可。单独安装客户端不会自动开通运营者尚未启用的槽位。

选择模型连接可以使用的账号

可以把模型连接理解为“保存的收件地址，加上一把钥匙”，槽位则是已经登录一个账号的环境。网页用于管理这些选择，CLI 也能完成配置；不需要把两种方式都操作一遍。

在网页上：打开我的槽位 → 连接 Claude。只用 A 时，仅给 A 填 1；需要 B 备选时，再给 B 填 2。不想使用的槽位留空，排序数字不能重复。选择路由方式后保存。只能选择你自己持有的槽位，而且各槽位需要有效的 Claude 登录才能接收请求。

使用 CLI：完成配对后，按需求选择下面的一条命令，把 A、B 换成真实槽位名称。--replace 表示主动替换已经保存的连接，并生成新密钥。

只想让这次启动固定使用 A，可以运行 ccfleet local --slot A。A 必须已经在这个连接的选择范围内；固定后，这次启动不会切到备选槽位，也不能借此使用未选中的槽位或其他用户的账号。

切换只发生在确定安全时。请求发出前已确认的连接失败，或上游明确返回、且被标为可以重试的特定拒绝，可以尝试下一个已选槽位。如果已经开始发送，却不知道对方是否收到，网关会停止，不会猜测重发。一旦已向客户端发送回复头，即使屏幕还没出现文字，流中断时也不会换账号重发。连接密钥错误或请求格式错误，需要先修正问题，换账号不能解决。

保持会话账号需要可识别的会话标识。原版 Claude Code 提供受支持的标识；兼容客户端可发送 X-CCFleet-Session。没有标识时按优先级选择。网关只在有限的运行时内存中保存选择，从正常回复开始起最多保留 24 小时；重启、配置变更或缓存淘汰可能重置它。切换不会搬动文件、合并登录凭证或叠加订阅配额，会话记录仍留在本地。

Base URL 是客户端保存的服务地址。保存地址不会创建本地服务器，也不表示消息存放在这里。/v1/messages 是我们服务上的 Messages API 兼容路径；路径名称相同，不代表这个域名归 Anthropic 所有。HTTPS 请求先到我们的网关，由网关选槽位，再由槽位连接 Anthropic。连接密钥用于向 CC Fleet 证明访问权限，不是 Claude 登录凭证，也不是 Anthropic 付费 API key。

隐私边界：电脑到网关的连接有加密，但网关为了路由会解密，因此可以读取模型消息和回复。原生 Claude 凭证仍保存在槽位。工具可能把文件内容放入模型上下文；文件留在本地，不等于任何文件内容都不会离开电脑。

机器管理员拥有 root 权限，能检查你的槽位，也可能修改转发的回复，进而影响本地工具行为。请选择合适的本地权限，并只放入你愿意信任服务方处理的数据。

路线图与 CC Host 对比见对比指南。2026 年 10 月 11 日记录的真实线上验证使用了一个实际账号；多槽位路由和故障使用受控测试，并非两个真实账号的线上实测。证据范围见验证说明。

本地文件与会话

ccfleet local 启动原版本地 Claude Code，不上传整个项目、不把文件系统挂载到槽位，也不需要 push/pull。CC Fleet 不对本地文件数量、大小或 Git-ignore 另设限制。先 cd 进入项目，或用 --project PATH 指定目录。

再次运行 ccfleet local 会新建会话，--new 明确表示新建；已有历史保留。--resume 打开原生历史选择器，或按 ID/名称恢复；--continue 继续当前目录最近的本地会话。使用 /exit 退出，以后再恢复。原生 Claude 设置与历史，包括已有的 CLAUDE_CONFIG_DIR，仍保存在这台电脑上。

工作目录不是沙箱。原生 Claude 权限决定文件与工具访问，也可能涉及目录外的文件。新会话默认使用 bypassPermissions、Opus 和 max effort，工具可能不逐次询问就修改、删除或传输数据。需要时，选择 --mode plan 或其他受支持的模式。会话内可用 /model 和 /effort 调整；更高推理强度通常消耗更多额度。

启动时使用临时的私有设置层，固定网关地址和认证信息，清除冲突的供应商设置，并关闭受支持的可选遥测。常规自定义设置保留，原生设置文件不会被永久改写。只有受支持的模型接口走网关；MCP、hooks、插件、shell 工具、更新和其他原生服务仍可能从电脑直接联网。可选遥测控制不是拦截所有流量的防火墙。

三个版本，分别更新

电脑上的 CC Fleet：运行 ccfleet update，更新启动器和连接辅助程序。这不会更新电脑或槽位上的 Claude Code。

电脑上的 Claude Code：在 CC Fleet 会话之外，单独更新原版的本地安装。已经打开的会话继续使用原进程，更新后打开新的本地会话才使用新版。

槽位上的 Claude Code：打开我的槽位，在 Claude Code 一栏点击更新至提供的新版本，同时会切换为 Latest 渠道。返回稳定版则选择 Stable 渠道。运营者固定的版本没有更新按钮。新 Claude 进程使用新版，已有进程不被打断；更新槽位不会改变你电脑上的 Claude Code。

日常操作

通过菜单可以新建会话、继续上一次工作，或恢复保存的会话。原生 Claude 历史留在这台电脑上，CC Fleet 不会导入或同步会话。

偏好用于当前项目的新会话，也可用 --project PATH 指定项目。启动时明确选择的选项优先。恢复时保留原有模型和推理强度，除非你主动修改；清除偏好不会删除历史。

使用当前本地客户端时，在普通终端中运行下面的命令，不要在 Claude 会话中输入。它检查安装和槽位是否就绪，不扫描项目、不启动 Claude 会话，也不调用模型。

Doctor 区分安装、配对、连接和账号状态问题。诊断报告只写入新的本地文件，不会上传，也不包含提示、文件内容、本地路径、token 或账号邮箱；请先检查再分享。显示“就绪”是一次状态观察，不保证 Anthropic 会接受下一条消息。排查问题时，请保留仍然有效的配对。

如需额外检查基本回复，打开 ccfleet local，粘贴下面的提示。它会调用模型，并可能消耗订阅额度：

不要使用工具、读取文件，或检查我的系统与网络。
只回复：CCFLEET_OK

收到相同回复，只说明基本响应正常。“不要使用工具”是提示要求，不是强制隔离，原生上下文或 hooks 仍可能存在。不要为了检查隐私，让 Claude 打印真实 IP、位置或环境变量。网关可以读取模型消息与回复；对于这些请求，Anthropic 看到的是选中槽位的出口 IP。其他工具或原生服务仍可能从电脑直接联网。

可以主动把本地管理 MCP 添加到 Claude；不会自动注册。它提供缓存的槽位状态、配额百分比与重置时间，以及转发用量数值，并标明观察时间和样本覆盖范围。没有记录表示未知，不表示零。

启用后，调用它的 AI 会看到固定状态码与数值。结果不含账号或设备标识、名称、邮箱、IP、本地路径、提示、日志，以及模型或会话标识。工具不能调用 Claude、刷新配额、扫描项目、执行命令或修改账号。更换配对或账号后，需要重启 MCP。用量覆盖七个 UTC 自然日，不是账单，也不只是今天的用量。

更新程序先用内置的 Ed25519 公钥验证发布渠道签名，再验证不可变清单和每个辅助文件，通过后才切换版本。验证或下载失败时保留当前客户端。回退使用保留的上一版，不改变配对、本地文件或原生历史。签名渠道缺失或过期时会报错。这里更新的是 CC Fleet，不是 Anthropic 的原版 Claude Code。

本地后台任务

受管理的任务可以在关闭启动终端后继续运行本地 Claude 的 print-mode 工作。你的电脑必须保持开机并联网。保存 start 返回的任务 ID，用它查看输出或停止任务。

要使用已有上下文，明确选择 --resume NAME_OR_ID 或 --continue。默认超时一小时，最长 24 小时；默认同时运行四个任务，最多 16 个。提示和输出保存在私有本地文件中，每份日志最多 4 MiB，可能含敏感内容，不会进入诊断导出。失败后不会自动重启或重发模型请求。

停止、超时、撤销授权或管理进程丢失时，会结束所管理的进程组；授权按周期检查。只有清理经过验证才会报告“已确认”，无响应的记录不能证明任务已停止。工具主动脱离管理时不会因此受到沙箱限制，本地文件仍由原生权限决定。归档已结束的记录可以保留私有文件并释放名额，不会停止活动任务。

管理你的槽位

每个槽位绑定你自己的一个 Claude 账号，重新登录 只用于这个账号。要换成另一个自己的账号，点击 更换账号，每周一次。需要同时保留两个账号，就持有两个槽位。同一账号应保持在一台机器上；同时在两台机器登录时，会向你和运营者提示。

更换账号保留文件与设置，但旧绑定的请求会失效。CC Fleet 不会自动关闭本地 Claude 进程，也不会删除历史；账号改变时，会取消正在进行的请求。等槽位重新显示 使用中，再主动重试；新的请求使用当前绑定账号。运营者能看到账号更换。

槽位名称也用作 hostname，Anthropic 可能看到它，请不要使用邮箱。同一台机器上的不同槽位使用独立的 Linux 用户，槽位内没有管理员权限（sudo）。

五小时和每周进度条表示整个 Claude 账号的用量；token 数表示这个槽位上的 Claude Code 使用量，不是完整的本地转发统计。配额每五分钟读取一次，点击 刷新 可立即读取。通过 连接另一台电脑 添加设备，之后可单独撤销。

槽位没有备份。点击 归还这个槽位 之前，请把槽位文件保存在 Git 或自己的存储中。归还会删除 Linux 用户及其中所有文件，不会删除 Claude 账号或本地历史。遇到连接问题，请保留有效配对、检查状态，再联系运营者。

有问题请联系 cdcupt@gmail.com。隐私说明列出服务处理与保存的信息。

选择槽位与价格

首页“槽位与价格”展示最多三个实际配置示例。打开完整公开槽位目录可查看主机服务商、网络类型、当前可用状态与 Alpha 报价明细。可按主机／IP 服务商或“主机 7”等公开标签搜索，按服务商与 IP 类型筛选，每页最多展示 20 台主机。紫色住宅、蓝色 ISP 与灰色机房 IP 标签描述网络类型；文字与颜色不代表质量排名，也不保证 Claude 兼容性。浏览不会预留槽位。领取时请先登录，再通过浏览可用槽位，在自己的额度内选择主机。

我的槽位集中展示你持有的槽位、操作和用量。需要增加槽位时，选择浏览可用槽位。此页面需要登录，可以按主机服务商、IP 服务商或“主机 7”等公开主机标签搜索，并按服务商及网络类型（ISP、住宅或机房）筛选；每页最多展示 20 台主机。先核对主机价格与成本明细，再领取该主机，随后返回“我的槽位”管理。原有槽位额度及领取条件仍然适用，领取不会自动扣款。

Alpha 定价。每台主机的美元月费分别列于公开槽位目录。按已记录的 VPS 与出口 IP 成本计价，另收资源成本 10% 的月度服务费，每槽位最低 $2。你自己的 Claude 订阅或 Anthropic API 用量另行付费。

已记录成本统一折算为日历月：30 天成本乘以 365/360，年付成本除以 12。报价先将折算后的美元资源成本四舍五入到美分，再取其 10% 并将服务费四舍五入到美分，服务费最低 $2，最后将两项显示金额相加。资源成本 $8.68、$10.83、$22.28 和 $27.44，分别对应月费 $10.68、$12.83、$24.51 和 $30.18。资源成本不超过 $20 时，服务费为 $2。

公开明细展示 VPS 成本、单独记录的出口 IP 成本、服务费与总价。主机包含出口 IP 时，展示已记录的打包资源成本，不虚构拆分金额。若各项单独舍入后与合计资源成本存在美分差异，会以折算舍入行解释。成本缺失或尚未转换为美元时，价格暂不可用。主机与 IP 服务商品牌保持可见。ISP、住宅与机房只描述网络类型，均采用同一公式，不另加住宅溢价；这些类型不保证质量、速度或 Claude 兼容性。

Alpha — 早期体验。服务仍在测试，尚未正式商业发布。运营者亲自使用过一个住宅槽位，结果令人鼓舞，但不同服务商、配置及多用户场景的可靠性仍待评估。Alpha 价格为初期价格，未来计费周期可能调整。如有变更，续期前会提供更新报价；已约定计费周期仍执行原约定价格。

价格及服务有效期直接与运营者约定；网站不会自动扣款、自动续费，也不会改写过去的付款记录。

已退役主机会从出租目录移除。仍在运营、只是暂时离线的主机继续显示在服务状态中。退役不会自动归还已有持有者的槽位，也不会删除其账号或付款历史。