Installation
How to install and set up CodePilot on your system.
System Requirements
- macOS 12+ (Apple Silicon or Intel)
- Windows 10+ (64-bit)
- Node.js 18 or later
- Claude Code CLI (will be installed automatically if not present)
Download
Download Latest ReleaseDownload the latest release for your platform from GitHub Releases.
| Platform | Format | Architecture |
|---|---|---|
| macOS | DMG | arm64 (Apple Silicon) + x64 (Intel) |
| Windows | NSIS Installer | x64 |
Installation Steps
macOS
- Download the
.dmgfile for your architecture - Open the DMG and drag CodePilot to your Applications folder
- Launch CodePilot from Applications
- On first launch, macOS may ask you to confirm opening an app from an unidentified developer — go to System Settings > Privacy & Security and click "Open Anyway"
Windows
- Download the
.exeinstaller - Run the installer and follow the prompts
- CodePilot will be available in your Start menu
First Launch
On first launch, CodePilot will:
- Check for Node.js — if not found, it will offer to install it automatically
- Check for Claude Code CLI — if not found, it will install it via npm
- Open the Setup Wizard — configure your API provider and preferences
Configuring an API Provider
CodePilot needs at least one API provider to function. Go to Settings and open the Providers section to add one:
- Anthropic — Direct API access to Claude models
- Custom API (OpenAI-compatible) — Any OpenAI-compatible endpoint, including local LLMs
- OpenRouter — Access multiple providers via OpenRouter
- AWS Bedrock — Claude via AWS
- Google Vertex — Claude/Gemini via Google Cloud
Enter your API key and select a default model. You can configure multiple providers and switch between them.
Updating
CodePilot includes an auto-updater. When a new version is available, you'll see a notification in the app. You can also manually check for updates in the General section of Settings.