Skip to main content

Windows

Codex App สำหรับ Windows มอบ interface เดียวสำหรับทำงานข้ามโปรเจกต์, รัน parallel agent threads และรีวิวผลลัพธ์

Windows App รองรับ workflows หลัก เช่น worktrees, automations, Git, in-app browser, artifact previews, plugins และ skills รันแบบเนทีฟบน Windows โดยใช้ PowerShell และ Windows sandbox หรือกำหนดค่าให้รันใน Windows Subsystem for Linux 2 (WSL2)

ดาวน์โหลด Codex App​

ดาวน์โหลด Codex App สำหรับ Windows แล้วทำตาม quickstart เพื่อเริ่มต้น

สำหรับ enterprises ผู้ดูแลระบบสามารถ deploy แอปด้วย Microsoft Store app distribution ผ่าน enterprise management tools

หากต้องการ command-line install path ให้รัน:

winget install Codex -s msstore

Native sandbox​

Codex App บน Windows รองรับ native Windows sandbox เมื่อ agent รันใน PowerShell และใช้ Linux sandboxing เมื่อรันใน WSL2

เพื่อใช้ sandbox protections ให้ตั้งค่า sandbox permissions เป็น Default permissions ใน Composer ก่อนส่งข้อความ

การรัน Codex ใน full access mode หมายความว่า Codex ไม่ถูกจำกัดในโฟลเดอร์โปรเจกต์และอาจทำการกระทำที่ทำลายข้อมูลโดยไม่ตั้งใจ รักษา sandbox boundaries ไว้และใช้ rules สำหรับข้อยกเว้นเฉพาะ

กำหนดค่าสำหรับ dev setup​

Editor ที่ต้องการ​

เลือก default app สำหรับ Open เช่น Visual Studio, VS Code หรือ editor อื่น คุณสามารถ override ต่อโปรเจกต์ได้

Integrated terminal​

เลือก default integrated terminal ตัวเลือกที่มีขึ้นอยู่กับสิ่งที่ติดตั้ง:

  • PowerShell
  • Command Prompt
  • Git Bash

การเปลี่ยนนี้ใช้เฉพาะกับ terminal sessions ใหม่เท่านั้น

Windows Subsystem for Linux (WSL)​

โดยค่าเริ่มต้น Codex App ใช้ Windows-native agent ซึ่งหมายความว่า agent รันคำสั่งใน PowerShell

หากต้องการเพิ่มโปรเจกต์จาก WSL filesystem ให้คลิก Add new project หรือกด Ctrl+O แล้วพิมพ์ \\wsl$\ ใน File Explorer window จากนั้นเลือก Linux distribution และโฟลเดอร์

หากวางแผนใช้ Windows-native agent ต่อไป ควรเก็บโปรเจกต์บน Windows filesystem และ access จาก WSL ผ่าน /mnt/<drive>/...

หากต้องการให้ agent รันใน WSL2 เปิด Settings สลับ agent จาก Windows native เป็น WSL แล้ว restart แอป

WSL1 รองรับถึง Codex 0.114 ตั้งแต่ Codex 0.115 เป็นต้นไป Linux sandbox ย้ายไปใช้ bubblewrap ทำให้ WSL1 ไม่รองรับอีกต่อไป

Developer tools ที่มีประโยชน์​

Codex ทำงานได้ดีที่สุดเมื่อมี developer tools ทั่วไปติดตั้งไว้:

  • Git: ขับเคลื่อน review panel และให้ inspect หรือ revert changes ได้
  • Node.js: tool ทั่วไปที่ agent ใช้ทำงานได้มีประสิทธิภาพขึ้น
  • Python: tool ทั่วไปที่ agent ใช้ทำงานได้มีประสิทธิภาพขึ้น
  • .NET SDK: มีประโยชน์เมื่อสร้าง native Windows apps
  • GitHub CLI: ขับเคลื่อนฟังก์ชัน GitHub เฉพาะใน Codex App

ติดตั้งด้วย winget:

winget install --id Git.Git
winget install --id OpenJS.NodeJS.LTS
winget install --id Python.Python.3.14
winget install --id Microsoft.DotNet.SDK.10
winget install --id GitHub.cli

หลังจากติดตั้ง GitHub CLI ให้รัน gh auth login เพื่อเปิดใช้ GitHub features

Troubleshooting และ FAQ​

รันคำสั่งด้วย elevated permissions​

หากต้องการให้ Codex รันคำสั่งด้วย elevated permissions ให้เริ่ม Codex App เองในฐานะ administrator: เปิด Start menu, ค้นหา Codex แล้วเลือก Run as administrator

PowerShell execution policy บล็อกคำสั่ง​

หากยังไม่เคยใช้ tools เช่น Node.js หรือ npm ใน PowerShell มาก่อน agent หรือ integrated terminal อาจพบ execution policy errors

Error อาจมีลักษณะ:

npm.ps1 cannot be loaded because running scripts is disabled on this system.

วิธีแก้ทั่วไปคือตั้งค่า execution policy เป็น RemoteSigned:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

Local environment scripts บน Windows​

หาก local environment ใช้ cross-platform commands เช่น npm scripts คุณสามารถมี shared setup script หรือ actions สำหรับทุกแพลตฟอร์มได้

หากต้องการ Windows-specific behavior ให้สร้าง Windows-specific setup scripts หรือ Windows-specific actions

Local setup scripts รันใน agent environment: WSL หาก agent ใช้ WSL และ PowerShell อื่นๆ

แชร์ config, auth และ sessions กับ WSL​

Windows App ใช้ Codex home directory เดียวกับ native Codex บน Windows: %USERPROFILE%\.codex

หากรัน Codex CLI ภายใน WSL ด้วย CLI จะใช้ Linux home directory โดยค่าเริ่มต้น ทำให้ไม่แชร์ configuration, cached auth หรือ session history กับ Windows App โดยอัตโนมัติ

เพื่อแชร์ ให้ใช้วิธีใดวิธีหนึ่ง:

  • Sync WSL ~/.codex กับ %USERPROFILE%\.codex
  • ชี้ WSL ไปที่ Windows Codex home directory โดยตั้ง CODEX_HOME:
export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

เพิ่มใน ~/.bashrc หรือ ~/.zshrc หากต้องการให้ใช้ทุก shell

Git features ไม่พร้อมใช้งาน​

หากไม่มี Git ติดตั้งแบบเนทีฟบน Windows แอปไม่สามารถใช้ฟีเจอร์บางอย่าง ติดตั้งด้วย:

winget install Git.Git

Cmder ไม่ปรากฏใน open dialog​

หาก Cmder ติดตั้งแล้วแต่ไม่แสดงใน dialog ของ Codex ให้เพิ่มไปยัง Windows Start Menu: คลิกขวา Cmder แล้วเลือก Add to Start จากนั้น restart Codex หรือ reboot