Gumawa ng isang nasuring pagbabago sa Claude Code gamit ang lokal na Ollama model

Maaaring magtrabaho ang Claude Code sa repository na pag-aari mo gamit ang model na pinapatakbo ng Ollama sa iyong computer. Ang kasalukuyang pagsasama ng Claude Code ng Ollama ay direktang kumokonekta sa Anthropic-compatible API nito. Sinusundan ng gabay ang isang limitadong pagbabago sa code mula sa naitalang panimulang kalagayan hanggang sa pasya ng tao tungkol sa diff. Para ito sa developer na makakapag-install ng dalawang tool, makakapagpahintulot ng pag-edit sa repository, at makakapagpatakbo ng angkop na lokal na coding model. Sinuri ng BIG CHANGE ang mga manwal noong 20 Oktubre 2026; hindi namin pinatakbo ang model o sinubukan ang isang repository.

Ang malaking pagbabago

• Ano ang nagbago: Inilalarawan na ngayon ng Ollama ang direktang ruta ng Claude Code patungo sa lokal nitong Anthropic-compatible server, gamit ang launcher o tahasang mga setting ng lokal na endpoint. Hindi kailangan ng hiwalay na proxy sa dokumentadong setup na ito.
• Bakit mahalaga: Mapapanatili mo ang daloy ng trabaho sa Claude Code habang pumipili ng lokal na model, sinusuri ang aktuwal na inilaan nitong context, at inihahambing ang tunay na pag-edit sa repository sa orihinal na pagsusulit sa pagtanggap ng proyekto.
• Ano ang dapat bantayan: Hindi patunay ang napiling lokal na tag at tumatakbong model na nanatiling lokal ang bawat request o tama ang code nito. Suriin ang aktuwal na ruta, access ng mga tool, buong diff at resulta ng pagsusulit bago tanggapin ang pagbabago.

1. Itala ang panimulang kalagayan ng repository

Gumamit ng Git repository na pag-aari mo o may pahintulot kang baguhin. Gumamit ng branch na maaaring suriin o checkout na maaaring itapon. Tukuyin ang isang maliit na asal o depektong babaguhin, mga file na maaaring maapektuhan at kundisyon ng paghinto. Hanapin ang umiiral na command sa pagtanggap ng repository, gaya ng dokumentadong test o build check; huwag itong palitan ng pangkalahatang command. Patakbuhin ito bago mag-edit ng anuman ang agent at itala ang command, exit status at mahalagang output. Itala rin ang branch, git status at anumang umiiral na diff. Bahagi ng panimulang kalagayan ang mga naunang pagbabago, hindi ng resulta ng AI.

Tiyaking pinapayagan ng mga patakaran ng organisasyon sa code at dependency ang napiling model at mga tool. Maaaring bumasa ng mga file at magpatakbo ng mga command ang Claude Code ayon sa aktuwal na mga pahintulot nito. Ang utos na “ang mga file na ito lang ang baguhin” ay gabay sa agent ngunit hindi naglilimita sa access nito sa filesystem.

2. Mag-install ng angkop na lokal na model at maglaan ng context

Mag-install ng kasalukuyang bersyon ng Ollama at Claude Code CLI ayon sa kanilang opisyal na mga tagubilin at mga tuntunin ng iyong computer at organisasyon. Itala ang ollama --version at claude --version. Idinagdag ng Ollama ang pagiging tugma sa Anthropic Messages sa bersyon 0.14.0 noong Enero 2026; ang petsang iyon ay hindi nagtatakda ng pinakamababang bersyon para sa kasalukuyang ollama launch command.

Pumili ng model na ang kasalukuyang tala sa katalogo ay may suporta sa mga tool, pinapayagan ng lisensya ang iyong paggamit, at ang mga weight at inilaan na context ay kasya sa iyong computer. Isang tiyak na lokal na halimbawa ang qwen3-coder:30b, na nakalistang may suporta sa mga tool, humigit-kumulang 19 GB na Q4_K_M artifact at Apache License 2.0. Laki iyon ng download, hindi kinakailangang RAM o VRAM. Hindi ibig sabihin ng ipinatalastas na context ng model na kaya itong ilaan ng iyong computer. Kung hindi kasya ang model, pumili ng ibang dokumentadong lokal na tag na may suporta sa mga tool at gamitin ang kapalit na tag sa lahat ng susunod na command.

Mula sa terminal, matapos tumakbo ang Ollama app o lokal na server, i-download at kumpirmahin ang eksaktong tag:

ollama pull qwen3-coder:30b
ollama list

