Comandos de barra diagonal / de Claude Code

Los comandos de barra diagonal (slash)/son la entrada de control rápido de las sesiones interactivas de Claude Code;al escribirinstrucciones que comiencen con /,/se pueden invocar rápidamente funciones, gestionar sesiones y personalizar flujos de trabajo.

Ver todos los comandos disponibles:

/help

/helpSe listarán todos los comandos integrados, los comandos personalizados del proyecto actual (Skills / Commands) y los comandos expuestos por los servidores MCP conectados.

Tipos de comandos:

Prioridad de comandos (cuando hay nombres duplicados): nivel empresarial > nivel personal > nivel de proyecto > integrado

1. Comandos de barra diagonal integrados de uso común

Los comandos integrados son funciones principales que vienen con Claude Code y se pueden usar directamente escribiéndolos. Los principiantes deben dominar primero estas categorías de comandos de alta frecuencia:

Comandos de operaciones básicas

Por ejemplo, usamos el/helpcomando /help para ver la información de ayuda;Tabla tecla Tab permite alternar menús;Escy /exit para salir:

Comandos de gestión de sesiones

Contexto y memoria

Proyecto y configuración

Modelo y salida

Tabla comparativa de modelos disponibles (2026):

Código y herramientas

Integración y extensiones

/pluginDetalle de subcomandos:

Estadísticas y cuenta

2. Skills integradosNEW

Los Skills integrados son flujos de trabajo de IA preconfigurados incluidos con Claude Code; a diferencia de los comandos integrados, cargan un prompt detallado y Claude los ejecuta mediante razonamiento, produciendo resultados de análisis y operación más ricos. De la misma manera,/se activan.

3. Sintaxis del prefijo de comando

!Ejemplos de uso de prefijos:

> ! ls
> !git log --oneline -10
> !npm test -- --coverage
> !cat logs/error.log | tail -50

@Ejemplos de uso de prefijos:

> 对比 @src/auth/v1.ts 和 @src/auth/v2.ts 的实现差异
> 审查 @src/api/users.ts 中的错误处理逻辑是否完善

4. Skills personalizados (nuevo formato recomendado)

Los Skills son el formato de nueva generación para comandos personalizados, que reemplaza a la versión anterior.claude/commands/. Ambos formatos funcionan correctamente, pero en proyectos nuevos se recomienda usar Skills directamente.

Comparación entre Skills y Commands

Pasos para crear un Skill

Paso 1: crear la estructura de directorios

Los Skills personalizados se dividen en dos tipos, con diferentes ubicaciones de almacenamiento:

• Skill de proyecto: solo es efectivo en el proyecto actual, compartido por el equipo → directorio:.claude/skills/<名称>/
• Skill personal: común a todos los proyectos, para uso propio → directorio:~/.claude/skills/<名称>/

# 创建项目级 Skill（团队共享，纳入 git）
mkdir -p .claude/skills/optimize

# 创建个人级 Skill（跨项目通用，本地私有）
mkdir -p ~/.claude/skills/fix-bug

Paso 2: escribir SKILL.md

Crear un nuevoSKILL.mdarchivo: escribir la configuración en el frontmatter YAML y el prompt en el cuerpo de Markdown de abajo.nameEl campo define el nombre del comando de activación.

Ejemplo: crear un Skill de optimización del rendimiento de código

---
name: optimize
description: 分析代码性能瓶颈，给出优化建议。当用户提到性能问题时自动触发。
allowed-tools: Read, Grep, Glob
argument-hint: [目标文件或目录]
model: claude-sonnet-4-6
---

分析以下代码的性能瓶颈，给出具体的优化建议，优先考虑时间复杂度和内存占用：
$ARGUMENTS

Para usarlo, ingresa:

/optimize src/utils/data-processor.ts

Organización de espacios de nombres en subdirectorios

Se puede.claude/skills/organizar en subdirectorios según la función; el nombre del directorio es el nombre del comando:

.claude/skills/
├── optimize/            → /optimize
│   ├── SKILL.md
│   └── examples/        # 可选：示例文件辅助 Claude 理解
├── debug/               → /debug
│   ├── SKILL.md
│   └── scripts/         # 可选：辅助脚本
└── commit/              → /commit
    └── SKILL.md

