# claude-init
**Repository Path**: mirrors_trending/claude-init
## Basic Information
- **Project Name**: claude-init
- **Description**: Claude Code 中文开发套件 - 为中国开发者定制的零门槛 AI 编程环境。一键安装完整中文化体验，集成 MCP 服务器、智能上下文管理、安全扫描，支持免翻墙访问。让 AI 编程更简单。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-09-27
- **Last Updated**: 2026-01-31
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Claude Code 中文开发套件
[](https://opensource.org/licenses/MIT)
[](README.md)
[](https://github.com/cfrs2005/claude-init/releases/latest)
[](https://github.com/cfrs2005/claude-init/releases)
[](https://github.com/cfrs2005/claude-init/stargazers)
[](https://github.com/cfrs2005/claude-init/network/members)
[](https://github.com/cfrs2005/claude-init/issues)
[](CONTRIBUTING.md)
[](README.md)
[](https://github.com/anthropics/claude-code)
[](README.md#mcp-服务器支持)
🚀 **为中国开发者定制的 Claude Code 智能开发环境**
[快速开始](#-快速开始) • [功能特性](#-特性) • [使用指南](#-使用指南) • [使用反馈](#-使用反馈) • [更新日志](CHANGELOG.md)
---
🚀 **新增智谱AI引擎**: 最新集成了 **[智谱大模型 (BigModel.cn)](https://www.bigmodel.cn/claude-code?ic=H0RNPV3LNZ)**。其旗舰 **GLM-4.5** 模型拥有媲美 Claude 的代码能力，并提供极具吸引力的包月服务，是入门和高频使用的绝佳选择。 **[点此注册即领2000万免费Tokens →](https://www.bigmodel.cn/claude-code?ic=H0RNPV3LNZ)**
基于 [Claude Code Development Kit](https://github.com/peterkrueck/Claude-Code-Development-Kit) 的完整中文本地化版本，提供零门槛的中文 AI 编程体验。
---
## 🏆 v1.3.0 重磅更新：集成 Anthropic 黑客松冠军配置（汉化版）
**🥇 融合 Anthropic x Forum Ventures 黑客松冠军 [@affaanmustafa](https://x.com/affaanmustafa) 的完整生产级配置 🥇**
[Everything Claude Code](https://github.com/affaan-m/everything-claude-code) | [完整指南](https://x.com/affaanmustafa/status/2012378465664745795)
本版本集成了 **Everything Claude Code** 的完整汉化配置——这是 **Anthropic 官方 x Forum Ventures 黑客松冠军团队**在构建 [zenith.chat](https://zenith.chat) 等真实产品过程中，历经 **10 个月高强度开发** 迭代出的生产级配置合集。原作者 [@affaanmustafa](https://x.com/affaanmustafa) 与 [@DRodriguezFX](https://x.com/DRodriguezFX) 凭借这套配置赢得了 Anthropic 官方举办的黑客马拉松冠军。所有配置文件均已完成中文本地化，开箱即用。
### 📦 新增核心组件
| 组件 | 数量 | 用途 |
|------|------|------|
| **智能体 (Agents)** | 9 个 | 专用子智能体，处理范围受限的委派任务 |
| **技能 (Skills)** | 7+ | 工作流定义与领域知识，由指令或智能体调用 |
| **指令 (Commands)** | 10 个 | 快捷斜杠指令，一键执行复杂工作流 |
| **规则 (Rules)** | 8 个 | 必须遵循的强制性准则 |
| **钩子 (Hooks)** | 多个 | 基于触发器的自动化脚本 |
| **上下文 (Contexts)** | 3 个 | 开发/研究/审查三种工作模式 |
### 🤖 智能体 (Agents) 详解
智能体是处理特定任务的专用子流程，每个智能体都有明确的职责边界：
- **`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`** - 文档与代码同步维护
### ⚡ 快捷指令 (Commands)
在 Claude Code 中直接输入斜杠指令，一键触发复杂工作流：
```bash
/tdd # 测试驱动开发流程
/plan # 功能实现规划
/e2e # 生成端到端测试
/code-review # 代码质量审查
/build-fix # 修复构建错误
/refactor-clean # 移除死代码
/test-coverage # 测试覆盖率分析
/update-codemaps # 刷新代码地图
/update-docs # 同步文档
/learn # 学习新技术
```
### 📐 规则 (Rules) 体系
规则是必须始终遵循的准则，确保代码质量和团队协作：
- **`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/` 目录，针对你的技术栈进行定制。
---
## ✨ 特性
### 🎯 完全中文化
- **中文 AI 指令** - 所有 AI 上下文和提示完全中文化
- **中文文档系统** - 三层文档架构的中文版本
- **中文错误信息** - 友好的中文错误提示和帮助
- **中文安装体验** - 从安装到配置全程中文
### 🧠 智能上下文管理
- **三层文档架构** - 基础层/组件层/功能层分级管理
- **自动上下文注入** - 子智能体自动获取项目上下文
- **智能文档路由** - 根据任务复杂度加载适当文档
- **跨会话状态管理** - 智能任务交接和状态保持
### 🔧 开发工具集成
- **Hook 系统** - 中文化的自动化 Hook 脚本
- **MCP 服务器支持** - Gemini 咨询、Context7 文档等
- **安全扫描** - 自动 MCP 调用安全检查
- **通知系统** - 重要事件的系统通知
### 📚 完整模板库
- **项目模板** - 多种编程语言的项目结构模板
- **文档模板** - 标准化的中文文档模板
- **配置示例** - 开箱即用的配置文件
- **Skills 扩展** - 模块化的能力扩展系统
- **示例项目** - Python、Node.js、Web 应用完整示例
## 🚀 快速开始
### 一键安装
```bash
curl -fsSL https://raw.githubusercontent.com/cfrs2005/claude-init/main/install.sh | bash
```
### 手动安装
```bash
# 克隆仓库
git clone https://github.com/cfrs2005/claude-init.git
cd claude-init
# 运行安装脚本
./setup.sh
```
## 📖 使用指南
### 1. 开始使用
安装完成后，在任意项目中启动 Claude Code：
```bash
claude
```
现在你可以用中文与 AI 对话，所有上下文和提示都已本地化。
### 2. 🎯 MCP 服务器功能
#### 🧠 Gemini 深度咨询
**触发方式：** 对 Claude 说"咨询 Gemini" 或 "请 Gemini 分析"
**适用场景：**
- 复杂架构设计问题
- 代码性能优化建议
- 多文件代码重构方案
- 深度技术问题分析
**发送内容：**
- 描述你的具体问题
- 附上相关代码文件
- 说明你想要什么类型的建议
**Gemini 能做什么：**
- 提供多种解决方案对比
- 深度代码审查和优化建议
- 架构设计最佳实践
- 跨技术栈的经验分享
#### 📚 Context7 文档查询
**触发方式：** 询问任何开源库的最新用法
**适用场景：**
- 学习新框架或库
- 查找最新 API 文档
- 解决版本兼容问题
**发送内容：**
- 说出库名称（如 "React 的最新 hooks 用法"）
- 描述你想解决的具体问题
**Context7 能做什么：**
- 获取最新官方文档
- 提供实用代码示例
- 解释最新特性和变化
### 3. 💡 增强功能
#### 🎵 自定义通知音效
**默认路径：** `.claude/hooks/sounds/`
**支持格式：** `.mp3`, `.wav`, `.aiff`
**替换方式：**
```bash
# 替换任务完成音效
cp your-sound.mp3 .claude/hooks/sounds/complete.mp3
# 替换输入提示音效
cp your-sound.mp3 .claude/hooks/sounds/input.mp3
```
#### 🔒 安全扫描
**自动功能：** 所有 MCP 调用前自动检查敏感信息
**检查内容：**
- API 密钥和令牌
- 密码和敏感配置
- 个人身份信息
- 私有代码片段
#### 🤖 智能上下文管理
**自动功能：** 子任务自动获取项目上下文
**工作方式：**
- 每个新任务自动加载项目文档
- 智能选择相关上下文信息
- 保持会话间状态一致性
### 4. 🎯 Claude Code 斜杠命令
安装后可使用的内置 Claude Code 命令：
```bash
# 📊 上下文分析
/full-context # 全面上下文收集和分析
# 🔍 代码质量
/code-review # 多专家角度代码审查
# 🧠 AI 咨询
/gemini-consult # 与 Gemini 深入对话咨询
# 📝 文档管理
/create-docs # 创建 AI 优化文档结构
/update-docs # 保持文档与代码同步
# ♻️ 代码维护
/refactor # 智能重构代码
# 🤝 会话管理
/handoff # 保留上下文和任务状态
# 📡 MCP 工具
/mcp-status # 检查 MCP 服务器状态
```
**使用方式：** 直接在 Claude Code 中输入斜杠命令
**自动功能：** 所有命令自动获得项目上下文注入
### 5. 🎯 Skills 模块化能力扩展
**什么是 Skills？** Skills 是 [Claude Code 云服务](https://www.anthropic.com/news/claude-code-on-the-web)的强大功能，让你创建可复用的能力模块。
**核心特性：**
- 📦 **自动调用** - Claude 根据需求智能选择合适的 skill
- 🎯 **渐进加载** - 只在需要时加载，节省上下文空间
- 🔧 **易于创建** - 简单的 Markdown + YAML 格式
- 🌍 **灵活部署** - 全局或项目级别安装
**内置 Skills：**
- 📰 **News Skill** - Anthropic 新闻追踪和深度分析
- 自动获取最新官方新闻
- 多维度分析（技术、商业、行业）
- 结构化知识整理
**使用示例：**
```
你：分析最新的 Anthropic 新闻
Claude：[自动使用 news skill 获取和分析]
```
**详细文档：** 查看 `templates/.claude/skills/README.md`
**了解更多：** [Claude Code 云服务介绍](https://www.anthropic.com/news/claude-code-on-the-web)
### 6. 📦 项目示例库
提供完整的项目模板，快速启动开发：
**可用示例：**
#### 🐍 Python 项目
- FastAPI Web 应用结构
- 数据科学项目配置
- 机器学习工作流
#### 🟢 Node.js 项目
- Express.js API 服务
- React 全栈应用
- 微服务架构
#### 🌐 Web 应用
- 前后端分离架构
- 移动端适配
- 部署和运维配置
**快速开始：**
```bash
# 复制示例项目
cp -r examples/python-project my-new-project
cd my-new-project
# 开始使用
claude
```
**详细文档：** 查看 `examples/README.md`
## 💬 使用反馈
### 🐛 问题反馈
**遇到问题？** [提交 Issue](https://github.com/cfrs2005/claude-init/issues)
**常见问题类型：**
- 安装失败或错误
- MCP 服务器无法使用
- Hook 脚本不工作
- 中文显示异常
- 功能建议和改进
### 💡 功能建议
**想要新功能？** [发起讨论](https://github.com/cfrs2005/claude-init/discussions)
**建议包含：**
- 功能描述和使用场景
- 期望的工作方式
- 类似工具的参考
### 🤝 参与贡献
欢迎提交代码、文档改进和翻译优化！
## 📄 开源协议
本项目基于 [MIT License](LICENSE) 开源。
## 🙏 致谢
- [Claude Code Development Kit](https://github.com/peterkrueck/Claude-Code-Development-Kit) - 原始项目
- [Everything Claude Code](https://github.com/affaan-m/everything-claude-code) - Anthropic 黑客松优胜者 [@affaanmustafa](https://x.com/affaanmustafa) 的完整配置合集
- [Anthropic](https://www.anthropic.com/) - Claude Code 平台
- 所有贡献者和中文开发社区
> 📦 **v1.3.0 新增**：集成 [Everything Claude Code](https://github.com/affaan-m/everything-claude-code) 汉化版配置，包含生产级智能体 (Agents)、技能 (Skills)、钩子 (Hooks)、指令 (Commands)、规则 (Rules) 和 MCP 配置。详见 [`templates/.claude/`](templates/.claude/) 目录。
---
🎉 **开始你的中文 AI 编程之旅吧！**
```bash
curl -fsSL https://raw.githubusercontent.com/cfrs2005/claude-init/main/install.sh | bash
```