Claude Code Remote Control: Cách lập trình từ điện thoại bằng mã QR vào năm 2026

Bạn có thể xem thêm hướng dẫn trong tài liệu Ailoot.

Remote Control là gì và vì sao lập trình từ điện thoại?#

Anthropic phát hành Remote Control vào ngày 24 tháng 2 năm 2026. Anthropic mô tả tính năng này là cách tiếp tục các phiên cục bộ từ bất kỳ thiết bị nào.

Nói đơn giản: bạn bắt đầu một phiên trong terminal như thường lệ. Bật Remote Control. Mở ứng dụng Claude trên điện thoại → vào tab Code → bạn sẽ thấy phiên làm việc có chấm màu xanh lá. Chạm vào đó để đọc và trả lời. Bạn có thể viết từ máy tính xách tay, điện thoại và trình duyệt theo bất kỳ cách kết hợp nào—mọi thứ đều được đồng bộ.

Tài liệu Remote Control chính thức phân biệt thực thi cục bộ với lưu lượng mạng: lệnh và thao tác hệ thống tệp chạy trên máy bạn, còn hội thoại được đồng bộ qua Anthropic.

Đây là điểm khác biệt chính so với Claude Code trên web, nơi phiên làm việc chạy trên một VM đám mây của Anthropic. Ở đây, Claude vẫn chạy trên phần cứng của bạn, cùng tất cả kho Git, biến môi trường và khóa cơ sở dữ liệu. Điện thoại chỉ là màn hình để bạn trò chuyện với Claude.

Vì sao người lập trình theo cảm hứng có thể cần tính năng này

Ba tình huống thực tế mà tác giả dùng hằng tuần:

1. Một đợt tái cấu trúc dài chạy qua đêm. Giao cho Claude nhiệm vụ cập nhật 40 tệp để dùng API mới. Rời khỏi máy tính xách tay. Sáng hôm sau, nằm trên ghế sofa với điện thoại, xem diff và nói: “Chấp nhận 12 mục đầu tiên; hiển thị phần còn lại riêng.” Không cần mở máy tính xách tay.
2. Phê duyệt một bước trên đường đi làm. Bạn đang ở tàu điện ngầm thì Claude gửi thông báo đẩy: “Cần quyết định về việc di chuyển lược đồ.” Mở thông báo, đọc hai phương án rồi viết: “Chọn phương án đầu tiên; đừng động vào các bài kiểm thử.” Phiên làm việc tiếp tục trong lúc bạn di chuyển.
3. Vừa xem livestream vừa họp. Trong cuộc họp Zoom, bạn có thể kiểm tra trên điện thoại xem một phiên Claude thứ hai đã tạo xong bản dựng thử hay chưa. Không cần chuyển khỏi cuộc gọi video.

Bạn cần gì để chạy Remote Control#

Bảng yêu cầu đầy đủ:

Kiểm tra phiên bản bằng lệnh:

claude --version

Nếu phiên bản thấp hơn 2.1.51, hãy cập nhật:

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

Nếu môi trường của bạn có đặt ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN hoặc apiKeyHelper, Remote Control sẽ không khởi chạy. Kể từ v2.1.139 (11.05.2026), Anthropic chặn rõ ràng tính năng này khi các biến đó tồn tại. Chạy unset ANTHROPIC_API_KEY rồi đăng nhập lại bằng /login.

Cách khởi chạy Remote Control: 3 cách trong 2 phút#

Cách 1. Chế độ máy chủ—máy chủ riêng dành cho các phiên từ xa

1. Mở terminal trong thư mục dự án

   Chạy cd một lần để chuyển đến thư mục bạn sẽ làm việc. Nếu đó là thư mục mới, hãy chạy claude như thường lệ để hoàn tất hộp thoại Workspace Trust.

2. Khởi chạy máy chủ

   claude remote-control
   

   Terminal tiếp tục chạy. URL phiên làm việc và lời nhắc “Press space to show QR” xuất hiện ở phía dưới. Máy chủ đang chờ kết nối.

