เอเจนต์ CLI

ถ้าคุณใช้ Claude Code หรือ Codex อยู่แล้ว คุณรันทั้งสองตัวใน Perch ได้ เลือกตัวหนึ่งในตัวเลือกโมเดล กำหนดโฟลเดอร์ให้ แล้วมันจะทำงานในโฟลเดอร์นั้นด้วยเครื่องมือของตัวเอง ภายใต้การลงชื่อเข้าใช้ของคุณเอง แชต Perch และเอเจนต์ของคุณอยู่ในแถบด้านข้างเดียวกัน คุณจึงติดตามทั้งหมดได้จากที่เดียว

เอเจนต์แต่ละตัวทำงานในสำเนารีโพของคุณที่เป็นของตัวเอง บน branch ของตัวเอง หลายตัวจึงทำงานพร้อมกันได้โดยไม่แตะ checkout ของคุณ เมื่อตัวใดทำเสร็จ คุณจะเห็นว่ามันเปลี่ยนอะไรไป แล้ว merge เข้าโฟลเดอร์ของคุณได้ในคลิกเดียว หรือจะเปิด pull request ก็ได้

ก่อนเริ่ม

• Perch Desktop 2.5.4 ขึ้นไป ที่ลงชื่อเข้าใช้บัญชี Pro หรือ Ultra ไว้ เอเจนต์ CLI ไม่มีใน Perch บนเว็บ
• Claude Code หรือ Codex ที่ติดตั้งบนคอมพิวเตอร์เครื่องนี้และลงชื่อเข้าใช้ไว้แล้ว ถ้า claude หรือ codex รันในเทอร์มินัลของคุณได้ Perch ก็เริ่มมันได้ Perch ใช้ตัวที่คุณติดตั้งไว้และการลงชื่อเข้าใช้ของคุณ และไม่ได้รวมตัวใดตัวหนึ่งมาให้
• Git บน Windows ให้ติดตั้ง Git for Windows การ merge ต้องใช้ git 2.40 ขึ้นไป
• โฟลเดอร์ที่คุณเพิ่มไว้ใน Perch ซึ่งอยู่ในรีโพ git ที่มี commit อย่างน้อยหนึ่งรายการ เอเจนต์จึงมีสำเนาของตัวเองได้

เริ่มเอเจนต์

แถบของแชตแสดงว่าเอเจนต์กำลังทำอะไร ชื่อของมัน โฟลเดอร์ และ branch ของมัน เช่น agent/add-a-dark-mode-toggle-t-7q2m

แชตจะใช้เอเจนต์ที่เริ่มไว้ตลอด หากต้องการกลับไปใช้โมเดลของ Perch เอง ให้เริ่มแชตใหม่

ระหว่างที่เอเจนต์ทำงาน

• คำขออนุมัติส่งมาที่คุณ เมื่อเอเจนต์ขอสิทธิ์ทำบางอย่าง จะมีการ์ดที่เขียนว่า Claude asks to go ahead พร้อมตัวเลือกที่เอเจนต์เสนอ
• Mode ใช้ตั้งโหมดของเอเจนต์เอง ซึ่งเป็นโหมดเดียวกับที่มีใน CLI ของมัน เช่น Accept edits สำหรับ Claude
• ส่งข้อความต่อได้ทุกเมื่อ ระหว่างที่เอเจนต์ทำงาน สิ่งที่คุณส่งจะรอและส่งออกไปเมื่อเทิร์นจบ คุณแนบรูปภาพ PNG, JPEG, GIF หรือ WebP ได้ ขนาดไม่เกิน 5 MB ต่อรูป
• Diff เปิดแผง Changes ที่แสดงทุกไฟล์ที่เอเจนต์เปลี่ยนในสำเนาของมัน
• Open terminal เปิดเทอร์มินัลข้างแชต ในสำเนารีโพของเอเจนต์
• รันหลายตัวพร้อมกันได้ เอเจนต์รันพร้อมกันได้สูงสุดสี่ตัว แต่ละตัวอยู่ในสำเนาของตัวเอง แถบด้านข้างแสดงว่าตัวไหนกำลังทำงานอยู่

สำเนารีโพที่เป็นของเอเจนต์เอง

โดยค่าเริ่มต้น เอเจนต์แต่ละตัวจะทำงานใน git worktree ซึ่งเป็น checkout ชุดที่สองของรีโพคุณ อยู่ในโฟลเดอร์ของตัวเองและบน branch ของตัวเอง ระหว่างที่เอเจนต์ทำงาน โฟลเดอร์ของคุณ branch ของโฟลเดอร์นั้น และทุกอย่างที่คุณยังไม่ได้ commit จะยังเหมือนเดิม และเอเจนต์สองตัวจะไม่แก้ไขไฟล์เดียวกันเลย

worktree มีเฉพาะไฟล์ที่ git ติดตามอยู่ Perch ยังนำสิ่งที่โปรเจกต์ส่วนใหญ่ต้องใช้ในการรันมาให้ด้วย:

