Plugin Telegram Code Claude: Hướng dẫn thiết lập hoàn chỉnh 2026

Plugin chính thức của Claude Code Telegram: Hướng dẫn thiết lập hoàn chỉnh 2026

🎯 Những bài học chính (TL;DR)

• plugin Anthropic Telegram chính thức dành cho Claude Code cho phép bạn trò chuyện với trợ lý AI của bạn trực tiếp thông qua Telegram
• Quá trình thiết lập chỉ cần 6 bước: tạo bot → cài đặt plugin → định cấu hình mã thông báo → khởi chạy lại → ghép nối → khóa
• Plugin hiển thị ba công cụ MCP: reply, react và edit_message để kiểm soát toàn bộ tin nhắn
• Kiểm soát truy cập mặc định ở chế độ "ghép nối" — chuyển sang danh sách cho phép sau khi được định cấu hình để ngăn người lạ truy cập vào trợ lý của bạn
• Không có lịch sử tin nhắn hoặc tìm kiếm — bot chỉ nhìn thấy tin nhắn khi chúng đến

Mục lục

1. Plugin Claude Code Telegram là gì?
2. Điều kiện tiên quyết
3. Thiết lập nhanh: 6 bước để có được Đang chạy
4. Tìm hiểu sâu về kiểm soát quyền truy cập
5. Tham khảo công cụ MCP
6. Làm việc với Ảnh
7. Các hạn chế quan trọng
8. So sánh: Plugin Telegram và Discord
9. Câu hỏi thường gặp
10. Tóm tắt & Tiếp theo Các bước

Plugin Telegram Claude Code là gì?

Plugin Claude Code Telegram là máy chủ MCP (Giao thức bối cảnh mô hình) chính thức do Anthropic phát triển, kết nối bot Telegram với phiên Claude Code của bạn. Sau khi được định cấu hình, bạn có thể nhắn tin cho bot Telegram của mình và chuyển tiếp những tin nhắn đó trực tiếp đến trợ lý Claude Code của bạn — mang lại cho bạn quyền truy cập di động vào Claude Code thông qua bất kỳ ứng dụng khách Telegram nào một cách hiệu quả.

Máy chủ MCP đăng nhập vào Telegram với tư cách là bot và cung cấp ba công cụ cho Claude: khả năng trả lời tin nhắn, phản ứng bằng biểu tượng cảm xúc và chỉnh sửa tin nhắn đã gửi trước đó. Khi bạn nhắn tin cho bot trên Telegram, máy chủ sẽ chuyển tiếp tin nhắn đó tới phiên Mã Claude đang hoạt động của bạn và phản hồi của Claude sẽ được gửi lại cho bạn trong cuộc trò chuyện.

Đây là plugin official từ kho lưu trữ GitHub claude-plugins-official của Anthropic — cùng một tổ chức xây dựng chính Claude. Đó là cách được khuyến nghị để tích hợp Telegram với Claude Code, thay vì các giải pháp của bên thứ ba.

Điều kiện tiên quyết

Trước khi bắt đầu, hãy đảm bảo bạn có:

💡 Mẹo chuyên nghiệp
Không giống như một số máy chủ MCP hỗ trợ nhiều thời gian chạy, plugin Telegram chính thức yêu cầu cụ thể Bun. Nếu cố chạy nó bằng Node.js hoặc Deno, bạn có thể gặp phải các lỗi không mong muốn.

Thiết lập nhanh: 6 bước để bắt đầu hoạt động

Bước 1: Tạo Bot với BotFather

Mở cuộc trò chuyện với @BotFather trên Telegram và gửi /newbot. BotFather sẽ yêu cầu hai điều:

1. Tên — tên hiển thị được hiển thị trong tiêu đề trò chuyện (có thể chứa dấu cách, ví dụ: "Trợ lý của Milo")
2. Tên người dùng — một tên người dùng duy nhất kết thúc bằng bot (ví dụ: my_claude_code_bot). Đây sẽ trở thành liên kết bot của bạn: t.me/my_claude_code_bot

