Claude Code Reference

v2.1.178 · 87 auto-discovered · Commands, shortcuts, hooks, Python/AWS tips.

Python Development

Auto-activate venv

VS Code setting claudeCode.usePythonEnvironment: true activates your workspace Python env automatically.

CLAUDE.md for Python

Document your Python version, venv path, test command (pytest), linter (ruff), type checker (mypy), and key directories.

FastAPI/Django

Claude understands these frameworks well. Describe your routes, models, and serialization patterns in CLAUDE.md.

Poetry/pipenv

Claude can run poetry/pipenv commands. Make sure they are in PATH.

Data science

Include data format, expected shape/columns, preprocessing steps in your prompts or CLAUDE.md.

Example CLAUDE.md for a Python/AWS project

# Project Context

## Stack
- Python 3.11, FastAPI, SQLAlchemy
- AWS: ECS Fargate, RDS Postgres, S3, Lambda
- Docker, Terraform (infra/)
- pytest, ruff, mypy

## Commands
- Run tests: `pytest tests/ -v`
- Lint: `ruff check src/`
- Type check: `mypy src/`
- Deploy: `./scripts/deploy.sh staging`

## Key Directories
- src/api/ — FastAPI route handlers
- src/models/ — SQLAlchemy models
- src/services/ — Business logic
- infra/ — Terraform configs
- tests/ — Test suites

## Conventions
- Use functional approach, no classes for services
- All API responses use Pydantic response models
- Write tests for all new endpoints
- Follow Conventional Commits