
Claude Code toimitetaan Anthropicin mallien kanssa, mutta yksi ympäristömuuttuja, ANTHROPIC_BASE_URL, antaa sinun ohjata pyynnöt käytännössä mille tahansa LLM-palveluntarjoajalle. Tämä tarkoittaa, että voit vaihtaa DeepSeekiin hinnalla noin 0,27 dollaria miljoonaa output-tokenia kohden Claude Opusin sijaan, jonka hinta on 25 dollaria, tai ajaa malleja paikallisesti Ollaman kautta ilmaiseksi. Tämä opas kattaa kaikki tavat käyttää eri malleja Claude Codessa, ja se rakentuu yksityiskohtaisen Claude Code -vertailumme päälle tarjoamalla käytännön asennusohjeet kullekin lähestymistavalle.
Kaikki menetelmät yhdellä silmäyksellä
Valitse tilanteeseesi sopiva menetelmä ja siirry sen osioon saadaksesi asennuskoodin.
| Menetelmä | Sopii parhaiten | Kustannus | Asennus | Mallit |
|---|---|---|---|---|
| OpenRouter | Mallien monipuolisuus, yksi API-avain | Maksu per token (läpivienti) | Helppo | 300+ |
| Ollama | Yksityisyys, ilmainen, offline | Ilmainen (oma laitteisto) | Helppo | 50+ avoimen lähdekoodin |
| LM Studio | Paikalliset mallit graafisella käyttöliittymällä | Ilmainen (oma laitteisto) | Helppo | 50+ avoimen lähdekoodin |
| claude-code-router | Älykäs reititys tehtäväkohtaisesti | Vaihtelee palveluntarjoajan mukaan | Keskitaso | Riippuu konfiguraatiosta |
| claude-code-proxy | Gemini/OpenAI-taustajärjestelmä | Palveluntarjoajan hinnoittelu | Keskitaso | OpenAI + Gemini |
| LiteLLM | Yrityskäyttö, kuormantasaus | Palveluntarjoajan hinnoittelu | Edistynyt | 100+ eri palveluntarjoajilta |
Jatka lukemista nähdäksesi vaiheittaiset asennusohjeet kullekin menetelmälle, tai siirry suoraan päätöskehykseen, jos tiedät jo, mitä tarvitset.
Miten Claude Code -mallin vaihto todellisuudessa toimii?
Ennen kuin konfiguroit välityspalvelimen, sinun on ymmärrettävä, miksi useimmat oppaat jättävät sinut rikkinäisen asennuksen äärelle. Claude Code käyttää sisäisesti kolmea mallipaikkaa, ei yhtä:
- Haiku-paikka, taustatehtäviin kuten tiedostojen yhteenvetoihin ja välilehtien täydennyksiin
- Sonnet-paikka, oletuskoodaus, malli, jonka kanssa vuorovaikutat eniten
- Opus-paikka, monimutkaiseen päättelyyn, suunnitteluun ja monivaiheisiin agenttitehtäviin
Kun vaihdat mallia komennolla /model tai parametrilla --model, vaihdat vain ensisijaisen paikan. Claude Code yrittää edelleen kutsua kahta muuta paikkaa käyttämällä Anthropicin API:a. Jos olet osoittanut ANTHROPIC_BASE_URL:n välityspalvelimeen, mutta asettanut vain yhden mallin, nämä muut paikat epäonnistuvat virheellä "model not found" (mallia ei löydy).
Ratkaisu: aseta kaikki kolme ympäristömuuttujaa, jotta jokainen paikka reititetään välityspalvelimesi kautta.
# Cut Claude Code's Bill 90%: Run OpenRouter, Ollama or LiteLLM
export ANTHROPIC_DEFAULT_HAIKU_MODEL="your-haiku-equivalent"
export ANTHROPIC_DEFAULT_SONNET_MODEL="your-sonnet-equivalent"
export ANTHROPIC_DEFAULT_OPUS_MODEL="your-opus-equivalent"Natiivi mallinvaihto (Anthropicin mallit)
Jos pysyt Anthropicin malliperheessä, vaihtaminen on suoraviivaista. Käytä /model-komentoa Claude Coden sisällä, anna --model käynnistäessäsi terminaalista tai lisää malleja availableModels-taulukkoon asetustiedostossasi. Anthropic lisää tähän jatkuvasti uusia vaihtoehtoja, ja katsauksemme vuoden 2026 uusimmista Claude Code -ominaisuuksista seuraa hiljattain julkaistuja uutuuksia.
opusplan-strategia
opusplan on Claude Coden sisäänrakennettu monimallireititys. Se lähettää taustatehtävät Haikulle ja ohjaa monimutkaisen päättelyn Opukselle automaattisesti. Sitä ei tarvitse konfiguroida manuaalisesti; valitse se vain malliksi. Se on Anthropicin oma vastaus kysymykseen "miksi maksan Opus-hintoja tiedostoluettelosta?". Kannattaa kokeilla ennen kuin turvaudut kolmannen osapuolen reitittimeen, yhdessä Anthropicin fast moden kanssa, jos raaka nopeus on etusijalla.
OpenRouter, yksi API-avain, 300+ mallia
OpenRouter toimii API-aggregaattorina. Saat yhden API-avaimen ja pääsyn yli 300 malliin Anthropicilta, Googlelta, Metalta, Mistralilta, DeepSeekiltä ja muilta. Hinnoittelu on useimmille malleille läpivientihinta ilman katetta.
Asennusvaiheet
- Luo tili osoitteessa openrouter.ai ja luo API-avain
- Suorita
claude /logouttyhjentääksesi mahdollisen olemassa olevan Anthropic-istunnon - Aseta ympäristömuuttujasi:
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_API_KEY="sk-or-v1-your-key-here"
# Map all three model slots
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek/deepseek-chat-v3"
export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-4"
export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-4"- Käynnistä
claudeja varmista yhteys
Huomaa kolme paikkamuuttujaa; jos ohitat ne, kohtaat yllä käsitellyn "model not found" -virheen. Virallinen OpenRouter-integraatio-opas vahvistaa tämän asennustavan.
Suositellut mallit OpenRouterin kautta
Kaikki OpenRouterin mallit eivät käsittele Claude Coden työkalukutsuja luotettavasti. Tässä ovat ne, jotka toimivat hyvin:
| Tehtävä | Malli | Miksi |
|---|---|---|
| Halvat taustatehtävät | DeepSeek V3.2 | 0,27 $ / 1,10 $ per MTok, kelvollinen työkalukutsujen tuki |
| Oletuskoodaus | Claude Sonnet 4 | Sama laatu kuin suorassa käytössä, konsolidoitu laskutus |
| Valtavat koodikannat (1M konteksti) | Gemini 2.5 Flash | 0,15 $ / 0,60 $ per MTok, valtava konteksti-ikkuna |
| Monimutkainen päättely | Claude Opus 4 | Paras agenttinen koodauslaatu |
Kustannukset ja laskutus
OpenRouter veloittaa useimmista malleista läpivientihinnan. Maksat tarkalleen sen, mitä underlying-palveluntarjoaja veloittaa, plus pienen marginaalin joistakin kolmannen osapuolen malleista. Aseta kulurajat OpenRouter-koordinaatistossasi välttääksesi yllätykset.
Tuomio: OpenRouter on paras vaihtoehto kehittäjille, jotka haluavat maksimaalisen mallivalikoiman minimaalisella asennuksella. Yksi API-avain, yksi laskutusnäkymä, 300+ mallia. Vaikea voittaa joustavuudessa.
Ollama, ilmainen, paikallinen ja yksityinen
Ollama ajaa malleja kokonaan omalla koneellasi. Versiosta 0.14.0 (tammikuu 2026) alkaen se tukee natiivisti Anthropic Messages API:a, mikä tarkoittaa, että Claude Code voi kommunikoida sen kanssa ilman käännöskerros. Koodisi ei koskaan poistu koneeltasi.
Esitiedot ja laitteisto
Tarvitset kunnollisen laitteiston käyttökelpoista kokemusta varten:
- 7B mallit (nopeat muutokset, yksinkertaiset tehtävät): vähintään 16 GB RAM
- 14B mallit (vankka koodauslaatu): 32 GB RAM, GPU suositeltu
- 32B+ mallit (lähes pilvilaatu): 64 GB RAM tai omistettu GPU, jossa 24 GB+ VRAM
Syvempään sukellukseen laitteistovaatimuksiin ja mallinvalintaan, tutustu oppaaseemme LLM:ien ajamisesta paikallisesti.
Asennusvaiheet
- Asenna Ollama osoitteesta ollama.com
- Hae koodaukseen keskittyvä malli
- Käynnistä Claude Code -yhteensopivuudella
- Aseta ympäristömuuttujasi
# Install and pull a coding model
ollama pull qwen2.5-coder:14b
# Launch with Claude Code compatibility
ollama launch claude
# Set env vars
export ANTHROPIC_BASE_URL="http://localhost:11434"
export ANTHROPIC_API_KEY="ollama"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen2.5-coder:14b"
export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen2.5-coder:14b"
export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen2.5-coder:14b"Ollaman integraatiodokumentit suosittelevia malleja, joissa on vähintään 64k tokenin konteksti-ikkuna parhaan Claude Code -kokemuksen saavuttamiseksi.
Parhaat paikalliset mallit koodaukseen
| Malli | Koko | Vahvuus | Huomioita |
|---|---|---|---|
| Qwen 2.5 Coder 14B | 14B | Paras yleinen paikallinen koodaus | Vahva työkalukutsujen tuki, hyvä kontekstin käsittely |
| devstral | 24B | Mistralin koodausasiantuntija | Erinomainen refaktorointiin ja koodikatselmointiin |
| GLM 4.7 | 9B | Yleinen päättely | Hyvä tasapaino nopeuden ja laadun välillä |
Ole rehellinen itsellesi yhdestä asiasta: paikalliset mallit tuottavat huomattavasti heikompilaatuista koodia kuin Claude Sonnet monimutkaisissa, monivaiheisissa agenttitehtävissä. Työkalukutsut ovat vähemmän luotettavia, ja näet enemmän hallusinoituja tiedostopolkuja. Ne ovat fantastisia nopeisiin muutoksiin, yksinkertaiseen generointiin ja yksityisyysarkaan työhön, mutta älä odota natiivia Claude-laatua 50 tiedoston refaktoroinnissa.
Tuomio: Ollama on paras valinta yksityisyysarkaan työhön ja kehittäjille, jotka haluavat ilmaisen, rajoittamattoman käytön. Jos sinulla on laitteisto, "nolla dollaria ikuisesti" on vaikea argumentti vastaan.
Ollama Cloud vs OpenRouter: Hinnoittelu ja milloin kukin voittaa
Ollama ja OpenRouter ratkaisevat kustannusongelman vastakkaisista päistä. Ollama ajaa malleja hallitsemallasi laitteistolla nollan token-kustannuksin, kun taas OpenRouter veloittaa läpivientihinnan yli 300 hostatusta mallista ilman hallittavaa laitteistoa. Tämä opas asentaa Ollaman paikallisesti, ja sama kiinteä-kustannus-vs-per-token-matematiikka pätee, jos käytät sen hostattua tasoa sen sijaan.
| Tekijä | Ollama | OpenRouter |
|---|---|---|
| Kustannusmalli | Ilmainen paikallisesti, maksat laitteistosta | Per-token läpivienti, ei katetta useimmilla malleilla |
| Esimerkkihintaa | 0 $ per token | DeepSeek V3.2 0,27 $/1,10 $, Gemini 2.5 Flash 0,15 $/0,60 $ per MTok |
| Laitteisto | 16 GB RAM (7B) aina 24 GB+ VRAM:iin (32B+) | Ei mitään, täysin hostattu |
| Mallien saatavuus | 50+ avoimen lähdekoodin mallia | 300+ eri palveluntarjoajilta |
| Yksityisyys | Koodi ei koskaan poistu koneeltasi | Pyynnöt kulkevat OpenRouterin kautta |
Valitse Ollama, kun yksityisyys, offline-käyttö tai suurvolyyminen rutiinimuokkaukset ovat tärkeitä ja omistat jo laitteiston. Valitse OpenRouter, kun haluat mallien monipuolisuutta, ei ennakkolaitteistoa ja maksat vain siitä, mitä käytät.
LM Studio, paikalliset mallit graafisella käyttöliittymällä
LM Studio tarjoaa saman paikallisen mallien suorituksen kuin Ollama, mutta visuaalisella käyttöliittymällä. Selait malleja GUI:ssa, valitset kvantisointitasot klikkaamalla ja testaat chattia ennen kuin osoitat Claude Coden siihen. Samat laitteistovaatimukset kuin Ollamalla. Jos vertailet ajureita, oppaamme parhaista työkaluista LLM:ien ajamiseen paikallisesti kattaa kompromissit.
Asennus
- Lataa LM Studio ja asenna se
- Etsi ja lataa koodausmalli (Qwen 2.5 Coder, devstral jne.)
- Käynnistä paikallinen palvelin LM Studion käyttöliittymästä
- Osoita Claude Code siihen:
# Point Claude Code to LM Studio's local server
export ANTHROPIC_BASE_URL="http://localhost:1234/v1"
export ANTHROPIC_API_KEY="lm-studio"
export ANTHROPIC_DEFAULT_SONNET_MODEL="your-loaded-model-name"LM Studion blogi sisältää läpikäynnin kuvakaappauksilla, jos preferoit visuaalisia asennusoppaita.
Tuomio: LM Studio on paras kehittäjille, jotka preferoivat GUI:ta CLI:n sijaan paikallisten mallien hallinnassa. Jos olet jo tottunut ollama pull -komentoon ja konfiguraatiotiedostoihin, pysy Ollamassa. Jos haluat selata malleja visuaalisesti ja säätää asetuksia liukusäätimillä, LM Studio on valintasi.
claude-code-router, älykäs mallireititys
claude-code-router on npm-paketti, joka ajaa paikallista välityspalvelinta Claude Coden ja konfiguroitujen palveluntarjoajiesi välillä. Mielenkiintoista siinä on kontekstitietoinen reititys: voit lähettää halvat taustatehtävät DeepSeekille, oletuskoodauksen Sonnetille ja monimutkaisen päättelyn Opukselle, kaikki automaattisesti.
Projektilla on yli 30 000 GitHub-tähteä ja se tukee palveluntarjoajina OpenRouteria, DeepSeekiä, Geminiä, Ollamaa, Groqia, Volcengineä ja SiliconFlow'ta.
Asennus ja käyttöönotto
npm install -g claude-code-router
claude-code-router init
claude-code-router startinit-komento luo config.json-tiedoston, jossa määrität palveluntarjoajasi ja mallikuvaukset:
{
"providers": {
"openrouter": {
"apiKey": "sk-or-v1-...",
"models": {
"haiku": "deepseek/deepseek-chat-v3",
"sonnet": "anthropic/claude-sonnet-4",
"opus": "anthropic/claude-opus-4"
}
}
}
}Kontekstitietoisen reitityksen konfiguraatio
Tässä claude-code-router loistaa. Voit reitittää eri tehtävätyyppejä eri malleille monimutkaisuuden perusteella. Taustayhteenvedot menevät halpaan malliin, kun taas suunnittelu- ja arkkitehtuurityö menee parhaaseen malliisi. Reititin hoitaa kaiken paikkojen kartoituksen läpinäkyvästi.
Voit myös sekoittaa palveluntarjoajia, käyttää Ollamaa yksityisyysarkoihin repositorioihin ja OpenRouteria kaikkeen muuhun, vaihtamalla /model-komennolla Claude Coden sisällä.
Tuomio: claude-code-router on paras power-userille, jotka haluavat hienojakoista kontrollia siitä, mikä malli käsittelee kunkin tehtävätyypin. Se on konfiguroitavin vaihtoehto, mutta tämä joustavuus tuo mukanaan enemmän asennustyötä kuin yksinkertainen ANTHROPIC_BASE_URL:n vaihto.
claude-code-proxy ja LiteLLM, edistyneet asennukset
Nämä kaksi menetelmää palvelevat eri tarpeita, mutta niillä on yksi yhteinen piirre: ne ovat molemmat välityspalvelimia, jotka kääntävät API-formaattien välillä.
claude-code-proxy (Gemini- ja OpenAI-taustajärjestelmä)
claude-code-proxy on Python-työkalu (3,3k GitHub-tähteä), joka hyväksyy Anthropic-formaatin pyynnöt Claude Codelta ja kääntää ne OpenAI- tai Gemini-formaattiin LiteLLM:n avulla kulissien takana. Se on yksinkertaisin tapa käyttää erityisesti Geminiä tai GPT-malleja Claude Coden kanssa.
pip install claude-code-proxy
claude-code-proxy --port 8080
# Then point Claude Code at it
export ANTHROPIC_BASE_URL="http://localhost:8080"
export ANTHROPIC_API_KEY="your-gemini-or-openai-key"Jos haluat nimenomaan Geminin 1M tokenin kontekstin suurille monorepoille, tämä on suoraviivaisin polku.
LiteLLM (yritystason universaali välityspalvelin)
LiteLLM on yritystason välityspalvelin, joka tukee yli 100 palveluntarjoajaa kuormantasauksella, varaketjuilla, nopeusrajoituksilla ja auditointilogauksella. Se on liiallista yhden hengen kehittäjälle, mutta välttämätöntä tiimeille, jotka tarvitsevat hallintaa tekoälymallien käytölle.
Asennus käyttää YAML-konfiguraatiota:
model_list:
- model_name: claude-sonnet-4-20250514
litellm_params:
model: gemini/gemini-2.5-flash
api_key: os.environ/GEMINI_API_KEY
- model_name: claude-haiku-3-5-20241022
litellm_params:
model: deepseek/deepseek-chat
api_key: os.environ/DEEPSEEK_API_KEY# Start LiteLLM proxy
litellm --config config.yaml --port 4000
# Point Claude Code to LiteLLM
export ANTHROPIC_BASE_URL="http://localhost:4000"
export ANTHROPIC_API_KEY="sk-litellm"Yksi tärkeä huomio virallisista Claude Code -dokumenteista: "Anthropic ei tue, ylläpidä tai auditoi LiteLLM:ää." Käytä sitä, mutta tiedä, että se on yhteisötyökalu, ei Anthropicin tuote. LiteLLM-opetusohjelma sisältää enemmän edistyneitä konfiguraatioesimerkkejä.
Tuomio: Käytä claude-code-proxyä, jos haluat nimenomaan Gemini- tai OpenAI-malleja. Käytä LiteLLM:ää, jos tiimisi tarvitsee kuormantaustausta, varaketjuja ja auditointilokauksia eri palveluntarjoajien välillä.
Claude Code Router vs LiteLLM: Kumpaa pitäisi käyttää?
Claude Code Router on yksinkertaisempi valinta yhden hengen kehittäjille, jotka haluavat tehtäväkohtaista mallireititystä, kun taas LiteLLM on rakennettu tiimeille, jotka tarvitsevat kuormantaustausta, varaketjuja ja auditointilokauksia. Router asennetaan npmin kautta ja lukee config.json:n; LiteLLM ajaa yritystason YAML-konfiguroitua välityspalvelinta yli 100 palveluntarjoajan yli.
| Tekijä | Claude Code Router | LiteLLM |
|---|---|---|
| Asennuksen vaikeus | Keskitaso: npm install, muokkaa config.json | Edistynyt: YAML-konfiguraatiotiedosto |
| Sopii parhaiten | Yhden hengen kehittäjille, jotka haluavat tehtäväkohtaista reititystä | Tiimeille, jotka tarvitsevat hallintaa |
| Konfiguraatioformaatti | config.json | YAML model_list |
| Eroava ominaisuus | Kontekstitietoinen tehtäväkohtainen reititys | Kuormantasaus, varaketjut, auditointilokaus |
| Palveluntarjoajat | OpenRouter, DeepSeek, Gemini, Ollama, Groq ja muut | 100+ eri palveluntarjoajilta |
| Kypsyys | 30k+ GitHub-tähteä, rakennettu Claude Codea varten | Yritysvälityspalvelin, yhteisötyökalu (ei Anthropicin tukema) |
Valitse claude-code-router, jos olet yhden hengen kehittäjä, joka haluaa halpoja taustatehtäviä DeepSeekillä ja monimutkaista päättelyä Opuksella ilman paljon asennustyötä. Valitse LiteLLM, jos tiimisi tarvitsee kuormantaustausta, nopeusrajoituksia ja auditointilokeja eri palveluntarjoajien välillä.
Punnitsetko muitakin välityspalvelimia? Katsauksemme parhaista LLM-yhdyskäytävätyökaluista vertaa niitä rinnakkain.
Mitä kukin menetelmä todellisuudessa maksaa?
Laitetaan tähän todelliset numerot. Tässä on, mitä maksat per 1M tokenia yleisimmillä malli/menetelmä-yhdistelmillä:
| Malli / Menetelmä | Syöte (per 1M tokenia) | Tuloste (per 1M tokenia) | Kuukausiarvio (kohtuullinen käyttö) |
|---|---|---|---|
| Claude Opus 4.6 (suora) | 5,00 $ | 25,00 $ | ~50–150 $ |
| Claude Sonnet 4.6 (suora) | 3,00 $ | 15,00 $ | ~30–60 $ |
| Claude Sonnet OpenRouterin kautta | 3,00 $ | 15,00 $ | Sama (läpivienti) |
| DeepSeek V3.2 (OpenRouter) | 0,27 $ | 1,10 $ | ~3–8 $ |
| Gemini 2.5 Flash (OpenRouter) | 0,15 $ | 0,60 $ | ~2–5 $ |
| Ollama (paikallinen) | Ilmainen | Ilmainen | 0 $ (laitteistokustannukset) |
Hintatiedot Anthropicin viralliselta hintasivulta ja OpenRouterista. Kohtuullinen käyttö olettaa ~5–10M tokenia/kuukausi päivittäisissä koodaussessioissa.
"Cost per 1M Output Tokens by Model"
Datataulukko
| "Model" | "Output Cost" |
|---|---|
| "Opus 4.6" | 25 |
| "Sonnet 4.6" | 15 |
| "DeepSeek V3.2" | 1.1 |
| "Gemini 2.5 Flash" | 0.6 |
| "Ollama (local)" | 0 |
Kustannusero on merkittävä, mutta halvemmilla malleilla tuotetaan heikompilaatuista koodia, erityisesti monimutkaisissa agenttitehtävissä, joissa työkalukutsujen luotettavuus on tärkeää. DeepSeek hinnalla 1,10 $/MTok tuloste on loistava rutiinimuokkauksiin. Monitiedostorefaktorointiin, jossa Claude Coden täytyy lukea, suunnitella, muokata ja varmistaa 20 tiedoston yli? Haluat silti Sonnetin tai Opusin.
Tuomio: Kustannussäästöihin hyväksyttävällä laadulla OpenRouter + DeepSeek tarjoaa parhaan suhteen. Nollakustannuksiin Ollama on voittamaton, jos sinulla on laitteisto. Maksimilaatuun Anthropic suoraan on edelleen kuningas.
Kumpaa menetelmää pitäisi käyttää? Päätöskehys
Tässä on osio, jonka kaikki muut oppaat ohittavat. Sen sijaan, että sanottaisiin "käytä vain OpenRouteria", sovitaan menetelmät todellisiin tarpeisiin:
| Jos tarvitset... | Käytä tätä menetelmää | Miksi |
|---|---|---|
| Maksimaalinen mallivalikoima, yksi API-avain | OpenRouter | 300+ mallia, helppo asennus, maksu käytön mukaan |
| Ilmainen, rajoittamaton, koodi pysyy paikallisena | Ollama | Nollakustannus, täysi yksityisyys, offline-käyttö mahdollista |
| Paikalliset mallit visuaalisella käyttöliittymällä | LM Studio | GUI-malliselain, helppo kvantisoinnin valinta |
| Älykäs tehtäväkohtainen reititys | claude-code-router | Reititä päättely Opukselle, nopeat muutokset DeepSeekille |
| Nimenomaan Gemini- tai OpenAI-mallit | claude-code-proxy | Kääntää Anthropic-formaatin OpenAI/Gemini-formaattiin |
| Yrityskäyttö: kuormantasaus, auditointi | LiteLLM | Nopeusrajoitukset, varaketjut, tiimikontrollit |
Pitäisikö sinun edes vaihtaa?
Rehellinen näkemys: useimmille kehittäjille, jotka tekevät monimutkaista agenttista koodausta, monitiedostorefaktorointeja, arkkitehtuurisuunnittelua, hankalien samanaikaisuusongelmien debuggausta, Claude Sonnet suoraan Anthropicilta on edelleen paras vaihtoehto. Natiivi Claudella on luotettavin työkalukutsujen tuki, paras ymmärrys omasta agenttisesta työnkulustaan ja nolla välityspalvelinlatenssia.
Mallinvaihto on optimointi tiettyihin skenaarioihin:
- Poltat tokeneita taustatehtäviin, jotka eivät tarvitse Sonnet-laatu, tai törmäät jatkuvasti Clauden 2x käyttörajoihin
- Tarvitset Geminin 1M konteksti-ikkunan valtavaan monorepoon
- Koodisi ei saa poistua koneeltasi (hallitus, terveydenhuolto, rahoitus)
- Sinulla on tiukka budjetti ja hyväksyttävä laatu voittaa täydellisen laadun
Jos mikään näistä ei päde, opusplan (Anthropicin sisäänrakennettu reititys) saattaa olla kaikki, mitä tarvitset.
Työkalukutsujen luotettavuus on laatumetriikka, joka merkitsee eniten tässä. Hierarkia on: natiivi Claude >> OpenRouter Claude >> DeepSeek/Gemini >> paikalliset mallit. Mitä alemmas menet, sitä enemmän näet epäonnistuneita työkalukutsuja, hallusinoituja tiedostopolkuja ja epätäydellisiä muokkauksia.
Yleisten ongelmien vianetsintä
"Model not found" -virhe
Tämä on yleisin ongelma. Se tapahtuu, kun asetat ANTHROPIC_BASE_URL:n mutta unohdat kartoittaa kaikki kolme mallipaikkaa. Claude Code yrittää kutsua Haikua tai Opusta välityspalvelimesi kautta, välityspalvelin ei tunnista oletusarvoista Anthropic-mallin nimeä, ja saat virheen.
# Fix: set ALL three model slot variables
export ANTHROPIC_DEFAULT_HAIKU_MODEL="your-model"
export ANTHROPIC_DEFAULT_SONNET_MODEL="your-model"
export ANTHROPIC_DEFAULT_OPUS_MODEL="your-model"Yhteys evätty / aikakatkaisu
Välityspalvelimesi ei ole käynnissä, tai Claude Code osuu väärään porttiin. Varmista, että välityspalvelinprosessi on aktiivinen ja tarkista portti ANTHROPIC_BASE_URL:ssa. Palomuurit ja VPN:t voivat myös estää localhost-yhteydet.
Työkalukutsujen epäonnistumiset
Malli ei tue Anthropicin työkalujen käyttöformaattia kunnolla. Oireet: Claude Code jumittuu, tuottaa tyhjiä työkalukutsuja tai muokkaa vääriä tiedostoja. Vaihda malliin, jossa on varmistettu työkalukutsujen tuki; Qwen 2.5 Coder ja devstral käsittelevät sitä parhaiten paikallisista malleista.
Streamausongelmat
Jotkut välityspalvelimet eivät käsittele server-sent events -tapahtumia oikein. Vastaukset ilmestyvät kerralla streamauksen sijaan, tai ne katkeavat kesken vastauksen. Varmista, että välityspalvelinversiosi on ajantasalla ja tarkista sen GitHub-ongelmat tunnetuista streamausbuugeista.
Konteksti-ikkuna ylitetty
Paikalliset mallit olettavat usein 4K–8K konteksti-ikkunan. Claude Code tarvitsee paljon enemmän kuin sen todellisiin koodaussessioihin. Käytä malleja, joissa on 32K+ konteksti, tai reititä pitkän kontekstin tehtävät Geminille (1M ikkuna) OpenRouterin kautta.
On kirjauduttava ulos ensin OpenRouteria varten
Jos vaihdat suoralta Anthropicilta OpenRouteriin, suorita ensin claude /logout. Claude Code cachettaa autentikoinnin ja yrittää edelleen käyttää Anthropic-avaintasi, vaikka olisit vaihtanut base URL:n.
# Clear cached authentication before switching providers
claude /logoutFAQ
Voiko Claude Codea käyttää GPT-4:n tai Geminin kanssa?
Kyllä. claude-code-proxy kääntää Anthropic-formaatin pyynnöt OpenAI- tai Gemini-formaattiin. Voit käyttää molempia myös OpenRouterin kautta yhdellä API-avaimella. Työkalukutsut voivat olla vähemmän luotettavia kuin natiivissa Claudessa, erityisesti monimutkaisissa monivaiheisissa tehtävissä.
Miten käytän Claude Codea ilman Anthropic API -avainta?
Käytä Ollamaa täysin ilmaiseen paikalliseen käyttöön, ei tarvita API-avainta keneltäkään palveluntarjoajalta. Vaihtoehtoisesti käytä OpenRouteria heidän API-avainformaatillaan. Asetat edelleen ANTHROPIC_API_KEY -ympäristömuuttujan, mutta se osoittaa välityspalvelimesi avaimeen (esim. sk-or-v1-... OpenRouterille, "ollama" Ollamalle).
Miten asennan Claude Coden Ollaman kanssa?
Asenna Ollama, hae malli kuten qwen2.5-coder:14b, suorita ollama launch claude ja aseta kolme ympäristömuuttujaa: ANTHROPIC_BASE_URL, ANTHROPIC_API_KEY ja kolme mallipaikkamuuttujaa. Katso yllä oleva Ollama-osio saadaksesi koko koodin.
Mitkä mallit toimivat parhaiten Claude Coden kanssa?
Pilvessä: Claude Sonnet 4 tarjoaa parhaan koodauslaadun, kun taas DeepSeek V3.2 tarjoaa parhaan vastineen rahalle. Paikallisesti: Qwen 2.5 Coder 14B on nykyinen kultastandardi. Ratkaiseva tekijä on työkalukutsujen luotettavuus; Claude Code riippuu siitä heavily tiedosto-operaatioissa, ja natiivit Claude-mallit käsittelevät sitä parhaiten.
Miten korjaan "model not found" -virheen Claude Codessa?
Aseta kaikki kolme mallipaikan ympäristömuuttujaa: ANTHROPIC_DEFAULT_HAIKU_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL ja ANTHROPIC_DEFAULT_OPUS_MODEL. Tämä virhe johtuu siitä, että Claude Code käyttää kolmea sisäistä mallipaikkaa, ja kartoittamaton paikka yrittää kutsua mallinimeä, jota välityspalvelimesi ei tunnista.
Voiko Claude Code toimia offline-tilassa paikallisten mallien kanssa?
Kyllä. Sekä Ollama että LM Studio ajavat malleja kokonaan koneellasi ilman internet-yhteyttä. Koodisi ei koskaan poistu laitteistoltasi. Tarvitset riittävät spesifikaatiot – vähintään 16 GB RAM 7B malleille, 32 GB+ kaikille suuremmille.
Voinko käyttää LM Studiota Claude Coden kanssa?
Kyllä. LM Studio ajaa paikallista palvelinta, johon Claude Code yhdistää asettamalla ANTHROPIC_BASE_URL:n arvoon http://localhost:1234/v1 ja ANTHROPIC_API_KEY:n arvoon lm-studio. Lataa koodausmalli kuten Qwen 2.5 Coder, käynnistä palvelin LM Studion GUI:sta ja kartoita sitten mallipaikkasi. Se on visuaalinen vaihtoehto Ollaman CLI:lle.
Mikä on ANTHROPIC_BASE_URL ja miten sitä käytetään?
Se on ympäristömuuttuja, joka kertoo Claude Codelle, minne API-pyynnöt lähetetään. Oletusarvoisesti se osoittaa https://api.anthropic.com. Muuta se mihin tahansa Anthropic-yhteensopivaan päätepisteeseen, OpenRouteriin (https://openrouter.ai/api), Ollamaan (http://localhost:11434), LiteLLM:ään (http://localhost:4000) jne.
Onko claude-code-router parempi kuin LiteLLM?
Eri työkalut eri ongelmiin. claude-code-router on yksinkertaisempi (npm install, muokkaa config.json, valmis) ja suunniteltu nimenomaan Claude Codea varten. LiteLLM on yritystason ratkaisu kuormantasauksella, nopeusrajoituksilla, varaketjuilla ja auditointilogauksella. Yhden hengen kehittäjä? Käytä claude-code-routeria. Tiimi, jolla on hallintatarpeita? Käytä LiteLLM:ää.
Kuinka paljon voin säästää käyttämällä muita kuin Anthropic-malleja?
Vaihtaminen Claude Opus 4.6:sta DeepSeek V3.2:een leikkaa output-tokenien kustannuksia noin 95 % (25 $ vs 1,10 $ per miljoona tokenia). Ollama vie tämän nollaan, jos sinulla on laitteisto. Mutta laadun kompromissit ovat todellisia; odota alhaisempaa tarkkuutta monimutkaisissa monivaiheisissa agenttitehtävissä, vähemmän luotettavia työkalukutsuja ja enemmän hallusinoituja tiedostopolkuja.
Toimivatko työkalukutsut kaikkien välitysmenetelmien kanssa?
Ei luotettavasti kauttaaltaan. Natiivilla Claudella on paras työkalukutsujen tuki. OpenRouter Claude-malleilla toimii lähes yhtä hyvin. DeepSeekillä ja Geminillä on osittainen tuki; yksinkertaiset työkalukutsut toimivat, mutta monimutkaiset ketjut voivat epäonnistua. Paikallisilla malleilla Ollaman kautta on vähiten luotettava työkalukutsujen tuki. Tämä on numero yksi laatuun liittyvä huoli, kun vaihdetaan pois Anthropicista.
Lähteet
- Mallikonfiguraatio, Claude Code Docs
- LLM-yhdyskäytävän konfiguraatio, Claude Code Docs
- Claude Code -integraatio, OpenRouter Docs
- Claude Code -integraatio, Ollama Docs
- Claude API -hinnoittelu, Anthropic
- claude-code-router, GitHub
- claude-code-proxy, GitHub
- Käytä Claude Codea ei-Anthropic-mallien kanssa, LiteLLM Docs