Cách kết nối Claude Code với Discord sử dụng Claude Code Channels

Claude Code giờ đây trở nên thú vị hơn rất nhiều. Thay vì bị trói buộc vào cửa sổ dòng lệnh, giờ đây bạn có thể gửi lệnh đến một phiên Claude Code trực tiếp từ Discord. Tính năng đó được gọi là Claude Code Channels, và nó thực sự hoạt động.

Hướng dẫn này bao gồm mọi thứ: Channels là gì, bạn cần chuẩn bị gì trước khi bắt đầu, và toàn bộ quy trình thiết lập từng bước từ cài đặt plugin đến kiểm tra phản hồi đầu tiên của bot Discord.

Nếu đã cài đặt Claude Code và có sẵn tài khoản Discord, bạn có thể bỏ qua phần này. Nếu không, hãy bắt đầu thực hiện ngay!

Điều kiện tiên quyết: Những gì bạn cần trước khi bắt đầu

Hãy chuẩn bị những thứ này trước khi làm bất cứ điều gì khác.

Bỏ qua bất kỳ bước nào sẽ khiến bạn mất thời gian sau này.

  • Claude Code phiên bản 2.1.80 trở lên đã được cài đặt trên máy tính của bạn
  • Một tài khoản Claude.ai đã đăng nhập thông qua Claude Code (không phải xác thực bằng API key)
  • Một gói đăng ký Pro hoặc Max
  • Bun đã được cài đặt, vì plugin kênh Discord phụ thuộc vào nó
  • Một tài khoản Discord có quyền truy cập vào máy chủ nơi bạn có thể thêm bot

Một điều mà nhiều người gặp khó khăn lúc đầu: Claude Code Channels không hoạt động với xác thực bằng API key hoặc đăng nhập chỉ qua console.

Bạn phải đăng nhập bằng tài khoản Claude.ai thực của mình.

Nếu bạn sử dụng Claude Code chỉ thông qua API key cho mục đích thanh toán, Channels sẽ không khả dụng cho đến khi bạn chuyển đổi.

Bước 1: Cài đặt Claude Code

Nếu bạn đã cài đặt và đang chạy Claude Code, hãy chuyển sang Bước 2.

Đối với những người còn lại, hãy truy cập trang web chính thức của Claude Code và lấy lệnh cài đặt cho nền tảng của bạn.

Quá trình cài đặt hỗ trợ Windows, macOS, Linux và WSL.

Trên Windows, sử dụng PowerShell, chạy lệnh:

irm https://claude.ai/install.ps1 | iex

Sau khi cài đặt, tạo thư mục dự án, di chuyển vào thư mục đó và khởi động Claude Code:

mkdir cc-channels
cd cc-channels
claude

Thao tác này sẽ mở Claude Code trong terminal của bạn và bắt đầu một phiên làm việc cục bộ.

Phiên làm việc đang chạy đó là nền tảng của mọi thứ tiếp theo, vì Channels chỉ hoạt động bên trong một phiên bản Claude Code đang hoạt động.

Bước 2: Đăng nhập bằng tài khoản Claude.ai của bạn

Channels yêu cầu xác thực tài khoản Claude.ai.

Khi bạn mở Claude Code lần đầu tiên, nó thường sẽ yêu cầu bạn đăng nhập.

Nếu không, hãy chạy lệnh này bên trong Claude Code:

/login

Lệnh này sẽ mở một cửa sổ trình duyệt để xác thực.

Hoàn tất đăng nhập, quay lại cửa sổ dòng lệnh, và bạn đã sẵn sàng.

Nếu bỏ qua bước này, Channels sẽ không hoạt động và bạn sẽ mất rất nhiều thời gian để tự hỏi tại sao bot của mình không phản hồi.

Bước 3: Cài đặt Bun

Các plugin kênh chính thức của Claude Code yêu cầu Bun.

Nếu bạn chưa cài đặt, đây là lệnh dành cho Windows thông qua PowerShell:

irm bun.sh/install.ps1 | iex

Sau khi cài đặt, hãy xác nhận rằng nó đã hoạt động:

bun --version

Nếu số phiên bản xuất hiện, bạn đã hoàn tất.

