YouTip

Codex provides native support on Windows, running without WSL. This section introduces Windows-specific features and configurations. * * * ## Windows Support Overview Codex supports the following Windows environments: | Environment | Support Status | | --- | --- | | Windows 11 (Native) | Officially Supported | | Windows 10 | Officially Supported | | Windows 11 + WSL2 | Fully Supported | !(#) > Codex can run natively on Windows, maintaining your Windows workflow. * * * ## Installation ### Install with winget ## winget Installation # Install using winget winget install OpenAI.Codex # Or install preview version winget install OpenAI.Codex --source winget --accept-source-agreements--accept-package-agreements ### Using Chocolatey ## Chocolatey Installation # Install using Chocolatey choco install codex -y ### Manual Installation Download the Windows version from GitHub: https://github.com/openai/codex/releases Download the .exe installer and run it. > It is recommended to install using winget or Chocolatey for automatic updates. * * * ## Native Sandbox Codex can run natively in Windows PowerShell: * No WSL or virtual machine required * Maintains Windows workflow * Seamless integration with Windows tools ### Sandbox Mode Configuration ## Configure Sandbox # Windows sandbox configuration # Sandbox mode: unelevated | elevated sandbox = "unelevated" # Run sandbox subprocess in private desktop sandbox_private_desktop = true ### Sandbox Mode Explanation | Mode | Description | | --- | --- | | `unelevated` | Run with standard user privileges (recommended) | | `elevated` | Run with administrator privileges | > It is recommended to use unelevated mode for security. * * * ### PowerShell Integration Codex can be used directly in PowerShell: ## Using in PowerShell # Start Codex codex # Non-interactive mode codex exec"review code" # Using PowerShell commands codex ! Get-Process ### CMD Support Codex also supports the traditional CMD environment: ## Using in CMD # Run in CMD codex exec"list files" > Codex automatically detects the terminal type and optimizes output. * * * ## Windows-Specific Configuration ### Path Handling Windows paths differ from Unix, and Codex handles them automatically: * Backslashes converted to forward slashes * Drive letter handling * UNC path support ### Environment Variables ## Windows Environment Variables # Set Codex-specific environment variables set CODEX_HOME=C:UsersYourName.codex set CODEX_SQLITE_HOME=C:UsersYourName.codex ### Proxy Configuration ## Proxy Settings # Set proxy set HTTP_PROXY=http://proxy.example.com:8080 set HTTPS_PROXY=http://proxy.example.com:8080 # Then run Codex codex > If your network requires a proxy, configure the environment variables accordingly. * * * ## Troubleshooting ### Common Issues #### Cannot start? * Check if the necessary Visual C++ Redistributable is installed * Try running with administrator privileges * Check if antivirus software is blocking #### PowerShell commands not executing? Ensure the PowerShell executable is in your PATH. #### Chinese path issues? Codex supports Unicode, but some older terminals may have issues. > Most issues can be resolved by reinstalling or updating. ### Log Location Windows log location: %USERPROFILE%.codexlogcodex-tui.log > Check the logs for detailed error information. * * * ## Comparison with WSL2 | Feature | Native Windows | WSL2 | | --- | --- | --- | | Performance | Faster | Slightly slower | | Setup | Simple | Requires WSL installation | | Compatibility | Windows tools | Linux tools | | Maintenance | Automatic updates | Independent updates | > For most Windows users, the native version is recommended. * * * ## Best Practices * Install using winget or Chocolatey * Keep your system and Codex updated * Use unelevated sandbox mode * Configure appropriate proxy if needed > Native Windows support allows Codex to seamlessly integrate into your Windows workflow. * * * ## FAQ ### Q: Which is better, the native Windows version or the WSL version? For most users, the native version is better - faster and simpler. ### Q: Can it coexist with WSL? Yes, both can be installed and used simultaneously. ### Q: Does it require administrator privileges? No, unelevated mode does not require administrator privileges. ### Q: Is PowerShell ISE supported? Windows Terminal or the new PowerShell is recommended.