Models — manage which models appear, and add your own.Modelos — gestiona qué modelos aparecen y añade los tuyos propios.
Everything about which models free-code offers lives in ~/.free-code/agent/models.json.Todo lo relacionado con qué modelos ofrece free-code vive en ~/.free-code/agent/models.json.
~/.free-code/agent/models.json is the single place you edit to control the
model list. It is re-read every time you open /model, so changes
apply without restarting. Use it to:~/.free-code/agent/models.json es el único lugar que editas para controlar la
lista de modelos. Se vuelve a leer cada vez que abres /model, así que los cambios
se aplican sin reiniciar. Úsalo para:
/model (the only whitelist) — including built-in ones.Seleccionar qué modelos se muestran en /model (la lista blanca only) — incluidos los integrados.models.json with an only whitelist
containing the most-used models (4 per provider) of each provider you can log in to, so
/model is short out of the box instead of listing the whole factory catalog.
It is only created if the file doesn't already exist — your edits are never overwritten.
models.json con una lista blanca only
que contiene los modelos más usados (4 por proveedor) de cada proveedor en el que puedes iniciar sesión, de modo que
/model sea breve desde el principio en lugar de listar todo el catálogo de fábrica.
Solo se crea si el archivo aún no existe — tus ediciones nunca se sobrescriben.
only whitelistSeleccionar la lista — la lista blanca onlyShow just the models you use, instead of every factory model.Muestra solo los modelos que usas, en lugar de todos los modelos de fábrica.
Add a top-level only array. When present and non-empty, /model shows only matching models:Añade un array only de nivel superior. Cuando está presente y no vacío, /model muestra solo los modelos que coincidan:
{
"only": [
"anthropic/claude-sonnet-4-6",
"anthropic/claude-haiku-4-5",
"fireworks/**",
"lmstudio/**"
],
"providers": {}
}provider/id (list ids with free-code --list-models).Añadir un modelo: añade su provider/id (lista los ids con free-code --list-models).only key (or set it to []).Mostrar todo: elimina la clave only (o ponla en []).lmstudio/** or fireworks/**.Conservar un proveedor completo: usa un glob como lmstudio/** o fireworks/**.
Matching is lenient: each entry matches by provider/id, id, or name
(case-insensitive; . - _ and spaces treated alike) or as a
glob. If the whitelist accidentally matches nothing, free-code falls back to showing all
models so the picker is never empty. Selecting a model explicitly with --model
still works even if it isn't in only.La coincidencia es flexible: cada entrada coincide por provider/id, id o nombre
(sin distinguir mayúsculas/minúsculas; . - _ y espacios se tratan igual) o como
glob. Si la lista blanca no coincide accidentalmente con nada, free-code recurre a mostrar todos los
modelos para que el selector nunca esté vacío. Seleccionar un modelo explícitamente con --model
sigue funcionando aunque no esté en only.
Built-in providers appear in /model once you authenticate. You can also add any OpenAI-compatible endpoint.Los proveedores integrados aparecen en /model una vez que te autenticas. También puedes añadir cualquier endpoint compatible con OpenAI.
/login (OAuth)Inicia sesión con /login (OAuth)| ProviderProveedor | Sign-in / tokenInicio de sesión / token |
|---|---|
anthropic | Claude subscription or ANTHROPIC_API_KEYSuscripción a Claude o ANTHROPIC_API_KEY |
openai-codex | ChatGPT / Codex sign-inInicio de sesión de ChatGPT / Codex |
github-copilot | Copilot sign-in (or GH_TOKEN)Inicio de sesión de Copilot (o GH_TOKEN) |
google-gemini-cli | Gemini CLI sign-inInicio de sesión de Gemini CLI |
google-antigravity | Google Antigravity sign-inInicio de sesión de Google Antigravity |
| ProviderProveedor | Environment variableVariable de entorno |
|---|---|
openai | OPENAI_API_KEY |
azure-openai-responses | AZURE_OPENAI_API_KEY (+ base URL)(+ URL base) |
google | GEMINI_API_KEY |
google-vertex | GOOGLE_APPLICATION_CREDENTIALS oro GOOGLE_CLOUD_API_KEY |
amazon-bedrock | AWS credentials /Credenciales de AWS / AWS_BEARER_TOKEN_BEDROCK |
xai | XAI_API_KEY |
groq | GROQ_API_KEY |
cerebras | CEREBRAS_API_KEY |
openrouter | OPENROUTER_API_KEY |
vercel-ai-gateway | AI_GATEWAY_API_KEY |
zai | ZAI_API_KEY |
mistral | MISTRAL_API_KEY |
minimax / minimax-cn | MINIMAX_API_KEY / MINIMAX_CN_API_KEY |
huggingface | HF_TOKEN |
opencode / opencode-go | OPENCODE_API_KEY |
kimi-coding | KIMI_API_KEY |
Define providers and models under providers. Keys resolve from env vars, a shell command, or a literal value.Define proveedores y modelos bajo providers. Las claves se resuelven a partir de variables de entorno, un comando de shell o un valor literal.
Cloud (e.g. Fireworks) — key from an environment variable:Nube (por ejemplo, Fireworks) — clave desde una variable de entorno:
{
"providers": {
"fireworks": {
"baseUrl": "https://api.fireworks.ai/inference/v1",
"api": "openai-completions",
"apiKey": "FIREWORKS_API_KEY",
"authHeader": true,
"models": [
{ "id": "accounts/fireworks/models/kimi-k2p7-code", "name": "Kimi K2.7 Code" }
]
}
}
}Local (LM Studio / Ollama) — any dummy key works:Local (LM Studio / Ollama) — cualquier clave ficticia funciona:
{
"providers": {
"ollama": {
"baseUrl": "http://localhost:11434/v1",
"api": "openai-completions",
"apiKey": "ollama",
"compat": { "supportsDeveloperRole": false, "supportsReasoningEffort": false },
"models": [ { "id": "qwen2.5-coder:7b" } ]
}
}
}~/.free-code/agent/.env on startup, so you can keep
FIREWORKS_API_KEY (and other secrets) there and reference them by name in
models.json.
~/.free-code/agent/.env al arrancar, así que puedes mantener
FIREWORKS_API_KEY (y otros secretos) ahí y referenciarlos por nombre en
models.json.
Full schema, value resolution, overriding built-ins, and OpenAI-compat flags: see packages/coding-agent/docs/models.md and docs/local-models-setup.md.Esquema completo, resolución de valores, sobrescritura de modelos integrados y flags de compatibilidad con OpenAI: consulta packages/coding-agent/docs/models.md y docs/local-models-setup.md.