← Back to directory
M

MiniClaude

Community
Lightweight local AI coding assistant, streamlined from Claude Code
GitHub source repository ↗
★ 172 Stars Category · Dev Tools Popular Source revision 561531ea4567
35FMRS · D
Reliability
5/20
Security and permissions
4/20
Maintenance
10/20
Documentation
8/20
Setup experience
8/20

Created by community developer txl16095, based on Claude Code, with code size about 20% of the original.

Read the FMRS scoring method →

MiniClaude is a lightweight local AI coding assistant derived from Claude Code, which removes cloud services, telemetry, and collaboration code (about 92,000 lines), while retaining core development features such as AI conversation, code generation, file operations, Git, MCP, plugin system, and skills. It supports using various AI models (e.g., DeepSeek) and is configured via settings.json.

Tools

The tool list has not been reviewed yet.

Setup

Prerequisites: Bun >= 1.3.11 and Git. Installation and build:

git clone https://github.com/txl16095/MiniClaude.git && cd MiniClaude
bun install
bun run build

Then copy the configuration file:

cp settings.example.json ~/.claude/settings.json

And edit it as needed, for example configuring DeepSeek:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key-here",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]"
  },
  "model": "deepseek-v4-pro[1m]"
}

Fit and risk

Best for

  • Developers concerned about privacy and local development
  • Individuals or teams needing a lightweight alternative to Claude Code
  • Developers familiar with Bun and TypeScript

Not for

  • Users needing team collaboration and cloud sync features
  • Enterprises requiring official support and maintenance
  • Windows users not comfortable with command line

Required permissions

  • Read and write project files
  • Execute shell commands (Bash/PowerShell)
  • Access Git repositories
  • Use network services (calling AI APIs)

Risks and side effects

  • When using third-party APIs, be aware of data privacy; code may be sent to external model services
  • Project is not official, there may be security vulnerabilities or incomplete features
  • Depends on Bun runtime, ensure environment stability

Troubleshooting

  1. If build fails, ensure Bun >= 1.3.11 and re-run bun install
  2. If AI features do not work, check API key and base URL in settings.json
  3. If environment issues occur, try copying .env.example and using bun run dev for development mode

Use cases

Local AI coding assistance without cloud services
Use third-party models (e.g., DeepSeek) for code generation and project understanding
Extend functionality via MCP protocol

Supported clients

Claude DesktopFull support