3. Kết nối từ điện thoại

   Nhấn Space—mã QR sẽ xuất hiện. Quét mã bằng ứng dụng Claude hoặc camera iPhone để mở phiên làm việc.

Tùy chọn: đặt tên phiên và tham số:

claude remote-control --name "Refactor API" --spawn worktree --capacity 4

• --name — tên hiển thị của phiên trong danh sách trên điện thoại.
• --spawn worktree — mỗi phiên mới mở trong một Git worktree riêng để các phiên chạy song song không ảnh hưởng lẫn nhau.
• --capacity 4 — tối đa 4 phiên từ xa đồng thời trên máy chủ. Mặc định là 32.

Cách 2. Chế độ tương tác—phiên của tôi với Remote Control được bật

claude --remote-control
# or shorter:
claude --rc

Cách này mở một phiên tương tác thông thường trong terminal, với Remote Control được bật. Bạn có thể trao đổi với Claude từ cả máy tính xách tay lẫn điện thoại—cuộc trò chuyện là một phiên được đồng bộ.

Khác với chế độ máy chủ, đây là một phiên duy nhất. Cách này hữu ích khi bạn dự định chủ yếu làm việc trên máy tính và muốn dùng điện thoại dự phòng lúc cần rời đi.

Cách 3. Từ phiên đang hoạt động bằng /rc

Đang làm việc trong Claude Code? Đừng tắt phiên. Chỉ cần nhập:

/remote-control

hoặc ngắn hơn:

/rc

Phiên sẽ chuyển thành phiên từ xa. Bạn không mất ngữ cảnh. Cách này hữu ích khi đang làm dở một tác vụ và nhận ra mình cần rời đi.

Mã QR: Kết nối điện thoại trong 10 giây#

1. Cài đặt ứng dụng Claude

   Nếu chưa có ứng dụng, hãy nhập /mobile trong Claude Code. Mã QR để tải ứng dụng từ App Store hoặc Google Play sẽ xuất hiện. Cách này nhanh hơn tìm kiếm thủ công.

2. Hiển thị mã QR của phiên trong terminal

   Sau khi chạy claude --rc hoặc claude remote-control, nhấn Space. Mã QR xuất hiện ngay trong terminal.

3. Quét bằng điện thoại

   Mở ứng dụng Claude → camera, hoặc dùng camera iPhone thông thường (camera Android cũng quét được). Nếu không hoạt động, hãy phóng to cửa sổ terminal, chuyển sang iTerm2 hoặc Windows Terminal, hoặc sao chép URL phía trên mã QR rồi dán thủ công vào trình duyệt.

4. Bật thông báo đẩy

   Nhập /config trong phiên và bật “Push when Claude decides.” Bạn cần Claude Code phiên bản 2.1.110 trở lên.

Bạn sẽ thấy gì trên điện thoại

Tab Code mở trong ứng dụng Claude. Phiên làm việc xuất hiện trong danh sách với biểu tượng máy tính và chấm màu xanh lá (online). Chạm vào phiên để truy cập.

Sau đó, trải nghiệm tương tự claude.ai/code: bạn có thể xem tin nhắn của Claude và diff tệp, chấp nhận hoặc từ chối chúng, hoặc yêu cầu thay đổi. Bạn có thể viết yêu cầu mới. Mọi thứ được gửi đến máy của bạn, nơi Claude cục bộ xử lý rồi trả lời.

Claude có thể làm gì với thông báo đẩy

Claude gửi thông báo đẩy khi quyết định rằng cần thiết. Theo mặc định, có hai trường hợp: một tác vụ dài hoàn tất hoặc Claude cần bạn quyết định. Bạn cũng có thể yêu cầu rõ ràng: “Báo cho tôi khi các bài kiểm thử chạy đạt”, và Claude sẽ gửi thông báo.

Nếu không nhận được thông báo đẩy:

