La versión breve
- Empieza con un comando slash y los permisos mínimos necesarios.
- Superar una prueba de código no sustituye la comprobación del comando en Discord.
Una skill de bots de Discord para Claude debe guiar al agente hasta una función que realmente funcione: definir el comando, crear la aplicación de Discord, solicitar los permisos mínimos, guardar el token en secreto y probarlo en un servidor que controles. Una lista de comprobaciones que obligue a Claude a verificar el comando en Discord resulta más útil que una carpeta de fragmentos genéricos.
Empieza con un comando y sus permisos
Imagina que una comunidad quiere que /resources topic:design devuelva un enlace seleccionado. Anota quién puede ejecutarlo, dónde debe responder, si la respuesta puede ser pública y dónde se guardan los enlaces. Con eso puedes construir y probar un recorrido completo mínimo. Pedir «crea un bot para la comunidad» deja sin resolver los permisos, el tratamiento de datos y los criterios de éxito.
La guía de inicio rápido de Discord explica la aplicación, el usuario del bot, las credenciales y el proceso de instalación. Consulta la guía vigente al configurar la aplicación, porque los ajustes del portal y los nombres de los permisos pueden cambiar. La documentación de comandos de aplicación explica la estructura de los comandos slash y el tratamiento de interacciones.
Decisión | En el ejemplo | Por qué importa |
|---|---|---|
Comando |
| Un comportamiento verificable en lugar de una lista imprecisa de funciones |
Instalación | Primero, un servidor de prueba | Permite comprobar cambios sin afectar a todos los servidores |
Permisos | Solo los necesarios para enviar la respuesta | Reduce las formas en las que un error puede afectar al servidor |
Datos | Enlaces seleccionados, sin crear perfiles de usuarios | Evita recopilar contenido que el comando no necesita |
Fallo | Error efímero útil cuando el tema no existe | El usuario sabe qué puede probar después |
Instala un método de trabajo y construye dentro del proyecto
Claude Code puede cargar las instrucciones de una skill según su documentación de skills. Instala la skill Discord Bot Builder para preparar el encargo, revisar los permisos y seguir la lista de pruebas. Proporciona a Claude los archivos existentes y el destino de alojamiento. La skill debe adaptarse al lenguaje y al framework del proyecto, sin sustituirlos por defecto.
Guarda el token del bot en una variable de entorno o un almacén de secretos. No lo pegues en el chat, en un archivo de código ni en un paquete para el navegador. Si se ha expuesto, rótalo en el portal de desarrolladores de Discord y actualiza el secreto del despliegue. Pide a Claude que muestre un .env.example con los nombres de las variables, sin sus valores.
Para un bot basado en comandos, considera los comandos de aplicación antes de leer todos los mensajes de un servidor. Solicita un intent privilegiado solo cuando la función lo necesite y la aplicación esté configurada para usarlo. Concede los ámbitos de instalación y los permisos mínimos que permitan su comportamiento real.
Pide a Claude que demuestre el primer recorrido
A useful build prompt is: “In this Node project, implement one Discord slash command, /resources topic, using the existing stack. Return one curated link for design and a clear response for unknown topics. Use environment variables for credentials, ask for only the scopes and permissions this command needs, register it in my test guild, and add tests for valid input and missing configuration. Show the exact manual guild checks before calling it complete.”
Claude puede escribir los archivos y las pruebas, pero superar una prueba unitaria no demuestra que el comando esté registrado, instalado y respondiendo en Discord. Pruébalo en un servidor que controles. Ejecútalo como usuario autorizado, con un tema desconocido y cuando al bot le falte un permiso. Registra el resultado observado y corrige la configuración o el código que falle.
Despliega sin perder el control del bot
Guarda las credenciales en los ajustes de secretos del proveedor y define un procedimiento de reinicio. Registra los nombres de los comandos, las categorías de error y los identificadores útiles de las peticiones; evita registrar tokens y mensajes privados. Documenta cómo desactivar el bot, rotar su token y actualizar los comandos registrados. Si guarda datos de usuarios, especifica cuáles, para qué y durante cuánto tiempo.
El primer despliegue está terminado cuando el comando funciona en el servidor previsto y el equipo puede repetir la configuración a partir de instrucciones escritas. Después, añade las funciones una a una y revisa los permisos cuando alguna necesite más acceso.
Preguntas frecuentes
¿Un bot de comandos slash necesita leer todos los mensajes?
No. Un comando como /resources puede responder a su propia interacción. Si una función posterior requiere leer mensajes u otro intent privilegiado, define esa función, confirma el requisito actual de Discord y actualiza la configuración de forma deliberada. No solicites acceso amplio como atajo.
¿Qué debo proporcionar a Claude antes de empezar?
Proporciona el repositorio existente, el entorno de ejecución, la especificación de un comando, un servidor de prueba, el destino de alojamiento y los permisos que quieras conceder. Facilita los nombres de las variables de credenciales, sin los tokens. Pide que informe de lo probado en el código y de lo que aún requiere una comprobación manual en Discord.
Llévalo a la práctica
Tu siguiente paso
¿Tienes una pregunta o una corrección?
Contactar con Thrive
