ข้ามไปยังเนื้อหา
เอกสาร V1
การตั้งค่า

Windows (WSL)

แม้ว่า OpenCode จะรันบน Windows ได้โดยตรง แต่เราแนะนำให้ใช้ Windows Subsystem for Linux (WSL) เพื่อประสบการณ์ที่ดีที่สุด WSL ให้สภาพแวดล้อม Linux ที่ทำงานร่วมกับฟีเจอร์ของ OpenCode ได้อย่างราบรื่น


  1. ติดตั้ง WSL

    ถ้ายังไม่ได้ติดตั้ง ให้ทำตามคู่มือทางการของ Microsoft เพื่อ ติดตั้ง WSL

  2. ติดตั้ง OpenCode ใน WSL

    เมื่อตั้งค่า WSL เสร็จแล้ว ให้เปิด terminal WSL และติดตั้ง OpenCode ด้วย วิธีติดตั้ง แบบใดแบบหนึ่ง

    เทอร์มินัล
    curl -fsSL https://opencode.ai/install | bash
  3. ใช้งาน OpenCode จาก WSL

    ไปที่ไดเรกทอรีโปรเจกต์ของคุณ (เข้าถึงไฟล์ Windows ผ่าน /mnt/c/, /mnt/d/ เป็นต้น) แล้วรัน OpenCode

    เทอร์มินัล
    cd /mnt/c/Users/YourName/project
    opencode

ถ้าคุณต้องการใช้ OpenCode Desktop แต่ให้เซิร์ฟเวอร์ทำงานบน WSL:

  1. เริ่มเซิร์ฟเวอร์ใน WSL โดยใช้ --hostname 0.0.0.0 เพื่อให้เชื่อมต่อจากภายนอกได้:

    เทอร์มินัล
    opencode serve --hostname 0.0.0.0 --port 4096
  2. เชื่อมต่อเดสก์ท็อปแอป ไปที่ http://localhost:4096


เพื่อประสบการณ์เว็บที่ดีที่สุดบน Windows:

  1. รัน opencode web ใน terminal WSL แทน PowerShell:

    เทอร์มินัล
    opencode web --hostname 0.0.0.0
  2. เข้าจากเบราว์เซอร์บน Windows ที่ http://localhost:<port> (OpenCode จะแสดง URL ให้)

การรัน opencode web จาก WSL ช่วยให้เข้าถึงระบบไฟล์และใช้งาน terminal ได้ถูกต้อง พร้อมเปิดใช้งานผ่านเบราว์เซอร์ Windows ได้เหมือนเดิม


WSL สามารถเข้าถึงไฟล์ Windows ทั้งหมดของคุณได้ผ่านไดเรกทอรี /mnt/:

  • C: drive → /mnt/c/
  • D: drive → /mnt/d/
  • ไดรฟ์อื่นก็ใช้รูปแบบเดียวกัน

ตัวอย่าง:

เทอร์มินัล
cd /mnt/c/Users/YourName/Documents/project
opencode

  • แม้โปรเจกต์จะอยู่บนไดรฟ์ Windows ก็ควรรัน OpenCode ใน WSL เพื่อการเข้าถึงไฟล์ที่ลื่นกว่า
  • ใช้ OpenCode ควบคู่กับ WSL extension ของ VS Code เพื่อเวิร์กโฟลว์ที่ต่อเนื่อง
  • การตั้งค่าและเซสชันของ OpenCode จะถูกเก็บในสภาพแวดล้อม WSL ที่ ~/.local/share/opencode/