Tutorial de introducción a Claude Code

Claude Code es la herramienta de agente oficial de Anthropic a nivel de CLI.

El posicionamiento de Claude Code no es el chat, sino ejecutar tareas de ingeniería de alto nivel de permisos y con conciencia del contexto en el repositorio de código local.

Claude Code es un agente, no un chat.

Consulte el tutorial detallado en:https://www.example.com/claude-code/claude-code-tutorial.html

Capacidades principales:

  • Leer directamente todo el directorio del proyecto
  • Comprender la estructura real del código
  • Ejecutar modificaciones en múltiples archivos
  • Seguir estrictamente las instrucciones en lugar de complacer mediante la conversación

Instalación y configuración

MacOS/Linux:

curl -fsSL https://claude.ai/install.sh | bash

Homebrew (MacOS):

brew install --cask claude-code

Windows:

irm https://claude.ai/install.ps1 | iex

NPM:

Instalación con npm: asegúrese de que su sistema tenga Node.js instalado, con una versión v18 o superior.

npm install -g @anthropic-ai/claude-code

A continuación, puede entrar en el directorio del proyecto que haya creado y comenzar a usar Claude Code:

cd your-project
claude

Inicie sesión en su cuenta

Al usar el comando `claude` para iniciar una sesión interactiva, deberá iniciar sesión:

claude
# 首次使用时会提示您登录
/login
# 按照提示使用您的账户登录

Si puede usar una cuenta de Anthropic normalmente, puede comenzar a usarlo; si no, fuera de China puede usar DeepSeek o GLM, etc.


Conexión de DeepSeek a Claude Code

Después de instalar Claude Code, configuramos las siguientes variables de entorno en la terminal:

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

Descripción de parámetros:

  • CLAUDE_CODE_EFFORT_LEVEL: profundidad de razonamiento, opciones: low / medium / max
  • ANTHROPIC_MODEL: especifica usar el modelo deepseek-v4-pro[1m]
  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1: deshabilita tráfico no esencial

Luego entre en el directorio del proyecto y ejecute el comando `claude` para comenzar a usarlo.

cd my-project
claude

Documentación de referencia:https://api-docs.deepseek.com/zh-cn/guides/anthropic_api


Conexión de Alibaba Bailian a Claude Code

Los modelos de la serie Qwen de Tongyi de Alibaba Cloud Bailian son compatibles con la interfaz compatible con la API de Anthropic. Modificando los siguientes parámetros, puede invocar los modelos de la serie Qwen de Tongyi en Claude Code.

  • ANTHROPIC_API_KEY (o ANTHROPIC_AUTH_TOKEN): reemplácelo con la API Key de Bailian, dirección de solicitud:https://bailian.console.aliyun.com/cn-beijing/?tab=model#/api-key。

  • ANTHROPIC_BASE_URL: reemplácelo con la dirección del endpoint compatible de Bailianhttps://dashscope.aliyuncs.com/apps/anthropic。

  • Nombre del modelo: reemplácelo con el nombre del modelo compatible con Bailian (por ejemplo, qwen3-max, qwen3-coder-plus, etc.)

macOS/Linux:

Cree y abra el archivo de configuración~/.claude/settings.json。

~representa el directorio principal del usuario; si.claudeel directorio no existe, debe crearlo primero; puede ejecutar en la terminalmkdir -p ~/.claude para crearlo.

Edite el archivo de configuración:

vim ~/.claude/settings.json

Reemplace YOUR_API_KEY con su API Key exclusiva.

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3-coder-plus"
    }
}

Abra una nueva terminal para que la configuración de variables de entorno surta efecto.

Windows:

Ejecute el siguiente comando en CMD para configurar las variables de entorno:

setx ANTHROPIC_AUTH_TOKEN "YOUR_API_KEY"
setx ANTHROPIC_BASE_URL "https://dashscope.aliyuncs.com/apps/anthropic"
setx ANTHROPIC_MODEL "qwen3-coder-plus"

Reemplace YOUR_API_KEY con la API Key exclusiva del plan.

Abra una nueva ventana de CMD y ejecute el siguiente comando para verificar si las variables de entorno están activas.

echo %ANTHROPIC_AUTH_TOKEN%
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_MODEL%

Ejecute el siguiente comando en PowerShell para configurar las variables de entorno:

# 用套餐专属 API Key 替换 YOUR_API_KEY
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://dashscope.aliyuncs.com/apps/anthropic", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "qwen3-coder-plus", [EnvironmentVariableTarget]::User)

Abra una nueva ventana de PowerShell y ejecute el siguiente comando para verificar si las variables de entorno están activas.

echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_MODEL

Conexión de los modelos de la serie Qwen de Tongyi en Claude Code

Durante la conversación, ejecute/model <nombre del modelo>comando para cambiar de modelo.

/model qwen3-coder-plus

También puede crear en el directorio raíz del proyecto.claude/settings.jsonen el archivo, y escribir la información de configuración del modelo para una configuración permanente.

{
  "env": {
    "ANTHROPIC_MODEL": "qwen3-coder-plus",
    "ANTHROPIC_SMALL_FAST_MODEL": "qwen-flash"
  }
}

Al iniciar Claude, puede ver la información de configuración:


Conexión de los modelos grandes de Zhipu a Claude Code

En esta sección usamos el archivo ~/.claude/settings.json para configurar el modelo grande. Antes de comenzar, debe obtener la API key en la plataforma oficial:GLM Coding Plan。

Edite o agregue el archivo de configuración de Claude Code ~/.claude/settings.json, y agregue o modifique el campo env dentro de él.

