Instal·lació de goose i configuració d'un proveïdor personalitzat

goose és un assistent d’IA de propòsit general que s’executa al teu ordinador. A més de programar, pot gestionar investigació, escriptura, automatització i organització de dades. Pots utilitzar-lo a través de l’aplicació d’escriptori, el terminal o l’API, i les versions d’escriptori i de terminal comparteixen la mateixa configuració de model. És adequat per a tasques de programació repetitives i també es pot connectar a GitHub, bases de dades i fitxers.

Abans de començar

goose ofereix dues opcions d’instal·lació: Escriptori i CLI. Escriptori és la versió gràfica amb una finestra, mentre que CLI s’utilitza introduint ordres en un terminal. Ambdues comparteixen la mateixa configuració bàsica, incloent-hi el proveïdor i el model. Un proveïdor és la configuració de connexió que indica a goose quin servei de model utilitzar.

Vols una finestra

goose Desktop

Descarrega el zip en macOS
O utilitza brew cask
Utilitza el paquet d'instal·lador en Linux

Només terminal

goose CLI

download_cli.sh
O la CLI de Homebrew
Després executa goose session

Windows

Tria un entorn primer

Git Bash o MSYS2
També pots utilitzar PowerShell
Si no es troba l'ordre, afegeix-la a PATH

En macOS, pots instal·lar-lo descarregant l'aplicació o utilitzant Homebrew. En Linux, utilitza el paquet de la teva distribució per a la versió d'escriptori. En Windows, comprova primer els entorns de terminal compatibles.

Abans de començar, tingues a punt l’ID del model de la llista de models actual. Un ID de model és el nom que utilitza el servei de model per identificar un model específic, i has de copiar l’ID complet quan l’utilitzis.

Instal·lació i llançament per primera vegada

Si vols una finestra gràfica

Hi ha dos mètodes d’instal·lació documentats per a macOS:

Descarrega’l des de la pàgina d’instal·lació. La pàgina proporciona versions per a macOS Silicon i macOS Intel. Després de descarregar-lo, extreu el fitxer zip i executa l’aplicació a l’interior.
Alternativament, utilitza Homebrew:

brew install --cask block-goose

Això descarrega la mateixa aplicació i també pot gestionar les actualitzacions.

Si estàs utilitzant un Apple Mac M3 i no apareix cap finestra després d’obrir l’aplicació, comprova si ~/.config és llegible i escriptible. goose utilitza aquest directori per escriure registres.

Per a la versió d’escriptori de Linux, descarrega-la des de la pàgina d’instal·lació. Els paquets disponibles són DEB per a Ubuntu/Debian, RPM per a RHEL/Fedora i Flatpak. En Debian o Ubuntu, descarrega el fitxer DEB, obre el directori on s’ha desat, executa sudo dpkg -i (filename).deb, i després obre goose des del menú d’aplicacions. Substitueix (filename) pel nom real del fitxer.

Per a la versió d’escriptori de Windows, descarrega-la des de la pàgina d’instal·lació, extreu el fitxer zip i executa l’aplicació a l’interior.

Si només vols la versió de terminal

En macOS i Linux, executa:

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

Per saltar-te la configuració interactiva durant la instal·lació, afegeix CONFIGURE=false abans de bash:

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

En macOS, també pots executar:

brew install block-goose-cli

Per actualitzar una CLI instal·lada, executa:

goose update

En Windows, es requereix un dels tres entorns següents: Git Bash, que s’inclou amb Git for Windows i està marcat com a recomanat; MSYS2; o PowerShell inclòs amb Windows 10/11. En Git Bash i MSYS2, utilitza la mateixa download_cli.sh ordre mostrada anteriorment. En PowerShell, descarrega l’script primer i després executa’l:

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

Si se’t diu que goose no està a PATH, segueix la pàgina d’instal·lació i afegeix ~/.local/bin o %USERPROFILE%\.local\bin a la configuració actual de l’intèrpret d’ordres, després torna a obrir el terminal. PATH és un conjunt de directoris que el terminal cerca per trobar programes. Si el directori d’instal·lació no està inclòs, és possible que no puguis executar un programa instal·lat introduint el seu nom directament.

