License: MIT Language: 中文 Version Downloads Stars Forks Issues PRs Welcome Platform Claude Code

📅 项目时间: 2025年07月
🎯 项目定位: Claude Code 项目初始化工具(非 Claude 汉化项目)
⚠️ 当前状态: Claude Code 版本快速迭代,本项目仅作为学习参考

本项目创建于 2025年07月,当时 Claude Code 在国内开发社区刚刚兴起。作为一个项目初始化工具,旨在帮助开发者快速搭建基于 Claude Code 的开发环境。

⚠️ 重要说明:

• 本项目 不是 Claude Code 的汉化版本
• 本项目 不是 Claude Code 的官方替代品
• Claude Code 官方版本更新频繁,本项目配置可能已过时
• 建议直接使用 Claude Code 官方版本 并参考官方中文文档

• ✅ macOS - 完全支持
• ✅ Linux - 完全支持
• ❌ Windows - 不支持(作者无 Windows 环境,无法测试和维护)

本版本集成了 Everything Claude Code 的完整汉化配置——这是 Anthropic 官方 x Forum Ventures 黑客松冠军团队在构建 zenith.chat 等真实产品过程中,历经 10 个月高强度开发 迭代出的生产级配置合集。原作者 @affaanmustafa 与 @DRodriguezFX 凭借这套配置赢得了 Anthropic 官方举办的黑客马拉松冠军。所有配置文件均已完成中文本地化,开箱即用。

智能体是处理特定任务的专用子流程,每个智能体都有明确的职责边界:

• planner.md - 功能实现规划,分解复杂需求为可执行步骤
• architect.md - 系统设计决策,架构方案评估与选型
• tdd-guide.md - 测试驱动开发导师,指导 RED-GREEN-REFACTOR 循环
• code-reviewer.md - 代码质量与安全审查,多维度评估代码
• security-reviewer.md - 专业漏洞分析,安全威胁识别
• build-error-resolver.md - 构建错误快速诊断与修复
• e2e-runner.md - Playwright 端到端测试执行
• refactor-cleaner.md - 死代码清理,技术债务消除
• doc-updater.md - 文档与代码同步维护

在 Claude Code 中直接输入斜杠指令,一键触发复杂工作流:

/tdd # 测试驱动开发流程
/plan # 功能实现规划
/e2e # 生成端到端测试
/code-review # 代码质量审查
/build-fix # 修复构建错误
/refactor-clean # 移除死代码
/test-coverage # 测试覆盖率分析
/update-codemaps # 刷新代码地图
/update-docs # 同步文档
/learn # 学习新技术

规则是必须始终遵循的准则,确保代码质量和团队协作:

• security.md - 禁止硬编码密钥,强制安全检查
• coding-style.md - 不可变性设计,文件组织规范
• testing.md - TDD 原则,80% 覆盖率要求
• git-workflow.md - 提交格式规范,PR 流程标准
• agents.md - 何时委派给子智能体的决策准则
• performance.md - 模型选择策略,上下文管理最佳实践
• patterns.md - API 响应格式,设计模式规范
• hooks.md - 钩子系统使用文档

⚠️ 重要提示:不要一次性启用所有 MCP。如果启用太多工具,你的 200k 上下文窗口可能缩减到 70k。

经验法则:

• 配置 20-30 个 MCP 服务器
• 每个项目保持启用少于 10 个
• 活跃工具数量控制在 80 个以内
• 使用 disabledMcpServers 禁用未使用的服务

所有新增配置位于 templates/.claude/ 目录:

templates/.claude/
├── agents/ # 9 个专用子智能体
├── skills/ # 工作流定义与领域知识 
├── commands/ # 10 个快捷斜杠指令
├── rules/ # 8 个强制性规则
├── hooks/ # 自动化钩子脚本
├── contexts/ # 3 种工作上下文模式
├── mcp-configs/ # MCP 服务器配置示例
├── plugins/ # 插件生态系统文档
└── examples/ # 配置示例和会话记录

使用方式:根据需要将配置复制到 ~/.claude/ 目录,针对你的技术栈进行定制。

• 快速启动 - 预配置的项目结构和开发环境
• 中文文档 - 项目初始化相关的中文说明文档
• 配置示例 - 常用开发场景的配置文件模板
• 学习参考 - Claude Code 配置和最佳实践的学习案例

• 三层文档架构 - 基础层/组件层/功能层分级管理
• 自动上下文注入 - 子智能体自动获取项目上下文
• 智能文档路由 - 根据任务复杂度加载适当文档
• 跨会话状态管理 - 智能任务交接和状态保持

• Hook 系统 - 中文化的自动化 Hook 脚本
• MCP 服务器支持 - Gemini 咨询、Context7 文档等
• 安全扫描 - 自动 MCP 调用安全检查
• 通知系统 - 重要事件的系统通知

• 项目模板 - 多种编程语言的项目结构模板
• 文档模板 - 标准化的中文文档模板
• 配置示例 - 开箱即用的配置文件
• Skills 扩展 - 模块化的能力扩展系统
• 示例项目 - Python、Node.js、Web 应用完整示例

强烈建议直接使用官方最新版本:

1. 安装 Claude Code

   # 访问官方文档获取最新安装方法
   https://docs.anthropic.com/zh-CN/docs/claude-code