5. Comandos de barra diagonal personalizados (formato antiguo, compatible)

Si hayprompts que se reutilizan(por ejemplo, requisitos fijos de revisión de código o plantillas de instrucciones repetitivas), puedes convertirlos en comandos personalizados e invocarlos con un solo clic.

Ubicación de almacenamiento de los archivos de comandos:

Sintaxis de parámetros:

Principio fundamental

Los comandos personalizados son esencialmentearchivos de texto Markdown—el nombre del archivo es el nombre del comando, el contenido del archivo es el prompt que se ejecutará; admite pasar parámetros y llamar comandos Bash.

Pasos para crear comandos personalizados

Paso 1: Crear el directorio de almacenamiento de comandos

Hay dos tipos de comandos personalizados, con ubicaciones de almacenamiento diferentes:

• Comandos de proyecto: solo efectivos en el proyecto actual, compartidos por el equipo → Directorio:.claude/commands/
• Comandos personales: comunes a todos los proyectos, de uso personal → Directorio:~/.claude/commands/

Tomando como ejemplo la creación de un comando de proyecto, primero cree el directorio:

# 在项目根目录执行
mkdir -p .claude/commands

Paso 2: Escribir el archivo de comando Markdown

Cree un.mdarchivo; el nombre del archivo es el nombre del comando (por ejemplooptimize.md→ comando/optimize), y escriba el prompt en el contenido del archivo.

Ejemplo: Crear un comando de optimización de rendimiento de código

# 写入提示词到文件
echo "分析这段代码的性能瓶颈，给出具体的优化建议，优先考虑时间复杂度和内存占用：" > .claude/commands/optimize.md

Ahora, en la sesión, escriba/optimize, luego pegue el código, ¡y Claude hará el análisis de rendimiento según lo que pidió!

Truco avanzado: añadir parámetros a los comandos

Los comandos pueden llevar parámetros, usando$ARGUMENTS(captura todos los parámetros) o$1 $2(toma parámetros por posición).

Ejemplo: Comando de corrección de bugs con parámetros

Cree el archivo de comando.claude/commands/fix-issue.md：

修复 Issue #$ARGUMENTS，要求：
1. 符合项目编码规范
2. 附上测试用例
3. 说明修复思路

Uso del comando:

/fix-issue 123  # $ARGUMENTS 会被替换成 "123"

6. Referencia de campos de Frontmatter

Tanto en los archivos de comando personalizados (commands/*.md) como en Skills (skills/*/SKILL.md) se puede agregar YAML Frontmatter en la parte superior para una configuración precisa:

---
name: commit                          # Skills 中必填；命令文件中可选（默认取文件名）
allowed-tools: Bash(git add:*), Bash(git commit:*), Read, Edit
argument-hint: [commit-message]
description: 检查代码质量后提交
model: claude-haiku-4-5-20251001
context: fork
agent: general-purpose
disable-model-invocation: false
user-invocable: true
hooks:
  PreToolUse:
    - matcher: "Bash"
      hooks:
        - type: command
          command: "./scripts/validate.sh"
          once: true
---

Descripción de los campos

allowed-toolsEjemplo de escritura

Momento de activación de los Hooks

7. Comandos de plugins y MCP

Además de escribirlos tú mismo, también puedes obtener más comandos de extensión a través depluginsyservidores MCP.

Formato de nomenclatura:

/mcp__<服务器名>__<命令名> [参数]

Ejemplos de comandos MCP de uso común

Ver todos los comandos MCP disponibles:/help(Los comandos MCP se muestran en un grupo separado al final de la lista de ayuda)

1. Comandos de plugins

Después de instalar un plugin de Claude Code, se agregan automáticamente comandos exclusivos del plugin, normalmente con el formato:

/plugin-name:command-name  # 避免命令名冲突

Por ejemplo, después de instalar el plugin de Git, podría haber un/git:commitcomando para generar mensajes de commit estandarizados con un solo clic.

2. Comandos MCP

Los servidores MCP (Protocolo de Contexto del Modelo) pueden convertir las funciones de herramientas externas (como GitHub, Jira) en comandos de barra, formato:

/mcp__<服务器名>__<功能名> [参数]

Ejemplo:

