Przejdź do głównej zawartości
OpenCode
app.header.homeapp.header.docs

Intro

Zacznij pracę z opencode.

opencode to open source AI coding agent. Jest dostępny jako interfejs terminalowy, aplikacja desktopowa i rozszerzenie IDE.

opencode TUI z motywem opencode

Zacznijmy.

Warunki wstępne

Aby uzyskać dostęp do opencode w swoim terminalu, będziesz potrzebować:

  1. Nowoczesny emulator terminala, taki jak:

  2. Klucze API dla dostawców LLM, z których korzystasz.

Instalacja

Najłatwiej zainstalować opencode za pomocą skryptu instalacyjnego.

Okno terminala
curl -fsSL https://opencode.ai/install | bash

Możesz też użyć poniższych metod instalacji:

  • Przy użyciu Node.js

    Okno terminala
    npm install -g opencode-ai

  • Korzystanie z Homebrew na macOS i Linux

    Okno terminala
    brew install anomalyco/tap/opencode

    W celu uzyskania najbardziej aktualnej wersji zalecamy korzystanie z opencode. Oficjalna formuła brew install opencode jest utrzymywana przez zespół Homebrew i jest aktualizowana.

  • Korzystanie z Paru na Arch Linux

    Okno terminala
    paru -S opencode-bin

Windows

  • Używając Chocolatey

    Okno terminala
    choco install opencode

  • Korzystanie z Scoop

    Okno terminala
    scoop install opencode

  • Przy użyciu NPM

    Okno terminala
    npm install -g opencode-ai

  • Używając Mise’a

    Okno terminala
    mise use -g github:anomalyco/opencode

  • Korzystanie z Dockera

    Okno terminala
    docker run -it --rm ghcr.io/anomalyco/opencode

Obecnie trwają prace nad instalacją opencode w systemie Windows za pomocą Bun.

Możesz także otrzymać plik binarny z Releases.

Skonfiguruj

Dzięki opencode możesz korzystać z dowolnego dostawcy LLM, konfigurując jego klucze API.

Jeśli nadal będziesz korzystać z dostawców LLM, zalecamy skorzystanie z OpenCode Zen. Do wyselekcjonowanej listy modeli, które zostały zatwierdzone i zweryfikowane przez opencode zespół.

  1. Uruchom opcję /connect w TUI, wybierz opencode i przejdź do opencode.ai/auth.

    /connect

  2. Zaloguj się, dodaj szczegóły rozliczeniowe i skopiuj klucz API.

  3. Wklej swój klucz API.

    ┌ API key
    │
    │
    └ enter

Alternatywnie możesz wybrać jednego z dodatkowych dostawców. Dowiedz się więcej.

Zainicjuj

Po skonfigurowaniu dostawcy, który może przejść do projektu, który chcesz pracować.

Okno terminala
cd /path/to/project

Uruchamiam opencode.

Okno terminala
opencode

Następnie zainicjuj opencode dla projektu, uruchamiając odpowiednią instrukcję.

/init

Spowoduje to, że opencode przeanalizuje Twój projekt i utworzy plik AGENTS.md katalog główny projektu.

Pomaga w opencode zrozumieniu struktury projektu i wzorce kodowania używany.

Użycie

Teraz możesz pracować nad swoim projektem. Możesz o to zapytać wszystko!

Jeśli tylko zaczniesz korzystać z agenta kodującego AI, oto kilka, które mogą być używane pomoc.

Zadawaj pytania

Możesz uruchomić opencode o wyjaśnienie bazy kodu.

How is authentication handled in @packages/functions/src/api/index.ts

Jest to pomocne, jeśli istnieje część bazy kodu, nad którą nie pracowałeś.

Dodaj funkcje

Możesz zastosować opencode o nowej funkcji do Twojego projektu. Najpierw zalecamy poproszenie o wypłacenie planu.

  1. Plan Stworza

    opencode ma Plan Mode, który umożliwia wyłączenie zmian i zamiast tego zasugeruj, jak_ zaimplementuje tę funkcję.

    Przejdź do niego za pomocą klawisza Tab. W osobnym dolnym rogu zobacz właściwy wskaźnik.

    <TAB>

    Opiszmy teraz, co chcemy, żeby robił.

    When a user deletes a note, we'd like to flag it as deleted in the database.
    Then create a screen that shows all the recently deleted notes.
    From this screen, the user can undelete a note or permanently delete it.

    Wersja opencode zawiera dużo oprogramowania, aby zrozumieć, czego chcesz. To pomaga rozmawiaj z nim tak, jakbyś rozmawiał z młodszym programistą w swoim zespole.

  2. Postęp zgodnie z planem

    Gdy będziesz mieć plan, możesz pozostawić go lub podłączyć więcej.

    We'd like to design this new screen using a design I've used before.
    [Image #1] Take a look at this image and use it as a reference.

    opencode może zeskanować obrazy, które mu przekażesz i poprosisz o potwierdzenie. Możesz należy to, przeciągając i upuszczając obraz do terminala.

  3. Stwórz przełącza

    Kiedy już jest komfortowo z planem, przełącz się z powrotem do Act Mode na klawisza Tab.

    <TAB>

    Poproszę o wprowadzenie zmian.

    Sounds good! Go ahead and make the changes.

Wprowadź zmiany

Aby zastosować następczą zmianę, można zastosować opencode lub bezpośrednio zbudowanie go bez konieczności wcześniejszego przeglądania planu.

We need to add authentication to the /settings route. Take a look at how this is
handled in the /notes route in @packages/functions/src/notes.ts and implement
the same logic in @packages/functions/src/settings.ts

Musisz mieć dostęp, że pod warunkiem dostępności narzędzia, więc opencode ma właściwie zmiany.

Cofnij zmiany

Załóżmy, że prosisz opencode o wprowadzenie zmian.

Can you refactor the function in @packages/functions/src/api/index.ts?

Ale z sobie sobie sprawę, że to nie jest to, czego chciałeś. Możesz być zmiany za pomoc polecenia /undo.

/undo

opencode cofnie teraz zmiany i wyświetli wiadomość Ponownie.

Can you refactor the function in @packages/functions/src/api/index.ts?

Można zastosować monit i zastosować opencode o próbę próby.

Możesz też możesz powtórzyć zmianę za pomocą polecenia /redo.

/redo

Udostępnianie

Rozmowy z opencode można udostępniać swoim zespół.

/share

Spowoduje to, że łącza do bieżących połączeń idą do schowki.

Oto przykładowa rozmowa z opencode.

Dostosuj

tyle! Jesteś teraz profesjonalistą w korzystaniu z opencode.

Aby dostosować go do potrzeb, zalecamy wybranie motywu, dostosowanie skrótów klawiaturowych, konfigurowanie programów formatujących kod, tworzenie niestandardowych kodów lub grę z konfiguracją opencode.