Awesome Claude Code Tips

Awesome Claude Code Tips

[🇨🇳 中文版本](README_zh.md) | English Version

A comprehensive guide to effective Claude Code usage, covering session management, git workflows, and best practices for AI-assisted development.

CLAUDE.md File

Purpose

• Provides project-specific guidance to Claude Code
• Automatically read when starting a new session
• Maintains context between sessions

What to Include

• Specific build commands (npm run build:prod) - see npm documentation
• Project architecture not obvious from file structure
• Custom workflows and conventions
• Important dependencies and tools

What to Exclude

• Generic advice ("write clean code")
• Basic commands (cd, ls) - see Unix command reference
• Information obvious from reading files
• Temporary or experimental setups

Keeping it Concise

• Use bullet points instead of paragraphs
• Group related information under clear headings
• Delete outdated information when adding new
• Test: "Will I need this next time I work on this project?"

Session Lifecycle

Start

• Reads CLAUDE.md from current project
• Loads global settings from ~/.claude/CLAUDE.md
• Establishes fresh conversation context

Active Session

• Maintains conversation memory
• Can read, write, and modify files
• Remembers previous exchanges in current chat
• Limited by context window constraints

End

• When exiting (Ctrl+C, closing terminal, timeout)
• Conversation memory is cleared
• Project files and CLAUDE.md remain intact

After Session Ends

• Persists: Repository files, CLAUDE.md, package.json, configs
• Cleared: Conversation history, in-memory context
• Next session: Starts fresh with file-based context

Context Persistence

How Context Syncs

1. CLAUDE.md file - Primary method, stays in repository
2. Repository files - Source code, package.js