/mcp__github__list_prs  # 列出 GitHub 仓库的 PR
/mcp__jira__create_issue "登录按钮失效" high  # 在 Jira 创建高优先级问题

8. Biblioteca de plantillas de comandos útiles

Vista general de plantillas

Commit inteligente de Git:

<!-- .claude/commands/commit.md -->
---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git diff:*), Bash(git commit:*)
argument-hint: [commit-message]
description: 检查代码质量后提交
model: claude-haiku-4-5-20251001
---

## 暂存区内容
!`git diff --cached`

提交前检查以下问题，发现问题则报告并询问是否继续：
1. 遗留的 `console.log` / `print` 调试语句
2. 未处理的 `TODO` / `FIXME` 注释
3. 大段被注释掉的代码
4. 测试文件中的 `.only` / `.skip` 标记

若无问题，使用以下信息提交：$ARGUMENTS

Revisión de código de PR:

<!-- .claude/commands/pr-review.md -->
---
allowed-tools: Read, Grep, Glob, Bash(git diff:*), Bash(git log:*)
description: 全面的 PR 代码审查
---

## 变更文件
!`git diff --name-only HEAD~1`

## 详细差异
!`git diff HEAD~1`

## 近期提交
!`git log --oneline -5`

按 Critical / Major / Minor 三级优先级输出审查结果，涵盖：
代码逻辑与可读性、安全漏洞、性能隐患（N+1 查询）、测试覆盖率、文档完整性

Ejecución inteligente de pruebas:

<!-- .claude/commands/test.md -->
---
allowed-tools: Bash, Read, Edit
argument-hint: [test-pattern]
description: 运行测试并自动修复失败用例
---

运行匹配 "$ARGUMENTS" 的测试：
1. 自动检测测试框架（Jest / pytest / Go test）
2. 运行指定模式的测试
3. 若有失败，分析根因并修复代码
4. 重新运行验证修复

不提供参数则运行全量测试并输出覆盖率报告。

Escaneo de vulnerabilidades de seguridad:

<!-- .claude/commands/security-scan.md -->
---
allowed-tools: Read, Grep, Glob
description: OWASP Top 10 安全漏洞扫描
model: claude-opus-4-6
---

以安全工程师视角审查代码库：

高危：SQL 注入、XSS、命令注入、硬编码密钥
中危：不安全的反序列化、过时依赖、敏感信息写入日志、CORS 配置过宽
低危：缺失安全响应头、错误信息暴露内部细节

输出格式：漏洞位置 + 危险级别 + 修复建议代码示例

Generación de documentación de API:

<!-- .claude/commands/api-docs.md -->
---
allowed-tools: Read, Glob, Edit
argument-hint: [输出文件路径]
description: 自动生成 REST API 文档
---

扫描 @src/routes/ 和 @src/controllers/，为所有端点生成 Markdown 文档：
- 端点路径与 HTTP 方法
- 请求参数（Query / Body / Path）及类型
- 响应结构（成功与错误）
- 认证要求
- curl 调用示例

保存到：$ARGUMENTS（默认：docs/api.md）

Refactorización de código:

<!-- .claude/commands/refactor.md -->
---
allowed-tools: Read, Edit, Glob
argument-hint: [目标文件或目录]
description: 代码质量重构
---

对 $ARGUMENTS 进行重构，遵循原则：
- 可读性：变量/函数命名语义化，消除魔法数字
- DRY 原则：提取重复逻辑为复用函数
- 单一职责：拆分超过 50 行的函数
- 错误处理：完善异常捕获和错误边界
- TypeScript：消除 `any` 类型，补全类型注解

重构前先输出变更计划，确认后再执行。

Verificación de enlaces de documentación:

<!-- .claude/commands/check-links.md -->
---
allowed-tools: Read, Bash, WebFetch
argument-hint: [文档文件路径]
description: 检查文档中的链接是否全部有效
model: claude-haiku-4-5-20251001
---

读取 $ARGUMENTS 文件，提取所有超链接（http/https），逐一请求并检查响应状态码。

输出格式：
- 有效链接（200）
- 重定向链接（3xx）及目标地址
- 失效链接（4xx/5xx）及建议替代链接

最后输出汇总：共 N 个链接，M 个失效。

Anexo: Explicación de los archivos de configuración