第一章（免費）：為什麼 Claude Code 該住進你的 Telegram，以及橋接怎麼運作
癢處
Claude Code 是你手上最強的助理，卻只住在一台機器的終端機裡。你的問題出現在手機上、公車上、晚上十一點。每一句「等我回到桌前再做」，都是一件永遠不會做的事。
Telegram 本來就是你開著的 app。在那裡放一個 bot 不用錢、即時、你的每台裝置都能用。
所以：一個很小的橋。傳訊息給 bot → 它在你電腦的某個資料夾裡執行 claude -p "<你的訊息>" → 答案傳回來。接續的訊息會延續同一個 Claude Code session，所以「再短一點」有效。照片和檔案會落到 inbox/，Claude 直接讀。
為什麼不用 API、不用框架、不用託管服務？
- 用你的登入，不用金鑰。 橋接呼叫的是
claudeCLI，所以跑在你已經付費的 Claude Code 登入之下。想按量計費的話，設ANTHROPIC_API_KEY就改走那條路。 - 零相依。 單一檔案、Node ≥ 22、不用
npm install、沒有東西要審。Telegram 那側就是對 Bot API 的原生fetch。 - 長輪詢，不用 webhook。 Webhook 需要 TLS、公開網址和固定埠——這是 Telegram bot「跑不起來」最常見的兩個原因。輪詢只需要對外連線，筆電本來就有。
- 除了 Claude Code 本來就會傳給 Anthropic 的東西，什麼都不會離開你的機器。 沒有第三方伺服器看得到你的 prompt 和檔案。
一段話說完安全模型
只有你的 Telegram user id 會得到回覆。Claude Code 以 dontAsk 模式執行，工具白名單只有：讀、搜、改工作目錄裡的檔案、網頁搜尋、幾個唯讀 git 指令。其他一律自動拒絕，Claude 會告訴你它本來想做什麼。你信任某個流程後再放寬。工作目錄出不了你允許的根目錄。這就是「一個助理」和「誰猜到 bot 名字誰就有你的遠端 shell」的差別。
現在就能做的前三步
- 安裝 Claude Code，執行一次
claude完成登入。 - 在 Telegram 找 @BotFather →
/newbot→ 複製 token。 - 先把 token 傳給自己存著，等一下貼進
setup.sh。
付費包多了什麼
橋接本體（bot.mjs）、帶自我測試的一鍵 setup.sh、macOS / Linux 背景常駐安裝、助理用的 CLAUDE.md 樣板、每個對話獨立 session 與 /new /cwd /model /status /cancel、照片／檔案／語音收件匣，以及 MISTAKES.md——用 Claude Code 做付費 Telegram 產品時踩過的 14 個真實的坑。