Primer uso de Claude Code

Una vez instalado Claude Code y configurada la API, podemos empezar a usarlo.

A continuación, usaremos un proyecto de ejemplo muy sencillo para completar el primer uso.

Crea un proyecto de ejemplo:

mkdir ejemplo-claude-demo
cd ejemplo-claude-demo

Crea un archivo simple:

touch main.py

Escribe el siguiente contenido:

def add(a, b):
    return a + b

Haz que Claude Code explique el código

Ejecuta en el directorio del proyecto:

claude

Luego introduce:

解释 main.py 这个文件在做什么,用新手能理解的方式说明

Claude leerá el código del directorio actual y dará una explicación.

Haz que Claude Code te ayude a modificar el código

Continúa escribiendo en la sesión de Claude:

Agrega anotaciones de tipo a esta función y añade manejo de errores básico.

Claude dará sugerencias de modificación, que normalmente incluyen:

  • El código modificado
  • Explicación del motivo del cambio

Puedes elegir:

  • Aplicar directamente
  • Ajustar manualmente
  • Rechazar la modificación


Formas básicas de interacción con Claude Code

Tipos de instrucciones comunes

Puedes dividir las instrucciones para Claude Code en tres categorías:

1. Explicativas

Explica este código.

¿Por qué está escrita esta función de esta manera?

2. De modificación

Ayúdame a refactorizar esta función.

Divídela en varias funciones pequeñas.

3. De generación

Agrega un caso de prueba.

Agrega salida de logs.

Una plantilla de instrucción simple pero útil:

在不改变现有行为的前提下,
帮我优化 XXX 文件的可读性,
并说明你做了哪些修改。

Preguntas frecuentes: reparar permisos de directorio

Si usas Mac o Linux, presta atención a si tienes permiso para ejecutar. Si aparece un error similar al siguiente, es que no tienes permisos suficientes:

Error: EACCES: permission denied, open

Abre la terminal y ejecuta el siguiente comando:

# 1. 修复 .claude 目录的所有权
sudo chown -R $(whoami) ~/.claude

# 2. 修复目录权限(给予读写执行权限)
chmod -R 755 ~/.claude

# 3. 确保 projects 目录可写
chmod -R 755 ~/.claude/projects

Verifica la reparación:

# 检查权限
ls -la ~/.claude/

Usar Claude Code en VS Code

Si no te gusta usar el modo de línea de comandos de Claude Code, podemos instalar Claude Code en el editor VS Code.

Abre VS Code, ve al mercado de extensiones y buscaClaude CodeInstalar:

Una vez completada la instalación, haz clic en el icono de Claude Code en la esquina superior derecha para acceder a la página de Claude Code:

A continuación, puedes usarlo en el cuadro de diálogo:

Otras extensiones