Verktøy

Administrer verktøyene en LLM kan bruke.

Verktøy lar LLM utføre handlinger i kodebasen din. OpenCode kommer med et sett med innebygde verktøy, men du kan utvide det med egendefinerte verktøy eller MCP servere.

Som standard er alle verktøy aktivert og trenger ikke tillatelse for å kjøre. Du kan kontrollere verktøyets oppførsel gjennom tillatelser.

Konfigurer

Bruk feltet permission for å kontrollere verktøyets oppførsel. Du kan tillate, avslå eller kreve godkjenning for hvert verktøy.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "deny",
    "bash": "ask",
    "webfetch": "allow"
  }
}

Du kan også bruke jokertegn for å kontrollere flere verktøy samtidig. For eksempel, for å kreve godkjenning for alle verktøy fra en MCP-server:

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "mymcp_*": "ask"
  }
}

Finn ut mer om konfigurering av tillatelser.

Innebygd

Her er alle de innebygde verktøyene som er tilgjengelige i OpenCode.

bash

Utfør shell-kommandoer i prosjektmiljøet ditt.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "bash": "allow"
  }
}

Dette verktøyet lar LLM kjøre terminalkommandoer som npm install, git status eller en hvilken som helst annen shell-kommando.

edit

Endre eksisterende filer ved å bruke eksakte strengerstatninger.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "allow"
  }
}

Dette verktøyet utfører nøyaktige redigeringer av filer ved å erstatte eksakte teksttreff. Det er den primære måten LLM endrer kode på.

write

Opprett nye filer eller overskriv eksisterende.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "allow"
  }
}

Bruk denne for å la LLM lage nye filer. Den vil overskrive eksisterende filer hvis de allerede eksisterer.

read

Les filinnholdet fra kodebasen din.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "read": "allow"
  }
}

Dette verktøyet leser filer og returnerer innholdet. Den støtter lesing av spesifikke linjeområder for store filer.

grep

Søk i filinnhold ved hjelp av regulære uttrykk.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "grep": "allow"
  }
}

Rask innholdssøk på tvers av kodebasen din. Støtter full regex-syntaks og filmønsterfiltrering.

glob

Finn filer etter mønstermatching.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "glob": "allow"
  }
}

Søk etter filer ved å bruke glob-mønstre som **/*.js eller src/**/*.ts. Returnerer samsvarende filbaner sortert etter endringstid.

list

List filer og kataloger i en gitt bane.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "list": "allow"
  }
}

Dette verktøyet viser kataloginnhold. Den aksepterer glob-mønstre for å filtrere resultater.

lsp (experimental)

Samhandle med dine konfigurerte LSP-servere for å få kodeintelligensfunksjoner som definisjoner, referanser, sveveinformasjon og anropshierarki.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "lsp": "allow"
  }
}

Støttede operasjoner inkluderer goToDefinition, findReferences, hover, documentSymbol, workspaceSymbol, goToImplementation, prepareCallHierarchy, incomingCalls og outgoingCalls.

For å konfigurere hvilke LSP-servere som er tilgjengelige for prosjektet ditt, se LSP-servere.

patch

Bruk patcher på filer.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "allow"
  }
}

Dette verktøyet bruker oppdateringsfiler til kodebasen din. Nyttig for å påføre diff og lapper fra forskjellige kilder.

skill

Last inn en ferdighet (en SKILL.md fil) og returner innholdet i samtalen.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "skill": "allow"
  }
}

todowrite

Administrer gjøremålslister under kodingsøkter.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "todowrite": "allow"
  }
}

Oppretter og oppdaterer oppgavelister for å spore fremdrift under komplekse operasjoner. LLM bruker dette til å organisere flertrinnsoppgaver.

todoread

Les eksisterende gjøremålslister.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "todoread": "allow"
  }
}

Leser gjeldende gjøremålslistestatus. Brukes av LLM for å spore hvilke oppgaver som venter eller er fullført.

webfetch

Hent nettinnhold.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "webfetch": "allow"
  }
}

Lar LLM hente og lese nettsider. Nyttig for å slå opp dokumentasjon eller forske på nettressurser.

websearch

Søk på nettet for informasjon.

Dette verktøyet er bare tilgjengelig når du bruker OpenCode-leverandøren eller når miljøvariabelen OPENCODE_ENABLE_EXA er satt til en sannverdi (f.eks. true eller 1).

Slik aktiverer du når du starter OpenCode:

OPENCODE_ENABLE_EXA=1 opencode

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "websearch": "allow"
  }
}

Utfører nettsøk med Exa AI for å finne relevant informasjon på nettet. Nyttig for å undersøke emner, finne aktuelle hendelser eller samle informasjon utover treningsdataavbruddet.

Ingen API-nøkkel kreves — verktøyet kobles direkte til Exa AIs vertsbaserte MCP-tjeneste uten autentisering.

question

Still brukeren spørsmål under utførelse.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "question": "allow"
  }
}

Dette verktøyet lar LLM stille spørsmål til brukeren under en oppgave. Det er nyttig for:

Samle brukerpreferanser eller krav
Avklarende tvetydige instruksjoner
Få beslutninger om gjennomføringsvalg
Tilbyr valg om hvilken retning du skal ta

Hvert spørsmål inkluderer en overskrift, spørsmålsteksten og en liste over alternativer. Brukere kan velge fra de angitte alternativene eller skrive inn et tilpasset svar. Når det er flere spørsmål, kan brukerne navigere mellom dem før de sender inn alle svarene.

!node_modules/
!dist/
!build/

For eksempel lar denne .ignore filen ripgrep søke i node_modules/, dist/ og build/ kataloger selv om de er oppført i .gitignore.