Configuración de la clave de API de Goose

Clave de API de Goose: configura tu propia clave en config.yaml

Pega el bloque de abajo en config.yaml, coloca tu propia clave de API en ~/.bashrc, y Goose podrá usar modelos Claude. Pago por uso.

~/.config/goose/config.yamlyaml
config
GOOSE_PROVIDER: openai
GOOSE_MODEL: claude-haiku-4-5-20251001
OPENAI_HOST: https://api.aicodewith.ai
OPENAI_BASE_PATH: v1/chat/completions

Pasos de configuración

Guarda esta clave para terminales posteriores

Una vez que inicies sesión, este comando incluye tu propia clave. Cópialo, ejecútalo una vez y la herramienta guardará la clave en la ubicación que probamos.

bash
for rc in "$HOME/.zshrc" "$HOME/.bashrc"; do
  touch "$rc"
  echo 'export OPENAI_API_KEY=sk-***' >> "$rc"
done

Los visitantes que no han iniciado sesión solo ven un marcador de posición. Inicia sesión y completaremos tu clave. Sign in · Obtén una clave en la consola

Copiar solo pone el comando en el portapapeles. Aún necesitas ejecutarlo en una terminal o pegar la clave en la configuración de la herramienta. Cómo obtener una clave API

Estos pasos fueron probados en Linux (bash). macOS y Windows aún no han sido probados, por lo que no se enumeran.

  1. ¿Aún no tienes Goose? Instálalo (omítelo si ya está instalado)

    Ejecuta curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash, luego goose --version. Un número de versión significa que está instalado.

    Instala Goose: curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash (CONFIGURE=false omite la configuración interactiva). Se instala en ~/.local/bin/goose. goose --version imprime 1.54.0
  2. Pega la configuración en config.yaml

    Abre ~/.config/goose/config.yaml, pega el bloque de la parte superior de esta página y guarda. Ya no necesitas exportar estos.

    El endpoint en ~/.config/goose/config.yaml
  3. Coloca tu clave de API en ~/.bashrc

    Ejecuta echo 'export OPENAI_API_KEY=sk-***' >> ~/.bashrc, reemplazando sk-*** con tu clave de API (Obtén una clave de API). La última línea de ~/.bashrc debería ser esa línea.

    Verifica que la última línea de ~/.bashrc sea export OPENAI_API_KEY=sk-*** (enmascarada aquí)
  4. Abre una nueva terminal y prueba Goose

    Abre una nueva terminal y ejecuta goose run --no-session --quiet --max-turns 1 -t "Reply with exactly: OK". OK significa que Goose está usando tu clave de API.

    Verifica: cierra la terminal, abre una nueva, ejecuta goose run --no-session --quiet --max-turns 1 -t "Reply with exactly: OK"; una respuesta OK significa que está configurado
  5. ¿No hay OK? Compara tu error

    Compara el error en tu terminal con Errores comunes a continuación. Cada uno enumera la causa y la solución.

  6. Cambia los modelos de Goose: cambia GOOSE_MODEL

    Reemplaza el nombre del modelo después de GOOSE_MODEL en config.yaml con el nuevo ID de modelo, escrito exactamente. Los IDs de modelo están en Modelos y precios.

Errores comunes

No se ha establecido la clave: Falló la autenticación para https://api.aicodewith.ai/v1/chat/completions. Estado: 401 Unauthorized. Respuesta: {"error":"请在请求中提供有效的 API Key。"}

Qué ves

error: Se encontró este error: Error de autenticación: Falló la autenticación para https://api.aicodewith.ai/v1/chat/completions. Estado: 401 Unauthorized. Respuesta: {"error":"请在请求中提供有效的 API Key。"}.
(Inglés: "Por favor, proporcione una clave de API válida en la solicitud.")
Causa
El terminal no tiene OPENAI_API_KEY: no está en ~/.bashrc, o lo agregaste pero no abriste una terminal nueva.
Cómo corregirlo
Pon la clave en ~/.bashrc como en el paso 3, luego abre una terminal nueva.

