Workspace ของ Cloud และเอเจนต์

Workspace ของ Cloud ทำงานเหมือน workspace ของ cmux ในเครื่อง แต่เทอร์มินัลรันบนเครื่องคลาวด์ หน้านี้ครอบคลุมเทอร์มินัลแบบถาวร การรันเอเจนต์ การแจ้งเตือน และเครื่องมือที่ติดตั้งไว้ในทุกเครื่อง

เทอร์มินัลแบบถาวร

เทอร์มินัลอยู่ใน daemon ของเครื่อง ไม่ได้อยู่บน Mac ของคุณ เทอร์มินัลยังทำงานต่อเมื่อคุณปิดพาเนล ปิด cmux Wi-Fi หลุด หรือปิดแล็ปท็อป เปิดเครื่องอีกครั้งจาก Mac ที่ลงชื่อเข้าใช้แล้วเครื่องใดก็ได้ แล้วเทอร์มินัลจะยังมีเอาต์พุตและโปรเซสที่กำลังทำงานอยู่

หากการเชื่อมต่อหลุด พาเนลจะแสดง Cloud session disconnected พร้อมปุ่ม Reconnect และ cmux จะลองเชื่อมต่อใหม่เอง

หาก daemon ของเครื่องรีสตาร์ต cmux จะกู้คืนเลย์เอาต์ของ workspace แต่โปรเซสที่กำลังทำงานอยู่จะไม่รอดจากการรีสตาร์ต

การปิด workspace จะทำให้เทอร์มินัลทำงานต่อแบบ detached ส่วนการลบ workspace จะหยุดเทอร์มินัล

รันเอเจนต์เขียนโค้ด

Claude Code, Codex, OpenCode และ Pi ติดตั้งไว้ในทุกเครื่อง เปิด workspace ของ Cloud แล้วเริ่มเอเจนต์เหมือนที่ทำในเครื่อง hook ของเอเจนต์ตั้งค่าไว้แล้ว สถานะและการแจ้งเตือนของเอเจนต์จึงส่งมาถึง Mac ของคุณ

cmux vm agent เริ่มเอเจนต์บนเครื่องจาก Mac ของคุณ เมื่อระบุพรอมต์ จะใช้โหมดรันครั้งเดียวของเอเจนต์ เพิ่ม --sync เพื่ออัปโหลดไดเรกทอรีปัจจุบันก่อน และ --wait เพื่อรอผลลัพธ์

cmux vm agent --agent claude --machine brave-otter -- "add tests for the parser"
cmux vm agent --agent codex --machine brave-otter --sync --wait -- "fix the build"
cmux vm agent --agent opencode --new --size 16g -- "profile the importer"

cmux vm prompt ติดตั้งทักษะ cmux Cloud ให้เอเจนต์ในเครื่องของคุณ และพิมพ์พรอมต์ที่สอนให้เอเจนต์ใช้เครื่อง Cloud

cmux vm prompt --open claude

รันคำสั่ง

cmux vm run รันคำสั่งบนเครื่องและส่งคืนรหัสออก การรันครั้งแรกจากไดเรกทอรีหนึ่งจะเลือกเครื่องและจำไว้สำหรับไดเรกทอรีนั้นเป็นเวลา 14 วัน เพิ่ม --sync เพื่ออัปโหลดไดเรกทอรีก่อน และ --pull เพื่อดาวน์โหลดผลลัพธ์

cmux vm run -- npm test
cmux vm run --sync --pull dist -- npm run build
cmux vm route --json

cmux vm exec รันคำสั่งสั้นๆ โดยไม่มีเทอร์มินัล ใช้สำหรับตรวจสอบอย่างรวดเร็ว หมดเวลาที่ 30 วินาทีโดยค่าเริ่มต้นและสูงสุด 5 นาที สำหรับงานที่ใช้เวลานาน ให้ใช้ cmux vm run, cmux vm agent หรือเทอร์มินัลใน workspace

cmux vm exec brave-otter -- uname -a
cmux vm exec --timeout 120 brave-otter -- docker ps

เริ่ม dev server

cmux vm dev อัปโหลดโปรเจกต์ หาวิธีเริ่มโปรเจกต์ แล้วเปิดใน workspace พร้อมเซิร์ฟเวอร์และเบราว์เซอร์ รองรับโปรเจกต์ package.json, Cargo, Go, target dev ใน Makefile, Django, uv, pyproject, requirements.txt และเว็บไซต์ index.html แบบสแตติก ใช้ --dry-run เพื่อดูแผนก่อน

cmux vm dev brave-otter --dry-run
cmux vm dev brave-otter . --port 3000

การแจ้งเตือน

