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.
GOOSE_PROVIDER: openai
GOOSE_MODEL: claude-haiku-4-5-20251001
OPENAI_HOST: https://api.aicodewith.ai
OPENAI_BASE_PATH: v1/chat/completionsPasos 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.
for rc in "$HOME/.zshrc" "$HOME/.bashrc"; do
touch "$rc"
echo 'export OPENAI_API_KEY=sk-***' >> "$rc"
doneLos 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.
¿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, luegogoose --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 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 Coloca tu clave de API en ~/.bashrc
Ejecuta
echo 'export OPENAI_API_KEY=sk-***' >> ~/.bashrc, reemplazandosk-***con tu clave de API (Obtén una clave de API). La última línea de~/.bashrcdebería ser esa línea.Verifica que la última línea de ~/.bashrc sea export OPENAI_API_KEY=sk-*** (enmascarada aquí) 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".OKsignifica 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 ¿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.
Cambia los modelos de Goose: cambia GOOSE_MODEL
Reemplaza el nombre del modelo después de
GOOSE_MODELen 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 →
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 →
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 →
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
- Documentación de proveedores de Goose
- Repositorio de Goose en GitHub (aaif-goose/goose, fuente del script de instalación)
- Documentación de instalación de Goose