Claude Code
Claude Code se comunica con MartLLM a través de su dirección compatible con Anthropic,
https://api.martllm.com. Con la dirección y tu clave configuradas, los comandos y herramientas de Claude Code
funcionan como antes, y las solicitudes se facturan a tu saldo de MartLLM.
Configurarlo a mano
Nada que ejecutar excepto el propio Claude Code. Crea una clave en tu página de claves, luego:
export ANTHROPIC_BASE_URL=https://api.martllm.com
export ANTHROPIC_AUTH_TOKEN=ull_your_key
claude
Windows PowerShell:
$env:ANTHROPIC_BASE_URL = "https://api.martllm.com"
$env:ANTHROPIC_AUTH_TOKEN = "ull_your_key"
claude
Eso dura para la terminal actual. Para mantenerla sin una clave en tu perfil de shell, guarda la clave en un archivo que solo tú puedas leer:
mkdir -p ~/.uberllm && chmod 700 ~/.uberllm
printf '%s\n' 'ull_your_key' > ~/.uberllm/key && chmod 600 ~/.uberllm/key
y pon esto en ~/.claude/settings.json (todos los proyectos) o en
<project>/.claude/settings.local.json (un proyecto):
{
"apiKeyHelper": "cat ~/.uberllm/key",
"env": {
"ANTHROPIC_BASE_URL": "https://api.martllm.com"
}
}
O usa el instalador
Si tienes Node.js, un comando configura Claude Code y las otras herramientas de codificación en tu máquina (Codex CLI, OpenCode y más) con la misma configuración que el instalador de abajo:
npx uberllm init
Consulta uberllm init para ver qué cambia y cómo deshacerlo.
El instalador hace lo mismo por ti y obtiene la clave a través de tu navegador. Léelo primero si quieres: es texto plano en martllm.com/install/claude-code.sh.
- SHA-256 de
claude-code.sh:34646d5a83e25a1c19057a6bca6aeaaf0118e0e43704d5dbb01e49ab15eb625f - SHA-256 de
claude-code.ps1:5caaa5f15f3e846c535e6668687fe9e0bdcf1e4f9a8a370af09a5137005f44b4
Para comprobarlo antes de ejecutarlo:
curl -fsSL https://martllm.com/install/claude-code.sh -o claude-code.sh
shasum -a 256 claude-code.sh # compare with the hash above
sh claude-code.sh
Cada proyecto en este ordenador:
curl -fsSL https://martllm.com/install/claude-code.sh | sh
Un solo proyecto (ejecútalo dentro del proyecto; otros proyectos permanecen en tu plan de Anthropic):
curl -fsSL https://martllm.com/install/claude-code.sh | sh -s -- --project
Añade una carpeta después de --project para configurar un proyecto distinto al actual.
Windows PowerShell (cada proyecto):
irm https://martllm.com/install/claude-code.ps1 | iex
No necesitas una API key primero, y no necesitas haber iniciado sesión cuando pegues el comando. El instalador abre un enlace en tu navegador (https://martllm.com/cli/link?code=XXXX-XXXX) e imprime el mismo código de confirmación en la terminal. Inicia sesión, comprueba que el código coincide y pulsa Aprobar.
Al aprobar, se crea una API key en tu cuenta y se entrega al instalador que espera. El código en tu terminal no es el secreto: solo el instalador que inició la solicitud puede recoger la clave, la clave se entrega exactamente una vez y la solicitud caduca después de 15 minutos.
Si Claude Code nunca se ha configurado en este ordenador, usa primero la instalación para cada proyecto. Claude Code lee la configuración propia de un proyecto solo después de que confíes en esa carpeta, por lo que una instalación completamente nueva aún podría pedirte que inicies sesión.
Para imprimir el bloque de configuración de tu ordenador sin escribir nada:
curl -fsSL https://martllm.com/install/claude-code.sh | sh -s -- --print
Lo que escribe el instalador
La clave va en un archivo que solo tú puedes leer (modo de carpeta 700, modo de archivo 600):
| Instalación | Archivo de clave | Archivo de configuración |
|---|---|---|
| Cada proyecto | ~/.uberllm/key |
~/.claude/settings.json (o $CLAUDE_CONFIG_DIR/settings.json) |
| Un proyecto | ~/.uberllm/key-<folder>-<number> |
<project>/.claude/settings.local.json |
El archivo de configuración obtiene la dirección y un apiKeyHelper que lee el archivo de clave.
La clave en sí nunca se escribe en un archivo de configuración, para que no termine en una
copia de seguridad, un repositorio de dotfiles o una pantalla compartida.
{
"apiKeyHelper": "cat \"/Users/you/.uberllm/key\"",
"env": {
"ANTHROPIC_BASE_URL": "https://api.martllm.com",
"CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
}
}
Claude Code ejecuta apiKeyHelper para obtener la clave y la envía como
Authorization: Bearer y x-api-key, para que funcione con una pasarela como
MartLLM. Mantiene la respuesta durante cinco minutos (CLAUDE_CODE_API_KEY_HELPER_TTL_MS
lo cambia).
El instalador se fusiona con tu archivo existente en lugar de reemplazarlo, así se mantienen los hooks,
los permisos y los servidores MCP, y copia el archivo antiguo a
<file>.bak-<timestamp> primero. Elimina un ANTHROPIC_AUTH_TOKEN de texto plano
dejado por una instalación anterior. Luego realiza una solicitud real a través de la pasarela, así
que un mensaje de éxito significa que una solicitud se realizó correctamente.
El instalador de Windows aún escribe la clave en settings.json como
ANTHROPIC_AUTH_TOKEN.
Qué configuración gana
Claude Code lee las configuraciones en este orden, la primera gana:
- Configuraciones gestionadas (establecidas por tu empresa, si aplica)
claude --settings <file><project>/.claude/settings.local.json<project>/.claude/settings.json~/.claude/settings.json
Una variable en el bloque env de un archivo de configuración gana a la misma variable en tu shell en la mayoría de las sesiones. Aquí importan dos excepciones:
- La clave. Claude Code usa
ANTHROPIC_AUTH_TOKENprimero, luegoANTHROPIC_API_KEY, luegoapiKeyHelper. Un token exportado en tu shell reemplaza a la clave guardada. - El modelo.
/modelen la sesión gana, luegoclaude --model, luegoANTHROPIC_MODEL, luego la configuraciónmodel. UnANTHROPIC_MODELde shell gana a la configuraciónmodel.
Así que elimina cada variable ANTHROPIC_* de tu shell y de tu perfil de shell
(~/.zshrc, ~/.bashrc) y guárdalas en el archivo de configuración. El instalador te avisa
cuando encuentra una.
Usar otros modelos
Por defecto, nada está fijado: Claude Code pide sus propios nombres de modelo (opus,
sonnet, haiku, claude-opus-5-5…) y MartLLM sirve los mismos modelos de Claude.
Para impulsar Claude Code con DeepSeek, GLM, Qwen, GPT o cualquier otro modelo,
mapea cada una de las ranuras de modelo de Claude Code a un ID de modelo de MartLLM
en el bloque env:
| Variable | Lo que configura |
|---|---|
ANTHROPIC_MODEL |
El modelo con el que se inicia la sesión. |
ANTHROPIC_DEFAULT_OPUS_MODEL |
Lo que significa opus. |
ANTHROPIC_DEFAULT_SONNET_MODEL |
Lo que significa sonnet. |
ANTHROPIC_DEFAULT_HAIKU_MODEL |
Lo que significa haiku. Claude Code también lo usa para tareas en segundo plano, como títulos y resúmenes. |
CLAUDE_CODE_SUBAGENT_MODEL |
El modelo en el que se ejecutan los subagentes. |
{
"apiKeyHelper": "cat \"/Users/you/.uberllm/key\"",
"env": {
"ANTHROPIC_BASE_URL": "https://api.martllm.com",
"ANTHROPIC_MODEL": "deepseek/deepseek-v4-pro",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek/deepseek-v4-pro",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek/deepseek-v4-pro",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek/deepseek-v4-flash",
"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek/deepseek-v4-pro"
}
}
Mapea cada ranura. Una ranura sin configurar sigue pidiendo un modelo de Claude, y pagas precios de Claude por ello.
El instalador hace esto por ti con un perfil:
curl -fsSL 'https://martllm.com/install/claude-code.sh?profile=glm' | sh
Los perfiles son claude-native (el predeterminado, no fija nada), glm, deepseek y
gpt. Cualquier ID de modelo de la tabla de modelos funciona si
configuras las variables manualmente; GET https://api.martllm.com/v1/models los enumera.
Contexto y compactación
Claude Code solo conoce el tamaño del contexto de los modelos Claude. Para cualquier otro modelo, asume 200,000 tokens y compacta la conversación antes de eso.
- Si el modelo tiene un contexto de 1 millones de tokens (su página en martllm.com muestra el contexto), añade
[1m]al final de su ID, por ejemplo"ANTHROPIC_MODEL": "deepseek/deepseek-v4-pro[1m]"oclaude --model 'deepseek/deepseek-v4-pro[1m]'. Claude Code entonces planifica para 1M. - Para cualquier otro tamaño, establece
CLAUDE_CODE_MAX_CONTEXT_TOKENSal contexto del modelo, por ejemplo"CLAUDE_CODE_MAX_CONTEXT_TOKENS": "400000". - Para elegir cuándo compacta: la configuración
autoCompactWindow(o la variableCLAUDE_CODE_AUTO_COMPACT_WINDOW) toma un número de tokens de 100,000 a 1,000,000.CLAUDE_AUTOCOMPACT_PCT_OVERRIDE(1–100) compacta antes, en esa proporción de la ventana.autoCompactEnabled: falselo desactiva.
Establecer un contexto mayor del que tiene el modelo hace que las solicitudes fallen una vez que la conversación supera el modelo.
Qué cambia
- No se usa tu inicio de sesión de claude.ai. Las funciones que lo necesitan, como los conectores de claude.ai,
/scheduley Remote Control, no están disponibles en una sesión que se ejecute en MartLLM. - El costo que muestra Claude Code no es tu factura. Claude Code lo calcula en tu equipo a partir de los precios de lista de Anthropic y no muestra nada útil para otros modelos. Lo que pagas está en Panel de control → API Keys → Uso de la API. Añade tu saldo a la barra de estado (más abajo) para verlo mientras trabajas.
- Tu código va a proveedores de modelos externos. Todo lo que lee la sesión se envía al modelo, que es ejecutado por proveedores de modelos externos en el mercado de MartLLM. No lo uses en un repositorio que contenga secretos, credenciales o datos de clientes.
Saldo en la línea de estado
curl -fsSL https://martllm.com/install/statusline.sh | sh -s -- --install
Esto guarda un pequeño script en ~/.uberllm/statusline.sh y lo añade como el statusLine de Claude Code en ~/.claude/settings.json (añade --project después de --install para ponerlo en el .claude/settings.local.json de este proyecto en su lugar). Debajo del prompt verás:
MartLLM $12.40 · $0.35 held · Opus
Ese es tu saldo disponible, la cantidad retenida para solicitudes aún en curso y el modelo. Lee GET /v1/balance con la misma key que usa Claude Code, como máximo una vez por minuto. Solo necesita sh, curl y sed. Léelo primero en martllm.com/install/statusline.sh.
Verificación
Inicia Claude Code y ejecuta /status: la dirección de la API es https://api.martllm.com. Luego hazle cualquier pregunta; la solicitud aparecerá en Panel → API Keys → Uso de la API en menos de un minuto.
La misma key responde a través de la Messages API:
curl https://api.martllm.com/v1/messages \
-H "Authorization: Bearer $(cat ~/.uberllm/key)" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-haiku-4-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'
Si una solicitud falla con Your apiKeyHelper script is failing, falta el archivo de la key o no se puede leer: vuelve a ejecutar el instalador.
Desinstalar y revocar
curl -fsSL https://martllm.com/install/claude-code.sh | sh -s -- --uninstall
Para una instalación de un solo proyecto, ejecútalo dentro del proyecto con
sh -s -- --project --uninstall. Primero, hace una copia de seguridad del archivo de configuración, elimina
solo lo que añadió y borra el archivo de clave guardado. Claude Code volverá a tu
inicio de sesión de Anthropic en el siguiente inicio.
Desinstalar no revoca la clave; solo deja de usarla. Elimina la clave en tu página de claves para asegurarte de que nunca pueda volver a gastar. Haz esto para cualquier ordenador en el que ya no confíes, o si aprobaste una solicitud que no iniciaste.