AI Code With

Configuración de clave de API de Crush

Clave de API de Crush: configura tu propia clave en crushrc

Pega el bloque de abajo en crushrc, sustituye por tu propia clave de API y Crush podrá usar Claude y otros modelos. Pago por uso.

Iniciar configuraciónObtener una clave de API →
~/.config/crush/crushrccrushrc
config
# ~/.config/crush/crushrc
provider add aicodewith --type openai-compat \
  --base-url "https://api.aicodewith.ai/v1" \
  --api-key "sk-***"
model add aicodewith/claude-haiku-4-5-20251001 --name "Claude Haiku 4.5"
model add aicodewith/gpt-5.5 --name "GPT-5.5"
model add aicodewith/deepseek-flash --name "DeepSeek Flash"

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
mkdir -p "$(dirname "$HOME/.config/crush/crushrc")"
cat > "$HOME/.config/crush/crushrc" << 'EOF'
# ~/.config/crush/crushrc
provider add aicodewith --type openai-compat \
  --base-url "https://api.aicodewith.ai/v1" \
  --api-key "sk-***"
model add aicodewith/claude-haiku-4-5-20251001 --name "Claude Haiku 4.5"
model add aicodewith/gpt-5.5 --name "GPT-5.5"
model add aicodewith/deepseek-flash --name "DeepSeek Flash"
EOF

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 se probaron en Linux (bash). macOS y Windows aún no se han probado, por lo que no se incluyen.

  1. ¿Aún no tienes Crush? Instálalo (omite si ya está instalado)

    Ejecuta npm i -g @charmland/crush, luego crush --version. Un número de versión significa que está instalado.

    Instala Crush con npm i -g @charmland/crush. crush --version luego dibuja su logotipo de píxeles e imprime crush version v0.98.1

  2. Pega la configuración en crushrc y añade tu clave API

    Abre ~/.config/crush/crushrc, pega el bloque de la parte superior de esta página y reemplaza sk-*** con tu clave API (Obtén una clave API). Escribe la clave en sí después de --api-key, no "$AICODEWITH_API_KEY", para que una nueva terminal la conserve.

    En ~/.config/crush/crushrc, establece --api-key con tu clave (enmascarada como sk-*** aquí)

  3. Abre una nueva terminal y prueba Crush

    Abre una nueva terminal y ejecuta crush run --quiet -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK". OK significa que Crush está usando tu clave API.

    Verifica: cierra la terminal, abre una nueva, ejecuta crush run --quiet -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK"; una respuesta OK significa que está configurado

  4. ¿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.

  5. Cambia los modelos de Crush: cambia el nombre después de -m

    Después de -m, escribe aicodewith/ más un modelo que hayas añadido con model add en crushrc, por ejemplo aicodewith/deepseek-flash. Los ID de modelo están en Modelos y precios.

Errores comunes

Sin clave configurada: Agent processing failed: failed to start agent processing stream: unauthorized: {"error":"请在请求中提供有效的 API Key。"}.

Qué ves

Agent processing failed: failed to start agent processing stream: unauthorized: {"error":"请在请求中提供有效的 API Key。"}.
(En inglés: "Please provide a valid API key in the request.")
Causa
--api-key en crushrc es "$AICODEWITH_API_KEY", y el nuevo terminal no tiene esa variable
Cómo corregirlo
Escribe tu clave directamente después de --api-key, como en el paso 2

Volver al paso 2: Pega la configuración en crushrc →

Sin clave configurada: crushrc hace referencia a "$AICODEWITH_API_KEY" pero el nuevo terminal no tiene esa variable. Al ejecutar crush run --quiet -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK" se imprime, bajo una etiqueta ERROR roja: Agent processing failed: failed to start agent processing stream: unauthorized: {"error":"请在请求中提供有效的 API Key。"}. (En inglés: "Please provide a valid API key in the request.")

Clave incorrecta: Agent processing failed: failed to start agent processing stream: unauthorized: {"error":"请在请求中提供有效的 API Key。"}.

Qué ves

Agent processing failed: failed to start agent processing stream: unauthorized: {"error":"请在请求中提供有效的 API Key。"}.
(En inglés: "Please provide a valid API key in the request.")
Causa
La clave en --api-key es incorrecta; el error es el mismo que sin clave
Cómo corregirlo
Copia la clave desde la consola de nuevo y reemplaza el valor entre las comillas de --api-key

Volver al paso 2: Pega la configuración en crushrc →

Clave incorrecta: grep -n sk-wrong ~/.config/crush/crushrc muestra que la línea 3 es --api-key "sk-wrong". Al ejecutar crush run --quiet -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK" se imprime, bajo una etiqueta ERROR roja: Agent processing failed: failed to start agent processing stream: unauthorized: {"error":"请在请求中提供有效的 API Key。"}. (En inglés: "Please provide a valid API key in the request.") — lo mismo que sin clave

403 Forbidden

Qué ves

403 Forbidden (el texto del mensaje varía según la red; p. ej., Request not allowed o Country, region, or territory not supported)
Causa
El comando no tiene -m aicodewith/<model>, por lo que Crush llama al endpoint predeterminado de Anthropic (api.anthropic.com)
Cómo corregirlo
Agrega -m aicodewith/deepseek-flash (u otro modelo de la configuración)

Volver al paso 3: Abre una nueva terminal y prueba Crush →

Error común: sin -m aicodewith/<model>, Crush llama al endpoint predeterminado de Anthropic (api.anthropic.com) y recibe 403 Forbidden (el texto del mensaje varía según la red; p. ej., Request not allowed o Country, region, or territory not supported). Agrega -m aicodewith/deepseek-flash (u otro modelo de la configuración)

Preguntas frecuentes

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

En ~/.config/crush/crushrc, usa provider add para agregar un proveedor openai-compat con --base-url https://api.aicodewith.ai/v1 y escribe tu clave después de --api-key. Una nueva terminal la conserva.

¿openai u openai-compat?

Usa openai-compat. Conserva openai para conectarte directamente a OpenAI.

¿Dónde está el crushrc de Crush?

Global: ~/.config/crush/crushrc. Un .crushrc o crushrc de proyecto tiene prioridad.

Crush dice unauthorized. ¿Ahora qué?

--api-key en crushrc está vacío o es incorrecto. Consulta Errores comunes arriba para la solución.

Fuentes

Enlaces relacionados

Obtén una clave de API de AI Code WithModelos y preciosOtras integraciones