BeiZi6/easy-cc

8 stars · Last commit 2026-09-28

Field guide to Claude Code for Chinese developers: setup, workflows, hooks, subagents, MCP, CI · Claude Code 折腾指南

README preview

# Claude Code 折腾指南

> 一份从零基础到高阶玩法的 Claude Code 中文指南。
> Claude Code 更新极快,本仓库按"框架 + 增量更新"的方式维护。

## Overview (English)

A Chinese-language field guide to Claude Code, written from daily use rather than translated from the docs.

- **Covers:** installation and first run → daily use (context management, plan mode) → workflows (spec-driven development, TDD, review, debugging, long tasks and memory) → configuration (settings layers, CLAUDE.md, permissions, hooks) → MCP and extensions → subagents and parallel worktrees → CI automation → anti-patterns.
- **Format:** about 60 notes in ten parts, organised as an Obsidian vault (backlinks, graph view) that also reads fine on GitHub.
- **Maintenance:** maintained as a stable framework plus incremental updates. Chapters with major changes are flagged at the top, and the changelog section covers Claude Code up to v2.1.150.

## 说明

这不是官方文档的翻译,就是我自己用 Claude Code 过程中顺手记下来的东西。官方文档写得挺全,但很多细节要自己踩过才知道——比如 context 什么时候会悄悄污染、hooks 的执行顺序为什么跟你想的不一样、MCP 连不上时该从哪里查。这些"踩坑笔记"散在各处很难找,所以整理成了这份指南。

内容按 Obsidian Vault 组织,但在 GitHub 上直接读也没问题。如果你有 Obsidian,用它打开体验更好(双向链接、图谱都能用),见下方说明。

Claude Code 更新很快,基本每周都有变化。我会持续追更,改动比较大的章节顶部会加提示。如果发现哪里写错了或者已经过时,欢迎提 Issue。

View full repository on GitHub →