• Trên iOS, kiểm tra Cài đặt → Thông báo → Claude. Các chế độ Focus có thể tắt tiếng thông báo.
• Trên Android, tắt tính năng tối ưu hóa pin cho ứng dụng Claude.
• Nếu /config hiển thị “No mobile registered”, hãy mở ứng dụng Claude ít nhất một lần để ứng dụng cập nhật token đẩy.

Làm việc trên ghế sofa: 5 tình huống hữu ích#

Tình huống 1. Xem lại trên ghế sofa—kiểm tra tác vụ chạy qua đêm

Trước khi đi ngủ, giao cho Claude một tác vụ như: “Chạy toàn bộ kho mã với các quy tắc lint mới và sửa mọi thứ không quan trọng; đánh dấu phần còn lại là TODO.” Chạy claude --rc và để terminal mở.

Buổi sáng, nằm trên ghế sofa cùng điện thoại. Mở ứng dụng Claude → thấy phiên có chấm màu xanh lá → tìm 87 commit dưới dạng diff. Cuộn xem; ở chỗ đáng ngờ, viết “hoàn tác phần này; tôi sẽ tự sửa”, còn với phần ổn thì viết “chấp nhận tất cả”. Không cần “đi đến máy tính xách tay” lúc 7 giờ sáng.

Tình huống 2. Phê duyệt khi đi lại—phê duyệt một bước trên tàu điện ngầm

Bắt đầu một đợt di chuyển lược đồ cơ sở dữ liệu dài vào buổi sáng. Lúc 9:30, thông báo đẩy đến khi bạn đang ở tàu điện ngầm: “Tìm thấy hai phương án di chuyển; cần quyết định.” Chạm vào thông báo, đọc các phương án, chọn một phương án rồi thêm: “Đừng xóa bảng cũ cho đến khi chạy xong toàn bộ bài kiểm thử.” Claude tiếp tục làm việc.

Nếu không có Remote Control, Claude sẽ dừng lại ở đó và chờ trong im lặng. Bạn đến nơi rồi mới mở máy tính xách tay—mất 40 phút.

Tình huống 3. Rời đi một lúc—giao tác vụ dài trong giờ nghỉ trưa

Trước giờ ăn trưa, giao Claude việc “Cập nhật tài liệu cho tất cả endpoint”. Đi đến quán cà phê. Sau 25 phút, một thông báo đẩy đến: “Xong rồi, xem thử nhé.” Chạm “chấp nhận” một lần, rồi quay lại ăn súp. Nếu không có Remote Control, hoặc bạn phải ngồi trước máy tính xách tay 25 phút như người canh gác, hoặc quay lại và thấy Claude chẳng làm gì suốt thời gian đó vì gặp điểm cần quyết định.

Đó là điểm quan trọng. Remote Control không khiến Claude tự chủ hơn—nó chỉ cho phép bạn truy cập từ bất cứ đâu. Claude gặp càng ít điểm cần quyết định thì bạn càng nhận được ít thông báo đẩy. Vì vậy, hãy viết hướng dẫn công việc cụ thể hơn: “Làm theo cách này; trong những trường hợp này thì làm cách kia; nếu thực sự không rõ thì dừng lại và gửi thông báo đẩy.”

Tình huống 4. Quyết định về kiến trúc từ quán cà phê

Giữa lúc tái cấu trúc, Claude tìm ra hai hướng di chuyển dữ liệu và hỏi bạn chọn hướng nào. Nếu đang xa máy tính, mở diff đề xuất trên điện thoại, chọn một phương án rồi thêm nhận xét: “Nhưng đừng động vào bảng user_settings—tuần sau tôi sẽ xóa bảng đó.” Phiên tiếp tục chạy.

Cách này đặc biệt hiệu quả trong chế độ worktree (--spawn worktree): mỗi tác vụ chạy song song ở nhánh riêng nên chúng không can thiệp lẫn nhau. Trên điện thoại, bạn chuyển qua lại giữa các tác vụ như giữa các cuộc trò chuyện.

