一个 agent,或者一支 agent 队伍。

从一个 cc-agent 二进制 + LLM key 起步。需要的时候接入控制面,浏览器/手机/iOS App 一键调度。已经在用 Claude Code / Codex / Gemini CLI?再加 cc-proxy。控制面用我们的托管站,或者自部署,都行。

# 单机起 cc-agent,不需要控制面
$ ./cc-agent -provider deepseek -model deepseek-chat -cwd .
# 直接问
you> 这台机器内核版本多少?
# 它会自己调 bash,再回答
bash {command=uname -r} → 6.6.87.2-microsoft-WSL2
$ _

为什么选择 Agent Control?

多服务器统一管理

一个控制台管理多环境,开发、测试、生产统一视图。

安全默认

仅出站 WebSocket,无需开放入站端口,天然适配 Zero Trust。

实时 PTY

xterm.js 终端实时交互,体验接近 SSH,但更适配 Web 协作。

审计可追溯

命令和输出全量 JSONL 记录,便于合规和回放分析。

原生应用支持

提供 macOS / iOS 客户端,随时查看并控制 Agent。

开源可自托管

MIT 许可,可二次开发,可部署在你自己的基础设施上。

从单机到控制面,4 个台阶

按你当前的需求挑一档。后面随时往上加层。

1

本机起 cc-agent — 一个二进制 + 一个 LLM key

下载 cc-agent,给它一份 DeepSeek / Anthropic / OpenAI / 本地 Ollama 的 key,它就能在终端 REPL 里跑起来。自带 8 个工具(bashreadwritegrepglobsysinfoproclistlogtail),destructive 命令默认走审批闸。

CC_AGENT_API_KEY=$(cat ~/.cc-agent-key) \ CC_AGENT_BASE_URL=https://api.deepseek.com \ ./cc-agent -provider deepseek -model deepseek-chat \ -cwd ~/work -memory ~/cc-agent.db

不连控制面、不开 UI、不出网,纯 REPL。适合本地用 / 嵌脚本。

2

cc-agent 接入 cc-control — 浏览器/手机 一键调度

想把 agent 跑在远端服务器、给同事一起用、或者用 iOS / macOS / Windows 客户端?加 -control-url 和 Agent Token,agent 就会注册到控制面,UI 自动看见它。

./cc-agent \ -control-url wss://cc-remote.app/ws/agent \ -agent-token <your-agent-token> \ -server-id srv-01 -allow-root /path/to/repo

每台机器跑一个进程。仪表盘上 cc-agent 节点带紫色徽章,与 cc-proxy 一目了然。

3

已经在用 Claude Code / Codex / Gemini CLI?跑 cc-proxy

cc-proxy 是 PTY 代理,包外部 CLI agent,让它以普通 session 形式在 UI 里出现。一台机器跑 cc-agent、另一台跑 cc-proxy 都没问题,控制面统一处理。

./cc-proxy \ -control-url wss://cc-remote.app/ws/agent \ -agent-token <your-agent-token> \ -server-id claude-node-01 \ -claude-path /usr/local/bin/claude

命名说明:cc-proxy 在 v0.7.0 之前叫 cc-agent,新自研的 agent 拿走了原名字。两者协议一致,角色不同。

4

用我们托管,或自部署 cc-control

控制面有两条路:

托管

console.cc-remote.app 注册租户、签 UI/Agent Token,agent 连 wss://cc-remote.app/ws/agent。几分钟搞定,iOS / macOS / Windows 客户端齐全。

自部署

cc-control MIT 开源。一台 Linux + TLS / Cloudflare Tunnel 就能上线,详见 部署文档

想按教程路径学? 中文进入 教程目录(5 分钟跑通 → 生产部署 → UI / Provider)。 英文看 Getting StartedUse Cases

架构

flowchart LR subgraph Clients Browser["浏览器 UI"] App["原生应用"] end subgraph Control["控制平面"] CC["cc-control"] end subgraph Agents A1["Agent 1"] A2["Agent 2"] end Clients -->|"REST/WS"| CC CC <-->|"Secure WS"| A1 CC <-->|"Secure WS"| A2 style Clients fill:#111725,stroke:#44697f,color:#d4d4d4 style Control fill:#111725,stroke:#44697f,color:#d4d4d4 style Agents fill:#111725,stroke:#44697f,color:#d4d4d4 style CC fill:#315f72,stroke:#274f62,color:#fff