ข้อมูลอ้างอิงคำสั่ง

ใส่ --dry-run ไว้หน้าคำสั่งเพื่อดูว่าคำสั่งนั้นจะทำอะไรโดยไม่ลงมือทำจริง เช่น ccam --dry-run work ตัวเลือกนี้ใช้ได้เมื่อเริ่ม Claude Code (ccam <name>, ccam run, ccam next) และกับ share, migrate, shortcut, update และ doctor --fix ส่วนคำสั่งอื่นที่เปลี่ยนแปลงบางอย่างจะปฏิเสธตัวเลือกนี้แทนที่จะทำงาน

การเริ่ม Claude Code

ccam <name|number> [arguments] เริ่ม Claude Code ในชื่อบัญชีนั้น ccam ไม่อ่านอาร์กิวเมนต์ที่อยู่หลังชื่อบัญชี แต่ส่งต่อให้ claude ตามลำดับเดิม ส่วนอินพุตมาตรฐาน รหัสออก (exit code) และสัญญาณ (signal) ทำงานเหมือนกับการใช้ claude โดยตรงทุกประการ จะใส่ -- หลังชื่อบัญชีหรือไม่ก็ได้

ccam ที่มีอาร์กิวเมนต์แต่ไม่มีชื่อบัญชี เช่น ccam -p "summarise" จะใช้บัญชีเริ่มต้น ตั้งบัญชีเริ่มต้นได้ด้วย ccam use <name>

คำสั่งลัดอย่าง ccwork เริ่มบัญชีของตัวเองในลักษณะเดียวกัน: ccwork --resume ทำงานเหมือนกับ ccam work --resume ดูที่ คำสั่งลัด

การเพิ่มและลบบัญชี

ccam add                      # wizard
ccam add work --share history=on
ccam add side --shortcut ccside
ccam add ci --no-login        # log in later with: ccam login ci
ccam rename work job
ccam remove side              # folder moves to ~/.local/share/ccam/trash
ccam import ~/.claude-old --name old

ccam import ที่ไม่ระบุโฟลเดอร์จะค้นหา ~/.claude และ ~/.claude-* แล้วถามคุณทีละโฟลเดอร์ โฟลเดอร์ที่นำเข้าจะถูกลงทะเบียนไว้ในตำแหน่งเดิม ccam ไม่ย้ายหรือคัดลอกการเข้าสู่ระบบใด ๆ

ccam rename, ccam remove และ ccam share จะไม่ยอมเปลี่ยนแปลงบัญชีในขณะที่ Claude Code กำลังทำงานด้วยบัญชีนั้น ให้ออกจากเซสชันนั้นก่อน

ccam list --json จะแสดงทุกบัญชีพร้อมสล็อต คำสั่งลัด อีเมล และโฟลเดอร์ ออบเจ็กต์ share ในผลลัพธ์จะจับคู่แต่ละรายการ (mcp, settings, memory, extensions, history) กับชื่อกลุ่มหรือ local

คำสั่งลัด

ccam shortcut work ccwork     # create it, or rename the existing one
ccam shortcut work            # show it
ccam shortcut work --remove

คำสั่งลัดคือคำสั่งที่คุณตั้งชื่อเองเพื่อเริ่ม Claude Code ในชื่อบัญชีหนึ่ง เช่นเดียวกับ ccam work คำสั่งลัดจะส่งทุกอาร์กิวเมนต์ให้ Claude Code โดยไม่เปลี่ยนแปลง ดังนั้น ccwork --resume และ ccwork -p "hi" จึงทำงานตามที่คุณคาดไว้ คำสั่งลัดเป็นลิงก์ไปยัง ccam ใน ~/.local/bin

คำสั่งลัดเป็นตัวเลือกเสริม ตัวช่วยตั้งค่าของ ccam add จะถามว่าจะสร้างหรือไม่ ส่วน ccam add <name> --shortcut <command> จะสร้างให้โดยไม่ถาม และ ccam list จะแสดงคำสั่งลัดของแต่ละบัญชี หรือแสดง - หากไม่มี

ชื่อใช้ได้เฉพาะอักขระ a-z, 0-9, ., - และ _ ชื่อต้องไม่ซ้ำกับคำสั่งของ ccam คำสั่งลัดของบัญชีอื่น หรือชื่อของโปรแกรมอื่นใน PATH ของคุณ

