Mini Claude Code

一个轻量级的 Claude Code 风格 CLI 工具，支持多 LLM 提供商。

用 ~7000 行 TypeScript 实现了 Claude Code 的核心交互体验：流式对话、工具调用、Skills、MCP、Hooks、权限、会话管理等完整功能。

平台支持： 当前对 macOS 支持友好，Windows 平台暂未支持。

功能一览

快速开始

# 安装依赖
pnpm install

# 方式一：直接启动，通过 /login 交互式配置
npx tsx src/index.ts

# 方式二：环境变量指定 API Key
MCC_API_KEY=your-key npx tsx src/index.ts

# 指定提供商
MCC_API_KEY=your-key npx tsx src/index.ts --provider deepseek
MCC_API_KEY=your-key npx tsx src/index.ts --provider openai
MCC_API_KEY=your-key npx tsx src/index.ts --provider openrouter
MCC_API_KEY=your-key npx tsx src/index.ts --provider qwen

# 自定义 API 地址
MCC_API_KEY=your-key npx tsx src/index.ts --base-url https://your-api.com/v1 --model your-model

# 单次提问模式
MCC_API_KEY=your-key npx tsx src/index.ts "解释这个项目的结构"

REPL 命令

Skills 系统

Skills 是用 Markdown + YAML frontmatter 定义的可复用指令模板。

目录结构

.claude/skills/     # 项目级（优先级高）
  commit/
    SKILL.md
  hello/
    SKILL.md

~/.claude/skills/   # 用户级
  my-skill/
    SKILL.md

项目级 skill 会覆盖同名的用户级 skill。

Skill 文件格式

---
name: commit
description: Create a well-formatted git commit
when_to_use: When the user asks to commit code changes
allowed_tools: Bash, Read
arguments: message
---

Please help me create a git commit:

1. First run `git status` and `git diff --cached` to see staged changes
2. Generate a concise commit message based on the changes
3. User's note: {{ message }}
4. Execute the commit

使用方式

用户手动调用：

❯ /commit fix typo

模型自动调用： 模型会在 system prompt 中看到可用的 skills 列表，当任务匹配时自动通过 Skill tool 调用。

项目结构

src/
  index.ts          # 入口，REPL 交互、命令菜单、粘贴检测
  engine.ts         # 查询引擎，流式调用 + 工具执行循环 + 自动压缩
  types.ts          # 类型定义
  config.ts         # 四层配置加载与合并
  context.ts        # CLAUDE.md 上下文文件加载
  permissions.ts    # 权限系统（分级授权 + 交互式提示）
  hooks.ts          # Hooks 生命周期管理
  session.ts        # 会话持久化与恢复
  mcp.ts            # MCP 协议客户端（stdio 传输）
  skills.ts         # Skills 加载、解析、执行
  tasks.ts          # 会话级任务跟踪
  markdown.ts       # 终端 Markdown 渲染 + Diff 渲染
  tools/
    index.ts        # 工具注册表 + MCP 工具注册
    bash.ts         # Shell 命令执行
    read.ts         # 文件读取
    write.ts        # 文件写入
    edit.ts         # 文件编辑（字符串替换）
    glob.ts         # 文件模式匹配
    grep.ts         # 内容搜索
    webfetch.ts     # URL 内容抓取
    agent.ts        # 子 Agent 启动
    task.ts         # 任务管理工具（Create/Update/List）

License

MIT