# 注意替换里面的your_zhipu_api_key 为您上一步获取到的 API Key
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "your_zhipu_api_key",
        "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
        "API_TIMEOUT_MS": "3000000",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
    }
}

Ejecute `claude` para iniciar Claude Code e ingrese/statuspara confirmar el estado del modelo:

Si no es así, puede ingresar/configpara cambiar de modelo.

Cuando hay muchos modelos grandes, la configuración se vuelve engorrosa. Puede usar la herramienta de terceros CC Switch que nos ayuda a gestionar fácilmente las configuraciones de API de estas herramientas populares:https://github.com/farion1231/cc-switch/, compatible con Windows / macOS / Linux.

Direcciones de descarga de los paquetes de instalación para cada plataforma:https://github.com/farion1231/cc-switch/releases。


Instalación de Claude Code en VS Code

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

Abra VS Code, vaya al mercado de extensiones y busqueClaude Codee instale:

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

Así, si tiene una cuenta, puede usar /login para iniciar sesión:

También puede ingresar /config en el cuadro de diálogo para entrar en la configuración, y marcar la opción Disable Login Prompt para desactivar la página de inicio de sesión:


Referencia de comandos relacionados

Lista de comandos integrados de Claude Code

Comando Descripción
/add-dir Agregar un directorio de trabajo adicional
/agents Gestionar subagentes de IA dedicados
/bashes Listar y gestionar tareas en segundo plano
/bug Reportar errores (enviar la conversación a Anthropic)
/clear Borrar el historial de conversación
/compact [指令] Comprimir la conversación, con opción de agregar instrucciones clave
/config Abrir la interfaz de configuración (pestaña de configuración)
/context Visualizar el uso actual del contexto en una cuadrícula de colores
/cost Mostrar estadísticas de uso de tokens
/doctor Verificar el estado de salud de la instalación de Claude Code
/exit Salir del REPL
/export [文件名] Exportar la conversación actual a un archivo o portapapeles
/help Obtener ayuda de uso, mostrar todos los comandos disponibles
/hooks Gestionar la configuración de hooks de eventos de herramientas
/ide Gestionar las integraciones con IDE y mostrar el estado
/init Inicializar el proyecto con la guía CLAUDE.md
/install-github-app Configurar Claude GitHub Actions para el repositorio
/login Cambiar de cuenta de Anthropic
/logout Cerrar sesión de la cuenta de Anthropic
/mcp Gestionar conexiones de servidores MCP y autenticación OAuth
/memory Editar el archivo de memoria CLAUDE.md
/model Seleccionar o cambiar el modelo de IA
/output-style [样式] Configurar directamente el estilo de salida o seleccionarlo desde el menú de selección
/permissions Ver o actualizar permisos
/plugin Gestionar los plugins de Claude Code
/pr-comments Ver comentarios de PR
/privacy-settings Ver y actualizar la configuración de privacidad
/release-notes Ver las notas de la versión
/resume Restaurar conversación
/review Solicitar revisión de código
/rewind Revertir conversación y/o código
/sandbox Habilitar la herramienta bash en modo sandbox, con aislamiento de sistema de archivos y red
/security-review Realizar una revisión segura de los cambios pendientes en la rama actual
/status Abrir la interfaz de configuración (pestaña de estado), mostrando versión, modelo, cuenta y estado de conexión
/statusline Configurar la UI de la barra de estado de Claude Code
/terminal-setup Instalar el enlace de tecla Shift+Enter para nueva línea (solo en iTerm2 y VSCode)
/todos Listar las tareas pendientes actuales
/usage Mostrar los límites de uso del plan y el estado de límites de velocidad (solo planes de suscripción)
/vim Entrar en modo vim, alternando entre modo inserción y modo comando

Tipos de comandos personalizados

Tipo de comando Ubicación Descripción
Comandos de proyecto .claude/commands/ Almacenados en el repositorio, compartidos con el equipo
Comandos personales ~/.claude/commands/ Disponibles en todos los proyectos
Comandos de plugin Del plugincommands/Tabla de contenido Distribución a través del mercado de plugins
Comandos MCP Proporcionado por el servidor MCP Formato:/mcp__<服务器名>__<提示名>

Comandos de shell (fuera de la sesión)

Comando Descripción
claude Iniciar una sesión interactiva de Claude Code
claude -p "查询" Modo no interactivo: imprime el resultado y sale
claude --dangerously-skip-permissions Omitir todas las comprobaciones de permisos (modo peligroso)
claude --debug Habilitar el modo de depuración
claude --mcp-debug Modo de depuración de MCP
claude mcp add Añadir servidor MCP
claude mcp list Listar los servidores MCP configurados
claude mcp remove Eliminar servidor MCP

Funciones especiales

Soporte de comandos personalizados:

  • $ARGUMENTS- Capturar todos los parámetros
  • $1, $2, $3...- Acceder a parámetros posicionales individuales
  • @nombre de archivo- Referenciar el contenido de archivos
  • !comando- Ejecutar comandos bash e incluir la salida

Metadatos frontmatter del comando:

  • allowed-tools- Lista de herramientas que el comando puede utilizar
  • argument-hint- Descripción de las sugerencias de parámetros
  • description- Descripción breve del comando
  • model- Especificar el modelo
  • disable-model-invocation- Evitar llamadas a herramientas de SlashCommand

Para obtener más información relacionada, puede/helpconsultar la lista completa de comandos disponibles (incluidos sus comandos personalizados).


Recursos relacionados

Otras extensiones