Jalankan satu perubahan Claude Code yang diperiksa dengan model Ollama lokal

Claude Code dapat mengerjakan repositori milik Anda melalui model yang dijalankan Ollama di komputer Anda. Integrasi Claude Code Ollama saat ini terhubung langsung melalui API yang kompatibel dengan Anthropic. Panduan ini membawa satu perubahan kode terbatas dari kondisi awal yang tercatat hingga keputusan manusia atas diff. Panduan ditujukan bagi pengembang yang dapat memasang kedua alat, mengizinkan penyuntingan repositori, dan menjalankan model pemrograman lokal yang sesuai. BIG CHANGE memeriksa manual pada 20 Oktober 2026; kami tidak menjalankan model atau menguji repositori.

Perubahan besar

• Yang berubah: Ollama kini mendokumentasikan rute langsung Claude Code ke server lokalnya yang kompatibel dengan Anthropic, melalui peluncur atau pengaturan endpoint lokal secara eksplisit. Penyiapan terdokumentasi ini tidak memerlukan proksi terpisah.
• Mengapa penting: Anda dapat mempertahankan alur kerja Claude Code sambil memilih model lokal, memeriksa alokasi konteks yang sebenarnya, dan meninjau penyuntingan repositori nyata menggunakan pemeriksaan penerimaan asli proyek.
• Yang perlu diperhatikan: Tag lokal yang dipilih dan model yang berjalan tidak membuktikan bahwa setiap permintaan tetap lokal atau kodenya benar. Periksa perutean efektif, akses alat, seluruh diff, dan hasil pemeriksaan sebelum menerima perubahan.

1. Catat kondisi awal repositori

Gunakan repositori Git milik Anda atau yang boleh Anda ubah. Gunakan branch yang dapat ditinjau atau checkout sementara. Tentukan satu perilaku kecil atau cacat yang ingin diubah, file yang boleh terpengaruh, serta kondisi berhenti. Temukan perintah penerimaan repositori yang sudah ada, misalnya pengujian atau pemeriksaan build yang terdokumentasi; jangan menggantinya dengan perintah umum. Jalankan sebelum agen menyunting apa pun, lalu catat perintah, status keluar, dan keluaran yang relevan. Catat juga branch, git status serta diff yang sudah ada. Perubahan yang sudah ada merupakan kondisi awal, bukan hasil AI.

Pastikan kebijakan kode dan dependensi organisasi Anda mengizinkan model dan alat yang dipilih. Claude Code dapat membaca file dan menjalankan perintah sesuai pengaturan izin efektifnya. Permintaan “ubah hanya file ini” mengarahkan agen, tetapi tidak membatasi akses sistem filenya.

2. Pasang model lokal yang sesuai dan alokasikan konteks

Pasang rilis Ollama dan Claude Code CLI terkini melalui petunjuk resminya, dengan mengikuti aturan komputer dan organisasi Anda. Catat ollama --version dan claude --version. Ollama memperkenalkan kompatibilitas Anthropic Messages pada versi 0.14.0 pada Januari 2026; tanggal itu tidak menetapkan versi minimum untuk perintah ollama launch saat ini.

Pilih model yang entri katalog terkininya menunjukkan dukungan alat, lisensinya mengizinkan penggunaan Anda, dan bobot serta alokasi konteksnya sesuai kapasitas komputer. Salah satu contoh lokal yang konkret adalah qwen3-coder:30b, yang tercantum dengan dukungan alat, artefak Q4_K_M sekitar 19 GB, dan Apache License 2.0. Itu ukuran unduhan, bukan kebutuhan RAM atau VRAM. Konteks model yang diiklankan tidak berarti komputer Anda dapat mengalokasikannya. Jika model tidak sesuai kapasitas, pilih tag lokal lain yang terdokumentasi mendukung alat dan ganti tag secara konsisten pada perintah berikut.

Dari terminal, setelah aplikasi Ollama atau server lokal berjalan, unduh dan konfirmasikan tag yang tepat:

ollama pull qwen3-coder:30b
ollama list

