📚 课程目录第1章初始化Claude Code项目

1. 初始化Claude Code项目

任务目标

在本案例中，你将创建一个全新的项目目录，将其初始化为Git仓库，并完成Claude Code的基本配置。完成本案例后，你将拥有一个可以直接开始使用Claude Code进行开发的项目环境。

环境要求

已安装 Node.js 18+（推荐20+）
已安装 Git 2.30+
已安装 Claude Code（npm install -g @anthropic-ai/claude-code）
已登录Claude Code（运行 claude 后按提示完成认证）

操作步骤与完整代码

以下命令在终端中依次执行，完成项目初始化、Git仓库创建和Claude Code配置。

# 1. 创建项目目录并进入
mkdir my-claude-project
cd my-claude-project

# 2. 初始化Git仓库
git init

# 3. 创建基础项目文件
echo "# My Claude Project" > README.md
echo "node_modules/" > .gitignore
echo ".claude/" >> .gitignore

# 4. 初始化npm项目（Claude Code插件与MCP依赖管理）
npm init -y

# 5. 创建Claude Code项目级配置文件目录
mkdir -p .claude

# 6. 创建项目级Claude Code设置文件
cat > .claude/settings.json << 'EOF'
{
  "permissions": {
    "allow": ["Bash(npm run *)", "Read(.env*)"],
    "deny": ["Bash(rm -rf /)"]
  },
  "env": {},
  "hooks": {}
}
EOF

# 7. 创建CLAUDE.md项目记忆文件（Claude Code启动时自动读取）
cat > CLAUDE.md << 'EOF'
# 项目指南

## 项目类型
Node.js命令行工具项目

## 常用命令
- 安装依赖: npm install
- 运行测试: npm test

## 代码规范
- 使用ESM模块语法
- 错误处理使用try/catch
EOF

# 8. 提交初始配置到Git
git add .
git commit -m "初始化项目结构与Claude Code配置"

# 9. 验证配置生效
claude --version
claude --help | head -20

配置说明

.claude/settings.json 是Claude Code的项目级权限与行为配置文件。上述示例中：

permissions.allow：允许Claude自动执行 npm run 开头的命令，并允许读取 .env 开头的文件（如 .env.local）；
permissions.deny：禁止执行危险的递归删除命令；
env：可在此注入项目专属环境变量（当前为空）；
hooks：可挂载前置/后置钩子（当前未启用）。

CLAUDE.md 是Claude Code每次会话启动时自动读取的项目记忆文件，用于告知Claude项目背景、常用命令和约定，建议随项目维护。

验证方法

完成上述步骤后，按以下顺序确认配置成功：

Git仓库检查：运行 git log --oneline，应看到一条提交信息 初始化项目结构与Claude Code配置；
配置文件检查：运行 cat .claude/settings.json，确认JSON格式正确且包含上述权限配置；
Claude Code启动验证：在项目目录下运行 claude，进入交互界面后输入 请读取CLAUDE.md并告诉我这个项目的类型，Claude应能正确回答“Node.js命令行工具项目”——这证明配置文件和项目记忆已被加载。

若第3步中Claude无法读取CLAUDE.md，请检查文件是否位于项目根目录且文件名拼写正确（必须为大写 CLAUDE.md）。