Claude Code Monitor - 安裝設定

← 返回監控面板
⚡一鍵安裝（推薦）

在終端機貼上以下指令，即可互動式完成所有設定：


        
腳本會自動：安裝依賴、下載腳本、設定環境變數、設定 Hooks、啟動 Heartbeat 背景服務。

      


      
── 或者手動安裝 ──


      

        
0前置條件：安裝 Claude Code

        
如果還沒有安裝 Claude Code CLI：

        
brew install node  # 如果沒有 Node.js
npm install -g @anthropic-ai/claude-code

        
安裝完後在專案目錄打 claude 就能啟動。

      


      

        
1下載 Reporter 與 Heartbeat

        

      


      

        
2安裝依賴

        
pip3 install httpx psutil

      


      

        
3設定環境變數

        
修改 MACHINE_ID 為你的機器名稱：

        

        
設定完後執行 source ~/.zshrc 或重開終端機。

      


      

        
4設定 Claude Code Hooks

        
將以下內容合併到 ~/.claude/settings.json（如果已有其他設定請手動合併）：

        

      


      

        
5啟動 Heartbeat 背景程序

        
cat > ~/Library/LaunchAgents/com.claude.monitor-heartbeat.plist << 'PLIST'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.claude.monitor-heartbeat</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/bin/python3</string>
        <string>~/.claude/heartbeat.py</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>
PLIST
launchctl load ~/Library/LaunchAgents/com.claude.monitor-heartbeat.plist

      


    


    
    


      

        
0前置條件：安裝 Claude Code

        
如果還沒有安裝 Claude Code CLI：

        
npm install -g @anthropic-ai/claude-code

      


      

        
1下載 Reporter 與 Heartbeat

        

      


      

        
2安裝依賴

        
pip install httpx psutil

      


      

        
3設定環境變數（PowerShell 管理員）

        
修改 MACHINE_ID 為你的機器名稱：

        

        
設定完後重新開啟終端機。

      


      

        
4設定 Claude Code Hooks

        
將以下內容合併到 %USERPROFILE%\.claude\settings.json：

        

      


      

        
5啟動 Heartbeat 背景程序

        
在 PowerShell 中建立開機自動啟動的捷徑：

        

        
立即啟動：

        
Start-Process pythonw "$env:USERPROFILE\.claude\heartbeat.py" -WindowStyle Hidden

      


    


    
    

      
驗證安裝

      
安裝完成後，在 Claude Code 中執行任意指令，然後點擊下方按鈕確認連線。

      
      

    


  


  
  


    

      
Telegram 遠端遙控

      
透過 Telegram 隨時從手機操控你的 Claude Code session，用自然語言下達指令、查看回覆，並遠端批准工具權限。

      
手機 Telegram ──訊息──> Telegram Bot
        │
        ▼
Claude Code Channel Plugin (本地)
        │ stdio
        ▼
Claude Code Session ──回覆──> Telegram Bot ──> 手機

      
    
        
  • 從手機用自然語言操控 Claude Code
    • 
        
  • 即時收到 Claude 的回覆與工作結果
    • 
        
  • 遠端批准/拒絕工具使用權限 (Permission Relay)
    • 
        
  • Sender Allowlist 安全控制
    • 
      

    


    