• ไฟล์ config ในเครื่อง ไฟล์ .env และ .env.* ไม่ว่าจะอยู่ลึกแค่ไหน จะถูกคัดลอกเข้ามาเมื่อ git ignore ไฟล์เหล่านั้น หากต้องการคัดลอกไฟล์อื่นที่ถูก ignore เช่น การตั้งค่าในเครื่องหรือใบรับรอง ให้ระบุไว้ในไฟล์ .worktreeinclude ที่ root ของรีโพ โดยใช้ไวยากรณ์แบบ .gitignore ไฟล์จะถูกคัดลอกก็ต่อเมื่อ git ignore ไฟล์นั้นในสำเนาด้วย ไฟล์จึงไม่มีทางหลุดเข้าไปใน commit สูงสุด 200 ไฟล์ ไฟล์ละ 10 MB และรวมกันไม่เกิน 50 MB symlink จะถูกข้าม
• Copy node_modules ใน Options บน macOS จะ clone node_modules ของคุณเข้าไปในสำเนา เป็นการ clone แบบ copy-on-write: เสร็จแทบจะทันที และไม่ใช้พื้นที่ดิสก์เพิ่ม
• Setup command ใน Options จะรันคำสั่ง เช่น npm install ในสำเนาก่อนที่เอเจนต์จะเริ่ม โดยใช้เชลล์ของคุณ (PowerShell บน Windows) Perch จะจำคำสั่งนี้ไว้สำหรับรีโพนั้น ถ้าคำสั่งล้มเหลวหรือรันนานเกิน 15 นาที เอเจนต์จะเริ่มอยู่ดี และแชตจะแจ้งไว้ Setup log ในแถบของแชตแสดงเอาต์พุตของคำสั่งนี้

Options ยังมี Worktree folder ซึ่งเป็นที่ที่สร้างสำเนา และ Account folder: ถ้าคุณลงชื่อเข้าใช้ Claude Code หรือ Codex ไว้หลายบัญชี ให้เลือกโฟลเดอร์ของบัญชีที่จะใช้ ทั้งสองโฟลเดอร์ต้องอยู่ในโฟลเดอร์โฮมของคุณ

ปิด Worktree หากต้องการให้เอเจนต์ทำงานในโฟลเดอร์ของคุณโดยตรง เมื่อปิดแล้ว การเปลี่ยนแปลงของเอเจนต์จะลงในโฟลเดอร์ของคุณทันทีที่มันแก้ไข และจะไม่มีขั้นตอน diff หรือ merge

นำงานกลับมา

เมื่อเทิร์นใดเปลี่ยนไฟล์ จะมีการ์ดใต้บทสนทนาแจ้งไว้ เช่น "Claude changed 4 files in its own copy of perch-app. They're not in your folder yet." แถบของแชตจะแสดงจำนวนไว้จนกว่าคุณจะนำการเปลี่ยนแปลงกลับมา Review changes จะเปิด diff

Merge เข้า branch ของคุณ

Merge into main ซึ่งตั้งชื่อตาม branch ที่โฟลเดอร์ของคุณใช้อยู่ จะนำการเปลี่ยนแปลงทั้งหมดของเอเจนต์มาไว้บน branch ของคุณเป็น commit เดียว ข้อความ commit ตั้งต้นเป็นชื่อแชต และคุณแก้ไขได้ หลังจากนั้น Remove the copy จะลบ worktree และ branch ของเอเจนต์

Perch จะไม่ stash, reset หรือเขียนทับสิ่งใดในโฟลเดอร์ของคุณเพื่อ merge เลย แต่จะหยุดและแจ้งคุณแทนในกรณีต่อไปนี้:

• โฟลเดอร์ของคุณมีการเปลี่ยนแปลงที่ยังไม่ได้ commit ให้ commit ก่อน แล้วค่อย merge
• ไฟล์เดียวกันเปลี่ยนทั้งบน branch ของคุณและในสำเนาของเอเจนต์ Ask Claude to fix จะส่งข้อความให้เอเจนต์จัดการเรื่องนี้ในสำเนาของมัน เมื่อเสร็จแล้ว ให้ merge อีกครั้ง
• โฟลเดอร์ของคุณไม่ได้อยู่บน branch ใด หรือ git เก่ากว่า 2.40

วิธีอื่นในการจบงาน

เมนูข้างปุ่ม merge มีอีกสองตัวเลือก:

• Commit only จะ commit การเปลี่ยนแปลงบน branch ของเอเจนต์เอง โฟลเดอร์ของคุณไม่เปลี่ยน
• Open pull request จะ push branch ของเอเจนต์ไปที่ origin และเปิด pull request ถ้าติดตั้ง GitHub CLI (gh) ไว้ Perch จะเปิด pull request ให้คุณ ถ้าไม่ได้ติดตั้ง Perch จะเปิดหน้าสร้าง pull request ใหม่ของ GitHub ส่วนโฮสต์ git อื่นๆ Perch จะ push branch ให้ แล้วคุณเปิด pull request ที่นั่นเอง

การปิดแชต

