goose installeren en een aangepaste provider configureren

goose is een AI-assistent voor algemeen gebruik die op je computer draait. Naast coderen kan het onderzoek, schrijven, automatisering en gegevensorganisatie afhandelen. Je kunt het gebruiken via de desktop-app, terminal of API, en de desktop- en terminalversies delen dezelfde modelconfiguratie. Het is geschikt voor repetitieve codeertaken en kan ook verbinding maken met GitHub, databases en bestanden.

Voordat je begint

goose biedt twee installatieopties: Desktop en CLI. Desktop is de grafische versie met een venster, terwijl CLI wordt gebruikt door commando’s in een terminal in te voeren. Beide delen dezelfde kernconfiguratie, inclusief de Provider en het model. Een Provider is de verbindingsconfiguratie die goose vertelt welke modeldienst moet worden gebruikt.

Wil je een venster

goose Desktop

Download de zip op macOS
Of gebruik brew cask
Gebruik het installatiepakket op Linux

Alleen terminal

goose CLI

download_cli.sh
Of de Homebrew CLI
Voer daarna goose session uit

Windows

Kies eerst een omgeving

Git Bash of MSYS2
Je kunt ook PowerShell gebruiken
Als het commando niet wordt gevonden, voeg het toe aan PATH

Op macOS kun je het installeren door de app te downloaden of Homebrew te gebruiken. Gebruik op Linux het pakket van je distributie voor de desktopversie. Controleer op Windows eerst de ondersteunde terminalomgevingen.

Zorg voordat je begint dat het model-ID uit de huidige modellijst gereed is. Een model-ID is de naam die de modeldienst gebruikt om een specifiek model te identificeren, en je moet het volledige ID kopiëren wanneer je het gebruikt.

Installeren en voor de eerste keer opstarten

Als je een grafisch venster wilt

Er zijn twee gedocumenteerde installatiemethoden voor macOS:

Download het vanaf de installatiepagina. De pagina biedt macOS Silicon- en macOS Intel-versies. Pak na het downloaden het zip-bestand uit en voer de applicatie erin uit.
Gebruik anders Homebrew:

brew install --cask block-goose

Dit downloadt dezelfde applicatie en kan ook updates afhandelen.

Als je een Apple Mac M3 gebruikt en er verschijnt geen venster na het openen van de app, controleer dan of ~/.config lees- en schrijfbaar is. goose gebruikt deze map om logs te schrijven.

Download voor de Linux-desktopversie het bestand vanaf de installatiepagina. De beschikbare pakketten zijn DEB voor Ubuntu/Debian, RPM voor RHEL/Fedora en Flatpak. Download op Debian of Ubuntu het DEB-bestand, open de map waar het is opgeslagen, voer sudo dpkg -i (filename).debuit en open daarna goose vanuit het applicatiemenu. Vervang (filename) door de werkelijke bestandsnaam.

Download voor de Windows-desktopversie het bestand vanaf de installatiepagina, pak het zip-bestand uit en voer de applicatie erin uit.

Als je alleen de terminalversie wilt

Voer op macOS en Linux het volgende uit:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

Voeg CONFIGURE=false toe vóór bash:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash

om interactieve configuratie tijdens de installatie over te slaan. Op macOS kun je ook het volgende uitvoeren:

brew install block-goose-cli

Voer het volgende uit om een geïnstalleerde CLI bij te werken:

goose update

Op Windows is een van de volgende drie omgevingen vereist: Git Bash, die is inbegrepen bij Git for Windows en als aanbevolen is gemarkeerd; MSYS2; of PowerShell inbegrepen bij Windows 10/11. Gebruik in Git Bash en MSYS2 hetzelfde download_cli.sh commando als hierboven getoond. Download in PowerShell eerst het script en voer het daarna uit:

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/aaif-goose/goose/main/download_cli.ps1" -OutFile "download_cli.ps1"
.\download_cli.ps1

Als je te horen krijgt dat goose niet in PATH staat, volg dan de installatiepagina en voeg ~/.local/bin of %USERPROFILE%\.local\bin toe aan de huidige shell-configuratie en heropen daarna de terminal. PATH is een set mappen die de terminal doorzoekt naar programma’s. Als de installatiemap niet is opgenomen, kun je een geïnstalleerd programma mogelijk niet uitvoeren door de naam direct in te voeren.