cmux notify ภายในเครื่องจะแสดงการแจ้งเตือนบน Mac ของคุณสำหรับเทอร์มินัลนั้น hook ของเอเจนต์ส่งการแจ้งเตือนเมื่อเอเจนต์ทำงานเสร็จ ต้องการการอนุมัติ ถามคำถาม หรือล้มเหลว หัวข้อจำกัดที่ 128 ไบต์ เนื้อหาจำกัดที่ 1 KB และมีการจำกัดอัตราเมื่อส่งถี่เกินไป

# Inside a Cloud machine
cmux notify --title "Build" --body "Tests passed"

วางรูปภาพ

กด ⌘V ขณะมีรูปภาพในคลิปบอร์ดในเทอร์มินัล Cloud cmux จะอัปโหลดรูปภาพไปยังเครื่องและวางพาธบนเครื่องนั้น Claude Code และ Codex จึงอ่านรูปได้ รองรับ PNG, JPEG, GIF และ WebP ขนาดสูงสุด 20 MB ต่อรูป และครั้งละ 8 รูป

เลย์เอาต์และเทอร์มินัลจาก CLI

cmux vm workspace สร้าง เปิด เปลี่ยนชื่อ ปิด และลบ workspace บนเครื่อง cmux vm terminal ส่งข้อความ อ่านเอาต์พุต และรอข้อความหรือการออก cmux vm tree แสดง workspace และเทอร์มินัลของเครื่อง cmux vm layout export และ apply ใช้ JSON รูปแบบเดียวกับ cmux new-workspace --layout

cmux vm tree brave-otter
cmux vm workspace new brave-otter --name review
cmux vm terminal send brave-otter term_2f9c "npm run dev" --keys enter
cmux vm terminal wait brave-otter term_2f9c --pattern "ready" --timeout 60
cmux vm terminal read brave-otter term_2f9c
cmux vm layout export brave-otter review > layout.json
cmux vm layout apply brave-otter layout.json --open

สิ่งที่ติดตั้งไว้

เครื่องรัน Ubuntu 24.04 คุณทำงานในฐานะผู้ใช้ cmux ที่ใช้ sudo ได้โดยไม่ต้องใส่รหัสผ่าน ไม่ใช่ root และ Docker จะเริ่มทำงานตอนบูต

• ภาษาและเครื่องมือ: Node.js LTS, Bun, Python 3.12, uv, Docker, git, GitHub CLI, ripgrep, fd, fzf, jq, tmux, sqlite3, build tools, vim, nano และ rsync
• เบราว์เซอร์และเดสก์ท็อป: Chrome, agent-browser, เดสก์ท็อป VNC และ Ghostty
• เอเจนต์: Claude Code, Codex, OpenCode และ Pi ตรึงไว้ที่เวอร์ชันที่ทดสอบแล้ว และอัปเดตเมื่ออิมเมจของเครื่องอัปเดต

หากไม่พบคำสั่งของเอเจนต์ทันทีหลังสร้างเครื่อง แสดงว่าการตั้งค่ายังทำงานอยู่ ล็อกการตั้งค่าอยู่ที่ /tmp/cmux/provision.log

การเข้าถึงโมเดล

เอเจนต์บนเครื่องใช้การกำหนดเส้นทางโมเดลของ cmux ได้โดยไม่ต้องมีคีย์บนเครื่อง ข้อมูลรับรองจริงถูกเพิ่มจากภายนอกเครื่อง จึงไม่มีโทเค็นบัญชีเก็บไว้ใน VM คุณยังลงชื่อเข้าใช้เอเจนต์ภายในเครื่อง หรืออัปโหลดบัญชีให้ทีมด้วย cmux ai-accounts upload ได้

cmux ai-accounts list
cmux ai-accounts upload claude
cmux coderouter status

เอกสาร CodeRouter: บัญชีที่รองรับ การแชร์ และการใช้งาน

cmux CLI ภายในเครื่อง

ภายในเครื่อง คำสั่ง cmux ควบคุมเซสชันของเครื่องนั้น รองรับ tree, new-workspace, new-split, send, send-key, read-screen, terminal, layout, env, notify, open-url และ self คำสั่ง cmux self แสดงเจ้าของ เครื่องนี้ และเครื่องอื่นๆ ของคุณ cmux vm verb peer ควบคุมเครื่องอื่นๆ ของคุณจากภายในเครื่อง

# Inside a Cloud machine
cmux tree
cmux new-split right
cmux self peers
cmux vm exec calm-heron -- git status

การลงชื่อเข้าใช้ การอัปโหลดบัญชี AI และคำสั่งวงจรชีวิตของเครื่อง เช่น new, delete, checkpoint, fork, resize, pause, domains, open และ vpn รันได้เฉพาะบน Mac ของคุณเท่านั้น

iPhone

แอป cmux บน iOS ไม่ได้จัดการเครื่อง Cloud เครื่องที่กำลังเริ่มต้นจะแสดงเป็นการ์ดตัวยึดตำแหน่ง