Ang Ollama ay nagrerekomenda ng hindi bababa sa 64,000 token para sa mga coding agent at nagsasabing mas maraming memory ang kailangan ng mas malaking context. Itakda ang 64k o higit pa sa mga setting ng umiiral na Ollama app, kung kaya ng iyong hardware. Kung ikaw ang nagpapatakbo ng server, ayusin ang umiiral na serbisyong iyon gamit ang OLLAMA_CONTEXT_LENGTH=64000 ayon sa mga tagubilin ng server para sa iyong platform; huwag magsimula ng ikalawang server sa port 11434. Pagkatapos mag-load ng isang request sa model, ipinapakita ng ollama ps ang aktuwal nitong CONTEXT at PROCESSOR. Huminto o bawasan ang saklaw ng gawain at pumili ng angkop na setup kung hindi ma-load ang nilalayong alokasyon. Huwag ituring na aktuwal na inilaan na context ang pinakamataas na nasa katalogo.

3. Ituro ang Claude Code sa lokal na server

Magbukas ng terminal sa napiling repository. Dokumentado ng Ollama ang rutang ito gamit ang launcher; gamitin ang parehong lokal na tag na nakumpirma ng ollama list:

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

Dokumentado ng Ollama ang rutang ito para sa model na hindi Claude. Ang manwal ng Anthropic tungkol sa mga gateway ay nagsasabing hindi sinusuportahan ng Anthropic ang pagtuturo ng Claude Code sa mga model na hindi Claude sa pamamagitan ng gateway. Ituring itong integrasyong dokumentado ng Ollama na walang suporta ng Anthropic para sa rutang iyon, at suriin ang aktuwal na session bago umasa rito.

Para sa manu-manong setup, ang mga tagubilin sa integrasyon ng Ollama ay gumagamit sa halip ng ANTHROPIC_AUTH_TOKEN=ollama, isang tahasang walang laman na ANTHROPIC_API_KEY, at ANTHROPIC_BASE_URL=http://localhost:11434. Itinatakda ng opsyonal na Bash command na ito ang tatlo para lamang sa prosesong ito ng Claude Code, mula sa directory ng repository na pag-aari mo; hindi nito binabago ang pangkalahatang shell profile:

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

Para sa ibang shell, gamitin ang inirerekomendang Ollama launcher sa itaas o ang setup para sa partikular na shell sa kasalukuyang opisyal na manwal. Suriin ang umiiral na mga setting ng Claude Code na maaaring manaig sa mga variable ng command. Huwag ilabas ang anumang dati nang credential habang sinusuri ang mga setting. Ang inaasahang aktuwal na mababasa ay ang napiling lokal na tag at http://localhost:11434; pagsusuri itong gagawin ng mambabasa, hindi resultang naobserbahan ng BIG CHANGE. Hindi pinapansin ng lokal na server ang ollama na placeholder token; hindi ito lihim na pangkontrol ng access. Hindi kailangan ng dokumentadong lokal na ruta ng Ollama cloud key o Anthropic inference key. Nalalapat pa rin ang mga tuntunin ng software ng Claude Code at mga nakakonektang serbisyo.

Panatilihing lokal lamang ang pag-bind ng server ayon sa gabay ng Ollama sa pagsasaayos ng server. Ang :cloud na tag o https://ollama.com na base URL ay ruta sa cloud na may ibang pasya tungkol sa data at gastos. Huminto bago magpadala ng nilalaman ng repository kung hindi malinaw ang model o destinasyon.

4. Suriin ang ruta, saka humiling ng isang pag-edit

Bago payagan ang mga pagbabago sa file, suriin ang aktuwal na model at koneksyon ng Claude Code gamit ang /status kung available. Ihambing ang nabasang iyon sa launcher o manu-manong endpoint, ollama list, at, matapos mag-load ang model dahil sa request, ollama ps. Itala ang eksaktong naka-load na tag, inilaan na CONTEXT at PROCESSOR; maaaring baguhin ng paghahati ng pagproseso sa CPU kung praktikal ang daloy ng trabaho. Kung available, suriin din ang ebidensya ng mga request sa lokal na server. Pinatutunayan ng mga pagsusuring ito ang configuration at pag-load ng model, hindi ang kumpletong pagsusuri ng lahat ng trapiko sa network. Hiwalay na suriin ang mga pinaganang MCP tool, pagkuha o paghahanap sa web, telemetry at anumang cloud setting kung mahalaga ang lokal na pagproseso sa patakaran mo sa code.

Gamitin ang karaniwang mga prompt ng Claude Code para sa pag-apruba at mga kontrol sa pahintulot. Hilingin ang iisang gawain sa repository na pag-aari mo gamit ang pangkaraniwang wika: tukuyin ang kailangang asal, pinapayagang saklaw, orihinal na command sa pagtanggap at kung saan hihinto. Hilinging iulat ang mga binagong file at output ng pagsusulit. Iwan sa may-ari ng repository ang mga pasya sa commit, push at release, at tanggihan ang di-inaasahang aksyon sa network o tool. Hindi pagpapatunay ang pahayag ng model na ginamit nito ang lokal na endpoint o pumasa ito sa pagsusulit.

