cc-connect + Claude Code Route

┌──────────────┐    Telegram API    ┌────────────────┐
│ Telegram 客户端│ ─────────────────> │ Telegram Bot   │
│ (你的手机)    │  @my_connect_bot
└──────────────┘                    └───────┬────────┘
                                            │ WebSocket / Long polling
                                            ↓
                              ┌──────────────────────────┐
                              │ cc-connect (systemd守护)  │
                              │ - 监听 Telegram 消息       │
                              │ - 调度 Claude Code 子进程  │
                              │ - allow_from 鉴权          │
                              └──────────────┬───────────┘
                                             │ spawn: ccr code --verbose ...
                                             ↓
                              ┌──────────────────────────┐
                              │ ccr code (shim)           │
                              │ - 强制覆盖 ANTHROPIC_*    │
                              │ - 检测并自动拉起 ccr 服务 │
                              │ - exec claude             │
                              └──────────────┬───────────┘
                                             │ ANTHROPIC_BASE_URL=http://127.0.0.1:3456
                                             ↓
                              ┌──────────────────────────┐
                              │ claude (Claude Code CLI)  │
                              │ - stream-json 协议        │
                              └──────────────┬───────────┘
                                             │ HTTP (anthropic 协议)
                                             ↓
                              ┌──────────────────────────┐
                              │ ccr 服务 (127.0.0.1:3456) │
                              │ - 协议转换 (anthropic→OpenAI) │
                              │ - 路由到上游 provider     │
                              └──────────────┬───────────┘
                                             │
                                             ↓
                              ┌──────────────────────────┐
                              │ 上游 LLM provider         │
                              │ (LongCat / GLM / Grok 等) │
                              └──────────────────────────┘

language = "en"

[[projects]]
name = "default"
# 启用 /shell /restart /upgrade 等管理命令(仅本人可用,project 级配置)
admin_from = "xxxxxxxxxx"

[projects.agent]
type = "claudecode"

[projects.agent.options]
work_dir = "/root/some-py/cc-connect"
mode = "default"
# 通过 ccr code 启动 claude,由 ccr 内部完成 ANTHROPIC_BASE_URL/API_KEY 注入
# --verbose 是 Claude Code 2.1.x 用 stream-json 时的强制要求
# 用绝对路径,避免 systemd daemon 模式下 PATH 不含 /root/.npm-global/bin 时找不到 ccr
cli_path = "/root/.npm-global/bin/ccr code --verbose"

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

[projects.platforms.options]
token = "<你的 Telegram bot token>"
api_proxy = "https://my.proxy.com"
# 仅允许本人使用,屏蔽陌生人
allow_from = "xxxxxxxxxxx"

{
  "PORT": 3456,
  "APIKEY": "<ccr 自身的接入鉴权 key>",
  "Providers": [
    {
      "name": "mei",
      "api_base_url": "https://api.longcat.chat/openai/v1/chat/completions",
      "api_key": "<LongCat api key>",
      "models": ["LongCat-Flash-Lite", "LongCat-Flash-Chat", "LongCat-Flash-Thinking-2601"],
      "transformer": { "use": ["mei"] }
    }
    // ... 其他 provider 省略
  ],
  "Router": {
    "default":      "mei,LongCat-Flash-Thinking-2601",
    "background":   "mei,LongCat-Flash-Thinking-2601",
    "think":        "mei,LongCat-Flash-Thinking-2601",
    "longContext":  "mei,LongCat-Flash-Thinking-2601",
    "longContextThreshold": 60000,
    "webSearch":    "mei,LongCat-Flash-Thinking-2601"
  }
}

cc-connect daemon status      # 看服务是否在跑
cc-connect daemon logs        # 看最近日志
cc-connect daemon logs -f     # 实时跟踪日志(类似 tail -f)
cc-connect daemon logs -n 50  # 看最近 50 行
cc-connect daemon restart     # 改了 config.toml 后重启
cc-connect daemon stop        # 临时停止
cc-connect daemon start       # 启动
cc-connect daemon uninstall   # 卸载 systemd 单元(配置文件不删)

systemctl status cc-connect         # 状态
systemctl restart cc-connect        # 重启
systemctl stop cc-connect           # 停止
systemctl start cc-connect          # 启动
systemctl disable cc-connect        # 取消开机自启
systemctl enable cc-connect         # 开机自启
systemctl cat cc-connect            # 查看 unit 文件
journalctl -u cc-connect -f         # 看 systemd 层面日志