Nếu không có gì xuất hiện, có nghĩa là quá trình cài đặt đã xảy ra lỗi và bạn nên kiểm tra xem phiên làm việc trên dòng lệnh của mình có quyền truy cập vào PATH đã được cập nhật hay không.

Bước 4: Thêm Marketplace Plugin chính thức và cài đặt plugin Discord

Claude Code sử dụng hệ thống plugin cho Channels, và plugin Discord nằm trong marketplace plugin chính thức của Anthropic.

Trước khi bạn có thể cài đặt bất cứ thứ gì, bạn cần đảm bảo rằng marketplace đã được thêm và cập nhật.

Chạy hai lệnh này trong Claude Code:

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

Nếu bạn bỏ qua bước này và marketplace bị thiếu, Claude Code sẽ không tìm thấy plugin Discord và sẽ báo rằng nó không tồn tại.

Thông báo lỗi không thực sự hữu ích, vì vậy hãy tránh nhầm lẫn và chạy các lệnh này trước.

Sau khi marketplace đã sẵn sàng, hãy cài đặt plugin Discord:

/plugin install discord@claude-plugins-official

Sau đó load lại các plugin để những lệnh mới có sẵn trong phiên hiện tại của bạn:

/reload-plugins

Việc load lại là bắt buộc.

Claude Code có thể không nhận ra các lệnh của plugin Discord cho đến khi bạn làm mới trạng thái plugin một cách rõ ràng.

Bước 5: Tạo bot Discord trong Developer Portal

Mở Discord Developer Portal và nhấp vào New Application. Đặt tên tùy ý, ví dụ như “CC-Bot” cũng được.

Sau khi tạo xong, điều hướng đến phần Bot:

  1. Nhấp vào Reset Token và sao chép token bot mới.
  2. Lưu token đó ở nơi an toàn, bạn sẽ cần nó ở Bước 7.
  3. Cuộn xuống và bật Message Content Intent.

Phần cuối cùng này rất quan trọng.

Nếu không bật Message Content Intent, Discord sẽ gửi cho bot các trường nội dung tin nhắn trống và phiên Claude Code của bạn sẽ không biết ai đang nói gì với nó.

Đây là yêu cầu cụ thể của Discord đối với các bot đọc văn bản tin nhắn đến.

Bước 6: Mời bot vào Discord Server của bạn

Vẫn trong Developer Portal, mở tab OAuth2 và cuộn xuống “OAuth2 URL Generator”.

Chọn bot trong phần Scopes.

Sau đó, chọn các Bot Permissions sau:

  • View Channels
  • Send Messages
  • Send Messages in Threads
  • Read Message History
  • Attach Files
  • Add Reactions
  • Send Voice Messages

Discord sẽ tạo URL mời ở cuối trang.

Sao chép URL đó, dán vào trình duyệt của bạn, chọn máy chủ bạn muốn thêm bot vào và nhấp vào Authorize.

Bot sẽ xuất hiện trong máy chủ của bạn, ở trạng thái ngoại tuyến cho đến khi bạn kết nối nó.

Bước 7: Kết nối bot token với Claude Code

Quay lại Claude Code, chạy lệnh:

/discord:configure YOUR_DISCORD_BOT_TOKEN

Thay thế YOUR_DISCORD_BOT_TOKEN bằng token bạn đã sao chép ở Bước 5.

Claude Code tự động lưu token vào:

~/.claude/channels/discord/.env

Bạn không cần phải chỉnh sửa file đó theo cách thủ công.

Lệnh sẽ tự động xử lý việc này.

Một vấn đề thường gặp: Nếu lệnh /discord:configure không hoạt động, hãy đóng hoàn toàn cửa sổ terminal, mở lại, quay lại thư mục dự án của bạn và khởi chạy Claude Code một lần nữa.

Đôi khi trạng thái plugin cần một phiên làm việc sạch để được đăng ký chính xác.

Bước 8: Khởi động Claude Code với tính năng Channels được kích hoạt

Tại thời điểm này, mọi thứ đã được cấu hình, nhưng bot Discord vẫn ngoại tuyến.

Channels chỉ được kích hoạt khi bạn khởi động Claude Code một cách rõ ràng với flag channel.

Thoát khỏi phiên Claude Code hiện tại của bạn, sau đó khởi chạy lại bằng lệnh:

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