ccam rename จะคงชื่อคำสั่งลัดไว้ และ ccam remove จะลบคำสั่งลัดไปพร้อมกับบัญชี ccam shims install จะสร้างลิงก์ของทุกบัญชีขึ้นใหม่ เช่น หลังจากที่คุณย้าย ccam ไปที่อื่น

การใช้ร่วมกัน

ccam share work                       # show the current state
ccam share work --history on --mcp team
ccam share work --settings off --fresh

แต่ละรายการรับค่า on (กลุ่ม default), off หรือชื่อกลุ่ม ดูที่ การใช้ร่วมกัน

การคัดลอกการตั้งค่าที่มีอยู่

ccam migrate                    # ~/.claude into the default group
ccam --dry-run migrate          # show the plan, copy nothing
ccam migrate ~/.claude-work --group work --settings --mcp
ccam migrate --history --yes    # conversation history only

ccam migrate คัดลอก settings.json, CLAUDE.md ส่วนขยาย และเซิร์ฟเวอร์ MCP ของผู้ใช้จากโฟลเดอร์ Claude Code ไปยังกลุ่ม เพื่อให้ทุกบัญชีที่ใช้รายการเหล่านั้นร่วมกันได้รับด้วย โฟลเดอร์ต้นทางจะถูกอ่านอย่างเดียว ตัวเลือก --settings, --memory, --extensions, --mcp และ --history จะคัดลอกเฉพาะรายการที่คุณระบุ หากไม่ระบุ บนเทอร์มินัลจะมีรายการตรวจสอบ (checklist) ให้คุณเลือก โดยเลือกทุกอย่างไว้ยกเว้นประวัติการสนทนา ส่วนในกรณีอื่นจะคัดลอกทุกอย่างยกเว้นประวัติการสนทนา -g หรือ --group ใช้เลือกกลุ่ม และ -y หรือ --yes จะคัดลอกโดยไม่ถาม และเก็บสำเนาของกลุ่มไว้เมื่อไฟล์ไม่ตรงกัน นอกจากนี้ยังคัดลอกการลงชื่อเข้าใช้ที่บันทึกไว้ของเซิร์ฟเวอร์ไปยังไฟล์เข้าสู่ระบบของแต่ละบัญชีเองด้วย ดูที่ การคัดลอกการตั้งค่าที่มีอยู่

เซิร์ฟเวอร์ MCP

ccam mcp add fs -- npx -y @modelcontextprotocol/server-filesystem ~/code
ccam mcp add docs --url https://mcp.example.com/mcp --header "Authorization: Bearer $TOKEN"
ccam mcp add-json db '{"type":"stdio","command":"db-mcp"}'
ccam mcp list
ccam mcp import work gh
ccam mcp remove fs

ccam mcp import <account> จะย้ายเซิร์ฟเวอร์ที่มีเฉพาะในบัญชีนั้นไปยังกลุ่มของบัญชี เซิร์ฟเวอร์ที่ใช้ชื่อซึ่งกลุ่มใช้อยู่แล้วกับนิยามอื่นจะถูกข้ามไป เพิ่ม --force เพื่อแทนที่สำเนาของกลุ่ม โดย ccam จะสำรองสำเนานั้นไว้ก่อน

การใช้งานและการสลับบัญชี

ccam usage           # also: ccam u
ccam usage --watch   # refresh every 60 seconds
ccam usage --json
ccam next --continue
ccam next --auto

การบำรุงรักษา

ccam doctor          # check
ccam doctor --fix    # repair what is safe to repair, with backups
ccam statusline install
ccam shims install   # recreate the shortcut links
ccam update          # install the latest ccam release
ccam update --check  # only check for a newer release
ccam version         # also: ccam -v, ccam --version

ccam update จะตรวจสอบ checksum แบบ SHA-256 ของรุ่นนั้นก่อนแทนที่ ccam และ --version v0.2.0 จะติดตั้งรุ่นที่ระบุ ส่วน ccam ที่ติดตั้งจากแพ็กเกจ .deb ให้อัปเดตด้วย apt แทน ดูที่ การอัปเดต

ไฟล์

ตัวแปร XDG_CONFIG_HOME, XDG_DATA_HOME และ XDG_STATE_HOME ใช้เปลี่ยนตำแหน่งของโฟลเดอร์เหล่านี้