Code Remote

Coding agents

Theo dõi mọi phiên Claude Code trên máy tính từ iPhone, trả lời các yêu cầu cấp quyền và câu hỏi ngay tại đó, và nhận thông báo khi nó cần bạn.

Tab Agents và thông báo là một phần của Code Remote Pro, và cần coderemote bản gần đây trên máy tính: chạy coderemote update và khởi động lại coderemote up nếu app yêu cầu.

Thiết lập

Một lần cho mỗi máy tính, khi đã cài Claude Code:

$ coderemote setup claude

Lệnh này cài plugin Code Remote vào Claude Code (giống /plugin install coderemote --marketplace CodeRemoteApp/coderemote bên trong Claude Code). Các phiên Claude Code bạn bắt đầu sau đó, trong thư mục được chia sẻ bằng coderemote up, sẽ hiện trong app. Các phiên đang chạy sẽ hiện sau khi bạn khởi động lại chúng. Để hoàn tác: coderemote setup claude --remove.

Plugin không làm gì khi không có coderemote nào đang chạy, hoặc khi thư mục của phiên không được chia sẻ: lúc đó Claude Code hoạt động y như khi không có nó.

Codex

Codex 0.139 trở lên cũng dùng được:

$ coderemote setup codex

Sau đó mở Codex một lần, gõ /hooks và tin cậy các hook của Code Remote: Codex chỉ chạy hook của plugin sau khi bạn đã xem qua chúng. Các phiên Codex hiện trong tab Agents với nhãn Codex.

Một điểm khác: Codex chỉ hiện hộp thoại phê duyệt của chính nó sau khi hook nhường chỗ. Vì vậy khi bạn đang dùng máy tính (hoặc đang mở máy đó trong app), Codex hỏi trong terminal như thường và app hiện "Answer on your computer"; khi bạn đi vắng, yêu cầu chờ điện thoại của bạn, kèm thông báo, tối đa mười phút trước khi Codex hỏi trong terminal. Codex không có "luôn cho phép" từ hook.

Tab Agents

Liệt kê các phiên trên máy, nhóm thành Needs You (đang chờ câu trả lời), Working, Idle và Ended; tab cho biết có bao nhiêu phiên cần bạn. Mở một phiên để xem nó đã làm gì: các prompt của bạn, câu trả lời của Claude, và từng công cụ nó đã chạy. Lệnh hiện kèm output, chỉnh sửa tệp hiện dưới dạng các dòng thay đổi (nhấn để xem toàn bộ thay đổi hoặc tệp), và các lần đọc mở tệp.

Một phiên bắt đầu trong terminal của app có Open in Terminal, để gõ trực tiếp vào đó. Các phiên bạn bắt đầu trên máy tính hiện cùng dòng thời gian.

Các phiên nằm trong bộ nhớ của coderemote: dừng coderemote up sẽ xóa danh sách, và các phiên đã kết thúc biến mất sau một ngày.

Trả lời từ điện thoại

Khi Claude xin quyền chạy thứ gì đó, hoặc hỏi bạn một câu, một thẻ sẽ hiện ở cuối phiên:

  • Allow hoặc Deny. Menu ⋯ có các lựa chọn "luôn cho phép" giống như Claude Code cung cấp trên máy tính, và Deny with Message để nói cho Claude biết nên làm gì thay thế.
  • Với một câu hỏi, nhấn một câu trả lời, hoặc Other… để tự gõ.

Yêu cầu vẫn mở trên máy tính. Bên nào trả lời trước sẽ được chọn: trả lời trên máy tính thì thẻ (và thông báo của nó) trên điện thoại biến mất. Một yêu cầu không ai trả lời từ điện thoại trong vòng một giờ sẽ được để lại cho máy tính.

Bắt đầu và điều khiển phiên

Nhấn + trong tab Agents để khởi chạy một coding agent trên máy tính. Chọn Agent (Claude Code, hoặc Codex sau khi đã thiết lập) và Folder: nó mở thư mục được chia sẻ, nơi bạn đi vào các thư mục con, lọc theo tên, và nhấn Use This Folder. Sau đó:

  • Với Claude Code, chọn một model và cách nó xin quyền (Ask First, Accept Edits, Plan Only hoặc Auto).
  • Với Codex, chọn một model trong số Codex cung cấp (Default là model trong cấu hình của Codex), và có cho phép Ask before running outside the sandbox hay không. Khi tắt, Codex từ chối những gì sandbox không cho phép mà không hỏi.

Phiên chạy trong một terminal của app, nên bạn có thể gõ vào nó từ hộp tin nhắn của phiên:

  • Viết một prompt rồi gửi; khi Claude đang làm việc, những gì bạn gửi sẽ chờ đến lượt, giống như khi ngồi ở máy tính. Stop ngắt nó (như Esc).
  • + đính kèm ảnh, video, tệp, ảnh chụp từ camera hoặc ảnh đã sao chép. Chúng được gửi đến ~/.coderemote/uploads/ trên máy tính (ngoài dự án của bạn, tự xóa sau một tuần), và Claude thấy ảnh như ảnh; với các tệp khác nó nhận đường dẫn.
  • Menu ⚡ có Next Permission Mode (Shift+Tab), /compact, /clear, /model và Open in Terminal (Codex không có chế độ cấp quyền để chuyển và không có /clear). Trong terminal, Chat trong menu … đưa bạn quay lại.
  • Một phiên đã kết thúc có nút Resume Here, tiếp tục cuộc trò chuyện trong một terminal mới.

Một phiên bạn bắt đầu trong terminal trên máy tính có thể được theo dõi và trả lời ở đây nhưng không gõ vào được, vì nó không phải terminal của app; hãy tiếp tục nó ở đây sau khi kết thúc.

Thông báo

Bật cho từng máy trong thông tin của máy (nhấn giữ nó trong danh sách máy, hoặc Machine Info trong menu của một tab): Cần câu trả lời và Hoàn thành tác vụ dài (tác vụ chạy từ một phút trở lên), có nút thử.

Nhấn giữ một thông báo cấp quyền để Cho phép hoặc Từ chối mà không cần mở app (sau Face ID); một câu hỏi đơn cũng cho trả lời theo cách tương tự. Sẽ không gửi gì khi bạn đang dùng máy tính (trên Mac) hoặc đang mở máy đó trong app.

Cách hoạt động

Plugin chạy coderemote hook cho từng sự kiện của Claude Code (một prompt, một lần gọi công cụ, một câu trả lời, một yêu cầu cấp quyền). Nó chuyển sự kiện cho coderemote đang chia sẻ thư mục của phiên, trên cùng máy tính, được xác thực bằng một bí mật không bao giờ rời khỏi máy. Yêu cầu cấp quyền sẽ chờ ở đó câu trả lời từ điện thoại, trong khi Claude Code vẫn hiện hộp thoại của riêng nó như thường.

Thông báo đi từ máy tính của bạn qua một relay gắn thêm khóa push của Apple cho app; nội dung được mã hóa cho iPhone của bạn, nên cả relay lẫn Apple đều không đọc được, và relay không lưu gì. Xem chính sách quyền riêng tư.