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
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
Go to the main project page here and download and run the files from the repository:
After you open the page:
- Look for the latest release or download files
- Download the package for your Mac
- Open the downloaded file
- Follow the on-screen steps
- Wait for the local model files to finish setting up
If macOS asks for permission:
- Open System Settings
- Go to Privacy & Security
- Allow the app to open
- Start the app again
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:
- Open the app
- Let it finish setup
- Keep the Mac plugged in
- Stay on a fast connection until downloads finish
- 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.
Once setup is done, you can start using the app in a simple flow:
- Open claude-code-local
- Point it to your project folder
- Type your request in plain English
- Let the local model read the files
- 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.
Your requests stay on your Mac. The app uses a local model instead of cloud APIs.
The bundled setup is tuned for Apple Silicon and uses a 122B model with TurboQuant support.
The app follows a code helper flow that feels familiar if you use CLI-style coding tools.
The local model can handle code, file context, and project tasks with more depth than small tools.
You do not need to pay per request. Once the app is set up, you can keep working locally.
The app can work with your code folder and respond with changes based on the files you open.
- 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
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/ProjectsDevelopment/MyAppMacintosh HD/AI Models
If you are new to local AI tools, use this simple order:
- Install the app
- Finish the first model setup
- Open your project folder
- Ask one clear question
- Read the answer
- Make one change at a time
This keeps things easy to follow and makes it simpler to spot mistakes.
If the app does not start, try this:
- Close the app
- Open it again
- Check that your Mac has enough free space
- Make sure the model download finished
- 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
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.
When a new version is posted:
- Go to the project page
- Download the latest files
- Replace the old app if needed
- Open the app again
- 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.
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.
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:
- 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
- Visit the project page
- Download and run the app
- Finish setup
- Open a project folder
- Ask for help in plain English
- Review the answer and continue working