BotFather trả lời bằng mã thông báo trông giống như 123456789:AAHfiqksKZ8... — sao chép toàn bộ mã thông báo bao gồm số ở đầu và dấu hai chấm.

⚠️ Lưu ý bảo mật
Hãy coi mã thông báo này như một mật khẩu. Bất cứ ai có nó đều có thể điều khiển bot của bạn. Không bao giờ chia sẻ công khai.

Bước 2: Cài đặt Plugin

Đây là các lệnh Mã Claude — chạy claude để bắt đầu phiên trước, sau đó thực thi:

/plugin cài đặt telegram@claude-plugins-official /reload-plugins

Kiểm tra xem tab /telegram:configure đã hoàn tất chưa. Nếu không, hãy khởi động lại phiên của bạn bằng exit và chạy lại claude.

Bước 3: Cung cấp mã thông báo cho máy chủ

/telegram:configure 123456789:AAHfiqksKZ8...

Thao tác này ghi TELEGRAM_BOT_TOKEN=... vào ~/.claude/channels/telegram/.env. Bạn cũng có thể chỉnh sửa tệp đó bằng tay hoặc đặt biến trong môi trường shell của mình — shell được ưu tiên nếu cả hai đều được đặt.

Bước 4: Khởi chạy lại với Cờ kênh

Máy chủ sẽ không kết nối nếu không có cờ kênh. Thoát phiên của bạn và bắt đầu phiên mới với:

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

Bước 5: Ghép nối

1. DM bot của bạn trên Telegram — nó trả lời bằng một Mã ghép nối gồm 6 ký tự
2. Trong phiên Mã Claude của bạn, hãy nhập:

/telegram:cặp truy cập <mã>

DM tiếp theo của bạn sẽ liên hệ với trợ lý.

✅ Tốt lắm Biết
Không giống như Discord, không có bước mời máy chủ — bot Telegram chấp nhận tin nhắn trực tiếp ngay lập tức. Việc ghép nối sẽ xử lý việc tra cứu ID người dùng để bạn không bao giờ chạm vào ID số.

Bước 6: Khóa nó xuống

Ghép nối là để chụp ID. Sau khi bạn đã đăng nhập, hãy chuyển sang chế độ danh sách cho phép để người lạ không thể nhận được câu trả lời bằng mã ghép nối. Yêu cầu Claude làm hoặc chạy trực tiếp:

/telegram:danh sách cho phép chính sách truy cập

Kiểm soát truy cập Tìm hiểu sâu

Plugin hỗ trợ nhiều chính sách truy cập. Xem ACCESS.md trong kho lưu trữ các chính sách, nhóm DM, phát hiện đề cập, cấu hình phân phối, lệnh kỹ năng và lược đồ access.json.

Tham khảo nhanh:

• ID là ID người dùng dạng số (lấy ID của bạn từ @userinfobot)
• Chính sách mặc định là ghép nối
• ackReaction chỉ chấp nhận danh sách trắng biểu tượng cảm xúc cố định của Telegram (👍 👎 ❤ 🔥 👀, v.v.)

Công cụ MCP Tài liệu tham khảo

Plugin hiển thị ba công cụ cho trợ lý:

Tin nhắn gửi đến:
Tin nhắn gửi đến tự động kích hoạt chỉ báo nhập — Telegram hiển thị "tên bot đang nhập..." trong khi trợ lý xử lý phản hồi.

Làm việc với Ảnh

Khi bạn gửi ảnh tới bot:

• Ảnh gửi đến được tải xuống ~/.claude/channels/telegram/inbox/
• Đường dẫn cục bộ được bao gồm trong thông báo <kênh> để trợ lý có thể Đọc thông báo đó
• Telegram nén ảnh — thay vào đó, nếu bạn cần tệp gốc, hãy gửi tệp đó dưới dạng tài liệu (nhấn và giữ → Gửi dưới dạng Tệp)

Hạn chế quan trọng

Không có lịch sử hoặc tìm kiếm

API Bot của Telegram hiển thị cả lịch sử tin nhắn cũng như tìm kiếm. Bot chỉ nhìn thấy tin nhắn khi chúng đến — không có công cụ fetch_messages nào tồn tại. Nếu trợ lý cần ngữ cảnh sớm hơn, trợ lý sẽ yêu cầu bạn dán hoặc tóm tắt.

