Edición en Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# Comprueba un cambio en Claude Code con un modelo local de Ollama

> Una guía basada en documentación para dirigir Claude Code a un modelo local de Ollama, verificar el endpoint y el contexto, y revisar un cambio del repositorio con su comprobación original.

By BIG CHANGE Editorial

Published: 2026-10-20T11:36:37.990Z
Updated: 2026-10-20T11:36:37.990Z
Canonical: https://bigchange.ai/blog/claude-code-local-ollama-checked-change-guide

![Conceptual charcoal illustration of an open desktop workstation showing its fan, memory modules, graphics card and internal cables.](https://bigchange.ai/api/media/file/local-model-workstation-open-chassis-hero-v2.png)
AI-generated conceptual illustration by BIG CHANGE.

Claude Code puede trabajar en un repositorio autorizado mediante un modelo servido por Ollama en tu equipo. La actual [integración de Claude Code con Ollama](https://docs.ollama.com/integrations/claude-code) se conecta directamente a su API compatible con Anthropic. Esta guía lleva un cambio acotado desde una base registrada hasta una decisión humana sobre el diff. Está dirigida a desarrolladores que pueden instalar ambas herramientas, autorizar cambios en el repositorio y ejecutar un modelo local de programación adecuado. BIG CHANGE consultó los manuales el 20 de octubre de 2026; no ejecutamos el modelo ni probamos un repositorio.

## El gran cambio

- **Qué cambió:** Ollama ya documenta una conexión directa de Claude Code a su servidor local compatible con Anthropic, mediante un lanzador o ajustes explícitos del endpoint local. Esta configuración documentada no necesita un proxy separado.
- **Por qué importa:** Puedes conservar el flujo de Claude Code mientras eliges un modelo local, compruebas su asignación real de contexto y revisas una modificación real del repositorio frente a la comprobación de aceptación original.
- **Qué conviene observar:** Una etiqueta local seleccionada y un modelo en ejecución no prueban que todas las solicitudes sean locales ni que el código sea correcto. Verifica el enrutamiento efectivo, los accesos de las herramientas, el diff completo y el resultado antes de aceptar el cambio.

### 1. Registra el punto de partida del repositorio

Trabaja en un repositorio Git propio o que puedas modificar con autorización. Usa una rama revisable o una copia de trabajo desechable. Define un pequeño comportamiento o defecto que cambiar, los archivos afectados y una condición de parada. Busca el comando de aceptación existente, como su prueba o compilación documentada; no lo sustituyas por uno genérico. Ejecútalo **antes** de que el agente edite y registra el comando, el estado de salida y el resultado relevante. Registra también la rama, `git status` y cualquier diff existente. Los cambios previos son parte de la base, no un resultado de la IA.

Confirma que las políticas de código y dependencias permitan el modelo y las herramientas elegidos. Claude Code puede leer archivos y ejecutar comandos según sus permisos efectivos. Pedir «toca solo estos archivos» orienta al agente, pero no limita su acceso al sistema de archivos.

### 2. Instala un modelo local adecuado y asigna contexto

Instala una versión actual de [Ollama](https://docs.ollama.com/quickstart) y [la CLI de Claude Code](https://code.claude.com/docs/en/setup) mediante las instrucciones oficiales y conforme a las normas de tu equipo y organización. Registra `ollama --version` y `claude --version`. Ollama introdujo compatibilidad con Anthropic Messages en la versión 0.14.0 en enero de 2026; esa fecha **no** establece la versión mínima para el comando actual `ollama launch`.

Elige un modelo cuya ficha actual indique soporte de herramientas, cuya licencia permita tu uso y cuyos pesos **y asignación de contexto** quepan en el equipo. Un ejemplo local concreto es [qwen3-coder:30b](https://ollama.com/library/qwen3-coder:30b), listado con herramientas, un archivo Q4\_K\_M de unos 19 GB y Apache License 2.0. Es el tamaño de descarga, no un requisito de RAM o VRAM. El contexto anunciado no significa que tu equipo pueda asignarlo. Si no cabe, elige otra etiqueta local documentada que admita herramientas y sustitúyela coherentemente en los comandos siguientes.

Desde un terminal, con la aplicación o servidor local de Ollama funcionando, descarga y confirma la etiqueta exacta:

```text
ollama pull qwen3-coder:30b
ollama list
```

Ollama [recomienda al menos 64.000 tokens](https://docs.ollama.com/context-length) para agentes de programación y señala que más contexto usa más memoria. Configura 64k o más en los **ajustes de la aplicación Ollama existente**, si el hardware lo permite. Si administras el servidor, configura ese servicio existente con `OLLAMA_CONTEXT_LENGTH=64000` siguiendo las [instrucciones del servidor para tu plataforma](https://docs.ollama.com/context-length); no inicies otro servidor en el puerto 11434. Tras cargarse un modelo por una solicitud, `ollama ps` muestra sus valores reales de `CONTEXT` y `PROCESSOR`. Detente, o reduce la tarea y elige una configuración adecuada, si no se puede cargar la asignación deseada. No presentes el máximo del catálogo como el contexto asignado.

### 3. Dirige Claude Code al servidor local

Abre un terminal **en el repositorio elegido**. Ollama documenta este lanzador; usa la misma etiqueta local confirmada mediante `ollama list`:

```text
ollama launch claude --model qwen3-coder:30b
```

Ollama documenta esta ruta para un modelo distinto de Claude. [El manual de gateways de Anthropic](https://code.claude.com/docs/en/llm-gateway) indica que Anthropic no ofrece soporte al enrutamiento de Claude Code hacia modelos ajenos a Claude mediante un gateway. Trátalo como una integración documentada por Ollama sin soporte de Anthropic para ese enrutamiento, y comprueba la sesión real antes de confiar en ella.

Para una configuración manual, las [instrucciones de integración de Ollama](https://docs.ollama.com/integrations/claude-code#manual-setup) usan en su lugar `ANTHROPIC_AUTH_TOKEN=ollama`, un valor explícitamente vacío para `ANTHROPIC_API_KEY`, y `ANTHROPIC_BASE_URL=http://localhost:11434`. Este comando opcional de **Bash** establece los tres solo para este proceso de Claude Code desde el directorio autorizado; no modifica un perfil global del shell:

```bash
ANTHROPIC_AUTH_TOKEN=ollama ANTHROPIC_API_KEY="" ANTHROPIC_BASE_URL=http://localhost:11434 claude --model qwen3-coder:30b
```

En otros shells, usa preferentemente el lanzador anterior o la configuración actual específica del shell del manual oficial. Examina los ajustes existentes de Claude Code que puedan reemplazar las variables del comando. No muestres credenciales preexistentes al comprobarlos. Los valores efectivos esperados son la etiqueta local elegida y `http://localhost:11434`; es una comprobación para el lector, no un resultado observado por BIG CHANGE. El servidor local ignora el token de ejemplo `ollama`; no es un secreto de control de acceso. La ruta local documentada no requiere una clave cloud de Ollama ni una clave de inferencia de Anthropic. Siguen aplicándose las condiciones del software Claude Code y de los servicios conectados.

Mantén el servidor vinculado localmente según la [guía de configuración del servidor Ollama](https://docs.ollama.com/faq). Una etiqueta `:cloud` o una URL base `https://ollama.com` es una ruta cloud que exige otra decisión sobre datos y costes. Detente antes de enviar contenido del repositorio si el modelo o destino no están claros.

### 4. Comprueba la ruta y pide una edición

Antes de permitir cambios en archivos, inspecciona el modelo y la conexión efectivos de Claude Code con `/status` cuando esté disponible. Compara lo observado con el lanzador o endpoint manual, `ollama list` y, tras cargar el modelo una solicitud, `ollama ps`. Registra la etiqueta exacta cargada, la asignación de `CONTEXT` y `PROCESSOR`; una distribución con CPU puede cambiar la viabilidad práctica. Cuando exista, consulta también la evidencia de solicitudes del servidor local. Estas comprobaciones establecen la configuración y carga del modelo, no una auditoría completa del tráfico de red. Revisa por separado las herramientas MCP activadas, la búsqueda y lectura web, la telemetría y los ajustes cloud si tu política exige tratamiento local.

Usa las solicitudes normales de aprobación de Claude Code y sus [controles de permisos](https://code.claude.com/docs/en/permissions). Pide en lenguaje corriente la única tarea del repositorio autorizado: comportamiento necesario, alcance permitido, comando de aceptación original y punto de parada. Pide los archivos modificados y los resultados. Deja commit, push y publicación al propietario y rechaza acciones de red o herramientas inesperadas. Que el modelo afirme usar el endpoint local o superar una comprobación no es verificación.

### 5. Decide a partir del diff completo y la comprobación original

Examina cada archivo modificado y el **diff completo de Git**, incluidos cambios fuera del alcance pedido. Compara el cambio con el comportamiento original y las políticas, incluida la licencia de cualquier dependencia nueva. Ejecuta tú mismo el comando de aceptación registrado tras editar. Guarda el estado de salida y el resultado relevante junto a la base. Acepta solo si el diff responde a lo pedido, la comprobación independiente resulta aceptable y la evidencia de enrutamiento y permisos cumple tus requisitos. Si no, deja la rama sin aceptar y conserva el fallo exacto para revisión.

Si Ollama no responde, comprueba la aplicación o servicio y `ollama list` antes de intentar la tarea. Si el modelo no carga o `ollama ps` indica contexto insuficiente, revisa la memoria y el ajuste de contexto; reduce la tarea o elige un modelo local adecuado. Si `/status` o los ajustes efectivos muestran un proveedor alojado, detente antes de enviar código y repara el shell actual o los ajustes de Claude Code. Un error de herramienta puede deberse a compatibilidad del modelo o denegación de permisos; inspecciona la respuesta exacta antes de cambiar nada. Si un intento ya editó archivos, mira el diff antes de revertir o continuar. Tras fallar la aceptación, diagnostica el código y repite la comprobación solo después de una corrección revisada.

La inferencia local evita el cargo por token del proveedor para el modelo descargado, pero usa hardware, almacenamiento y electricidad. Descargas, telemetría, herramientas web, integraciones MCP o modelos cloud pueden enviar datos o generar otros costes. Ollama admite un [subconjunto de la API Messages de Anthropic](https://docs.ollama.com/api/anthropic-compatibility), con límites en recuento de tokens, caché de prompts, lotes, citas, PDF y elección forzada de herramientas; la capacidad de usar herramientas también varía por modelo. La revisión documental de BIG CHANGE no midió velocidad, calidad, privacidad ni ahorro. Para otra configuración de agente local, consulta nuestra [guía de Junie Local](https://bigchange.ai/blog/junie-local-windows-coding-agent-setup); este procedimiento conserva específicamente Claude Code y verifica su ruta Ollama.

## Fuentes y lecturas adicionales

- [Ollama, «Claude Code»](https://docs.ollama.com/integrations/claude-code) proporciona el lanzador actual, ajustes locales manuales y alternativa cloud. Documenta una ruta, no una ejecución exitosa en el repositorio del lector.
- [Ollama, «Compatibilidad con Anthropic»](https://docs.ollama.com/api/anthropic-compatibility) describe el endpoint local, token de ejemplo ignorado, descarga de modelos y límites de la API. La compatibilidad no certifica cada modelo o llamada de herramienta.
- [Ollama, «Longitud de contexto»](https://docs.ollama.com/context-length) explica la recomendación de 64k para programación, el equilibrio de memoria y la consulta de `ollama ps`. La máquina real determina la asignación viable.
- [La ficha qwen3-coder:30b de Ollama](https://ollama.com/library/qwen3-coder:30b) enumera el archivo de ejemplo, herramientas y licencia Apache 2.0 enlazada. Revisa la ficha exacta antes de descargar o redistribuir.
- [Instalación de Claude Code](https://code.claude.com/docs/en/setup) y [ajustes de permisos](https://code.claude.com/docs/en/permissions) describen el acceso y las autorizaciones de herramientas. Ninguno demuestra el endpoint efectivo de una sesión ni un resultado seguro para el repositorio.
- [Anthropic, «Otros gateways LLM»](https://code.claude.com/docs/en/llm-gateway) indica que Anthropic no ofrece soporte a dirigir Claude Code hacia modelos ajenos a Claude mediante un gateway. Ollama documenta por separado la integración local descrita aquí.

## Sources

- [Claude Code — Ollama](https://docs.ollama.com/integrations/claude-code) — Instrucciones principales del lanzador y endpoint local manual, además de la ruta cloud separada. No prueban que una ejecución concreta usara localhost.
- [Compatibilidad con Anthropic — Ollama](https://docs.ollama.com/api/anthropic-compatibility) — Endpoint Messages local, token de ejemplo ignorado, descarga del modelo y funciones no admitidas. La compatibilidad varía por modelo y herramienta.
- [Longitud de contexto — Ollama](https://docs.ollama.com/context-length) — Recomendación de 64k para programación, equilibrio de memoria y lectura de contexto/procesador con ollama ps; no certifica la capacidad de una máquina concreta.
- [qwen3-coder:30b — Biblioteca de modelos Ollama](https://ollama.com/library/qwen3-coder:30b) — Etiqueta local exacta del ejemplo, herramientas, archivo Q4_K_M de unos 19 GB y enlace Apache 2.0; el tamaño de descarga no equivale a la memoria de trabajo necesaria.
- [Inicio rápido — Ollama](https://docs.ollama.com/quickstart) — Ruta oficial de instalación e inicio; el lector debe verificar las instrucciones actuales de su plataforma y la versión instalada.
- [Preguntas frecuentes — Ollama](https://docs.ollama.com/faq) — Configuración del servidor local y límite de red/cloud; no es una auditoría completa de la privacidad de Claude Code o sus integraciones.
- [Soporte de Claude Code — Ollama](https://ollama.com/blog/claude) — Fecha la compatibilidad Messages en v0.14.0; no establece la versión mínima del lanzador actual.
- [Configuración avanzada — Claude Code Docs](https://code.claude.com/docs/en/setup) — Instalación oficial y requisitos por plataforma; no se instaló ni ejecutó Claude Code para este artículo.
- [Configurar permisos — Claude Code Docs](https://code.claude.com/docs/en/permissions) — Autorización de herramientas y permisos efectivos; una instrucción de ruta en lenguaje natural no es un sandbox.
- [Otros gateways LLM — Claude Code Docs](https://code.claude.com/docs/en/llm-gateway) — Anthropic no ofrece soporte a dirigir Claude Code hacia modelos ajenos a Claude mediante un gateway. Es el límite de soporte del proveedor junto a la integración local documentada por Ollama, no una conclusión legal.