Ollama menyarankan setidaknya 64.000 token untuk agen pemrograman dan menyatakan konteks yang lebih besar memakai lebih banyak memori. Atur 64k atau lebih pada pengaturan aplikasi Ollama yang sudah ada, jika perangkat keras mendukungnya. Jika Anda mengoperasikan server sendiri, konfigurasikan layanan yang sudah ada dengan OLLAMA_CONTEXT_LENGTH=64000 menggunakan petunjuk server khusus platform; jangan memulai server kedua pada port 11434. Setelah permintaan memuat model, ollama ps menampilkan nilai sebenarnya untuk CONTEXT dan PROCESSOR. Berhenti atau kurangi cakupan tugas dan pilih penyiapan yang sesuai jika alokasi yang dimaksud tidak dapat dimuat. Jangan melaporkan nilai maksimum katalog sebagai konteks yang dialokasikan.

3. Arahkan Claude Code ke server lokal

Buka terminal di repositori yang dipilih. Ollama mendokumentasikan rute peluncur ini; gunakan tag lokal yang sama seperti yang dikonfirmasi oleh ollama list:

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

Ollama mendokumentasikan rute model non-Claude ini. Manual gateway Anthropic menyatakan bahwa Anthropic tidak mendukung pengarahan Claude Code ke model non-Claude melalui gateway. Perlakukan ini sebagai integrasi yang didokumentasikan Ollama tanpa dukungan Anthropic untuk perutean tersebut, dan periksa sesi sebenarnya sebelum mengandalkannya.

Untuk penyiapan manual, petunjuk integrasi Ollama menggunakan ANTHROPIC_AUTH_TOKEN=ollama, nilai yang secara eksplisit kosong untuk ANTHROPIC_API_KEY, dan ANTHROPIC_BASE_URL=http://localhost:11434. Perintah Bash opsional ini mengatur ketiganya hanya untuk proses Claude Code ini, dari direktori repositori milik Anda; perintah ini tidak mengubah profil shell global:

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

Untuk shell lain, gunakan peluncur Ollama yang disarankan di atas atau penyiapan khusus shell dalam manual resmi terkini. Periksa pengaturan Claude Code yang mungkin mengesampingkan variabel perintah. Jangan mencetak kredensial yang sudah ada saat memeriksa pengaturan. Hasil pembacaan efektif yang diharapkan adalah tag lokal pilihan Anda dan http://localhost:11434; ini pemeriksaan yang harus dilakukan pembaca, bukan hasil yang diamati BIG CHANGE. Server lokal mengabaikan token pengganti ollama; token itu bukan rahasia pengendalian akses. Rute lokal yang didokumentasikan tidak memerlukan kunci cloud Ollama atau kunci inferensi Anthropic. Ketentuan perangkat lunak Claude Code dan layanan yang terhubung tetap berlaku.

Pertahankan server terikat secara lokal sesuai panduan konfigurasi server Ollama. Tag :cloud atau URL dasar https://ollama.com merupakan rute cloud dengan pertimbangan data dan biaya yang berbeda. Berhenti sebelum mengirim isi repositori jika model atau tujuannya tidak jelas.

4. Periksa rute, lalu minta satu penyuntingan

Sebelum mengizinkan perubahan file, periksa model dan koneksi efektif Claude Code dengan /status jika tersedia. Bandingkan hasil pembacaan itu dengan peluncur atau endpoint manual, ollama list, dan, setelah suatu permintaan memuat model, ollama ps. Catat tag persis yang dimuat, alokasi CONTEXT dan PROCESSOR; pembagian pemrosesan dengan CPU dapat memengaruhi kelayakan alur kerja. Jika tersedia, periksa juga bukti permintaan server lokal. Pemeriksaan ini membuktikan konfigurasi dan pemuatan model, bukan audit lengkap seluruh lalu lintas jaringan. Tinjau alat MCP yang aktif, pengambilan atau pencarian web, telemetri, dan pengaturan cloud secara terpisah jika penanganan lokal penting bagi kebijakan kode Anda.

Gunakan permintaan persetujuan normal Claude Code dan kontrol izinnya. Minta satu tugas pada repositori milik Anda dengan bahasa biasa: sebutkan perilaku yang diperlukan, cakupan yang diizinkan, perintah penerimaan semula, dan titik berhenti. Minta laporan file yang diubah dan keluaran pemeriksaan. Serahkan keputusan commit, push, dan rilis kepada pemilik repositori, serta tolak tindakan jaringan atau alat yang tidak diharapkan. Klaim model bahwa ia memakai endpoint lokal atau lulus pemeriksaan bukanlah verifikasi.

