Claude Code 精通指南 第3篇：项目配置

Your-project/CLAUDE.md

Your-project/.claude/CLAUDE.md

~/.claude/CLAUDE.md

Your-project/CLAUDE.local.md

Monorepo/
├── CLAUDE.md              # 对所有内容生效
├── apps/
│   ├── web/
│   │   └── CLAUDE.md      # 在 web/ 中工作时加载
│   └── api/
│       └── CLAUDE.md      # 在 api/ 中工作时加载
└── packages/
    └── shared/
        └── CLAUDE.md      # 在 shared/ 中工作时加载

# Project Name

一句话：这是什么，做什么。

## Tech Stack

- Next.js 14 (App Router)
- TypeScript (strict mode)
- Tailwind CSS
- Prisma + PostgreSQL
- Jest for testing

## Directory Structure

Src/
├── app/           # Next.js routes
├── components/    # Reusable UI components
├── lib/           # Utilities and helpers
├── services/      # Business logic
└── types/         # TypeScript interfaces

## Commands

- `bun dev` - Start development server (port 3000)
- `bun test` - Run Jest tests
- `bun lint` - ESLint check
- `bun build` - Production build
- `bunx prisma studio` - Database GUI

## Coding Conventions

- Use path aliases (@/components, @/lib, @/services)
- Server components by default, 'use client' only when needed
- All functions must have typed parameters and return types
- Keep methods small with single responsibility
- Tests colocated with components (Component.test.tsx)

## Important Notes

- Never commit .env files
- Run `bunx prisma generate` after schema changes
- API routes use Zod for runtime validation
- Authentication uses NextAuth with JWT strategy

## Next.js Conventions

- Server Components by default
- Use 'use client' only for useState, useEffect, event handlers
- Data fetching: direct DB calls in Server Components, SWR in Client
- API Routes: app/api/[route]/route.ts
- File naming: PascalCase components, camelCase utilities

## FastAPI Conventions

- Type hints on all functions
- Async/await for I/O operations
- Pydantic v2 models for request/response validation
- Dependency injection for services
- Alembic for migrations: `alembic upgrade head`

## Go Conventions

- Standard project layout (cmd/, internal/, pkg/)
- Use interfaces for testability
- Error wrapping with fmt.Errorf and %w
- Tests in same package with _test.go suffix
- Run `go test ./...` before commits

# Project Overview

See @README.md for detailed project description.
See @docs/api-patterns.md for API conventions.
See @docs/testing-guide.md for testing requirements.

## Quick Reference

@package.json shows available npm scripts.

.claude/
├── CLAUDE.md           # 主文件
└── rules/
    ├── coding-style.md
    ├── testing.md
    ├── security.md
    └── deployment.md

~/.claude/settings.json           # 全局（所有项目）
.claude/settings.json             # 项目级（提交到 git）
.claude/settings.local.json       # 本地（被 gitignore）

{
  "permissions": {
    "allow": [
      "Read(./src/**)",
      "Read(./tests/**)",
      "Bash(git status)",
      "Bash(git diff)",
      "Bash(bun test:*)",
      "Bash(bun lint)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Bash(rm *)",
      "Bash(git push *)"
    ]
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "if [[ \"$CLAUDE_FILE_PATH\" == *.py ]]; then black \"$CLAUDE_FILE_PATH\"; fi"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Write(./config/production.*)",
        "hooks": [
          {
            "type": "command",
            "command": "echo 'Blocked: Cannot modify production config' && exit 1"
          }
        ]
      }
    ]
  }
}

## General Guidelines
- Write clean code
- Follow best practices
- Use meaningful variable names
- Keep functions small

## Project-Specific Rules
- Error responses use the ApiError class from @/lib/errors
- All dates stored as UTC, displayed in user's timezone
- Feature flags checked via @/lib/features.isEnabled()
- Log format: [LEVEL] [SERVICE] [REQUEST_ID] message

Claude

Summarize the project configuration and conventions you understand.
What tech stack is this? What commands should you use for testing?