需要 Claude Code v2.1.80+、claude.ai 帳號登入、Bun runtime。Team/Enterprise 需管理員啟用 Channels。


    

      
1建立 Telegram Bot

      
在 Telegram 搜尋 @BotFather，發送 /newbot。設定顯示名稱和 username（需以 bot 結尾）。複製 BotFather 回傳的 token。

    


    

      
2安裝 Bun（如尚未安裝）

      
curl -fsSL https://bun.sh/install | bash

      
Windows 用戶：

      
powershell -c "irm bun.sh/install.ps1 | iex"

    


    

      
3在 Claude Code 中安裝 Telegram Plugin

      
啟動 Claude Code session，執行：

      
/plugin install telegram@claude-plugins-official

      
如果找不到 plugin，先更新 marketplace：

      
/plugin marketplace add anthropics/claude-plugins-official
/plugin marketplace update claude-plugins-official

      
安裝後執行 /reload-plugins 啟用設定指令。

    


    

      
4設定 Bot Token

      
用步驟 1 取得的 token 執行：

      
/telegram:configure <your-bot-token>

      
Token 會儲存到 ~/.claude/channels/telegram/.env

    


    

      
5啟動 Channel 模式

      
退出 Claude Code，以 channel 模式重新啟動：

      
claude --channels plugin:telegram@claude-plugins-official

    


    

      
6配對你的 Telegram 帳號

      
在 Telegram 對你的 Bot 發送任意訊息，Bot 會回覆一個配對碼。回到 Claude Code 執行：

      
/telegram:access pair <pairing-code>
/telegram:access policy allowlist

      
設定 allowlist 後只有你的帳號能發送訊息。

    


    

      
7開始使用！

      
現在從手機發送訊息給 Bot，Claude 會在你的本機執行工作並回覆結果。

      
搭配 Monitor Dashboard 使用：在 Dashboard 看全局狀態，在 Telegram 操控特定 session。

      
如果 Claude 碰到需要權限批准的操作，Telegram 會收到提示，你可以直接回覆 yes <id> 或 no <id> 來批准或拒絕。

    


    

      
Discord 也可以！

      
同樣的流程也適用於 Discord，只需將指令中的 telegram 替換為 discord，並使用 Discord Bot Token。詳見 官方文件。

    


  


  
  


    

      
Monitor Alert Channel

      
將 Monitor 的告警自動推送到你的 Claude Code session，讓 Claude 在偵測到異常時自動反應。

      
Monitor Server 偵測到異常
        │ HTTP POST /alert
        ▼
Channel Server (localhost:8789)
        │ stdio (MCP)
        ▼
Claude Code Session ──自動調查/修復
        │ reply tool
        ▼
Monitor Dashboard 顯示回覆

      
    
        
  • Session Error 自動偵測並通知 Claude 調查
    • 
        
  • 用量接近上限時提醒 Claude 優化
    • 
        
  • Session 異常停止時通知
    • 
        
  • Claude 的回覆會顯示在 Dashboard
    • 
      

    


    
此功能需要先完成「Monitor Hook」基礎安裝。Alert Channel 是額外的增強功能。


    

      
1安裝 Bun（如尚未安裝）

      
curl -fsSL https://bun.sh/install | bash

      
Windows：

      
powershell -c "irm bun.sh/install.ps1 | iex"

    


    

      
2下載 Channel Server

      
Mac / Linux：

      

      
Windows (PowerShell)：

      

    


    

      
3安裝依賴

      
cd ~/.claude/channel && bun install

    


    

      
4設定 MCP Server

      
在你的專案根目錄建立或編輯 .mcp.json：

      

      
或加入到全域設定 ~/.claude.json（對所有專案生效）。

    


    

      
5在 Monitor 註冊 Channel 端點

      
告訴 Monitor Server 你的 Channel 在哪裡，讓它能推送告警：

      

    


    

      
6啟動 Claude Code（含 Channel）

      
使用開發模式啟動（自訂 channel 目前需要此 flag）：

      
claude --dangerously-load-development-channels server:monitor-alert

      
Channel Server 會自動隨 Claude Code 啟動，監聽 localhost:8789。當 Monitor 偵測到異常會自動推送告警到你的 session。

    


    

      
7測試告警

      
手動發送一個測試告警：

      
curl -X POST http://localhost:8789/alert \
  -H "Content-Type: application/json" \
  -d '{"alert_type":"custom","message":"Test alert from Monitor","severity":"info"}'

      
你應該會在 Claude Code session 中看到告警訊息，Claude 會據此作出反應。

    


    

      
告警規則設定

      
你可以在 Monitor Dashboard 的告警設定中調整規則，或透過 API：