Op 09-10-2026 was de CLI-versie 1.54.0. Standaard plaatst het installatiescript het programma in ~/.local/bin. Je kunt deze map wijzigen met de GOOSE_BIN_DIR omgevingsvariabele. Als je dit wijzigt, zal het script de shell-configuratie niet automatisch bijwerken en zal de terminal melden dat de map niet in PATH staat. Voeg die map toe aan PATH of voer goose uit met het volledige pad.

De eerste keer dat je goose gebruikt, zal het je vragen om een Provider te configureren. Je kunt de ingebouwde providers overslaan en een aangepaste Provider toevoegen zoals beschreven in de volgende sectie. Navigeer in de terminal naar de map waar je wilt werken en voer het volgende uit:

goose session

Verbindingswaarden ophalen uit OmniProxy

Bereid het adres, de sleutel en de modelnaam voor vanuit je eigen OmniProxy-instantie. Het voorbeeld van de aangepaste Provider gebruikt een base_url eindigend op /v1/chat/completions, dus deze gids volgt hetzelfde formaat:

API URL:  https://your-omniproxy-origin.example/v1/chat/completions
API Key:  <YOUR_OMNIPROXY_API_KEY>
Models:   Copy from the current OmniProxy model list; separate multiple models with commas

Kopieer de volledige modelnaam uit de huidige OmniProxy-lijst, inclusief slashes. Op 09-10-2026 waren twee referentie-ID’s in de providerdocumentatie grok-4.7 voor Grok en gpt-6-luna uit de OpenAI-documentatie. gpt-6-luna ondersteunt Chat Completions; functie-aanroepen in Chat Completions worden alleen ondersteund wanneer reasoning_effort is ingesteld op none. Kopieer geen naam die niet in de lijst voorkomt.

Toolconfiguratie invoeren

Een aangepaste Provider kan een OpenAI-, Anthropic- of Ollama-compatibel formaat gebruiken. Een compatibel formaat betekent dat de tool verzoeken verstuurt volgens een algemene API-specificatie. Selecteer bij het verbinden met OmniProxy OpenAI Compatible.

Desktop

Klik op de knop in de linkerbovenhoek om de zijbalk te openen.
Klik op Settings.
Klik op Models.
Klik op Configure providers.
Klik onderaan het venster op Add Custom Provider.
Selecteer bij Provider Type OpenAI Compatible. Je kunt Display Name instellen op OmniProxy. Voer het adres uit de vorige sectie in bij API URL. Als een sleutel vereist is, selecteer dan de optie die een API Key vereist en voer je OmniProxy-sleutel in. Voer bij Available Models de modelnamen in en scheid meerdere namen met komma’s.
Klik op Create Provider.

De desktopversie kan momenteel geen aangepaste verzoekheaders definiëren in dit venster. Als je verzoekheaders nodig hebt, bewerk dan het configuratiebestand nadat je de Provider hebt aangemaakt.

Terminal

Voer het volgende uit:

goose configure

Selecteer Custom Providers en selecteer daarna Add A Custom Provider. Selecteer bij API Type OpenAI Compatible en volg daarna de aanwijzingen om de naam, API URL, of een sleutel vereist is, modelnamen en of streaming-antwoorden worden ondersteund in te voeren.

Als je handmatig configureert op Windows en de keychain een fout meldt, zeggen de installatie-instructies om het opslaan van de sleutel in de keychain te weigeren en in plaats daarvan een omgevingsvariabele te gebruiken. Voer daarna goose configure opnieuw uit. De keychain is een klein beveiligd opslagsysteem dat door het besturingssysteem wordt gebruikt om geheimen op te slaan.

Configuratiebestand

De gedocumenteerde mappen zijn:

macOS en Linux: ~/.config/goose/custom_providers/
Windows: %APPDATA%\Block\goose\config\custom_providers\

Je kunt het bestand baseren op het verstrekte voorbeeld. Vervang de naam, het adres en de modellen door je eigen waarden. Sla de sleutel op in de omgevingsvariabele gespecificeerd door api_key_env; schrijf de echte sleutel niet in het bestand:

