Mini Claude Code

Mini Claude Code Agent

[English](README.md) | [中文](README_zh.md)

A minimal implementation of the Claude Code CLI coding assistant.

Overview

Mini Claude Code Agent is a simplified version of Claude Code that allows AI models to interact directly with your codebase through a powerful set of tools. It provides a command-line interface that enables Claude to:

• Read and write files
• Execute shell commands
• Edit text in files
• Navigate project structures

This tool is designed to be used with LLM models to provide an interactive coding experience where the LLM can make direct changes to your codebase.

Features

• Coding Assistant: Uses large language models as the core AI engine
• File Operations: Support for reading, writing, and editing files
• Shell Execution: Can execute shell commands within the project workspace
• MCP Integration: Supports Model Context Protocol, can connect to various MCP servers to extend functionality
• Skills System: Support Anthropic Skills specification to install and invoke specialized skills
• Context Compression: Intelligent automatic and manual context compression to handle long conversation token limits
• Real-time Status Bar: Display MCP connection status and context usage at a glance
• Security Restrictions: Prevents path traversal and dangerous command execution
• Real-time Feedback: Provides visual feedback during execution
• Modular Architecture: Well-organized codebase for easy maintenance and extension

Tech Stack

• TypeScript
• Node.js
• Anthropic AI SDK
• MCP (Model Context Protocol) SDK

Prerequisites

• Node.js >= 16.0.0
• Anthropic-compatible API key
• Proxy LLM model

Quick Start

The fastest way to get started:

1. Set environment variables:

export ANTHROPIC_API_KEY="your-api-key-here"
export ANTHROPIC_BASE_URL="your-anthropic-compatible-api-base-url"
export ANTHROPIC_MODEL="model-name"

1. Run directly with npx (no installation needed):