Volver al paso 3: Pon tu clave de API en ~/.bashrc →

No se ha establecido la clave: la terminal nueva no tiene OPENAI_API_KEY. Al ejecutar goose run --no-session --quiet --max-turns 1 -t "Reply with exactly: OK" se imprime dos veces: error: Se encontró este error: Error de autenticación: Falló la autenticación para https://api.aicodewith.ai/v1/chat/completions. Estado: 401 Unauthorized. Respuesta: {"error":"请在请求中提供有效的 API Key。"}. (Inglés: "Por favor, proporcione una clave de API válida en la solicitud.") seguido de Vuelve a intentarlo si crees que es un error transitorio o recuperable.

Clave incorrecta: Falló la autenticación para https://api.aicodewith.ai/v1/chat/completions. Estado: 401 Unauthorized. Respuesta: {"error":"请在请求中提供有效的 API Key。"}

Qué ves

error: Se encontró este error: Error de autenticación: Falló la autenticación para https://api.aicodewith.ai/v1/chat/completions. Estado: 401 Unauthorized. Respuesta: {"error":"请在请求中提供有效的 API Key。"}.
(Inglés: "Por favor, proporcione una clave de API válida en la solicitud.")
Causa
OPENAI_API_KEY en ~/.bashrc es incorrecta; el error es el mismo que sin clave.
Cómo corregirlo
Copia la clave de la consola de nuevo, corrige la última línea de ~/.bashrc y luego abre una terminal nueva.

Volver al paso 3: Pon tu clave de API en ~/.bashrc →

Clave incorrecta: tail -n 1 ~/.bashrc muestra export OPENAI_API_KEY=sk-wrong. Al ejecutar goose run --no-session --quiet --max-turns 1 -t "Reply with exactly: OK" se imprime dos veces: error: Se encontró este error: Error de autenticación: Falló la autenticación para https://api.aicodewith.ai/v1/chat/completions. Estado: 401 Unauthorized. Respuesta: {"error":"请在请求中提供有效的 API Key。"}. (Inglés: "Por favor, proporcione una clave de API válida en la solicitud.") — lo mismo que sin clave

404 "不支持的请求路径" (ruta de solicitud no admitida)

Qué ves

404 "不支持的请求路径" (ruta de solicitud no admitida)
Causa
OPENAI_BASE_PATH es incorrecto (por ejemplo, nope/chat/completions), por lo que la solicitud va a https://api.aicodewith.ai/nope/chat/completions
Cómo corregirlo
Restablécelo a v1/chat/completions

Volver al paso 2: Pega la configuración en config.yaml →

Error común: un OPENAI_BASE_PATH incorrecto (aquí nope/chat/completions) envía la solicitud a https://api.aicodewith.ai/nope/chat/completions y devuelve 404 (ruta no admitida). Restablécelo a v1/chat/completions. Nota: este relay aún aceptó (probado) un HOST que ya incluye /v1, por lo que no es una forma fiable de detectar una configuración incorrecta.

Preguntas frecuentes

¿Cómo uso mi propia clave de API en Goose?

En ~/.config/goose/config.yaml, establece GOOSE_PROVIDER: openai, OPENAI_HOST: https://api.aicodewith.ai y OPENAI_BASE_PATH: v1/chat/completions; luego agrega export OPENAI_API_KEY=tu clave a ~/.bashrc.

¿Debe el OPENAI_HOST de Goose incluir /v1?

No. Establece OPENAI_HOST a https://api.aicodewith.ai y pon /v1 en OPENAI_BASE_PATH.

Goose dice 401. ¿Y ahora qué?

El terminal no tiene OPENAI_API_KEY, o la clave es incorrecta. Consulta los errores comunes de arriba para ver la solución.

Goose no puede encontrar el modelo. ¿Y ahora qué?

Asegúrate de que GOOSE_MODEL coincida exactamente con un ID de modelo de AI Code With.

Fuentes

Enlaces relacionados