{
  "name": "omniproxy",
  "engine": "openai",
  "display_name": "OmniProxy",
  "api_key_env": "OMNIPROXY_API_KEY",
  "base_url": "https://your-omniproxy-origin.example/v1/chat/completions",
  "models": [
    { "name": "grok-4.7", "context_limit": 128000 },
    { "name": "gpt-6-luna", "context_limit": 128000 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

Houd een numerieke waarde aan voor context_limit, zoals getoond in het voorbeeld. De werkelijke contextlimiet hangt af van het model en OmniProxy; behandel het voorbeeldgetal niet als de officiële limiet van het model. Voer voordat je het gebruikt het volgende uit:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Voer na het betreden van de werkmap het volgende uit:

goose session --provider omniproxy --model grok-4.7

Vervang de waarde van --model door het volledige ID uit de lijst. goose session heeft geen start subcommando. Je kunt ook --provider en --model instellen via de GOOSE_PROVIDER en GOOSE_MODEL omgevingsvariabelen. Zelfs als de gateway geen sleutels valideert, OMNIPROXY_API_KEY moet nog steeds een waarde hebben. Het kan een placeholder-string zijn die alleen op je lokale computer wordt gebruikt. Deze configuratie las succesvol een bestand tijdens het testen op 09-10-2026.

Venster

Instellingen

Instellingen in de zijbalk
Modellenpagina
Aangepaste provider toevoegen

Terminal

goose configure

Selecteer Aangepaste providers
Selecteer daarna toevoegen
Kies OpenAI Compatible als type

Bestand

custom_providers

Op macOS en Linux staat het onder ~/.config
Op Windows staat het onder APPDATA
Stel base_url in volgens het officiële voorbeeld

Alle drie de methoden creëren hetzelfde type configuratie. Selecteer OpenAI Compatible als Provider-type.

Verifiëren met een echte taak

Open een map met een gewoon bestand en voer goose session uit zoals getoond in de vorige sectie. Vraag het om de eerste regel van een bestand dat je specificeert te lezen. Het zou de bestandsinhoud moeten retourneren in plaats van alleen te zeggen dat de configuratie is opgeslagen.

Om bestanden te lezen of commando’s uit te voeren, heeft de sessie de Developer-extensie nodig. De Developer-extensie is een toolmodule waarmee goose met lokale bestanden en commando’s kan werken. Deze is over het algemeen inbegrepen in de standaardconfiguratie. Als goose zegt dat het geen bestandstools heeft, voeg dan het volgende toe aan het commando:

--with-builtin developer

Voeg niet ook --no-profiletoe, omdat die optie de standaardextensies uitschakelt.

Tijdens het testen op 09-10-2026 las goose 1.54.0 succesvol de eerste regel van het opgegeven bestand. Het eerste antwoord kan ongeveer een minuut duren.

Controleer daarna de OmniProxy-verzoeklogs om de bron en modelnaam te bevestigen.

Starten

Een sessie opent

goose session
Provider is degene die zojuist is toegevoegd
De modelnaam staat in de lijst

Taak

Het heeft de taak daadwerkelijk voltooid

Bijvoorbeeld, lijst de huidige map op
Controleer het antwoord
Vertrouw niet alleen op een succesvolle opslag

Logs

Zichtbaar in de gateway

Gebruik het adres uit het documentatievoorbeeld
Zet de sleutel niet in de repository
Het model-ID komt overeen met de lijst

Bevestig na het opslaan van de Provider deze met een echte sessie.

Veelvoorkomende fouten

Het goose commando kan niet worden gevonden: Voeg de installatiemap toe aan PATH zoals beschreven op de installatiepagina en heropen daarna de terminal.
Er verschijnt geen venster in de desktopversie op een M3 Mac: Controleer de lees- en schrijfrechten voor ~/.config.
De keychain faalt: Sla de sleutel niet op in de keychain; gebruik in plaats daarvan een omgevingsvariabele.
Het model staat niet in de lijst: Selecteer in de desktopversie Use custom model en voer de modelnaam handmatig in. goose configure kan geen aangepaste modelnaam accepteren. Schakel voor terminalgebruik over naar de desktopversie of bewerk GOOSE_MODEL direct in de configuratie.
Het adres is onbereikbaar: Bevestig dat de API URL eindigt op /v1/chat/completions, zoals in het voorbeeld, en dat OmniProxy actief is.
Het zegt dat het bestanden niet kan lezen: Voeg de Developer-extensie toe en gebruik niet --no-profile.
Het retourneert unsupported Responses role: system: Het adres is meestal correct. Schakel over naar een ander volledig ID uit de modellijst.

Officiële referenties

Zie Install goose voor installatie. Zie goose providers voor aangepaste Providers. Zie de xAI modellenpagina en GPT-6 Luna voor de model-ID’s die in de voorbeelden worden gebruikt.

Vervang elke placeholder met waarden uit uw eigen OmniProxy-configuratie. Publiceer nooit een echte sleutel.

Een opgeslagen resultaat of HTTP 200 alleen bewijst niet volledige agentcompatibiliteit. Controleer de bron en het model in de verzoeklog van OmniProxy.

Officiële bronnen · goose ↗