Herramientas
Las herramientas permiten que LLM realice acciones en su código base. OpenCode viene con un conjunto de herramientas integradas, pero puede ampliarlo con herramientas personalizadas o servidores MCP.
De forma predeterminada, todas las herramientas están habilitadas y no necesitan permiso para ejecutarse. Puede controlar el comportamiento de la herramienta a través de permisos.
Utilice el campo permission para controlar el comportamiento de la herramienta. Puede permitir, denegar o exigir aprobación para cada herramienta.
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"edit": "deny",
"bash": "ask",
"webfetch": "allow"
}
}También puedes utilizar comodines para controlar varias herramientas a la vez. Por ejemplo, para solicitar aprobación para todas las herramientas de un servidor MCP:
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"mymcp_*": "ask"
}
}Más información sobre la configuración de permisos.
Aquí están todas las herramientas integradas disponibles en OpenCode.
Ejecute comandos de shell en el entorno de su proyecto.
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"bash": "allow"
}
}Esta herramienta permite que LLM ejecute comandos de terminal como npm install, git status o cualquier otro comando de shell.
Modifique archivos existentes utilizando reemplazos de cadenas exactas.
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"edit": "allow"
}
}Esta herramienta realiza ediciones precisas de archivos reemplazando coincidencias de texto exactas. Es la forma principal en que LLM modifica el código.
Cree nuevos archivos o sobrescriba los existentes.
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"edit": "allow"
}
}Utilice esto para permitir que LLM cree nuevos archivos. Sobrescribirá los archivos existentes si ya existen.
Lea el contenido del archivo desde su base de código.
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"read": "allow"
}
}Esta herramienta lee archivos y devuelve su contenido. Admite la lectura de rangos de líneas específicos para archivos grandes.
Busque contenidos de archivos utilizando expresiones regulares.
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"grep": "allow"
}
}Búsqueda rápida de contenido en su base de código. Admite sintaxis de expresiones regulares completa y filtrado de patrones de archivos.
Encuentre archivos por coincidencia de patrones.
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"glob": "allow"
}
}Busque archivos usando patrones globales como **/*.js o src/**/*.ts. Devuelve rutas de archivos coincidentes ordenadas por hora de modificación.
Interactúe con sus servidores LSP configurados para obtener funciones de inteligencia de código como definiciones, referencias, información de desplazamiento y jerarquía de llamadas.
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"lsp": "allow"
}
}Las operaciones admitidas incluyen goToDefinition, findReferences, hover, documentSymbol, workspaceSymbol, goToImplementation, prepareCallHierarchy, incomingCalls y outgoingCalls.
Para configurar qué servidores LSP están disponibles para su proyecto, consulte Servidores LSP.
Aplicar parches a los archivos.
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"edit": "allow"
}
}Esta herramienta aplica archivos de parche a su código base. Útil para aplicar diferencias y parches de diversas fuentes.
Cargue una habilidad (un archivo SKILL.md) y devuelva su contenido en la conversación.
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"skill": "allow"
}
}Obtener contenido web.
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"webfetch": "allow"
}
}Permite que LLM busque y lea páginas web. Útil para buscar documentación o investigar recursos en línea.
Busque información en la web.
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"websearch": "allow"
}
}Realiza búsquedas web utilizando Exa AI para encontrar información relevante en línea. Útil para investigar temas, encontrar eventos actuales o recopilar información más allá del límite de datos de entrenamiento.
No se requiere ninguna clave API: la herramienta se conecta directamente al servicio MCP alojado de Exa AI sin autenticación.
Haga preguntas al usuario durante la ejecución.
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"question": "allow"
}
}Esta herramienta permite que LLM haga preguntas al usuario durante una tarea. Es útil para:
- Recopilar preferencias o requisitos del usuario.
- Aclarar instrucciones ambiguas
- Tomar decisiones sobre las opciones de implementación.
- Ofrecer opciones sobre qué dirección tomar.
Cada pregunta incluye un encabezado, el texto de la pregunta y una lista de opciones. Los usuarios pueden seleccionar entre las opciones proporcionadas o escribir una respuesta personalizada. Cuando hay varias preguntas, los usuarios pueden navegar entre ellas antes de enviar todas las respuestas.
Las herramientas personalizadas le permiten definir sus propias funciones a las que LLM puede llamar. Estos están definidos en su archivo de configuración y pueden ejecutar código arbitrario.
Más información sobre la creación de herramientas personalizadas.
Los servidores MCP (Model Context Protocol) le permiten integrar herramientas y servicios externos. Esto incluye acceso a bases de datos, integraciones API y servicios de terceros.
Más información sobre la configuración de servidores MCP.
Internamente, herramientas como grep y glob usan ripgrep bajo el capó. De forma predeterminada, ripgrep respeta los patrones .gitignore, lo que significa que los archivos y directorios enumerados en su .gitignore se excluirán de las búsquedas y listados.
Para incluir archivos que normalmente se ignorarían, cree un archivo .ignore en la raíz de su proyecto. Este archivo puede permitir explícitamente ciertas rutas.
!node_modules/
!dist/
!build/Por ejemplo, este archivo .ignore permite que ripgrep busque dentro de los directorios node_modules/, dist/ y build/ incluso si figuran en .gitignore.