kosa8

ปลั๊กอิน kosa8 สำหรับ Claude Code

kosa8: โครงสร้างพื้นฐานที่ปลอดภัยสำหรับเอเจนต์ AI

มอบเครื่องที่ปิดผนึกให้ Claude ใช้งาน ปลั๊กอินนี้เชื่อมต่อ Claude Code กับ kosa8 ซึ่งเป็นโครงสร้างพื้นฐานที่ปลอดภัยสำหรับเอเจนต์ AI: เอเจนต์แต่ละตัว จะได้เครื่องที่ปิดผนึกเป็นของตัวเอง ซึ่งเป็น microVM จริงที่มีเคอร์เนลของตัวเอง ไม่ใช่ คอนเทนเนอร์ที่ใช้เคอร์เนลร่วมกับโฮสต์

เมื่อเปิดใช้ปลั๊กอิน Claude จะสามารถ:

• เรียกใช้โค้ดที่ไม่น่าเชื่อถือหรือเขียนโดยเอเจนต์ใน microVM ที่ปิดผนึก ซึ่งมองเห็นเพียงโฟลเดอร์เดียว (workspace) และไม่เห็นสิ่งอื่นใดบนโฮสต์
• ทำงานผ่านเครือข่ายปิด ซึ่งเข้าถึงได้เฉพาะโฮสต์ที่อยู่ในรายการอนุญาตที่คุณกำหนด ส่วนการเชื่อมต่ออื่นจะถูกปฏิเสธ
• ใช้คีย์ API โดยไม่ต้องถือคีย์ไว้เอง: egress broker บนโฮสต์จะใส่คีย์ให้ระหว่างส่งออก และ sandbox จะเก็บไว้เพียง placeholder
• สร้าง checkpoint ของเครื่องที่กำลังทำงานทั้งเครื่อง รวมถึงหน่วยความจำและโปรเซส ในเวลาประมาณ 0.7 วินาทีก่อนขั้นตอนที่มีความเสี่ยง และย้อนกลับไปยัง checkpoint โดยที่เครื่องยังทำงานอยู่ได้ในเวลาประมาณหนึ่งวินาที เมื่อเกิดปัญหา
• fork เครื่องที่กำลังทำงานเป็นสำเนาที่ทำงานอยู่ เพื่อทดลองแนวทางต่าง ๆ พร้อมกัน แล้ว เก็บแนวทางที่ใช้ได้ผล
• รอผู้อนุมัติที่ระบุชื่อหนึ่งหรือสองคนสำหรับการดำเนินการที่มีความเสี่ยง (กฎสองคน) โดยทุกการดำเนินการจะถูกบันทึกลงใน audit log ที่เชื่อมโยงด้วยแฮชและตรวจพบการแก้ไขได้

ปลั๊กอินมีสี่ส่วน:

• เซิร์ฟเวอร์ MCP (.mcp.json) ที่เริ่ม kosa8 mcp serve ผ่าน scripts/kosa8-mcp เป็นโปรเซส stdio ในเครื่อง
• สกิล (skills/kosa8-sandbox) ที่บอก Claude ว่าควรใช้ sandbox เมื่อใด และใช้งาน checkpoint, rewind, fork, egress allow-list และ การอนุมัติอย่างปลอดภัยได้อย่างไร
• คำสั่ง: /kosa8:status, /kosa8:sandbox <task>, /kosa8:checkpoint, /kosa8:rewind (ถามก่อนย้อนกลับ) และ /kosa8:explore (ลองใช้คำสั่งหลายรายการใน fork แบบขนาน)
• เอเจนต์: sandbox-runner เรียกใช้โค้ดที่ไม่น่าเชื่อถือหรือโค้ดที่สร้างขึ้นใน microVM ที่ปิดผนึกและรายงานสิ่งที่ทำ; fork-explorer เปรียบเทียบแนวทางต่าง ๆ ใน fork แบบขนานของ sandbox ที่กำลังทำงานอยู่เครื่องเดียวกัน

ข้อกำหนดเบื้องต้น

• Claude Code
• ติดตั้ง kosa8 ไว้บนเครื่องเดียวกัน โดยมี kosa8 บน PATH ของคุณ kosa8 ทำงาน บน Mac ที่ใช้ชิป Apple และ Linux x86-64 รวมถึง Windows ผ่าน WSL2 (รุ่นพรีวิว) ติดตั้งจาก kosa8.com/download รุ่นที่เผยแพร่มีการลงนามและรับรองการตรวจสอบแล้ว ตรวจสอบการติดตั้งด้วย kosa8 version
• daemon ของ kosa8 กำลังทำงาน ปลั๊กอินนี้เป็นเพียงตัวเรียกใช้งานขนาดเล็ก: sandbox คือ microVM ที่ kosa8d เรียกใช้บนเครื่องของคุณ ดังนั้นจะไม่มีอะไรทำงานได้จนกว่า daemon จะเริ่มทำงาน

ก่อนเริ่มต้น: ติดตั้ง kosa8 และเริ่ม daemon

ปลั๊กอินไม่ได้ติดตั้ง kosa8 และไม่สามารถทำงานได้หากไม่มี kosa8 บนเครื่องใหม่:

# 1. Install kosa8 (macOS on Apple silicon, x86-64 Linux, or WSL2)
#    from https://kosa8.com/download/, then check it:
kosa8 version

# 2. Start the daemon that runs the microVMs:
kosa8 daemon start

# 3. Confirm both halves are up:
kosa8 version          # prints "kosa8 daemon <version> (up Ns)"
kosa8 mcp tools        # lists the tools this plugin exposes

หาก kosa8 version รายงานว่า kosa8 daemon: not running ให้เรียกใช้ kosa8 daemon start อีกครั้ง เซิร์ฟเวอร์ MCP จะเริ่มทำงานได้แม้ไม่มี daemon แต่ เครื่องมือ sandbox ทุกตัวจะตอบกลับด้วย cannot reach kosa8d

เอเจนต์ที่ติดตั้งเซิร์ฟเวอร์นี้ให้ผู้ใช้สามารถทำตาม llms-install.md

ติดตั้ง

ใน Claude Code ให้เพิ่ม repository นี้เป็น marketplace แล้วติดตั้งปลั๊กอิน:

/plugin marketplace add kosa8ai/kosa8-claude-plugin
/plugin install kosa8@kosa8

หรือใช้ shell:

claude plugin marketplace add kosa8ai/kosa8-claude-plugin
claude plugin install kosa8@kosa8

เริ่ม Claude Code ใหม่ (หรือเรียกใช้ /reload-plugins) เรียกใช้ /mcp เพื่อยืนยันว่าเซิร์ฟเวอร์ kosa8 เชื่อมต่อแล้ว จากนั้นขอให้ Claude “ตรวจสอบสถานะ kosa8”

การแชร์โฟลเดอร์บนโฮสต์

โดยค่าเริ่มต้น เอเจนต์จะไม่สามารถแชร์ไดเรกทอรีใด ๆ บนโฮสต์เข้าไปใน sandbox ได้ หากต้องการให้แชร์โฟลเดอร์โปรเจกต์ได้ ให้เริ่มเซิร์ฟเวอร์ด้วย --allow-mount DIR (อ่านอย่างเดียว) หรือ --allow-mount DIR:rw คุณทำได้โดยเพิ่มรายการเซิร์ฟเวอร์ MCP ของคุณเอง ตัวอย่างเช่น ในไฟล์ .mcp.json ของโปรเจกต์:

{
  "mcpServers": {
    "kosa8-workspace": {
      "command": "kosa8",
      "args": ["mcp", "serve", "--allow-mount", "/Users/you/code/api:rw"]
    }
  }
}