Tình huống 5. Chạy nhiều phiên worktree cùng lúc

Một cách mạnh mẽ là kết hợp chế độ máy chủ với nhiều worktree. Khởi chạy trên máy tính xách tay:

claude remote-control --spawn worktree --capacity 4

Bắt đầu các phiên trên những nhánh khác nhau từ điện thoại: một phiên xây dựng tính năng, phiên khác sửa lỗi trong danh sách, phiên thứ ba chạy kiểm thử hồi quy. Tất cả cùng chạy trên máy tính xách tay của bạn mà không phiên nào chặn phiên nào.

Bảo mật: Những gì ở lại trên máy tính và những gì được gửi đi#

Trước khi nối dự án nhạy cảm, xác định nội dung được phép vào lời nhắc và đầu ra công cụ. Giữ bí mật sản xuất ngoài môi trường tác nhân truy cập được; bảng truyền dữ liệu không chứng minh một phiên cụ thể không thể làm lộ chúng.

Nói theo cách thông thường: máy tính xách tay hỏi Anthropic, “Có tin nhắn nào cho tôi không?”, nhận phản hồi rồi xử lý cục bộ. Không ai bên ngoài mở cổng kết nối đến máy của bạn. Tường lửa doanh nghiệp sẽ cho phép kết nối này mà không cần cấu hình đặc biệt.

Những dữ liệu nào thực sự được gửi đến Anthropic

Remote Control thêm giao diện đồng bộ, không tạo chế độ suy luận ngoại tuyến. Anthropic lưu transcript phiên được nối gồm tin nhắn, phản hồi và hoạt động công cụ theo chính sách dữ liệu. Xem cả dữ liệu gửi mô hình lẫn quyền truy cập từ thiết bị đã nối.

Lưu ý về thông tin xác thực

Nói cách khác, một nhóm token có thời hạn ngắn luân chuyển giữa máy tính xách tay, Anthropic và điện thoại của bạn thay vì một token có thời hạn dài duy nhất. Nếu một token bị xâm phạm, kẻ tấn công cũng không thể truy cập tất cả token còn lại.

Một giới hạn quan trọng nữa: --dangerously-skip-permissions không hoạt động trong Remote Control. Mọi lần gọi công cụ (Bash, Write, Edit) vẫn phải chờ bạn phê duyệt. Đây là chủ ý thiết kế, nhằm ngăn tính năng điện thoại biến thành “máy tính xách tay tự chạy mà không có ai giám sát”.

Đã bắt đầu Remote Control? Giờ hãy thiết lập để Claude không làm gián đoạn bạn mỗi 10 phút#

/rc là cách tiện lợi để đưa phiên làm việc lên điện thoại. Nhưng nếu Claude cứ viết “Tôi không hiểu cần làm gì” mỗi 10 phút, vấn đề không nằm ở điện thoại mà là thiết kế ngữ cảnh: bạn đặt quy tắc ban đầu rõ ràng đến mức nào.

Sáu sự cố khi chạy lần đầu và cách khắc phục#

Sự cố 1. “Remote Control environments are not available for your account”

