# Windows

> Windows-specific instructions for OpenCode - installation and usage on Windows systems

- Skill: `timsonner/windows` (Agent Skill)
- Install (CLI): `npx skillmds@latest add timsonner/windows`
- Raw SKILL.md: https://api.skillmd.com/api/skills/timsonner/windows/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: timsonner (https://skillmd.com/u/timsonner)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/timsonner/windows

---


# OpenCode on Windows

## Recommended: Use WSL

For the best experience on Windows, we recommend using [Windows Subsystem for Linux (WSL)](/docs/windows-wsl). It provides better performance and full compatibility with OpenCode’s features.

## Installation Methods on Windows

**Recommended:**

```powershell
winget install --id SST.opencode --accept-source-agreements --accept-package-agreements
```

Refresh PATH afterwards (`Machine` + `User`). CLI id: `SST.opencode`. Desktop: `SST.OpenCodeDesktop`.

-   **Using Chocolatey**
    
    Terminal window
    
    ```
    choco install opencode
    ```
    
-   **Using Scoop**
    
    Terminal window
    
    ```
    scoop install opencode
    ```
    
-   **Using NPM**
    
    Terminal window
    
    ```
    npm install -g opencode-ai
    ```
    
-   **Using Mise**
    
    Terminal window
    
    ```
    mise use -g github:anomalyco/opencode
    ```
    
-   **Using Docker**
    
    Terminal window
    
    ```
    docker run -it --rm ghcr.io/anomalyco/opencode
    ```
    
Support for installing OpenCode on Windows using Bun is currently in progress.

You can also grab the binary from the [Releases](https://github.com/anomalyco/opencode/releases).

## Windows-Specific Considerations

While OpenCode can run on Windows, using WSL is recommended for:
- Better performance
- Full compatibility with all features
- Consistent Linux-like environment
- Access to Unix-based tools and utilities

If you choose to run OpenCode natively on Windows, be aware that some features may have limited functionality or require additional configuration.