ccr status     # 查 ccr 服务状态
ccr start      # 手动启动 ccr 服务(通常不需要,ccr code 会自动)
ccr stop       # 停止 ccr 服务
ccr restart    # 重启(改了 config.json 后必须)
ccr code       # 启动 claude(会自动拉起 ccr 服务)
ccr ui         # 浏览器打开 ccr web UI
ccr model      # 交互式选择模型

# 同时看 cc-connect 和 ccr 两边日志
cc-connect daemon logs -f &
tail -f /root/.claude-code-router/logs/ccr-*.log &

cc-connect daemon restart
# 或
systemctl restart cc-connect

ccr restart

[[projects]]
name = "frontend"
admin_from = "xxxxxxxxxx"

[projects.agent]
type = "claudecode"

[projects.agent.options]
work_dir = "/root/some-py/frontend"
mode = "default"
cli_path = "/root/.npm-global/bin/ccr code --verbose"

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

[projects.platforms.options]
token = "<同一个 token>"
allow_from = "xxxxxxxxxxxx"

# 编辑 /root/.claude-code-router/config.json,改 Router.default
ccr restart
# cc-connect 不用动!下条消息自动用新模型

# 快速检查
ccr status      # 看 ccr 是否在跑
ss -tlnp | grep :3456  # 端口有没有监听

# 没在跑就启动
ccr start

开机
  → systemd 自动启 cc-connect daemon (bot 连接成功,但 ccr 服务还没起)
  → 你 SSH 上来执行 ccr start
  → 发 Telegram 消息 → 链路通

/help          - 看全部 46 个命令
/new           - 开新会话
/list          - 列会话
/switch <id>   - 切换会话
/current       - 当前活跃会话
/history 20    - 看最近 20 条历史
/mode plan     - 切换权限模式 (default/edit/plan/yolo)
/quiet         - 切换思考过程显示
/stop          - 中止当前 turn
/provider      - 列出/切换 ccr provider
/shell <cmd>   - 在服务器上跑 shell(仅 admin_from)
/restart       - 重启 cc-connect 自身(仅 admin_from)

# 看源码里的 toml tag
curl -s https://raw.githubusercontent.com/chenhg5/cc-connect/main/agent/claudecode/claudecode.go | grep -E 'toml:"' | head

Error: When using --print, --output-format=stream-json requires --verbose

disableVerbose := a.routerURL != ""

ANTHROPIC_AUTH_TOKEN=sk-ON6Cwp1807aupnQpBuRyXQhV5uivjXOCBFU2OUiUgNk4Eucd
ANTHROPIC_BASE_URL=https://anyrouter.top

export ANTHROPIC_AUTH_TOKEN=sk-ON6Cwp...
export ANTHROPIC_BASE_URL=https://anyrouter.top

[Unit]
Description=Claude Code Router
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
ExecStart=/root/.npm-global/bin/ccr start --foreground
Restart=on-failure
RestartSec=5
Environment="PATH=/root/.npm-global/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"

[Install]
WantedBy=multi-user.target

After=ccr.service Wants=ccr.service

ExecStartPre=/root/.npm-global/bin/ccr start

# Step 1: ccr 服务在吗 ← 最常见故障点!
ccr status
ss -tlnp | grep :3456
# 没在跑? → ccr start

# Step 2: cc-connect 服务在吗
systemctl status cc-connect
# inactive? → systemctl start cc-connect

# Step 3: 网络通吗(ccr → 127.0.0.1:3456)
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:3456
# 401 = 通了但 token 有问题,200 = 正常,无法连接 = ccr 没起来

# Step 4: bot 连接正常吗
cc-connect daemon logs -n 30 | grep -iE 'telegram|error|warn'

# Step 5: 最近一次消息处理日志
cc-connect daemon logs -n 50 | tail -30
# 关注 input_tokens: 0 = 请求没到 provider(401/502); >0 = 链路通了

# Step 6: claude 端发生了什么
ls -lt /root/.claude/projects/-root-some-py-cc-connect/*.jsonl | head -3
# 用 python 解析最新文件,看 user/assistant 对话

# Step 7: ccr 详细日志(每次启动一个新文件)
ls -lt /root/.claude-code-router/logs/ | head -3

# Step 8: 终极回退 - 从干净环境手工跑一次
env -i HOME=$HOME PATH=$PATH /root/.npm-global/bin/ccr code --print "ping"

echo "=== ccr ===" && ccr status 2>&1 | head -4 && \
echo "=== port ===" && ss -tlnp 2>/dev/null | grep :3456 && \
echo "=== cc-connect ===" && systemctl is-active cc-connect 2>&1 && \
echo "=== last turn ===" && cc-connect daemon logs -n 10 2>&1 | grep -E 'turn complete|error|input_tokens'