Column 1
Column 2
基于你的工作区现有文档，我为你整理一个 Claude Code 新项目配置教程。
Claude Code 新项目配置教程
📁 项目目录结构总览
第一步：创建 CLAUDE.md（核心配置）[1]
在项目根目录创建
CLAUDE.md，定义技术栈、规范和工作流：多层级配置优先级：
路径 | 用途 |
~/.claude/CLAUDE.md | 全局默认配置 |
项目根/CLAUDE.md | 团队共享配置（提交至 Git） |
项目根/CLAUDE.local.md | 个人覆盖配置（加入 .gitignore） |
子目录/CLAUDE.md | 子模块专用配置 |
第二步：配置 Skills（知识载体）[2]
Skills 是程序性知识包，Claude 按需加载。
创建项目级 Skill：
编写
.claude/skills/commit-helper/SKILL.md：存储位置选择：
- 个人通用：
~/.claude/skills/
- 项目专用：
.claude/skills/
第三步：创建自定义命令（Slash Commands）[1]
在
.claude/commands/ 目录创建 .md 文件：示例：
.claude/commands/fix-issue.md使用方式：
/project:fix-issue 1234常用命令建议：
/project:review→ 代码审查
/project:test→ 生成测试用例
/user:explain→ 解释复杂代码
第四步：配置 MCP（外部连接器）[3]
在项目根目录创建
.mcp.json：常用 MCP 服务器：
服务 | 用途 |
server-github | GitHub 仓库操作 |
server-filesystem | 文件系统访问 |
server-slack | Slack 集成 |
server-postgres | 数据库查询 |
第五步：配置 Subagents（并行执行者）[4]
创建
.claude/agents/ 目录，定义专用 Agent：示例：
.claude/agents/security-reviewer/AGENT.md第六步：环境配置（.claude/settings.json）[1]
🚀 快速初始化脚本
📋 配置检查清单
组件 | 文件 | 状态 |
项目配置 | ⬜ | |
个人覆盖 | ⬜ | |
环境变量 | .claude/settings.json | ⬜ |
自定义命令 | .claude/commands/*.md | ⬜ |
Skills | .claude/skills/*/SKILL.md | ⬜ |
MCP | .mcp.json | ⬜ |
Agents | .claude/agents/*/AGENT.md | ⬜ |
