Inicialización de Proyectos de Claude Code

La inicialización de proyectos de Claude Code se puede introducir en la interfaz interactiva de Claude Code:

/init

Podemos inicializar en un directorio de proyecto existente, o crear uno nuevo.

Primero podemos crear un directorio:

mkdir claude-ejemplo-test

Entrar en ese directorio:

cd claude-ejemplo-test

Crear un archivo de prueba test.py, con el siguiente código:

print("Hello, Ejemplo!")

Entrar en la interfaz interactiva de Claude Code:

claude

Usar/init el comando para inicializar el proyecto:

/init

Si se usa VS Code, también se puede introducir en la interfaz de Claude Code dentro de VS Code/init:

Claude escaneará automáticamente tu código: leerá package.json, la documentación existente, los archivos de configuración y la estructura del código, y luego generará un archivo CLAUDE.md exclusivo para tu proyecto.

Claude Todo el proceso no requiere operación manual; Claude analizará por sí mismo y generará la configuración inicial.

Archivo CLAUDE.md

CLAUDE.md es un archivo Markdown ubicado en el directorio raíz del proyecto, que Claude Code lee automáticamente al inicio de cada sesión.

CLAUDE.md pasa a formar parte del prompt del sistema de Claude, de modo que cada conversación precarga el contexto del proyecto sin necesidad de explicar repetidamente la información básica.

Un buen CLAUDE.md debe cubrir tres dimensiones:

  • QUÉ (qué es): stack tecnológico, estructura del proyecto; proporciona a Claude un mapa global del código base.
  • POR QUÉ (por qué): el propósito del proyecto, las funciones y el posicionamiento de cada módulo.
  • CÓMO (cómo hacerlo): la forma de desarrollo, por ejemplo, usar bun en lugar de node, y cómo Claude verifica si los cambios son correctos Humanlayer.

A continuación se muestra un ejemplo de estructura típica de CLAUDE.md:

# 项目名称

## 项目概述
简述这个项目的目的和功能。

## 技术栈
- Frontend: React + TypeScript
- Backend: Node.js + Express
- Database: PostgreSQL

## 目录结构
- `src/components/` - React 组件
- `src/api/`        - API 层
- `tests/`          - 测试文件

## 常用命令
- 启动开发服务器：`pnpm dev`
- 运行测试：`pnpm test`
- 代码检查：`pnpm lint`

## 开发规范
- 使用 TypeScript strict 模式
- 优先使用 interface 而非 type
- 禁止使用 any，使用 unknown 替代
```

### 文件位置与层级

项目的核心文件结构如下： 
```
your-project/
├── CLAUDE.md                  # 项目主记忆文件（团队共享）
├── .claude/
│   ├── settings.json          # Hooks、权限、环境配置
│   ├── settings.local.json    # 个人配置（建议加入 .gitignore）
│   └── commands/              # 自定义斜杠命令
│       └── my-command.md
└── .mcp.json                  # MCP 服务配置
```

Mejores prácticas después de la inicialización

Iteración y optimización, en lugar de escribirlo todo de una vez y dejarlo fijo.

/initEl comando sirve para una introducción rápida, pero el verdadero valor proviene de iterar continuamente con el tiempo. Se puede complementar con contenido que Claude no puede inferir automáticamente, como las convenciones de nombres de ramas, los procesos de despliegue y los requisitos de Code Review; también se deben eliminar las sugerencias genéricas que no sean aplicables.

  • Enviar al control de versiones: envíaCLAUDE.mdel archivo a Git, de modo que todo el equipo pueda beneficiarse; los nuevos miembros pueden ponerse al día rápidamente haciendo que Claude les explique el código base.

  • Mantenerlo conciso: el contenido debe ser conciso y de aplicación general. Adopta el principio de "divulgación progresiva": no metas todo lo que quieres que Claude sepa, sino dilecómo encontrar información importante, para que la consulte según sea necesario y evitar desbordar la ventana de contexto.

  • No dejes que CLAUDE.md reemplace al linter: escribir normas de estilo de código en el archivo es uno de los errores más comunes. Nunca uses un LLM para hacer el trabajo del linter: el linter es más rápido, más barato y determinista. Las restricciones de estilo de código solo inflan la ventana de contexto y reducen la calidad del cumplimiento de instrucciones de Claude.

Uso#Atajos de teclado actualizados continuamente

En la conversación, usa en cualquier momento#el prefijo para enviar instrucciones de memoria a Claude:

# 我们始终使用 pnpm，不用 npm
# 所有组件必须包含单元测试

Estas adiciones se acumularán gradualmente, formando un documento que refleje la forma de trabajo real del equipo.CLAUDE.md。

Verificar el resultado de la inicialización

Una vez completada la inicialización, puedes confirmar si Claude entendió correctamente el proyecto mediante los siguientes diálogos:

  • ¿Qué hace este proyecto?
  • Explica la estructura de directorios.
  • ¿Qué tecnologías utiliza el proyecto?
  • ¿Cuál es el comando para ejecutar las pruebas?
Otras extensiones