Đây là lời phàn nàn phổ biến nhất trong kho anthropics/claude-code (issue #29449 và hơn một tá bản trùng lặp). Bạn trả lời y cho câu hỏi “enable Remote Control?”—CLI trả về lỗi và không đề nghị thử lại.

Nguyên nhân hầu như luôn giống nhau: ANTHROPIC_API_KEY hoặc CLAUDE_CODE_OAUTH_TOKEN được đặt trong môi trường. Remote Control chỉ hoạt động qua OAuth đầy đủ bằng /login, không dùng khóa.

Cách khắc phục:

unset ANTHROPIC_API_KEY
unset CLAUDE_CODE_OAUTH_TOKEN
unset apiKeyHelper

# kiểm tra xem môi trường đã sạch chưa:
env | grep -i anthropic
env | grep -i claude

# đăng nhập lại:
claude
/logout
/login

Sau khi /login qua trình duyệt, Remote Control sẽ khởi chạy.

Sự cố 2. Điện thoại không quét được mã QR

Camera điện thoại hướng vào mã nhưng không phản hồi, hoặc báo “Không thể đọc mã này”.

Nguyên nhân: terminal hiển thị mã QR quá nhỏ hoặc độ tương phản không đủ.

Cách khắc phục:

1. Phóng cửa sổ terminal ra toàn màn hình.
2. Nếu đang dùng Apple Terminal, hãy chuyển sang iTerm2 (hoặc Warp). Nếu dùng Windows, hãy dùng Windows Terminal thay cho CMD.
3. Giảm cỡ chữ trong terminal 1–2 điểm để mã QR lớn hơn.
4. Nếu vẫn không được, sao chép URL phía trên mã QR và mở URL đó trong trình duyệt trên điện thoại.

Sự cố 3. Tường lửa chặn cổng 443

Việc này thường xảy ra trên máy tính doanh nghiệp có proxy chặn can thiệp (Zscaler hoặc VPN doanh nghiệp có MITM).

Cách khắc phục: bắt đầu bằng nhật ký verbose và lưu lại lỗi cụ thể:

claude remote-control --verbose

Nếu thấy “certificate verification failed”, kết nối đang bị MITM can thiệp và bạn cần liên hệ quản trị viên mạng. Nếu thấy “connection refused” / “timeout”, hãy yêu cầu quản trị viên cho phép kết nối đi ra ngoài tới *.anthropic.com:443.

Sự cố 4. Claude Code quá cũ

Kiểm tra:

claude --version

Nếu thấp hơn 2.1.51, hãy cập nhật:

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

Tiện ích mở rộng VS Code yêu cầu ít nhất v2.1.79. Thông báo đẩy yêu cầu v2.1.110.

Sự cố 5. Không nhận được thông báo đẩy

Tình huống: Remote Control hoạt động nhưng điện thoại im lặng khi Claude hoàn tất một tác vụ dài.

Danh sách kiểm tra:

1. Chạy /config trong phiên. Nếu thấy “No mobile registered”, hãy mở ứng dụng Claude trên điện thoại ít nhất một lần để ứng dụng cập nhật token đẩy.
2. iOS: Cài đặt → Thông báo → Claude → kiểm tra thông báo đã bật và không bị chế độ Focus tắt tiếng.
3. Android: mở phần cài đặt pin và loại Claude khỏi danh sách tối ưu hóa pin.
4. Nếu bật Tóm tắt thông báo của iOS, thông báo đẩy có thể đến nhưng xuất hiện trong bản tóm tắt theo giờ. Tắt tính năng Tóm tắt cho Claude.

Sự cố 6. Claude Desktop làm hỏng /remote-control

Nếu chạy /remote-control trong ứng dụng Claude Desktop, bạn sẽ gặp lỗi “Remote Control requires a full-scope login token” (GitHub issue #48378).

Nguyên nhân: Claude Desktop chèn một token OAuth có quyền hạn chế (chỉ dùng cho suy luận).

Cách khắc phục: chạy Claude Code trong terminal hệ thống thông thường, không phải terminal tích hợp trong Claude Desktop. Đây là giới hạn đã biết; Anthropic đang khắc phục.

Thêm. Tự động kết nối lại âm thầm ngừng hoạt động trong các phiên dài

Triệu chứng: phiên Remote Control chạy được 30–60 phút, sau đó điện thoại âm thầm ngắt kết nối mà không có dấu hiệu báo (issue #34255). Khắc phục thủ công: /remote-control → Disconnect → khởi động lại. Cách này chưa lý tưởng, nhưng tính năng vẫn đang ở giai đoạn xem trước nghiên cứu.

Chỉ riêng tháng 5 năm 2026, Anthropic đã phát hành tám bản sửa lỗi dành riêng cho Remote Control—tính năng này đang được cải thiện tích cực. Bạn có thể phàn nàn, nhưng cũng có cơ sở để kỳ vọng phần lớn vấn đề sẽ biến mất trong vài tháng tới.

Remote Control so với bot Telegram và SSH+tmux#

Bảng so sánh

Khi nào nên chọn từng phương án

• Remote Control — thiết lập mặc định cho việc “rời khỏi máy tính xách tay nhưng vẫn tiếp tục chỉ đạo công việc”. Có giao diện đầy đủ, đồng bộ thiết bị và không dùng dịch vụ bên thứ ba.
• Channels (bot Telegram) — khi bạn muốn Claude tự động điều tra sau một lần CI thất bại, một khiếu nại mới của khách hàng hoặc một tin nhắn trò chuyện. Đây là “sự kiện → Claude phản ứng” thay vì “tôi chỉ đạo Claude từ điện thoại”. Đọc thêm trong hướng dẫn về Telegram và Claude Code.
• SSH + tmux — khi cần một shell tùy ý trên điện thoại để chạy lệnh của riêng bạn (triển khai bản phát hành, kiểm tra nhật ký, khởi động lại dịch vụ). Một shell đa năng bên ngoài Claude Code. Với tác vụ một lần, có thể dùng Termux/Blink.
• Các tác nhân lập trình khác — Anthropic Remote Control chỉ dành cho Claude Code. Để so sánh Claude với các lựa chọn khác, xem Cursor so với Claude Code.

Vì vậy, tài liệu của Anthropic phân biệt hai tính năng này theo mục đích sử dụng: Remote Control dùng để điều khiển; Channels dùng để phản ứng.

Remote Control có gì mới từ tháng 5 năm 2026 đến tháng 6 năm 2026#

Dòng thời gian đầy đủ của các bản sửa lỗi:

Tám bản sửa lỗi riêng cho Remote Control trong một tháng là bình thường với một tính năng đang ở giai đoạn xem trước nghiên cứu. Anthropic rõ ràng đang phản hồi ý kiến và xử lý các trường hợp biên.

Nếu tính năng hoạt động kỳ lạ, bước đầu tiên là kiểm tra phiên bản và cập nhật. Có thể lỗi đó đã được sửa.

Danh sách kiểm tra: Thiết lập và khởi chạy trong 5 phút#

1. Kiểm tra phiên bản Claude Code

   claude --version — phiên bản phải là 2.1.51 trở lên. Nếu chưa đạt, chạy npm install -g @anthropic-ai/claude-code@latest.

2. Xóa khóa API khỏi môi trường

   Chạy unset ANTHROPIC_API_KEY và unset CLAUDE_CODE_OAUTH_TOKEN. Sau đó chạy /logout → /login qua trình duyệt.

3. Cài ứng dụng Claude trên điện thoại

   Chạy /mobile trong phiên Claude Code để hiển thị mã QR dẫn đến App Store / Google Play.

4. Khởi chạy Remote Control

   Chạy claude --rc hoặc /rc trong một phiên. URL và lời nhắc “Press space to show QR” sẽ xuất hiện.

5. Quét mã QR bằng điện thoại

   Nhấn Space trong terminal → dùng camera hoặc ứng dụng Claude. Phóng to cửa sổ terminal nếu không quét được.

6. Bật thông báo đẩy

   /config → “Push when Claude decides.” Nếu thấy “No mobile registered”, hãy mở ứng dụng Claude ít nhất một lần.

7. Bắt đầu một tác vụ dài rồi rời đi

   Viết lời nhắc cụ thể: “Làm theo cách này; trong những trường hợp này thì làm cách kia; nếu có điểm đáng ngờ thì gửi thông báo đẩy.” Sau đó làm việc từ điện thoại bằng thông báo đẩy.

Trong một ví dụ thực tế, quá trình từ lúc bắt đầu đến cuộc trò chuyện đầu tiên trên ghế sofa mất 3–5 phút.

Khi sẵn sàng, hãy tìm hiểu về Ailoot.