A data de 09-10-2026, la versió CLI era la 1.54.0. Per defecte, l’script d’instal·lació col·loca el programa a ~/.local/bin. Pots canviar aquest directori amb la GOOSE_BIN_DIR variable d’entorn. Si el canvies, l’script no actualitzarà automàticament la configuració de l’intèrpret d’ordres i el terminal informarà que el directori no està a PATH. Afegeix aquest directori a PATH o executa goose utilitzant el seu camí complet.

La primera vegada que utilitzis goose, et demanarà que configuris un proveïdor. Pots saltar-te els proveïdors integrats i afegir un proveïdor personalitzat tal com es descriu a la secció següent. Al terminal, navega fins al directori on vols treballar i executa:

goose session

Obtenir valors de connexió d’OmniProxy

Prepara l’adreça, la clau i el nom del model de la teva pròpia instància d’OmniProxy. L’exemple de proveïdor personalitzat utilitza un base_url que acaba en /v1/chat/completions, així que aquesta guia segueix el mateix format:

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

Copia el nom complet del model de la llista actual d’OmniProxy, incloent-hi qualsevol barra. A data de 09-10-2026, dos IDs de referència a la documentació del proveïdor eren grok-4.7 per a Grok i gpt-6-luna de la documentació d’OpenAI. gpt-6-luna admet Chat Completions; la crida de funcions en Chat Completions només s’admet quan reasoning_effort està configurat com a none. No copiïs un nom que no aparegui a la llista.

Entrar la configuració de l’eina

Un proveïdor personalitzat pot utilitzar un format compatible amb OpenAI, Anthropic o Ollama. Un format compatible significa que l’eina envia sol·licituds segons una especificació d’API comuna. Quan et connectis a OmniProxy, selecciona OpenAI Compatible.

Escriptori

Fes clic al botó de l’extrem superior esquerre per obrir la barra lateral.
Fes clic a Settings.
Fes clic a Models.
Fes clic a Configure providers.
Fes clic a Add Custom Provider a la part inferior de la finestra.
Per a Provider Type, selecciona OpenAI Compatible. Pots configurar Display Name com a OmniProxy. Introdueix l’adreça de la secció anterior a API URL. Si es requereix una clau, selecciona l’opció que requereix una API Key i introdueix la teva clau d’OmniProxy. A Available Models, introdueix els noms dels models, separant diversos noms amb comes.
Fes clic a Create Provider.

La versió d’escriptori actualment no pot definir capçaleres de sol·licitud personalitzades en aquesta finestra. Si necessites capçaleres de sol·licitud, edita el fitxer de configuració després de crear el proveïdor.

Terminal

Executa:

goose configure

Selecciona Custom Providers, després selecciona Add A Custom Provider. Per a API Type, selecciona OpenAI Compatible, després segueix les indicacions per introduir el nom, l’URL de l’API, si es requereix una clau, els noms dels models i si s’admeten respostes en streaming.

Quan configuris manualment en Windows, si el clauer informa d’un error, les instruccions d’instal·lació diuen que rebutgis desar la clau al clauer i utilitzis una variable d’entorn en el seu lloc. Després executa goose configure de nou. El clauer és un petit sistema d’emmagatzematge segur utilitzat pel sistema operatiu per emmagatzemar secrets.

Fitxer de configuració

Els directoris documentats són:

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

Pots basar el fitxer en l’exemple proporcionat. Substitueix el nom, l’adreça i els models pels teus propis valors. Emmagatzema la clau a la variable d’entorn especificada per api_key_env; no escriguis la clau real al fitxer:

{
  "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
}

Mantén un valor numèric per a context_limit, tal com es mostra a l’exemple. El límit de context real depèn del model i d’OmniProxy; no tractis el número de l’exemple com el límit oficial del model. Abans d’utilitzar-lo, executa:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Després d’entrar al directori de treball, executa:

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

