Tools

Narzędzia umożliwiają LLM wykonywanie działań w bazie kodu. opencode ma zestaw wbudowanych narzędzi, ale możesz go rozszerzyć o narzędzia niestandardowe lub serwery MCP.

Domyślnie wszystkie narzędzia są włączone i nie wymagają pozwolenia na uruchomienie. Możesz kontrolować zachowanie narzędzia poprzez uprawnienia.

---

Skonfiguruj

Użyj pola permission do kontrolowania zachowania narzędzia. Dla każdego narzędzia możesz zezwolić, odmówić lub wymagać zatwierdzenia.

opencode.json

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

Możesz także używać symboli wieloznacznych do kontrolowania wielu narzędzi jednocześnie. Na przykład, aby wymagać zatwierdzenia wszystkich narzędzi z serwera MCP:

opencode.json

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

Dowiedz się więcej o konfigurowaniu uprawnień.

---

Wbudowane

Oto wszystkie wbudowane narzędzia dostępne w opencode.

---

bash

Wykonuj polecenia shell w środowisku projektu.

opencode.json

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

To narzędzie umożliwia LLM uruchamianie poleceń terminalowych, takich jak npm install, git status lub dowolne inne polecenie shell.

---

edit

Modyfikuj istniejące pliki przez dokładne podmiany tekstu.

opencode.json

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

To narzędzie umożliwia precyzyjną edycję plików poprzez zastąpienie dokładnych dopasowań tekstu. Jest to główny sposób, w jaki LLM modyfikuje kod.

---

write

Utwórz nowe pliki lub nadpisz istniejące.

opencode.json

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

Użyj tego, aby umożliwić LLM tworzenie nowych plików. Zastąpi istniejące pliki, jeśli już istnieją.

Notatka

Narzędzie write jest kontrolowane przez uprawnienie edit, które obejmuje wszystkie modyfikacje plików (edit, write, patch, multiedit).

---

read

Przeczytaj zawartość pliku z bazy kodu.

opencode.json

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

Narzędzie to odczytuje pliki i zwraca ich zawartość. Obsługuje czytanie określonych zakresów linii w przypadku dużych plików.

---

grep

Przeszukuj zawartość plików za pomocą wyrażeń regularnych.

opencode.json

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

Szybkie wyszukiwanie treści w całej bazie kodu. Obsługuje pełną składnię wyrażeń regularnych i filtrowanie wzorców plików.

---

glob

Znajduj pliki na podstawie wzorców.

opencode.json

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

Szukaj plików przy użyciu wzorców globalnych, takich jak **/*.js lub src/**/*.ts. Zwraca pasujące ścieżki plików posortowane według czasu modyfikacji.

---

lista

Wyświetla listę plików i katalogów w podanej ścieżce.

opencode.json

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

To narzędzie wyświetla zawartość katalogu. Akceptuje wzorce globalne do filtrowania wyników.

---

LSP (experimental)

Wejdź w interakcję ze skonfigurowanymi serwerami LSP, aby uzyskać funkcje analizy kodu, takie jak definicje, odniesienia, informacje o najechaniu myszką i hierarchia połączeń.

Notatka

To narzędzie jest dostępne tylko wtedy, gdy OPENCODE_EXPERIMENTAL_LSP_TOOL=true (lub OPENCODE_EXPERIMENTAL=true).

opencode.json

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

Obsługiwane operacje obejmują goToDefinition, findReferences, hover, documentSymbol, workspaceSymbol, goToImplementation, prepareCallHierarchy, incomingCalls i outgoingCalls.

Aby skonfigurować, które serwery LSP są dostępne dla Twojego projektu, zobacz Serwery LSP.

---

patch

Stosuj patche do plików.

opencode.json

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

To narzędzie stosuje pliki poprawek do bazy kodu. Przydatne do stosowania różnic i poprawek z różnych źródeł.

Notatka

Narzędzie patch jest kontrolowane przez uprawnienie edit, które obejmuje wszystkie modyfikacje plików (edit, write, patch, multiedit).

---

skill

Załaduj umiejętność (plik SKILL.md) i zwróć jej treść w rozmowie.

opencode.json

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

---