5. Putuskan berdasarkan seluruh diff dan pemeriksaan semula

Periksa setiap file yang berubah dan seluruh diff Git, termasuk perubahan di luar cakupan permintaan. Bandingkan perubahan dengan perilaku semula dan kebijakan repositori, termasuk lisensi dependensi baru. Jalankan sendiri perintah penerimaan tercatat yang sama setelah penyuntingan. Catat status keluar dan keluaran relevan bersama kondisi awal. Terima perubahan hanya jika diff sesuai permintaan, pemeriksaan independen memberikan hasil yang dapat diterima, dan bukti perutean serta izin memenuhi kebutuhan Anda. Jika tidak, biarkan branch belum diterima dan simpan kegagalan persisnya untuk ditinjau.

Jika Ollama tidak dapat dihubungi, periksa aplikasi atau layanan yang berjalan dan ollama list sebelum mencoba tugas pemrograman. Jika model tidak dapat dimuat atau ollama ps melaporkan konteks yang tidak mencukupi, periksa memori dan pengaturan konteks; gunakan tugas dengan cakupan lebih kecil atau model lokal yang sesuai. Jika /status atau pengaturan efektif menunjukkan penyedia yang dihosting, berhenti sebelum mengirim kode dan perbaiki shell saat ini atau pengaturan Claude Code. Kesalahan pemanggilan alat dapat berasal dari kompatibilitas model atau penolakan izin; periksa respons persisnya sebelum mengubah salah satunya. Jika suatu percobaan sudah menyunting file, periksa diff sebelum mengembalikan atau melanjutkan. Setelah pemeriksaan penerimaan gagal, diagnosis kodenya dan jalankan ulang pemeriksaan hanya setelah koreksi yang ditinjau.

Inferensi lokal menghindari biaya inferensi per token penyedia untuk model yang diunduh, tetapi memakai perangkat keras, penyimpanan, dan listrik. Unduhan, telemetri, alat web, integrasi MCP, atau pengaturan model cloud dapat mengirim data atau menimbulkan biaya lain. Ollama mendukung sebagian Anthropic Messages API, dengan batasan pada fitur termasuk penghitungan token, cache prompt, batch, kutipan, PDF, dan pemilihan alat paksa; kemampuan alat setiap model juga berbeda. Tinjauan dokumentasi BIG CHANGE tidak menghasilkan pengukuran kecepatan, kualitas, privasi, atau penghematan. Untuk penyiapan agen lokal yang berbeda, lihat panduan Junie Local kami; prosedur ini secara khusus mempertahankan Claude Code dan memeriksa rutenya ke Ollama.

Sumber dan bacaan lanjutan

• Ollama, “Claude Code” menyediakan peluncur terkini, pengaturan lokal manual, dan alternatif cloud. Dokumen ini menjelaskan rute, bukan keberhasilan menjalankannya pada repositori pembaca.
• Ollama, “Anthropic compatibility” menjelaskan endpoint lokal, token pengganti yang diabaikan, pengunduhan model, dan batasan fitur API. Kompatibilitas tidak menjamin setiap model atau pemanggilan alat.
• Ollama, “Context length” menjelaskan rekomendasi 64k untuk pemrograman, konsekuensi penggunaan memori, dan pembacaan ollama ps. Komputer sebenarnya menentukan alokasi yang memungkinkan.
• Entri qwen3-coder:30b milik Ollama mencantumkan artefak contoh, alat, dan tautan lisensi Apache 2.0. Periksa kembali entri model yang tepat sebelum mengunduh atau mendistribusikannya kembali.
• Petunjuk pemasangan Claude Code dan pengaturan izin menjelaskan akses dan persetujuan alat. Keduanya tidak membuktikan endpoint efektif sesi tertentu atau hasil repositori yang aman.
• Anthropic, “Other LLM gateways” menyatakan bahwa Anthropic tidak mendukung pengarahan Claude Code ke model non-Claude melalui gateway. Ollama secara terpisah mendokumentasikan integrasi lokal yang dijelaskan di sini.