Điều này cũng có nghĩa là không có công cụ download_attachment dành cho các tin nhắn lịch sử — ảnh được tải xuống một cách hào hứng khi đến nơi vì không có cách nào để tìm nạp chúng sau này.

Không tìm nạp chủ đề

Không giống như Discord, bot Telegram không thể chủ động tìm nạp tin nhắn. Bot hoạt động hoàn toàn theo mô hình đẩy — nó nhận tin nhắn và phản hồi nhưng không thể quay lại và đọc các tin nhắn cũ hơn trong cuộc trò chuyện.

So sánh: Plugin Telegram vs Discord

Plugin Telegram thường dễ dàng hơn cho việc thiết lập một người dùng vì không có bước mời máy chủ — bạn chỉ cần gửi tin nhắn trực tiếp cho bot.

Câu hỏi thường gặp

Hỏi: Tôi có thể sử dụng plugin với nhiều người dùng không?

Có, nhưng bạn sẽ cần định cấu hình quyền truy cập của nhiều người dùng thông qua Hệ thống chính sách access.json. Chính sách ghép nối mặc định cho phép người dùng mới tự ghép nối, trong khi chế độ danh sách cho phép yêu cầu phê duyệt trước.

Hỏi: Tại sao tôi không thể tìm kiếm tin nhắn cũ?

API Bot của Telegram không cung cấp quyền truy cập vào lịch sử tin nhắn. Bot chỉ nhận được tin nhắn đến khi nó đang chạy. Lập kế hoạch phù hợp bằng cách tóm tắt các cuộc trò chuyện quan trọng.

Hỏi: Tôi có thể sử dụng tính năng này khi trò chuyện nhóm không?

Có, hãy xem ACCESS.md để biết các nhóm, tính năng phát hiện đề cập và cấu hình dành riêng cho nhóm. Bạn có thể muốn định cấu hình tính năng phát hiện đề cập để bot chỉ phản hồi khi được đề cập rõ ràng.

Hỏi: Tại sao ảnh của tôi bị mờ?

Telegram nén ảnh được gửi dưới dạng hình ảnh. Thay vào đó, nếu bạn cần chất lượng gốc, hãy gửi ảnh dưới dạng tài liệu (nhấn và giữ → Gửi dưới dạng tệp).

Hỏi: Điều gì xảy ra nếu bot ngoại tuyến?

Tin nhắn được gửi khi bot ngoại tuyến sẽ bị mất — không có tin nhắn nào phải xếp hàng. Bạn sẽ cần gửi lại bất kỳ tin nhắn nào chưa được phản hồi.

Tóm tắt & Các bước tiếp theo

plugin Claude Code Telegram chính thức là cách được đề xuất để đưa trợ lý AI của bạn đến với Telegram. Chỉ với sáu bước, bạn sẽ có được:

• Quyền truy cập nhắn tin trực tiếp vào Mã Claude từ bất kỳ ứng dụng khách Telegram nào
• Ba công cụ MCP mạnh mẽ để trả lời, phản hồi và chỉnh sửa
• Chính sách kiểm soát quyền truy cập linh hoạt
• Chỉ báo nhập tự động
• Xử lý ảnh bằng cách tải xuống cục bộ

Tiếp theo Các bước:

1. Tạo bot của bạn tại @BotFather
2. Cài đặt bằng /plugin install telegram@claude-plugins-official
3. Định cấu hình mã thông báo của bạn và khởi chạy lại bằng cờ kênh
4. Ghép nối tài khoản Telegram của bạn
5. Chuyển sang chính sách danh sách cho phép cho bảo mật

Để biết cấu hình nâng cao (nhóm, phát hiện đề cập, lệnh kỹ năng), hãy tham khảo ACCESS.md đầy đủ trong kho lưu trữ chính thức.

Nguồn: Plugin Telegram chính thức của Anthropic Claude Code README

Được xuất bản lần đầu tại: Plugin Claude Code Telegram: Hướng dẫn thiết lập hoàn chỉnh 2026