# เริ่มต้นใช้งาน

cmux เป็นเทอร์มินัล macOS เนทีฟที่เบาสร้างบน Ghostty สำหรับจัดการ AI coding agent หลายตัว มีแท็บแนวตั้ง, แผงแจ้งเตือน และ API ควบคุมผ่าน socket

## ติดตั้ง

### DMG (แนะนำ)

[ดาวน์โหลดสำหรับ Mac](https://cmux.com/th/download/confirmation?dl=1)

เปิด .dmg แล้วลาก cmux ไปที่โฟลเดอร์ Applications cmux อัปเดตอัตโนมัติผ่าน Sparkle คุณจึงต้องดาวน์โหลดแค่ครั้งเดียว

### Homebrew

```
brew tap manaflow-ai/cmux
brew install --cask cmux
```

อัปเดตภายหลัง:

```
brew upgrade --cask cmux
```

เมื่อเปิดครั้งแรก macOS อาจขอให้คุณยืนยันการเปิดแอปจากนักพัฒนาที่ระบุตัวตนแล้ว คลิก **เปิด** เพื่อดำเนินการต่อ

## ยืนยันการติดตั้ง

เปิด cmux แล้วคุณจะเห็น:

-   หน้าต่างเทอร์มินัลที่มีแถบข้างแท็บแนวตั้งทางซ้าย
-   workspace เริ่มต้นหนึ่งอันเปิดอยู่แล้ว
-   เทอร์มินัลที่ขับเคลื่อนด้วย Ghostty พร้อมรับ input

## ตั้งค่า CLI

cmux มีเครื่องมือ command-line สำหรับระบบอัตโนมัติ ภายในเทอร์มินัล cmux มันทำงานอัตโนมัติ หากต้องการใช้จากเทอร์มินัลอื่น ให้เปิดแถบคำสั่ง (⌘⇧P) แล้วเรียก **คำสั่ง Shell: ติดตั้ง 'cmux' ใน PATH** ซึ่งจะลิงก์ CLI ที่มาพร้อมแอปไปยัง /usr/local/bin และจะขอรหัสผ่านผู้ดูแลระบบหากโฟลเดอร์นั้นต้องใช้

หรือสร้าง symlink ด้วยตัวเอง:

```
sudo ln -sf "/Applications/cmux.app/Contents/Resources/bin/cmux" /usr/local/bin/cmux
```

จากนั้นคุณสามารถรันคำสั่งเช่น:

```
cmux list-workspaces
cmux notify --title "Build Complete" --body "Your build finished"
```

## ตั้ง cmux เป็นเทอร์มินัลเริ่มต้น

หากต้องการให้ลิงก์ ssh:// และสคริปต์ shell ที่เปิดจาก Finder เปิดใน cmux แทน Terminal ให้เลือก **cmux > Make cmux the Default Terminal** ในแถบเมนู หรือเรียก **Make cmux the Default Terminal** จากแถบคำสั่ง

## อัปเดตอัตโนมัติ

cmux ตรวจสอบอัปเดตอัตโนมัติผ่าน Sparkle เมื่อมีอัปเดต คุณจะเห็นปุ่มอัปเดตใน titlebar คุณยังตรวจสอบด้วยตัวเองได้ผ่าน cmux > Check for Updates ในแถบเมนู

## การกู้คืนเซสชัน (พฤติกรรมปัจจุบัน)

หลังจากเปิดใหม่ cmux กู้คืน layout และ metadata เท่านั้น:

cmux ยังไม่กู้คืนสถานะโปรเซสที่กำลังทำงาน เซสชันแอปเทอร์มินัลที่ใช้งานอยู่เช่น Claude Code, tmux และ vim จะไม่ถูกกู้คืนหลังรีสตาร์ทแอป

See the [session restore guide](https://cmux.com/th/docs/session-restore) for agent hook setup and the supported resume matrix.

## ความต้องการ

-   macOS 14.0 หรือใหม่กว่า
-   Apple Silicon หรือ Intel Mac

Canonical: https://cmux.com/th/docs/getting-started

Documentation index: https://cmux.com/llms.txt