ถ้าคุณปิดแชตที่สำเนายังมีการเปลี่ยนแปลงที่ยังไม่อยู่ในโฟลเดอร์ของคุณ Perch จะถามก่อน: Merge first, Keep the copy (worktree และ branch ของสำเนายังอยู่ที่เดิม) หรือ Discard (ลบสำเนาและ branch ของสำเนา รวมถึงการเปลี่ยนแปลงด้วย)

แพ็กเกจของคุณเอง

เอเจนต์ CLI รันภายใต้การลงชื่อเข้าใช้ Claude Code หรือ Codex ของคุณเอง การใช้งานของเอเจนต์จึงนับรวมในแพ็กเกจนั้น ไม่ได้นับรวมในการใช้งาน Perch ของคุณ ข้อความที่ส่งถึงเอเจนต์ไม่ใช้การใช้งานที่รวมอยู่ในแพ็กเกจ Perch ของคุณ

Perch แสดงขีดจำกัดของเอเจนต์แต่ละตัวตามที่เอเจนต์รายงาน ได้แก่ 5-hour limit และ Weekly limit พร้อมเวลาที่แต่ละขีดจำกัดจะรีเซ็ต คุณดูได้บนการ์ดของเอเจนต์ในตัวเลือกโมเดล และใน Settings › Usage ใต้ On this computer และจะมีหมายเหตุเหนือช่องพิมพ์ข้อความเตือนคุณเมื่อเอเจนต์ใกล้ถึงขีดจำกัด ขีดจำกัดเหล่านี้จะแสดงหลังจากที่เอเจนต์ตอบครั้งแรกบนคอมพิวเตอร์เครื่องนี้

ความเป็นส่วนตัว

• แชตอยู่บนคอมพิวเตอร์เครื่องนี้ แชตของเอเจนต์ CLI ไม่ได้ถูกบันทึกในบัญชี Perch ของคุณ จึงไม่แสดงใน Perch บนเว็บหรือบนโทรศัพท์ของคุณ
• เอเจนต์สื่อสารกับบริการของตัวเอง ข้อความของคุณส่งจาก Claude Code ไปยัง Anthropic หรือจาก Codex ไปยัง OpenAI แบบเดียวกับตอนที่คุณใช้ CLI เอง ข้อความไม่ผ่านเซิร์ฟเวอร์ของ Perch
• เอเจนต์แต่ละตัวได้รับเฉพาะสิ่งที่จำเป็น Perch เริ่มเอเจนต์โดยส่งตัวแปรสภาพแวดล้อมของคุณให้เพียงรายการสั้นๆ: ไม่มีคีย์ของเอเจนต์ตัวอื่น และไม่มีอะไรของ Perch

ใช้กับซับเซสชัน

Perch ส่งงานบางส่วนให้ Claude Code หรือ Codex ได้ แค่ขอ เช่น "ให้ Codex แก้ flaky test ในเซสชันของตัวเอง" แล้ว Perch จะเสนอซับเซสชันที่รันบนเอเจนต์ตัวนั้น ใน worktree ใหม่ของโฟลเดอร์ของแชต เช่นเดียวกับซับเซสชันอื่นๆ ซับเซสชันนี้จะเริ่มเมื่อคุณเลือก Start เท่านั้น และจะรายงานกลับไปที่แชตที่เริ่มมัน คำขออนุมัติของเอเจนต์ยังคงส่งมาที่คุณ

การแก้ปัญหา

ไม่เห็น On this computer ในตัวเลือกโมเดล ตรวจสอบว่าคุณลงชื่อเข้าใช้บัญชี Pro หรือ Ultra ใน Perch Desktop 2.5.4 ขึ้นไป

เอเจนต์แสดงว่า Not installed ติดตั้งให้ claude หรือ codex อยู่ใน PATH ของคุณ แล้วออกจาก Perch และเปิดใหม่

แสดงว่า Needs sign-in เลือก Sign in in a terminal ซึ่งจะรัน claude หรือ codex login ให้คุณ ลงชื่อเข้าใช้ให้เสร็จ แล้วเลือก Try again

แสดงว่า CLI ของเอเจนต์เก่ากว่าที่ Perch ต้องการ อัปเดต CLI นั้น สำหรับ Claude Code ให้รัน claude update ส่วน Codex ให้อัปเดตด้วยวิธีเดียวกับที่คุณติดตั้ง คือผ่าน npm หรือ Homebrew

แสดงว่าต้องใช้ Node 22 ข้อความนี้มาจากบิลด์เดสก์ท็อปก่อนเวอร์ชัน 2.5.4 อัปเดต Perch Desktop ซึ่งรันเอเจนต์ได้โดยไม่ต้องใช้ Node

โฟลเดอร์นั้นมี worktree ไม่ได้ โฟลเดอร์ต้องอยู่ในรีโพ git ที่มี commit อย่างน้อยหนึ่งรายการ หรือคุณจะปิด Worktree ก็ได้

บน Windows ลบสำเนาไม่ได้ มีไฟล์ในสำเนาที่เปิดอยู่ในโปรแกรมอื่น ปิดไฟล์นั้น แล้วลองอีกครั้ง