# Claude Code Remote Control: Cách lập trình từ điện thoại bằng mã QR vào năm 2026
> Hướng dẫn từng bước kết nối Claude Code với điện thoại bằng /rc và mã QR. Lệnh, giới hạn, bảo mật và 6 lỗi thường gặp khi chạy lần đầu.
Source: https://ailoot.ai/blog/vi/claude-code-remote-control-phone/
Canonical: https://ailoot.ai/blog/vi/claude-code-remote-control-phone/
Language: vi
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-052
Revision: sha256-f65387132ef766275191ca5f0d9a35f60193fad331549239a1df55d0bda90153
Điểm chính
Chạy `claude --rc` trong terminal, nhấn Space rồi quét mã QR bằng ứng dụng Claude trên điện thoại. Phiên làm việc chạy trên máy tính xách tay; điện thoại chỉ là một cửa sổ để truy cập phiên đó. Tính năng này hữu ích cho các tác vụ chạy qua đêm và làm việc trên ghế sofa, nhưng không phù hợp để chỉnh sửa mã nghiêm túc. Bạn cần phiên bản v2.1.51 trở lên và gói đăng ký Pro hoặc Max.
Bạn có thể xem thêm hướng dẫn trong [tài liệu Ailoot](https://ailoot.ai/docs/).
## Remote Control là gì và vì sao lập trình từ điện thoại?
Điểm chính
Remote Control là cầu nối giữa Claude Code trên máy tính xách tay của bạn với ứng dụng Claude trên điện thoại hoặc trình duyệt claude.ai/code. Phiên làm việc chạy trên máy của bạn; điện thoại chỉ là giao diện để tương tác. Thực thi và công cụ cục bộ ở trên máy; nội dung trong tin nhắn và kết quả công cụ vẫn đi qua Anthropic. Tính năng này hữu ích khi bạn giao một tác vụ dài và muốn tiếp tục chỉ đạo mà không phải ngồi bên máy tính xách tay.
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](https://code.claude.com/docs/en/remote-control#connection-and-security) 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
Điểm chính
Claude Code phiên bản 2.1.51 trở lên và gói đăng ký Pro, Max, Team hoặc Enterprise. Khóa API không dùng được. Bạn cần mạng cho phép kết nối HTTPS đi ra qua cổng 443, không có proxy chặn hoặc can thiệp. Đăng nhập một lần bằng `/login` thông qua claude.ai trong terminal là có thể bắt đầu. Với Team/Enterprise, quản trị viên cũng phải bật tùy chọn trong phần cài đặt tổ chức.
Bảng yêu cầu đầy đủ:
| Hạng mục | Phiên bản tối thiểu / yêu cầu |
|----|----|
| Claude Code CLI | v2.1.51 (phát hành ngày 24.02.2026) |
| Tiện ích mở rộng VS Code | v2.1.79 |
| Thông báo đẩy | v2.1.110 |
| Gói đăng ký | Pro, Max, Team hoặc Enterprise |
| Khóa API | Không dùng được—chỉ hỗ trợ OAuth qua `/login` |
| Mạng | HTTPS đi ra qua cổng 443 |
| Hệ điều hành | macOS, Linux, WSL |
| Tin cậy không gian làm việc | Chạy `claude` trong thư mục dự án ít nhất một lần |
| Team/Enterprise | Quản trị viên đã bật Remote Control trong cài đặt quản trị |
Kiểm tra phiên bản bằng lệnh:
```bash
claude --version
```
Nếu phiên bản thấp hơn 2.1.51, hãy cập nhật:
```bash
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
Điểm chính
Có ba cách khởi chạy Remote Control: lệnh `claude remote-control` trần sẽ khởi chạy máy chủ cho các phiên từ xa; cờ `claude --rc` mở một phiên thông thường với Remote Control được bật; còn lệnh slash `/rc` trong một phiên đang hoạt động sẽ chuyển phiên đó thành phiên từ xa. Cách thứ hai tiện hơn cho hầu hết công việc.
### 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ủ
```bash
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ố:
```bash
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
```bash
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
Điểm chính
Sau khi khởi chạy Remote Control trong terminal, nhấn Space để hiển thị mã QR. Mở ứng dụng Claude trên điện thoại (iOS hoặc Android), hoặc dùng camera, rồi quét mã. Phiên sẽ mở trong ứng dụng hoặc trình duyệt tại claude.ai/code. Trong cùng màn hình của ứng dụng, phiên xuất hiện trong danh sách với chấm màu xanh lá cho biết trạng thái “online”.
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.
Làm việc từ cả hai giao diện cùng lúc: cuộc trò chuyện đồng bộ trên mọi thiết bị đã kết nối—viết từ terminal, trình duyệt hoặc điện thoại tùy thích.
— Anthropic Docs, https://code.claude.com/docs/en/remote-control
### 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
Điểm chính
Lợi ích thực sự của Remote Control là bạn không phải quay lại máy tính xách tay chỉ để nhấp một lần phê duyệt. Không ai định viết mã đầy đủ trên điện thoại. Sau đây là năm tình huống mà tác giả dùng tính năng này hằng tuần: xem lại tác vụ chạy qua đêm, phê duyệt một bước trên tàu điện ngầm, giao việc dài trong giờ nghỉ trưa, quyết định về kiến trúc từ quán cà phê và chạy các phiên song song trong worktree.
### 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:
```bash
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.
Chú ý
Chế độ máy chủ sử dụng tài nguyên máy tính xách tay tương ứng với số phiên chạy đồng thời. Với 16 GB RAM, chạy song song bốn phiên Claude đã có thể nhận thấy rõ mức tải. Hãy chạy số phiên mà máy của bạn có thể xử lý.
## Bảo mật: Những gì ở lại trên máy tính và những gì được gửi đi
Điểm chính
Tin nhắn và kết quả công cụ đi qua Anthropic, có thể chứa mã nguồn hoặc bí mật. Thực thi cục bộ không ngăn việc tiết lộ đó. Kết nối chỉ đi ra ngoài qua cổng 443, dùng thông tin xác thực có thời hạn ngắn và được mã hóa bằng TLS. Máy tính xách tay không mở cổng kết nối đến, và điện thoại từ xa không được truy cập trực tiếp vào hệ thống tệp.
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.
Một phiên Claude Code cục bộ chỉ gửi yêu cầu HTTPS đi ra ngoài và không bao giờ mở cổng kết nối đến trên máy của bạn. Khi khởi chạy Remote Control, phiên sẽ đăng ký với Anthropic API rồi thăm dò API để nhận việc.
— Anthropic Docs, https://code.claude.com/docs/en/remote-control
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
| Loại dữ liệu | Nơi lưu trữ |
|----|----|
| Tệp mã nguồn | Lưu cục bộ; đoạn trích và diff trong hội thoại được truyền đi |
| `.env`, bí mật, khóa API | Có thể lộ khi vào lời nhắc hoặc kết quả công cụ; lưu cục bộ không hạn chế truy cập |
| Máy chủ MCP cục bộ và cấu hình | Chạy cục bộ; nội dung trả về có thể vào hội thoại |
| Cơ sở dữ liệu Claude kết nối | Ở host đã cấu hình; kết quả truy vấn có thể vào hội thoại |
| Nội dung tin nhắn bạn gửi Claude | Trong Anthropic API, sau đó phản hồi được gửi lại |
| Nội dung câu trả lời của Claude | Trong Anthropic API, sau đó đến điện thoại của bạn |
| Diff tệp Claude hiển thị cho bạn | Qua Anthropic API (giống phiên Claude.ai thông thường) |
| Hình ảnh nhập vào, tệp qua `@` | Qua Anthropic API |
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
Kết nối sử dụng một số thông tin xác thực có thời hạn ngắn, mỗi thông tin có một mục đích và thời hạn độc lập.
— Anthropic Docs, https://code.claude.com/docs/en/remote-control
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”.
Lưu ý
Nếu bạn muốn Claude hoàn toàn tự chủ (“Claude tự quyết định và làm việc liên tục 14 giờ mà không cần phê duyệt”), đó là một tính năng khác: chế độ `/goal`. Đọc thêm trong [hướng dẫn về /goal trong Claude Code](https://ailoot.ai/blog/vi/goal-mode-claude-code-codex/). Remote Control làm việc khác: cho phép bạn chỉ đạo công việc từ bất cứ đâu mà không tăng mức độ tự chủ.
## Đã 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
Điểm chính
Bản thân Remote Control chỉ giải quyết một nửa vấn đề: nó cho bạn một cửa sổ xem phiên từ điện thoại. Nửa còn lại là thiết lập để Claude biết khi nào nên dừng lại hỏi và khi nào nên tự tiếp tục. Bạn có thể thực hiện việc này bằng CLAUDE.md, lời nhắc chi tiết khi bắt đầu tác vụ và chế độ `/goal`. Khi đó, thông báo đẩy sẽ đến đúng lúc cần thiết, chứ không phải 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
Điểm chính
Các lỗi thường gặp nhất khi kết nối lần đầu là: “Remote Control environments are not available” do có đặt khóa API; không quét được mã QR vì mã quá nhỏ trong terminal; tường lửa chặn cổng 443; Claude Code quá cũ; thông báo đẩy không phát âm thanh; hoặc Remote Control không hoạt động từ Claude Desktop. Mỗi lỗi mất 1–2 phút để 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:**
```bash
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).
Sự cố mạng hoặc proxy: tường lửa hoặc proxy có thể chặn yêu cầu HTTPS đi ra ngoài. Remote Control cần truy cập Anthropic API qua cổng 443.
— Anthropic Docs, https://code.claude.com/docs/en/remote-control
**Cách khắc phục:** bắt đầu bằng nhật ký verbose và lưu lại lỗi cụ thể:
```bash
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:
```bash
claude --version
```
Nếu thấp hơn 2.1.51, hãy cập nhật:
```bash
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
Điểm chính
Remote Control là cửa sổ chính thức, đồng bộ để truy cập phiên Claude cục bộ. Bot Telegram thông qua Anthropic Channels là kênh phản ứng, nơi “một sự kiện bên ngoài kích hoạt Claude”. SSH+tmux trên điện thoại là shell đa năng, nhưng bị ngắt kết nối khi Mac chuyển sang chế độ ngủ và khiến việc xem diff trên màn hình 6 inch trở nên khó khăn. Hãy chọn theo tác vụ: chỉ đạo một phiên bằng Remote Control, phản ứng với sự kiện bằng Channels hoặc dùng SSH+tmux khi cần một shell tùy ý.
### Bảng so sánh
| Hạng mục | Remote Control | Channels (TG/Discord) | SSH + tmux |
|----|----|----|----|
| Ai khởi chạy | Tôi mở phiên | Sự kiện bên ngoài kích hoạt Claude | Tôi kết nối |
| Giao diện | Giao diện claude.ai/code đầy đủ | Tin nhắn trò chuyện | Terminal trên điện thoại |
| Phiên chạy ở đâu | Trên máy của tôi | Trên máy của tôi | Trên máy chủ |
| Xem xét diff | Tiện lợi (UI gốc) | Dưới dạng văn bản trong chat | Chữ cực nhỏ |
| Hỗ trợ CLI | Chỉ Claude Code | Lệnh bất kỳ thông qua bot | Lệnh bất kỳ |
| Giá | Đã bao gồm trong Pro/Max | Miễn phí (plugin Channels) | Miễn phí |
| Kết nối lại khi mất mạng | Tự động kết nối lại | Phản ứng (push) | Ngắt kết nối khi chuyển ứng dụng |
| Khi nào phiên kết thúc | Đóng terminal / mất mạng quá \>10 phút | Bot chạy liên tục | tmux giữ phiên |
### 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](https://ailoot.ai/blog/vi/claude-code-telegram-channels/).
- **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](https://ailoot.ai/blog/vi/cursor-vs-claude-code/).
Channels: đẩy sự kiện từ ứng dụng trò chuyện như Telegram hoặc Discord, hoặc từ máy chủ của riêng bạn. Hữu ích để phản ứng với các sự kiện bên ngoài—ví dụ như CI thất bại hoặc tin nhắn trò chuyện.
— Anthropic Docs, https://code.claude.com/docs/en/remote-control
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
Điểm chính
Trong một tháng rưỡi, Anthropic phát hành tám bản sửa lỗi và cải tiến tập trung cụ thể vào Remote Control: chặn tính năng khi môi trường có khóa API; sửa lỗi chuyển hướng trình kết nối MCP khi xoay vòng token; thay “Opening your options” bằng nội dung nâng cấp phù hợp khi chạm giới hạn; thay thông báo lúc khởi động bằng viên nút cố định ở chân trang; sửa thông báo đẩy trong các phiên SDK; và hiển thị thông báo lỗi thích hợp ngay lần kết nối đầu tiên. Tính đến 03.06.2026, phiên bản hiện tại là 2.1.162.
Dòng thời gian đầy đủ của các bản sửa lỗi:
| Phiên bản | Ngày | Thay đổi |
|----|----|----|
| v2.1.51 | 24.02.2026 | Phát hành Remote Control lần đầu |
| v2.1.79 | Tháng 3 năm 2026 | Hỗ trợ trong tiện ích mở rộng VS Code |
| v2.1.110 | Tháng 4 năm 2026 | Thông báo đẩy trở thành tính năng chính thức |
| v2.1.126 | 01.05.2026 | Thay thông báo trống “Opening your options...” bằng nội dung nâng cấp phù hợp khi chạm giới hạn tốc độ |
| v2.1.139 | 11.05.2026 | Chặn Remote khi có `ANTHROPIC_API_KEY` hoặc `apiKeyHelper` |
| v2.1.140 | 12.05.2026 | Cài đặt được quản lý thử lại lỗi 401 bằng token vừa được buộc làm mới |
| v2.1.141 | 13.05.2026 | Sửa lỗi trình kết nối MCP gặp 401 trong lúc xoay vòng token phiên worker |
| v2.1.149 | 22.05.2026 | Sửa thông báo “Mobile push not sent” sai trong các phiên SDK |
| v2.1.151 | 27.05.2026 | Remote Control giờ đây là viên nút cố định ở chân trang |
| v2.1.152 | 27.05.2026 | Sửa lỗi `/remote-control` bị treo ở trạng thái “connecting...” |
| v2.1.154 | 28.05.2026 | Tự động hoàn thành hiển thị “Disconnect” khi tính năng đã hoạt động |
| v2.1.162 | 03.06.2026 | Phiên bản hiện tại; cải tiến tổng thể về chỉ số, xử lý công cụ song song, v.v. |
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
Điểm chính
Để Remote Control hoạt động ổn định ngay lần đầu, hãy làm theo bảy bước dưới đây. Các bước này xử lý 90% vấn đề khi chạy lần đầu và giúp bạn phê duyệt thông báo đẩy đầu tiên từ điện thoại trong vòng năm phút sau khi bắt đầu.
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.
### Nguồn
- [Tiếp tục các phiên cục bộ từ mọi thiết bị bằng Remote Control - Tài liệu Claude Code](https://code.claude.com/docs/en/remote-control) — tài liệu chính thức của Anthropic và nguồn chính về lệnh, yêu cầu và giới hạn.
- [Nhật ký thay đổi Claude Code](https://code.claude.com/docs/en/changelog) — lịch sử phiên bản từ 2.1.51 đến 2.1.162, gồm mọi bản sửa lỗi Remote Control.
Khi sẵn sàng, hãy tìm hiểu về [Ailoot](https://ailoot.ai/).
## Câu hỏi thường gặp
### Remote Control có giữ toàn bộ hội thoại ngoài đám mây không?
Không. Lệnh và truy cập hệ thống tệp chạy cục bộ, nhưng tin nhắn, phản hồi, diff và hoạt động công cụ được đồng bộ qua Anthropic. Đoạn mã hay bí mật nằm trong nội dung đó có thể rời máy.
### Vì sao máy tính phải bật khi dùng Remote Control?
Điện thoại là giao diện của tiến trình Claude Code đang chạy trên máy tính. Cần giữ tiến trình và máy sẵn sàng; mở ứng dụng điện thoại không chuyển việc thực thi cục bộ sang máy ảo đám mây.
## Ailoot · Công ty và danh mục dự án của công ty
Ailoot dựa trên kinh nghiệm vận hành tích lũy, cơ sở khách hàng lớn, dịch vụ ổn định và việc kiểm soát KPI liên tục.
Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng.
Ailoot áp dụng kinh nghiệm vận hành này để cung cấp quyền truy cập API vào các tính năng AI trong sản phẩm của khách hàng, tác tử, ứng dụng và quy trình tự động hóa.