OpenCode: OpenCode Built-in Tools

Última atualização: 2026-08-31

--- title: Ferramentas Integradas do OpenCode description: Compreenda o sistema de ferramentas integradas incluindo operações de arquivos, execução Shell e busca order: 11 lang: pt-br

O poder do OpenCode vem do seu sistema de ferramentas integradas — a IA chama ferramentas para executar operações específicas.

1. O Que Você Vai Aprender

Visão geral das ferramentas integradas
Ferramentas de operação de arquivos
Ferramenta de execução Shell
Ferramentas de busca e análise
Configuração e permissões de ferramentas

2. Visão Geral das Ferramentas Integradas

Ferramenta	Função	Nível de Permissão
`read`	Ler conteúdo de arquivo	Somente leitura
`write`	Escrever/criar arquivos	Escrita
`edit`	Editar/patch arquivos	Escrita
`bash`	Executar comandos Shell	Execução
`grep`	Buscar conteúdo de arquivos	Somente leitura
`glob`	Encontrar arquivos por padrão	Somente leitura
`list`	Listar conteúdo de diretório	Somente leitura
`webfetch`	Obter conteúdo web	Rede
`task`	Chamar sub-agente	Agente

3. Ferramentas de Operação de Arquivos

read: A IA lê automaticamente arquivos do projeto para contexto
write: Criar novos arquivos ou sobrescrever existentes
edit: Modificar precisamente conteúdo usando busca+substituição

4. Ferramenta de Execução Shell

Execute qualquer comando Shell:

TEXT 📖 Somente leitura

Execute npm test e analise os testes falhando

A IA: executa o comando → analisa erros → identifica problemas → sugere correções → pode modificar o código diretamente.

5. Ferramentas de Busca e Análise

grep: Buscar conteúdo em arquivos do projeto
glob: Encontrar arquivos por padrões de nome
list: Listar estrutura de diretórios

6. Configuração de Ferramentas

Interruptores globais:

JSON

{
  "tools": {
    "write": true,
    "edit": true,
    "bash": true,
    "webfetch": false
  }
}

Nível de agente:

JSON

{
  "agent": {
    "review": {
      "tools": { "write": false, "edit": false }
    }
  }
}

Valores de permissão: `allow` (automático), `ask` (confirmar), `deny` (rejeitar)

❓ FAQ

P: Como impedir a IA de executar operações perigosas?

R: Configure bash como ask ou deny. Use padrões Glob para controle fino: permita git status, negue rm -rf.

P: A IA fez modificações erradas?

R: Use /undo imediatamente. Recomendamos configurar edit e write como ask para confirmação antes de mudanças.

P: Alice permite todas as ferramentas, Bob só permite somente leitura. Quem está mais seguro?

R: Bob. Configuração somente leitura impede qualquer modificação pela IA — ideal para revisão de código. Alice é mais eficiente mas mais arriscada.

📖 Resumo

Ferramentas integradas: read, write, edit, bash, grep, glob, list, webfetch, task
Níveis de permissão: allow, ask, deny
Configurável em nível global e por agente
Permissões bash suportam padrões Glob
Expanda mais ferramentas via MCP

📝 Exercícios

Básico: Configure permissões de ferramentas no opencode.json, defina edit como ask.
Intermediário: Crie um agente somente leitura com todas as ferramentas de escrita/execução desabilitadas.
Avançado: Use padrões Glob para permitir operações git mas negar rm e outros comandos perigosos.

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós