Claude Code 的 Python 專案 CLAUDE.md 範本可直接複製使用
El CLAUDE.md perfecto para proyectos Python (plantilla lista para copiar)
文章提供一份可直接複製的 Python 專案 CLAUDE.md 範本，供 Claude Code 在每次工作開始時讀取專案規則。範本涵蓋 uv、pytest、ruff 和 mypy 命令、公開函式的型別提示、先寫測試的流程，以及不得使用無類型 except 或提交 .env、data/raw/ 等規則。
CLAUDE.md es el archivo que Claude Code lee al empezar cada sesión. Es tu oportunidad de decirle cómo se trabaja en tu proyecto, para no repetirlo cada vez.
El error típico es llenarlo de prosa. Lo que funciona: comandos exactos, convenciones concretas y prohibiciones claras.
Plantilla
# CLAUDE.md — Proyecto Python
## Entorno
- Gestor: `uv`
- Ejecutar: `uv run python -m paquete`
- Tests: `uv run pytest -q` (uno: `uv run pytest tests/test_x.py::test_y`)
- Formato y lint: `uv run ruff format . && uv run ruff check --fix .`
- Tipos: `uv run mypy src/`
## Convenciones
- Type hints en toda función pública.
- `pathlib` en vez de `os.path`.
- `logging.getLogger(__name__)`, nunca `print` en código de librería.
## Flujo
1. Escribe o ajusta el test primero.
2. Implementa.
3. ruff + mypy + pytest antes de dar la tarea por terminada.
## No hacer
- No usar `except:` sin tipo.
- No commitear `.env` ni `data/raw/`.
Por qué funciona
-
Comandos copiables: Claude no tiene que adivinar si usas
pip,poetryouv. - El comando para un solo test le ahorra ejecutar toda la suite en cada cambio.
- "No hacer" previene los errores que más te molestan.
Extra: CLAUDE.md por carpetas
Puedes tener un CLAUDE.md en subcarpetas (por ejemplo tests/CLAUDE.md) con reglas locales. Claude lo carga cuando trabaja con archivos de esa carpeta.
Mantenlo corto: si pasa de ~100 líneas, probablemente algo debería ser una skill.
¿Te sirvió? Los hooks de seguridad están gratis en GitHub. Si quieres todo listo (6 skills, 4 comandos, 5 plantillas CLAUDE.md, hooks e instalador), está el Kit Claude Code en Español: paga lo que quieras, desde 1 USD.
來源：DEV Community · dev.to