เครือข่ายและคีย์

กำหนดสิทธิ์เข้าถึงเครือข่ายของ sandbox ตอนสร้าง หากต้องการให้ sandbox เข้าถึง API เพียงรายการเดียวและไม่เข้าถึงสิ่งอื่น ให้สร้างจากเทอร์มินัลของคุณ:

kosa8 sandbox create sealed --egress-allow api.anthropic.com

เครื่องมือ

kosa8 mcp serve เปิดให้ใช้เครื่องมือเหล่านี้ (ตามที่ kosa8 mcp tools รายงานใน kosa8 0.5.0):

เครื่องมือ	ทำอะไร
kosa8_status	ตรวจสอบว่า daemon ของ kosa8 กำลังทำงานหรือไม่ และรายงานเวอร์ชัน
sandbox_create	บูต sandbox microVM แบบแยกส่วนที่มีเคอร์เนลและ container engine ของตัวเอง
sandbox_list	แสดงรายการ sandbox รวมถึงระบุว่าแต่ละ fork มาจาก parent ใด
sandbox_run	เรียกใช้คอนเทนเนอร์ภายใน engine ส่วนตัวของ sandbox โดยแยกจากโฮสต์
sandbox_pull	ดึงอิมเมจเข้า engine ส่วนตัวของ sandbox
sandbox_checkpoint	บันทึกจุดคืนค่า รวมถึงหน่วยความจำและโปรเซสที่กำลังทำงาน
sandbox_checkpoint_list	แสดงรายการจุดคืนค่าของ sandbox
sandbox_rewind	ย้อน sandbox กลับไปยัง checkpoint โดยให้โปรเซสทำงานต่อ
sandbox_fork	fork sandbox ที่กำลังทำงานเป็นสำเนาอิสระ N ชุด
sandbox_explore	Best-of-N: fork หนึ่งครั้งต่อคำสั่งที่เป็นตัวเลือก เรียกใช้พร้อมกัน แล้วเก็บตัวเลือกที่ดีที่สุด
sandbox_snapshot	บันทึกสถานะทั้งหมดของ sandbox เป็น snapshot
sandbox_stop	หยุด sandbox โดยไม่ลบออก
sandbox_start	เริ่ม sandbox ที่หยุดอยู่จากดิสก์ของตัวเอง
sandbox_delete	หยุดและลบ sandbox กับ VM ของ sandbox
snapshot_list	แสดงรายการ snapshot ของ sandbox ที่บันทึกไว้
snapshot_restore	บูต sandbox จาก snapshot โดยให้โปรเซสทำงานต่อ
snapshot_rm	ลบ snapshot
container_run	เรียกใช้คอนเทนเนอร์จนเสร็จและส่งคืนผลลัพธ์
container_exec	เรียกใช้คำสั่งภายในคอนเทนเนอร์ที่กำลังทำงาน
container_list	แสดงรายการคอนเทนเนอร์
container_logs	ดึงผลลัพธ์ของคอนเทนเนอร์
container_stats	รายงานการใช้งาน CPU หน่วยความจำ และ pid ของคอนเทนเนอร์
container_stop	หยุดคอนเทนเนอร์ที่กำลังทำงาน
image_build	สร้างอิมเมจจาก Dockerfile ในไดเรกทอรีบนโฮสต์
image_list	แสดงรายการอิมเมจ
image_pull	ดึงอิมเมจจาก registry
network_create	สร้างเครือข่าย bridge แบบแยกส่วน
network_list	แสดงรายการเครือข่ายของคอนเทนเนอร์
volume_create	สร้าง volume ที่ตั้งชื่อ
volume_list	แสดงรายการ volume ที่ตั้งชื่อ

เรียกใช้ kosa8 mcp tools เพื่อดูรายการเครื่องมือสำหรับเวอร์ชันที่ติดตั้งไว้

ปลั๊กอินนี้เรียกใช้อะไร