Substitueix el valor de --model per l’ID complet de la llista. goose session no té una start subordre. També pots configurar --provider i --model a través de les GOOSE_PROVIDER i GOOSE_MODEL variables d’entorn. Fins i tot si la passarel·la no valida les claus, OMNIPROXY_API_KEY encara ha de tenir un valor. Pot ser una cadena de text de marcatge utilitzada només al teu ordinador local. Aquesta configuració va llegir correctament un fitxer en les proves del 09-10-2026.

Finestra

Configuració

Configuració a la barra lateral
Pàgina de models
Afegeix un proveïdor personalitzat

Terminal

goose configure

Selecciona proveïdors personalitzats
Després selecciona afegir
Tria OpenAI Compatible com a tipus

Fitxer

custom_providers

En macOS i Linux, es troba a ~/.config
En Windows, es troba a APPDATA
Configura base_url segons l'exemple oficial

Els tres mètodes creen el mateix tipus de configuració. Selecciona OpenAI Compatible com a tipus de proveïdor.

Verificar amb una tasca real

Obre un directori que contingui un fitxer normal i executa goose session tal com es mostra a la secció anterior. Demana-li que llegeixi la primera línia d’un fitxer que especifiquis. Hauria de retornar el contingut del fitxer en lloc de dir només que la configuració s’ha desat.

Per llegir fitxers o executar ordres, la sessió necessita l’extensió Developer. L’extensió Developer és un mòdul d’eines que permet a goose treballar amb fitxers i ordres locals. Generalment s’inclou a la configuració per defecte. Si goose diu que no té eines de fitxers, afegeix el següent a l’ordre:

--with-builtin developer

No afegeixis també --no-profile, perquè aquesta opció desactiva les extensions per defecte.

En les proves del 09-10-2026, goose 1.54.0 va llegir correctament la primera línia del fitxer especificat. La primera resposta pot trigar al voltant d’un minut.

Després, comprova els registres de sol·licituds d’OmniProxy per confirmar la font i el nom del model.

Llançament

S'obre una sessió

goose session
El proveïdor és el que s'acaba d'afegir
El nom del model és a la llista

Tasca

Ha completat realment la tasca

Per exemple, llista el directori actual
Revisa la seva resposta
No confiïs només en un desat correcte

Registres

Visible a la passarel·la

Utilitza l'adreça de l'exemple de la documentació
No posis la clau al repositori
L'ID del model coincideix amb la llista

Després de desar el proveïdor, confirma-ho amb una sessió real.

Errors comuns

L’ordre goose no es pot trobar: Afegeix el directori d’instal·lació a PATH tal com es descriu a la pàgina d’instal·lació, després torna a obrir el terminal.
No apareix cap finestra a la versió d’escriptori en un Mac M3: Comprova els permisos de lectura i escriptura per a ~/.config.
El clauer falla: No desis la clau al clauer; utilitza una variable d’entorn en el seu lloc.
El model no és a la llista: A la versió d’escriptori, selecciona Use custom model i introdueix el nom del model manualment. goose configure no pot acceptar un nom de model personalitzat. Per a l’ús del terminal, canvia a la versió d’escriptori o edita GOOSE_MODEL directament a la configuració.
No es pot arribar a l’adreça: Confirma que l’URL de l’API acaba en /v1/chat/completions, com a l’exemple, i que OmniProxy està en marxa.
Diu que no pot llegir fitxers: Afegeix l’extensió Developer i no utilitzis --no-profile.
Retorna unsupported Responses role: system: L’adreça sol ser correcta. Canvia a un altre ID complet de la llista de models.

Referències oficials

Per a la instal·lació, vegeu Instal·lar goose. Per als proveïdors personalitzats, vegeu proveïdors de goose. Per als IDs de models utilitzats als exemples, vegeu la pàgina de models de xAI i GPT-6 Luna.

Substitueix cada marcador de posició amb valors de la teva pròpia configuració d'OmniProxy. No publiquis mai una clau real.

Un resultat guardat o HTTP 200 sols no demostra compatibilitat completa de l'Agent. Comprova la font i el model al registre de crides d'OmniProxy.

Fonts oficials · goose ↗