Lệnh này sẽ khởi động một phiên Claude Code mới với plugin Discord đã được load và đang lắng nghe.

Bot của bạn giờ sẽ trực tuyến trên Discord.

Nếu nó không hiển thị trực tuyến, hãy kiểm tra lại xem token có chính xác hay không và Claude Code có thực sự đang chạy với flag --channels hay không.

Bước 9: Ghép nối tài khoản Discord của bạn

Khi Claude Code đang chạy và bot đang trực tuyến, hãy mở Discord và gửi tin nhắn trực tiếp cho bot của bạn.

Bot sẽ trả lời bằng mã ghép nối.

Nếu bot không phản hồi, có thể phiên Claude Code của bạn đã đóng hoặc được bắt đầu mà không có flag --channels.

Sau khi có mã ghép nối, hãy quay lại Claude Code và chạy lệnh:

/discord:access pair YOUR_PAIRING_CODE

Thay thế YOUR_PAIRING_CODE bằng mã mà bot đã gửi cho bạn.

Sau khi ghép nối, hãy khóa quyền truy cập để chỉ những tài khoản Discord được chấp thuận mới có thể gửi tin nhắn vào phiên của bạn:

/discord:access policy allowlist

Đây là bước bạn không nên bỏ qua.

Nếu không có danh sách cho phép, bất kỳ ai có thể nhắn tin cho bot của bạn đều có khả năng tương tác với phiên Claude Code trực tuyến của bạn.

Điều đó bao gồm cả những người vô tình tìm thấy bot.

Bước 10: Kiểm tra thiết lập

Gửi tin nhắn cho bot của bạn trong Discord.

Hãy hỏi nó một điều gì đó đơn giản, yêu cầu một tác vụ, hoặc bảo nó kiểm tra điều gì đó.

Tin nhắn sẽ được gửi vào phiên Claude Code đang chạy của bạn, Claude sẽ xử lý nó, và phản hồi sẽ được trả về trong Discord.

Một vài điều cần lưu ý trong quá trình thử nghiệm:

Yêu cầu quyền có thể làm tạm dừng bot. Claude Code được thiết kế để hỏi trước khi thực hiện các hành động như chạy lệnh shell hoặc ghi file.

Nếu bạn yêu cầu bot làm điều gì đó kích hoạt kiểm tra quyền, nó sẽ dừng lại và chờ phê duyệt trong terminal trước khi phản hồi trong Discord.

Bạn sẽ cần phải phê duyệt thủ công.

Nếu muốn ít bị gián đoạn hơn trong quá trình thử nghiệm, bạn có thể khởi động Claude Code như sau:

claude --dangerously-skip-permissions --channels plugin:discord@claude-plugins-official

Flag này bỏ qua hoàn toàn các yêu cầu quyền.

Nó tiện lợi cho việc thử nghiệm, nhưng chỉ sử dụng trong môi trường mà bạn hoàn toàn kiểm soát. Tên gọi đã nói lên tất cả.

Kết luận

Tính năng Channels của Claude Code thực sự hữu ích một khi đã được thiết lập.

Quá trình thiết lập có nhiều bước hơn bạn nghĩ, nhưng hầu hết các bước đều chỉ cần thực hiện một lần.

Sau đó, bot Discord của bạn sẽ trở thành giao diện trực tiếp cho phiên Claude Code cục bộ, và bạn có thể tương tác với nó từ bất cứ nơi nào có thể truy cập Discord.

Các bước thiết lập như sau: Cài đặt Claude Code, đăng nhập bằng tài khoản Claude.ai, cài đặt Bun, thêm cửa hàng plugin chính thức, cài đặt plugin Discord, tạo và cấu hình bot Discord, khởi chạy Claude Code với tính năng Channels được bật, ghép nối tài khoản Discord của bạn và kiểm tra.

Tất cả là 10 bước, mỗi bước đều khá đơn giản.

Nếu bạn muốn tìm hiểu thêm về Claude Code, việc khám phá danh sách các IDE dựa trên trí tuệ nhân tạo (AI) năm 2026 sẽ cho bạn cái nhìn rõ hơn về vị trí của Claude Code trong bối cảnh rộng lớn hơn của các công cụ phát triển hỗ trợ AI.