Control Claude Code from Your Phone with cc‑connect: Mobile AI Agent Management

Developers often need to run AI agents such as Claude Code while away from their computers, but traditional tools only work in a terminal.

What cc‑connect Does

cc‑connect bridges AI agents running on a developer machine to everyday chat platforms (Feishu, DingTalk, Telegram, Slack, Discord, etc.), allowing you to send a message from your phone and receive the agent’s result back in the chat.

Architecture

You (phone / PC / tablet)
                │
    ┌───────────────┼───────────────┐
    ▼               ▼               ▼
 Feishu   Slack   Telegram   … (9 platforms)
    │               │               │
    └───────────────┼───────────────┘
                ▼
          ┌────────────┐
          │ cc‑connect │ ← your dev machine
          └────────────┘
                ┌─────┼─────┐
                ▼     ▼     ▼
          Claude  Gemini  Codex … (7 agents)
          Code    CLI    CLI

cc‑connect runs on the dev machine, listens to chat messages, forwards them to the selected AI agent, and pushes the result back to the chat window.

Supported Agents

Claude Code ✅

Codex (OpenAI) ✅

Cursor Agent ✅

Gemini CLI ✅

Qoder CLI ✅

OpenCode ✅

iFlow CLI ✅

Goose / Aider (planned)

Kimi Code / GLM Code (exploratory)

Supported Chat Platforms

Feishu – WebSocket long‑connection (no public IP needed)

DingTalk – Stream mode (no public IP needed)

Telegram – Long polling (no public IP needed)

Slack – Socket mode (no public IP needed)

Discord – Gateway (no public IP needed)

Enterprise WeChat – Webhook (requires public IP)

LINE – Webhook (requires public IP)

QQ (NapCat/OneBot) – WebSocket (no public IP needed)

QQ Official Bot – WebSocket (no public IP needed)

Core Features

Permission Modes: Switch from Phone

Different tasks need different control granularity. Use slash commands in chat to change modes:

/mode          # view current mode
/mode yolo     # full‑auto: all tools run without confirmation
/mode default  # manual confirmation for each tool

Example with Claude Code:

Sending /mode yolo puts Claude Code into full‑auto mode, suitable for background batch jobs.

Natural‑Language Cron Creation

每天早上 6 点帮我总结 GitHub trending

Claude Code translates this to the command:

/cron add 0 6 * * * 帮我收集 GitHub trending 并发送总结
/cron list
/cron del <id>

The cron runs silently in the background and pushes results to the chat.

API Provider Management (Runtime Switching)

/provider list                # list configured providers
/provider switch relay       # switch to a relay provider

Providers are defined in config.toml (TOML syntax). Example snippet:

[[projects.agent.providers]]
name = "anthropic"
api_key = "sk-ant-xxx"

[[projects.agent.providers]]
name = "relay"
api_key = "sk-xxx"
base_url = "https://api.relay-service.com"
model = "claude-sonnet-4-20250514"

Switching restarts the agent session and loads new credentials via environment variables, avoiding local config files.

Multi‑Bot Relay in a Single Group

/bind claudecode   # bind Claude Code bot
/bind gemini       # bind Gemini CLI bot

After binding, you can let Claude Code review code and then @Gemini for a second opinion without leaving the group chat.

Claude Code Router Integration

Tasks are automatically routed to different models based on intent:

You: 帮我重构这段代码   → Router → DeepSeek (default)
You: 思考一下这个架构决策 → Router → DeepSeek Reasoner (reasoning model)
You: 分析这个大型代码库   → Router → Gemini Pro (long context)

Set router_url in the config; cc‑connect injects ANTHROPIC_BASE_URL accordingly.

Voice Message Support

Voice messages in Feishu, Telegram, Enterprise WeChat, etc., are transcribed via Whisper (OpenAI or Groq) and sent to the selected agent. Requires ffmpeg for audio conversion.

Daemon Mode

cc-connect daemon install --config ~/.cc-connect/config.toml
cc-connect daemon start
cc-connect daemon status
cc-connect daemon logs -f

Supports Linux systemd and macOS launchd, with automatic log rotation and auto‑start on boot.

Quick Start

Install globally: npm install -g cc-connect Or let Claude Code install it for you by sending the following prompt:

请参考 https://raw.githubusercontent.com/chenhg5/cc-connect/refs/heads/main/INSTALL.md 帮我安装和配置 cc-connect

Configuration example for Feishu (TOML):

[[projects]]
name = "my-backend"

[projects.agent]
type = "claudecode"

[projects.agent.options]
work_dir = "/path/to/project"
mode = "default"

[[projects.platforms]]
type = "feishu"

[projects.platforms.options]
app_id = "cli_xxxx"
app_secret = "xxxx"

Run the bridge with:

cc-connect

FAQ

Difference between cc‑connect and /loop: /loop makes Claude Code continuously execute tasks locally; cc‑connect lets you trigger and control tasks remotely from a chat app. They can be used together.

Do Feishu integrations need a public IP? No. Feishu uses a WebSocket long‑connection initiated by cc‑connect, so the dev machine does not need to be reachable from the internet. The same applies to DingTalk, Telegram, Slack, Discord, and QQ. Enterprise WeChat and LINE (webhook mode) do require a public IP.

Can multiple projects be managed simultaneously? Yes. A single cc‑connect process can handle multiple [[projects]] entries, each with its own agent and platform configuration.

Can I switch to other agents such as Gemini CLI? Absolutely. Change the type field in the project’s [projects.agent] section to gemini, codex, cursor, etc., and restart the bridge.

How can developers in China access Claude Code? Official access requires overseas payment and network conditions. Using a third‑party endpoint like Code80, set the api_key and base_url in the providers section to route calls through the alternative service.

About code80

code80 offers a proxy endpoint for Claude Code, allowing Chinese developers to use the model without overseas credit cards or VPNs. Configure the base_url and api_key in the provider section to switch.