3rd/ccc

---

CCC 是一个 Claude Code 启动器，允许你从一个地方以分层方式配置提示符、命令、代理、技能、钩子、MCP 和插件。

• 动态配置： 在 TypeScript 中生成提示符、命令、代理和技能，并可访问当前项目。
• 分层配置： 将全局配置与自动检测预设和项目覆盖合并。
• 低强度扩展性： 用微小辅助工具在 TypeScript 中编写钩子、MCP 服务器、状态行和工作流。

与Anthropic无关。使用官方@anthropic-ai/claude-code CLI。

警告：未在Windows上测试，遇到问题请开启。

---

开始

1.设置

要求：

• Bun 在 PATH 下运行。ccc 运行在 Bun 下，配置加载、钩子、内联 MCP 和状态行也同样如此。
• Node.js 24 或更新于 PATH，或将 CCC_NODE 设置为节点二进制。Claude 代码本身运行于 Node 下。
• 可选，仅限 Linux：unshare（util-linux 2.38+）和一个 C 编译器（[cc）。有了它们，子进程如 Bash 工具命令也能看到你生成的配置（参见工作原理）。没有它们，CCC 跳过这一步，依然能正常工作。

---

CCC is a launcher for Claude Code that lets you configure prompts, commands, agents, skills, hooks, MCPs, and plugins from a single place, in a layered way.

• Dynamic configuration: generate prompts, commands, agents, and skills in TypeScript with access to the current project.
• Layered config: merge global configuration with auto-detected presets and project overrides.
• Low‑effort extensibility: write hooks, MCP servers, statuslines, and workflows in TypeScript with tiny helpers.

Not affiliated with Anthropic. Uses the official @anthropic-ai/claude-code CLI.

Warning: Not tested on Windows, open an issue if you run into problems.

---

Getting Started

1. Setup

# clone this repo somewhere you'd like to keep going to edit your configuration
git clone https://github.com/3rd/ccc.git ~/my-claude-launcher
cd ~/my-claude-launcher

# install dependencies and link `ccc`
bun install
bun link

Requirements:

• Bun on PATH. ccc runs under Bun, and so do config loading, hooks, inline MCPs, and the statusline.
• Node.js 24 or newer on PATH, or set CCC_NODE to a Node binary. Claude Code itself runs under Node.
• Optional, Linux only: unshare (util-linux 2.38+) and a C compiler (cc). With them, child processes such as Bash tool commands also see your generated config (see How It Works). Without them, CCC skips that step and still works.

Claude Code version: @anthropic-ai/claude-code is pinned to an exact version in package.json, so bun update leaves it unchanged. To try another release, run bun add @anthropic-ai/claude-code@; at startup, CCC lists any runtime patch that no longer matches as stale. To run a different Claude Code executable without changing the dependency, set CLAUDE_PATH. CCC supports Claude Code 2.1.242 and later.

2. Customize your config

Your configuration lives in ./config, which ships with examples:

~/my-claude-launcher/     # Your copy of this repository
└── config/
    ├── global/           # Applies everywhere
    │   ├── prompts/      # system.ts (system prompt) and user.ts (CLAUDE.md)
    │   ├── commands/     # Slash commands
    │   ├── agents/       # Sub-agents
    │   ├── settings.ts   # Claude Code settings plus CCC-only keys
    │   ├── hooks.ts      # Hooks
    │   ├── mcps.ts       # MCP servers
    │   └── statusline.ts # Statusline
    └── presets/          # Language/framework/whatever-specific configs
        ├── golang/
        ├── rust/
        └── typescript/