2. 参考本项目配置

   # 克隆本仓库作为参考
   git clone https://github.com/cfrs2005/claude-init.git
   cd claude-init
   # 查看配置文件,根据需要调整你的 Claude Code 设置
   ls templates/.claude/

如果你想参考本项目的配置:

本项目的配置文件位于 templates/.claude/ 目录:

templates/.claude/
├── agents/ # 智能体配置示例
├── skills/ # 技能配置示例 
├── commands/ # 命令配置示例
├── rules/ # 规则配置示例
├── hooks/ # 钩子脚本示例
├── contexts/ # 上下文配置示例
└── mcp-configs/ # MCP 服务器配置示例

# 查看感兴趣的配置文件
cat templates/.claude/agents/planner.md
# 复制有用的配置到你的 Claude Code 目录
cp templates/.claude/agents/planner.md ~/.claude/agents/

注意: 以下功能配置仅供参考,可能需要根据最新 Claude Code 版本调整

触发方式: 对 Claude 说"咨询 Gemini" 或 "请 Gemini 分析" 适用场景:

• 复杂架构设计问题
• 代码性能优化建议
• 多文件代码重构方案
• 深度技术问题分析

注意: 以下功能配置仅供参考,可能需要根据最新 Claude Code 版本调整

触发方式: 询问任何开源库的最新用法 适用场景:

• 学习新框架或库
• 查找最新 API 文档
• 解决版本兼容问题

配置参考: 钩子脚本配置示例

默认路径: .claude/hooks/sounds/ 支持格式: .mp3, .wav, .aiff

配置参考: 安全检查钩子示例

功能: MCP 调用前自动检查敏感信息

配置参考: 上下文管理配置示例

功能: 子任务自动获取项目上下文

配置参考: 命令配置文件示例

以下为本项目包含的命令配置示例:

# 📊 上下文分析
/full-context # 全面上下文收集和分析
# 🔍 代码质量
/code-review # 多专家角度代码审查
# 📝 文档管理
/create-docs # 创建 AI 优化文档结构
/update-docs # 保持文档与代码同步
# ♻️ 代码维护
/refactor # 智能重构代码
# 🤝 会话管理
/handoff # 保留上下文和任务状态

注意: 具体可用命令请参考官方最新文档

配置参考: Skills 配置文件示例

什么是 Skills? Skills 是 Claude Code 云服务的强大功能,让你创建可复用的能力模块。

本项目包含的 Skills 示例:

• 📰 News Skill - 新闻追踪和深度分析示例

详细文档: 查看 templates/.claude/skills/README.md 了解更多: Claude Code 云服务介绍

学习参考: 项目结构配置示例

本项目包含以下项目模板示例:

• FastAPI Web 应用结构
• 数据科学项目配置
• 机器学习工作流

• Express.js API 服务
• React 全栈应用
• 微服务架构

• 前后端分离架构
• 移动端适配
• 部署和运维配置

参考方式:

# 查看示例项目
ls examples/
# 参考项目结构和配置
cat examples/python-project/README.md

详细文档: 查看 examples/README.md

• Claude Code 官方版本更新频繁,API 和配置可能发生变化
• 本项目的配置文件可能需要根据最新版本进行调整
• 建议始终参考 官方文档 获取最新信息

• ✅ macOS - 完全支持
• ✅ Linux - 完全支持
• ❌ Windows - 不支持(作者无 Windows 环境,无法提供支持)

• 本项目是 学习参考 项目,不是官方产品
• 本项目 不是 Claude Code 的汉化版本
• 本项目提供配置文件示例和最佳实践参考
• 遇到问题请首先查阅 官方文档

官方推荐学习路径:

1. 📖 Claude Code 官方文档 - 完整的中文使用指南
2. 🚀 Claude Code GitHub 仓库 - 最新版本和更新
3. 💡 官方示例和最佳实践 - 官方推荐用法

遇到问题?

1. 首先查阅官方文档 - 大部分问题都能在官方文档中找到解决方案
2. 检查版本兼容性 - 确认你使用的 Claude Code 版本与配置文件匹配
3. 搜索已有 Issues - 查看是否有类似问题已经被讨论
4. 提交新 Issue - 如果以上都没有解决,可以 提交 Issue

Issue 提示:

• 详细描述问题和复现步骤
• 说明你的操作系统和 Claude Code 版本
• 提供相关的错误信息和配置文件

想要新功能?

1. 先确认是否为官方功能 - 查看官方文档确认是否已是内置功能
2. 发起讨论 - 在 Discussions 中讨论想法
3. 提交 PR - 如果你是配置改进,欢迎提交 Pull Request

欢迎提交配置改进、文档修正和示例优化!

本项目基于 MIT License 开源。

• Claude Code Development Kit - 原始项目灵感来源
• Everything Claude Code - Anthropic 黑客松优胜者配置参考
• Anthropic - Claude Code 官方平台
• 所有贡献者和开发社区

💡 推荐学习资源:

• 📖 Claude Code 官方中文文档
• 🚀 Claude Code 官方 GitHub
• 💡 官方示例和最佳实践

🎓 本项目仅供学习参考,建议使用官方最新版本!

# 访问官方文档开始使用
https://docs.anthropic.com/zh-CN/docs/claude-code