5. Magpasya batay sa buong diff at orihinal na pagsusulit

Suriin ang bawat binagong file at ang buong Git diff, kasama ang mga pagbabagong labas sa hiniling na saklaw. Ihambing ang pagbabago sa orihinal na asal at patakaran ng repository, kabilang ang lisensya ng anumang bagong dependency. Ikaw mismo ang magpatakbo ng parehong naitalang command sa pagtanggap pagkatapos ng pag-edit. Itala ang exit status at mahalagang output kasama ng panimulang kalagayan. Tanggapin lamang ang pagbabago kung tugma ang diff sa kahilingan, katanggap-tanggap ang resulta ng hiwalay na pagsusulit, at natutugunan ng ebidensya sa ruta at pahintulot ang iyong mga kailangan. Kung hindi, huwag tanggapin ang branch at panatilihin ang eksaktong pagkabigo para masuri.

Kung hindi makonekta ang Ollama, suriin ang tumatakbong app o serbisyo at ollama list bago subukan ang gawain sa code. Kung hindi ma-load ang model o ang ollama ps ay nag-uulat ng kulang na context, suriin ang memory at setting ng context; gumamit ng gawaing mas maliit ang saklaw o angkop na lokal na model. Kung ang /status o aktuwal na mga setting ay nagpapakita ng hosted provider, huminto bago magpadala ng code at ayusin ang kasalukuyang shell o mga setting ng Claude Code. Maaaring sanhi ng pagiging tugma ng model o pagtanggi ng pahintulot ang error sa pagtawag ng tool; suriin ang eksaktong tugon bago baguhin ang alinman. Kung nakapag-edit na ng mga file ang pagtatangka, suriin ang diff bago ibalik o magpatuloy. Matapos mabigo ang pagsusulit sa pagtanggap, alamin ang sanhi sa code at ulitin lamang ang pagsusulit pagkatapos ng nasuring pagwawasto.

Naiiwasan ng lokal na inference ang singil ng provider kada token para sa na-download na model, ngunit gumagamit ito ng hardware, storage at kuryente. Maaaring magpadala ng data o magkaroon ng ibang gastos ang mga download, telemetry, web tool, MCP integration o cloud model setting. Sinusuportahan ng Ollama ang isang bahagi ng Anthropic Messages API, na may mga limitasyon sa mga tampok gaya ng pagbibilang ng token, prompt caching, batch, citation, PDF at sapilitang pagpili ng tool; nag-iiba rin ang kakayahan ng bawat model sa paggamit ng tool. Walang nasukat na resulta sa bilis, kalidad, privacy o pagtitipid mula sa pagsusuri ng BIG CHANGE sa dokumentasyon. Para sa ibang lokal na agent setup, tingnan ang aming gabay sa Junie Local; partikular na pinananatili ng pamamaraang ito ang Claude Code at sinusuri ang ruta nito sa Ollama.

Mga sanggunian at karagdagang babasahin

• Ollama, “Claude Code” ay nagbibigay ng kasalukuyang launcher, manu-manong lokal na mga setting at alternatibong cloud. Nagdodokumento ito ng ruta, hindi ng matagumpay na pagtakbo sa repository ng mambabasa.
• Ollama, “Anthropic compatibility” ay naglalarawan ng lokal na endpoint, hindi pinapansing placeholder token, pag-download ng model at mga limitasyon ng tampok ng API. Hindi ginagarantiya ng pagiging tugma ang bawat model o pagtawag sa tool.
• Ollama, “Context length” ay nagpapaliwanag ng rekomendasyong 64k para sa coding, kapalit na paggamit ng memory at ang nababasa sa ollama ps. Ang aktuwal na computer ang nagtatakda ng posibleng alokasyon.
• Ang tala ng Ollama para sa qwen3-coder:30b ay naglilista ng halimbawang artifact, mga tool at naka-link na Apache 2.0 license. Suriin muli ang eksaktong tala ng model bago mag-download o muling ipamahagi ito.
• Ang pag-install ng Claude Code at mga setting ng pahintulot ay naglalarawan ng access at pag-apruba sa mga tool. Wala sa dalawa ang nagpapatunay sa aktuwal na endpoint ng partikular na session o ligtas na resulta sa repository.
• Anthropic, “Other LLM gateways” ay nagsasaad na hindi sinusuportahan ng Anthropic ang pagtuturo ng Claude Code sa mga model na hindi Claude gamit ang gateway. Hiwalay na dokumentado ng Ollama ang lokal na integrasyong inilalarawan dito.