todowrite

Zarządzaj listami rzeczy do zrobienia podczas sesji kodowania.

opencode.json

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

Tworzy i aktualizuje listy zadań w celu śledzenia postępu podczas złożonych operacji. LLM wykorzystuje to do organizowania zadań wieloetapowych.

Notatka

To narzędzie jest domyślnie wyłączone dla podagentów, ale można je włączyć ręcznie. Dowiedz się więcej

---

todoread

Odczytuj istniejące listy todo.

opencode.json

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

Odczytuje bieżący stan listy rzeczy do zrobienia. Używany przez LLM do śledzenia zadań oczekujących lub ukończonych.

Notatka

To narzędzie jest domyślnie wyłączone dla podagentów, ale można je włączyć ręcznie. Dowiedz się więcej

---

webfetch

Pobieraj treści z web.

opencode.json

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

Umożliwia LLM pobieranie i odczytywanie stron internetowych. Przydatne do wyszukiwania dokumentacji lub wyszukiwania zasobów online.

---

websearch

Wyszukaj informacje w Internecie.

Notatka

To narzędzie jest dostępne tylko w przypadku korzystania z dostawcy opencode lub gdy zmienna środowiskowa OPENCODE_ENABLE_EXA jest ustawiona na dowolną wartość prawdziwą (np. true lub 1).

Aby włączyć przy uruchamianiu opencode:

OPENCODE_ENABLE_EXA=1 opencode

opencode.json

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

Przeszukuje Internet za pomocą Exa AI, aby znaleźć odpowiednie informacje w Internecie. Przydatne do badania tematów, znajdowania bieżących wydarzeń lub zbierania informacji wykraczających poza limit danych szkoleniowych.

Nie jest wymagany żaden klucz API — narzędzie łączy się bezpośrednio z usługą MCP hostowaną przez Exa AI bez uwierzytelniania.

Wskazówka

Użyj websearch, gdy chcesz znaleźć informacje (odkrycie), i webfetch, gdy musisz pobrać treść z określonego adresu URL (pobieranie).

---

question

Zadawaj pytania użytkownikowi podczas wykonywania.

opencode.json

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

To narzędzie umożliwia LLM zadawanie pytań użytkownikowi podczas wykonywania zadania. Jest to przydatne dla:

• Zbieranie preferencji i wymagań użytkownika
• Doprecyzowanie niejednoznacznych instrukcji
• Uzyskiwanie decyzji dotyczących implementacji
• Proponowanie możliwych kierunków działania

Każde pytanie zawiera nagłówek, tekst pytania i listę opcji. Użytkownicy mogą wybierać spośród dostępnych opcji lub wpisać niestandardową odpowiedź. Jeśli pytań jest wiele, użytkownicy mogą nawigować między nimi przed przesłaniem wszystkich odpowiedzi.

---

Narzędzia niestandardowe

Niestandardowe narzędzia pozwalają zdefiniować własne funkcje, które LLM może wywołać. Są one zdefiniowane w pliku konfiguracyjnym i mogą wykonywać dowolny kod.

Więcej informacji o tworzeniu narzędzi niestandardowych.

---

Serwery MCP

Serwery MCP (Model Context Protocol) umożliwiają integrację zewnętrznych narzędzi i usług. Obejmuje to dostęp do baz danych, integracje API i usługi stron trzecich.

Dowiedz się więcej o konfigurowaniu serwerów MCP.

---

Wnętrze działania

Wewnętrznie narzędzia takie jak grep, glob i list używają pod maską ripgrep. Domyślnie ripgrep respektuje wzorce .gitignore, co oznacza, że ​​pliki i katalogi wymienione w Twoim .gitignore zostaną wykluczone z wyszukiwań i list.

---

Wzorce ignorowania

Aby uwzględnić pliki, które normalnie byłyby ignorowane, utwórz plik .ignore w katalogu głównym projektu. Ten plik może jawnie zezwalać na określone ścieżki.

.ignore

!node_modules/
!dist/
!build/

Na przykład ten plik .ignore pozwala ripgrepowi przeszukiwać katalogi node_modules/, dist/ i build/, nawet jeśli są one wymienione w .gitignore.