ไฟล์ปฏิบัติการเพียงไฟล์เดียวของปลั๊กอินคือ scripts/kosa8-mcp ซึ่งเป็น shell script สั้น ๆ ที่ ค้นหา kosa8 ที่ติดตั้งไว้แล้วบนเครื่องของคุณและเรียกใช้ kosa8 mcp serve โดยไม่มีการดาวน์โหลดหรือติดตั้งสิ่งใด ปลั๊กอินเองไม่ส่งข้อมูลไปที่ใด ไม่ติดต่อเซิร์ฟเวอร์ และไม่อ่านข้อมูลรับรองใด ๆ

ไคลเอนต์ MCP อื่น ๆ

เซิร์ฟเวอร์เดียวกันนี้เผยแพร่ใน Official MCP Registry ในชื่อ io.github.kosa8ai/kosa8 (ดู server.json) โดยแจกจ่ายเป็น MCP bundle ชื่อ kosa8-mcp.mcpb ซึ่งแนบมากับแต่ละ GitHub release: ประกอบด้วย manifest และ launcher สั้น ๆ ตัวเดียวกับ scripts/kosa8-mcp โดยไม่มีการดาวน์โหลด หรือติดตั้งสิ่งใด ดังนั้นให้ติดตั้ง kosa8 ก่อน

ไคลเอนต์ MCP ใด ๆ ที่เริ่มเซิร์ฟเวอร์ stdio ได้ ก็สามารถเรียกใช้ kosa8 mcp serve ได้โดยตรงเช่นกัน

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

เซิร์ฟเวอร์ MCP ของ kosa8 ทำงานในเครื่องและสื่อสารกับ daemon ของ kosa8 บน เครื่องเดียวกัน ภายใต้ นโยบายความเป็นส่วนตัวของ kosa8 การเรียกใช้เครื่องมือ ที่เอเจนต์ของคุณทำ อาร์กิวเมนต์ และผลลัพธ์จะอยู่บนเครื่องของคุณและไม่ส่งไปถึง kosa8 นโยบายระบุทุกสิ่งที่ซอฟต์แวร์ kosa8 ส่งออกและเวลาที่ส่ง รวมถึงการตรวจสอบใบอนุญาตสำหรับใบอนุญาตแบบชำระเงิน และวิธีปิดการเรียกออกทั้งหมดด้วย KOSA8_OFFLINE=1

นโยบายฉบับเต็ม: https://kosa8.com/privacy/

ราคา

kosa8 เป็นซอฟต์แวร์เชิงพาณิชย์ ไฟล์ปลั๊กอินใน repository นี้ใช้งานได้ฟรีและอยู่ภายใต้ สัญญาอนุญาต MIT แต่ตัว kosa8 เองต้องมีใบอนุญาต: มาพร้อมช่วงทดลองใช้ 14 วัน ที่ใช้ได้ทุกฟีเจอร์ โดยไม่ต้องมีบัญชีหรือบัตร Plans เริ่มต้นที่ $29 ต่อเดือน ดู https://kosa8.com/pricing/.

การสนับสนุนและติดต่อ

• อีเมล: contact@kosa8.com
• ปัญหา: https://github.com/kosa8ai/kosa8-claude-plugin/issues
• เว็บไซต์: https://kosa8.com

ใบอนุญาต

ไฟล์ใน repository นี้เผยแพร่ภายใต้ MIT License ใบอนุญาตนี้ครอบคลุมเฉพาะไฟล์ใน repository นี้เท่านั้น (ปลั๊กอิน Claude Code: manifest, ไฟล์ marketplace, การกำหนดค่า MCP, skill, commands, agents, launcher, README และโลโก้) ไม่ครอบคลุมซอฟต์แวร์ kosa8 ซึ่งเป็นซอฟต์แวร์เชิงพาณิชย์ ที่แจกจ่ายแยกต่างหากภายใต้ข้อกำหนดของตนเอง