Guide · Windows

AI coding agents on Windows: the complete setup guide

TL;DR

To run AI coding agents on Windows you need git (and Node.js or Python for some agents), then the agents themselves, like Claude Code or Codex. Keep projects that build natively on Windows in Windows, and put Linux-toolchain projects inside WSL, where file access is fast. Pane runs agents for both kinds of repo from one Windows app and gives every task its own worktree. This guide goes from a fresh machine to several agents running side by side.

This guide takes you from a fresh Windows machine to several AI coding agents running in parallel: prerequisites, the native-or-WSL choice, installing agents, and running them with Pane. If you already have git and Node.js, skip to installing agents.

Prerequisites

Git for everything; Node.js for Codex and npm installs; Python for Aider.

Git

Download it from git-scm.com or install with WinGet. Keep the default that makes git available from PowerShell. Git for Windows also gives Claude Code a Bash shell to work in.

winget install --id Git.Git -e --source winget

Node.js

Codex, OpenCode and other npm-installed agents need Node.js. Install the LTS version from nodejs.org or with WinGet, then check it with node --version in a new terminal.

winget install --id OpenJS.NodeJS.LTS -e

Python (optional)

Aider and a few other agents run on Python. Tick “Add Python to PATH” during installation.

winget install --id Python.Python.3.12 -e

Native Windows or WSL

Keep each repo on the side where its tools run; Pane handles both.

WSL gives you a real Linux environment inside Windows. Both work with agents; pick per project.

Native WindowsWSL
Best for.NET, Unity, PowerShell, anything that builds on WindowsDocker, bash-heavy projects, Linux-only toolchains
File speedFast for Windows pathsFast inside the Linux filesystem; slow across the boundary
In PaneAgents run in Git Bash, PowerShell or cmdAgents, terminals and git run inside the distro

If you're unsure, start native; you can add WSL later. To install it:

wsl --install

Installing agents

Install only the agents you'll use, then open a new terminal.

Claude Code

Anthropic's agent. Works with a Claude Pro or Max plan or an API key. See Claude Code in Pane.

irm https://claude.ai/install.ps1 | iex
# or: winget install Anthropic.ClaudeCode
claude

Codex

OpenAI's agent. Sign in with ChatGPT the first time you run it. See Codex in Pane.

npm install -g @openai/codex
codex

Aider

Open source pair programmer for almost any model. See Aider in Pane.

python -m pip install aider-install
aider-install
aider

OpenCode

Open source terminal agent for many providers. See OpenCode in Pane.

scoop install opencode
# or: npm i -g opencode-ai@latest
opencode

Run each command in a new terminal to check it works. “Not recognized as a command” usually means the terminal predates the PATH change; open a new one.

Installing Pane

One PowerShell line, or a guided setup through npx.

Pane is where your agents live: it handles worktrees, terminals, diffs and git. Install it with PowerShell:

irm https://runpane.com/install.ps1 | iex

Or use the guided setup, which also offers remote and headless options:

npx --yes runpane@latest

The installer picks the x64 or ARM64 build for your machine. The first time you run it, Windows SmartScreen may ask you to confirm; choose “More info”, then “Run anyway”.

Your first parallel session

Two panes, two agents, two branches.

Add your repo, then create two panes with Ctrl+N, one per task:

  • → Pane 1: Claude Code (Ctrl+Alt+3) refactoring the auth module.
  • → Pane 2: Codex (Ctrl+Alt+4) writing tests for the payment API.

Each pane has its own worktree and terminal. Move between them with Ctrl+Tab, review a pane's diff with Ctrl+Shift+B, and commit with Ctrl+Shift+K. When a task is done, archive the pane with Ctrl+Shift+W; Pane removes its worktree after checking nothing is left unsaved. More in how to run multiple AI agents in parallel.

Agents running in parallelEach pane runs the agent's real terminal UI, with several panes going at once.Pane 2.4.155 on Windows 11, repo inside WSL2

Common Windows issues

PATH, long paths, ports and the WSL boundary cause most problems.

"claude is not recognized as a cmdlet"

Open a new terminal first. If you installed with npm, run npm config get prefix and add that folder to your PATH. claude doctor checks the install.

Long path errors

Windows limits paths to 260 characters by default, which deep node_modules folders can hit. Turn long paths on in git:

git config --system core.longpaths true

And in Windows, under Settings, System, For developers, Enable long paths, or with:

reg add "HKLM\SYSTEM\CurrentControlSet\Control\FileSystem" /v LongPathsEnabled /t REG_DWORD /d 1 /f

Dev servers fighting over a port

Several worktrees running dev servers all want port 3000. Pane gives each pane its own block of ten ports in PANE_PORT; have your dev server read it. Without Pane, set the port yourself, for example PORT=3001 npm run dev.

Slow git across the WSL boundary

If a repo lives in WSL, run git from inside WSL. Reaching Linux files from Windows, or the other way round, is slow. Pane runs git inside the distro for WSL repos; in your own terminals, stay on one side.

Sumber

Yang kami jalankan
  • → Pane 2.4.155 on Windows 11 with Ubuntu 24.04 on WSL2; install commands checked against each tool's docs in October 2026
Koreksi
Jika ada yang salah atau sudah usang di sini, beri tahu kami dan kami akan memperbaikinya serta memperbarui tanggal di bagian atas. Buka issue di GitHub
Sumber

pertanyaan yang sering diajukan

atau
Unduh*
Peringatan Windows SmartScreenUnduhan langsung bisa menampilkan peringatan SmartScreen selama Pane belum ditandatangani. Pane sepenuhnya open source. Kamu bisa memeriksa kodenya atau build sendiri dari kode sumber.1. Klik Info selengkapnya2. Klik Tetap jalankan3. Lanjutkan instalasiInstalasi PowerShell mengunduh rilis resmi secara langsung dan menghindari sebagian besar masalah saat mengunduh lewat browser.instalasi global npm
Tempelkan di PowerShell.Linux

Oleh Parsa Khazaeepoul, salah satu pendiri Pane. .