Claude Code-u necə qurmaq olar: 2026-cı il üçün tam bələdçi

Qısa Xülasə: Claude Code, macOS və Linux-da yerli olaraq, ya da Windows-da WSL2 vasitəsilə işləyən bir terminal əsaslı süni intellekt kodlaşdırma köməkçisidir. Qurulumu Anthropic API açarının yaradılmasını, platforma xas quraşdırıcının işlədilməsini, açarla autentifikasiyanı və test komandası ilə quraşdırmanın təsdiqlənməsini tələb edir. 

Claude Code, Anthropic-in rəsmi terminal əsaslı kodlaşdırma köməkçisidir. O, birbaşa komanda xəttində yerləşir və təbii dildəki komandalar vasitəsilə kod yaradılmasından səhvlərin düzəldilməsinə qədər hər şeyi idarə edir.

Lakin quraşdırma prosesi həmişə düzgün olmur. Windows istifadəçiləri WSL2-yə ehtiyac duyurlar. API autentifikasiyası ilk dəfə istifadə edənləri çaşdıra bilər. Versiya uyğunsuzluqları baş verir.

Bu bələdçi, sistem tələblərindən ilk kodlaşdırma seansına qədər bütün platformalar üçün tam quraşdırma prosesini izah edir.

Claude Code Əslində Nədir?

Claude Code, inkişaf mühitləri ilə inteqrasiya olunan agentlik terminal tətbiqidir. Kod bazalarını başa düşür, rutin tapşırıqları yerinə yetirir və söhbət komandaları vasitəsilə git iş axınlarını idarə edir.

Brauzer əsaslı alətlərdən fərqli olaraq, Claude Code terminalda yerli olaraq işləyir. O, layihə fayllarına birbaşa daxil olur, sessiyalar arasında konteksti saxlayır və mövcud inkişaf iş axınları ilə inteqrasiya olunur. Rəsmi Claude Code sənədlərinə görə, alət Anthropic-in API-na qoşulur və Amazon Bedrock, Google Cloud Vertex AI və Azure AI ilə inteqrasiyanı dəstəkləyir.

Alət ənənəvi kodlaşdırma köməkçilərindən fərqli işləyir. Düzünü desək: bu, kod tamamlama aləti deyil, terminalınızda bir həmkarlıq proqramçıya sahib olmaq kimidir.

Claude Code Üçün Sistem Tələbləri

Quraşdırmadan əvvəl sistemlər müəyyən tələbləri ödəməlidir. Hər platformanın nəyə ehtiyacı olduğu budur:

Bütün platformalar API zəngləri üçün sabit internet bağlantısına ehtiyac duyur. Claude Code yükləmələri adətən təxminən 50MB tələb edir, Windows-dakı WSL2 isə Linux alt sistemi üçün təxminən 500MB əlavə edir.

Saxlama sahəsində ən azı 4GB boş yer gözləyin. Tətbiqin özü kiçikdir, lakin asılılıqlar və layihə faylları üçün yer vacibdir.

Windows-a Xüsusi Tələblər

Claude Code, Node.js quraşdırılmışsa, PowerShell və ya Command Prompt vasitəsilə Windows-da işləyə bilər. Alət Linux mühiti yaratmaq üçün Windows Subsystem for Linux 2-ni tələb edir.

claude.ai-dən alınan quraşdırma bələdçilərinə görə, Windows 10 sistemləri Version 1903 və ya daha yeni, Build 19041 və ya daha yüksək versiyaya malik olmalıdır. Windows 11 istifadəçilərində WSL2 dəstəyi quraşdırılmışdır. İlkin WSL2 quraşdırması üçün Administrator hüquqları tələb olunur.

Proses BIOS-da virtualizasiyanın aktivləşdirilməsini, Windows xüsusiyyətlərinin aktivləşdirilməsini və Linux paylanmasının quraşdırılmasını əhatə edir. Uyğunluq üçün Ubuntu 22.04 LTS tövsiyə olunan paylanmadır.

Claude Code-u Quraşdırma: Addım-Addım Proses

Quraşdırma prosesi platformaya görə dəyişir. Claude Code-u hər bir əməliyyat sistemində necə işlək vəziyyətə gətirmək:

macOS və Linux-da Quraşdırma

macOS və Linux quraşdırmaları eyni nümunəni izləyir. Hər iki platforma əlavə quraşdırma olmadan yerli quraşdırmanı dəstəkləyir.

Proses quraşdırıcının endirilməsi ilə başlayır. Terminalı açın və işlədin:

curl -fsSL claude.ai/install.sh | sh

Skript əməliyyat sistemini aşkar edir, uyğun ikili faylı endirir və Claude Code-u yerli bin qovluğuna quraşdırır. Quraşdırma adətən sabit əlaqə ilə iki dəqiqədən az müddətdə tamamlanır.

Curl olmayan sistemlər üçün wget alternativ kimi işləyir. Quraşdırıcı Claude Code-u sistem PATH-ə avtomatik olaraq əlavə edir.

Windows-da WSL2 Vasitəsilə Quraşdırma

Windows quraşdırması əvvəlcə WSL2-ni quraşdırmağı tələb edir. Budur tam proses:

PowerShell-i Administrator kimi açın və WSL-i aktivləşdirin:

wsl --install

Bu komanda tələb olunan Windows xüsusiyyətlərini aktivləşdirir, WSL2 kernelini endirir və Ubuntu-nu standart olaraq quraşdırır. Sistem yenidən başlatma tələb edəcək. Yenidən başlatdıqdan sonra Ubuntu istifadəçi quraşdırmasını tamamlamaq üçün avtomatik olaraq işə düşəcək.

Sorğu edildikdə istifadəçi adı və şifrə yaradın. Bu etimadnamələr Linux mühiti üçündür, Windows giriş məlumatlarından ayrıdır.

WSL2 işlək vəziyyətə gəldikdən sonra Linux quraşdırma prosesi tətbiq olunur. Ubuntu terminalında yuxarıdakı macOS/Linux bölməsindən curl komandantını işlədin.

Quraşdırıcı qalanını idarə edir. Claude Code WSL2 mühiti daxilində quraşdırılır və Ubuntu terminalı vasitəsilə işləyir.

Anthropic API Açarı Almaq

Claude Code autentifikasiya üçün Anthropic API açarına ehtiyac duyur. Açarı yerli quraşdırmanı Anthropic-in serverlərinə qoşur.

Anthropic Console-u console.anthropic.com ünvanında ziyarət edin. Hesab yaradın və ya mövcud etimadnamələrlə daxil olun. Hesab ayarlarında API Keys bölməsinə gedin.

Yeni API açarı yaratmaq üçün "Create Key" düyməsinə basın. Açarı bir dəfə görünür — dərhal kopyalayın. Anthropic səhifədən çıxdıqdan sonra tam açarı bir daha göstərmir.

Açarını təhlükəsiz saxlayın. O, Anthropic API-na və əlaqəli bütün faturalandırmaya tam daxil olmaq imkanı verir.

API Xərclərini Anlamaq

Claude Code Anthropic API vasitəsilə istifadəyə görə ödəniş modelinə uyğun işləyir. claude.ai quraşdırma bələdçilərindən alınan məlumatlara əsasən, xərclər modelə görə dəyişir:

Faturalandırmanı aktivləşdirmək üçün minimum alma $5-dir, lakin icma müzakirələri test üçün $20-30 daha yaxşı imkan verdiyini göstərir. Alternativ abunə planlarına Claude Pro ayda $20 və ya Claude Max ayda $100 (çox istifadə üçün) daxildir.

Standart davranış istifadə limitlərinin 50%-nə çatana qədər Opus-dan istifadə edir, sonra isə xərc səmərəliliyi üçün Sonnet-ə keçir.

Autentifikasiya və İlk Başlanğıc

Quraşdırmadan sonra Claude Code ilk istifadədən əvvəl autentifikasiyaya ehtiyac duyur. Claude Code-u işlədərək başlayın:

claude

İlk başlanğıc API açarını tələb edir. Anthropic Console-dan açarı yapışdırın və Enter düyməsini basın. Claude Code açarı yoxlayır və onu yerli konfiqurasiya fayllarında təhlükəsiz saxlayır.

Autentifikasiya sessiyalar arasında qalır. Açarı açıq şəkildə çıxarılmadığı və ya hesablar dəyişdirilmədiyi müddətcə yenidən daxil etməyə ehtiyac yoxdur.

Autentifikasiyanın işlədiyini təsdiqləmək üçün Claude Code salam mesajı və komanda sorğusu göstərir. İnterfeys mövcud komandaları göstərir və Anthropic-in API-na qoşulmasını təsdiqləyir.

Model Tercihlərini Konfiqurasiya Etmək

Claude Code avtomatik model seçimi ilə işləyir, lakin əl ilə konfiqurasiya mümkündür. Rəsmi sənədlərə görə, istifadəçilər /model komandası vasitəsilə və ya CLAUDE_CODE_EFFORT_LEVEL mühit dəyişənini təyin etməklə model seçimini tənzimləyə bilərlər.

Səy səviyyəsi Opus 4.6 və Sonnet 4.6 modelləri üçün düşüncə dərinliyini idarə edir: aşağı, orta və ya yüksək. Daha yüksək səy səviyyələri məntiq dərinliyini artırır, lakin xərci və cavab müddətini də artırır.

Dərin təhlil tələb edən layihələr üçün, "ultrathink" sözünü həmin xüsusi növbə üçün səyi yüksək səviyyədə təyin etmək üçün istifadə edin.

Quraşdırmanın Uğurlu Olduğunu Təsdiqləmək

Autentifikasiyadan sonra Claude Code-un düzgün işlədiyini yoxlayın. Bu əsas testləri aparın:

claude --help
claude --version

Help komandası mövcud seçimləri və komandaları göstərir. Versiya çıxışı hansı buraxılışın quraşdırıldığını təsdiqləyir. Hər iki komanda səhvsiz icra olunmalıdır.

Növbəti, layihə qovluğunda Claude Code-u test edin. Test qovluğu yaradın:

mkdir test-project
cd test-project
echo "# Test Project" > README.md
claude

Claude Code sessiyasının daxilində, əsas qarşılıqlı əlaqələri sınayın:

• "help" yazaraq mövcud komandaları görün
• "explain what you can do" (nə edə biləcəyini izah et) soruşun
• "summarize this project" (bu layihəni xülasə et) tələb edin
• /help komandantını test edin

Bu qarşılıqlı əlaqələr Claude Code-un layihə fayllarını oxuya və sorğulara cavab verə bildiyini təsdiqləyir. Uğurlu cavablar quraşdırmanın işlək olduğunu bildirir.

Claude Code-u Layihələr Üçün Konfiqurasiya Etmək

Claude Code layihəyə xas ayarları konfiqurasiya fayllarında saxlayır. Bu fayllar davranışı tənzimləyir, yaddaşı müəyyənləşdirir və iş axınlarını təyin edir.

Əsas konfiqurasiya faylı layihə kökündəki CLAUDE.md-dir. Bu fayl Claude Code-un sessiyalar zamanı istinad etdiyi təlimatları, konteksti və layihəyə xas təlimatları ehtiva edir.

Əsas CLAUDE.md faylını yaradın:

# Layihə Konteksti

Bu, [texnologiyalar] ilə hazırlanmış bir [layihə növü]dir.

## Əsas Təlimatlar
– [Vacib qayda 1]
– [Vacib qayda 2]

## Layihə Quruluşu
[Qovluq təşkilinin qısa izahı]

Fayl Markdown formatını qəbul edir. Claude Code bu konteksti sessiya başlanğıcında oxuyur və bütün söhbət boyu onu saxlayır.

Qabaqcıl Konfiqurasiya Seçimləri

Əsas kontekstdən əlavə, Claude Code .claude qovluğu vasitəsilə qabaqcıl konfiqurasiyanı dəstəkləyir. Bu qovluq aşağıdakıları ehtiva edə bilər:

• Bacarıqlar: .claude/skills/SKILL.md-də təyin edilmiş ixtisaslaşdırılmış qabiliyyətlər
• Komandalar: .claude/commands/*.md-də xüsusi slash komandaları
• Qarmaqlar: Hadisələr tərəfindən tetiklenen avtomatik iş axınları
• Pluginlər: Proqramlaşdırma inteqrasiyası vasitəsilə genişləndirilmiş funksionallıq

Rəsmi Agent SDK sənədlərinə görə, bu xüsusiyyətlər mürəkkəb fərdiləşdirməyə imkan verir. Bacarıqlar təkrar istifadə olunan qabiliyyətləri təyin edir. Komandalar ümumi tapşırıqlar üçün qısa yollar yaradır. Qarmaqlar fayl dəyişikliklərinə və ya alətlərin istifadəsinə cavabları avtomatlaşdırır.

Claude Code-dan İstifadə: Əsas İş Axınları

Quraşdırma tamamlandıqdan sonra Claude Code ümumi inkişaf tapşırıqlarını təbii dildə həll edir.

Bir layihə qovluğuna gedərək və işlədərək sessiyanı başlayın:

claude

Sorğu sadə dildə tələbləri qəbul edir. Bəzi ümumi iş axınları:

• Kod Yaradılması: "Uyğun səhv idarəetməsi ilə e-poçt ünvanlarını doğrulayan Python funksiyası yaradın."
• Səhv Düzəltmə: "Bu funksiya null pointer səhvi verir. Problemi müəyyən edib düzəldə bilərsinizmi?"
• Yenidən Qurma: "Bu komponenti birbaşa instanslaşdırmaq əvəzinə dependensiya injeksiyasından istifadə etmək üçün yenidən qurun."
• Git Əməliyyatları: "Yeni bir branch yaradın, bu dəyişiklikləri təsviri bir mesajla commit edin və origin-ə göndərin."

Claude Code sessiya boyunca konteksti saxlayır. O, əvvəlki qarşılıqlı əlaqələri xatırlayır, fayl dəyişikliklərini izləyir və daha geniş layihə strukturunu başa düşür.

Plan Rejimini Anlamaq

Mürəkkəb dəyişikliklər üçün Claude Code Plan Rejimi təklif edir. Bu rejim dəyişikliklər etməzdən əvvəl ətraflı icra planı yaradır.

Tələblərin əvvəlinə "plan:" əlavə etməklə və ya /plan komandını istifadə etməklə Plan Rejimini aktivləşdirin. Claude Code sonra təklif olunan dəyişiklikləri planlaşdırır, səbəbini izah edir və icra etməzdən əvvəl təsdiq gözləyir.

Plan Rejimi xüsusilə yenidən qurma, arxitektura dəyişiklikləri və ya bir çox faylı əhatə edən dəyişikliklər üçün faydalıdır. Dəyişiklikləri etməzdən əvvəl Claude Code-un nə etmək niyyətində olduğunu görməyə imkan verir.

VS Code və IDE-lərlə İnteqrasiya

Claude Code terminalda işləsə də, kod redaktorları ilə inteqrasiya iş axınını gücləndirir. Rəsmi VS Code uzantısı Claude Code qabiliyyətlərini birbaşa redaktora gətirir.

Uzantını VS Code marketindən quraşdırın. "Claude Code" axtarın və Install düyməsini basın. Uzantı yan panelə bir Claude Code paneli əlavə edir.

Rəsmi VS Code sənədlərinə görə, uzantı dəstəkləyir:

Uzantı IDE-ə xas rahatlıqlar, məsələn, inline diff-lər və @-mention fayl istinadları ilə terminal versiyası ilə eyni funksionallığı qoruyur.

Claude Code-u Güncəlləmək və İdarə Etmək

Claude Code standart olaraq avtomatik olaraq güncəllənir. Tətbiq vaxtaşırı yeni versiyaları yoxlayır və arxa planda güncəlləmələri quraşdırır.

Əl ilə güncəlləmək üçün işlədin:

claude --update

Bu, son versiyanın dərhal yoxlanılmasını və quraşdırılmasını məcbur edir. Güncəlləmə prosesi konfiqurasiya fayllarını və autentifikasiya etimadnamələrini qoruyur.

Versiya nəzarəti tələb edən təşkilatlar üçün avtomatik güncəlləmələr söndürülə bilər. CLAUDE_CODE_AUTO_UPDATE mühit dəyişənini "false" olaraq təyin edin və ya server tərəfindən idarə olunan ayarlar vasitəsilə konfiqurasiya edin.

Xüsusi bir versiyanı quraşdırmaq üçün istifadə edin:

curl -fsSL claude.ai/install.sh | sh -s -- --version=X.Y.Z

Təyinatlı versiya nömrəsi ilə X.Y.Z əvəz edin.

Ümumi Quraşdırma Problemləri və Həlləri

Quraşdırma zamanı ümumiyyətlə bir sıra problemlər yaranır. Budur onları necə həll etmək:

• API Açarının Rədd Edilməsi: Claude Code API açarını rədd edərsə, əlavə boşluqlar və ya simvollar olmadığından əmin olun. Açarı Anthropic Console-dan yenidən kopyalayın. Faturalandırmanın aktiv olduğundan əmin olun — ödəniş metodu olmadan açarlar işləməyəcək.
• WSL2 Quraşdırma Səhvləri: Windows sistemlərində virtualizasiya ayarları səbəbindən bəzən WSL2 quraşdırması uğursuz olur. BIOS-a daxil olun və virtualizasiyanı aktivləşdirin (Intel VT-x və ya AMD-V). Windows versiyasının minimum tələbləri ödədiyiindən əmin olun.
• Komanda Tapılmadı: Terminal "claude" komandasını tanımıırsa, PATH düzgün yenilənməyib. Terminalı bağlayın və yenidən açın. Davamlı problemlər üçün, quraşdırma qovluğunu əl ilə PATH-ə əlavə edin.
• Bağlantı Vaxtı Aşımı: Şəbəkə məhdudiyyətləri və ya firewall-lar API zənglərini bloklaya bilər. Claude Code-un api.anthropic.com saytına HTTPS girişi tələb olunur. Korporativ şəbəkələrə proxy konfiqurasiyası lazım ola bilər.
• İcazə Səhvləri: Linux və macOS quraşdırmaları bəzən icazə problemləri ilə qarşılaşır. Uyğun icazələrlə quraşdırıcıyı işlədin və ya sistem səviyyəsindən istifadəçinin qovluğuna quraşdırın.

Claude Code-u Quraşdırmadan Əvvəl Mövcud AI Kreditlərini Yoxlayın

Claude Code-u quraşdırmaq adətən mühitə keçməzdən, inteqrasiyaları test etməkdən və kiçik prototiplər yaratmaqdan əvvəl sınaqlar aparmağı nəzərdə tutur. Bu erkən mərhələ tez-tez API istifadəsini çox artırır. Hər bir tələb üçün dərhal ödəmək əvəzinə, bir çox geliştirici əvvəlcə mövcud kreditlər və ya bu ilkin xərcləri azaltmağa kömək edən start-up proqramları axtarır.

Get AI Perks bu imkanları bir yerdə toplayır. Platforma AI təminatçıları, bulud platformları və geliştirici alətləri üzrə AI kreditlərini, endirimləri və tərəfdaş proqramlarını siyahıya alır, onları necə tələb etməyi izah edən addım-addım bələdçilərlə. Ümumilikdə, məlumat bazası 200-dən çox alətin endirimlərini və start-up-lar və qurucular tərəfindən müraciət edilə bilən milyonlarla dollarlıq mövcud kreditləri ehtiva edir.

Claude Code-u quraşdırmağı bitirməzdən əvvəl, Get AI Perks-i yoxlayın və ilk təcrübələrinizi əhatə edə biləcək AI kreditlərini tələb edin.

Tez-tez Verilən Suallar

Claude Code ilə İrəliləmək

Claude Code, AI köməkçisini birbaşa komanda xəttinə inteqrasiya edərək terminal əsaslı inkişafı dəyişdirir. Quraşdırma platformaya xas quraşdırma, API autentifikasiyası və əsas konfiqurasiyanı tələb edir, lakin düzgün addımlar izlənildikdə proses sadədir.

Alət adi inkişaf tapşırıqları, kod yaradılması və git iş axını idarə edilməsində mükəmməldir. Plan Rejimi mürəkkəb əməliyyatlar üçün təhlükəsizlik təmin edir. IDE inteqrasiyası qabiliyyətləri terminaldan kənara genişləndirir.

Claude Code-un tələbləri necə başa düşdüyünü anlamaq üçün sadə tapşırıqlarla başlayın. Tanışlıq artdıqca daha mürəkkəb iş axınlarına keçin. Təmiz konteksti saxlamaq üçün fərqli tapşırıqlar arasında /clear komandasından istifadə edin. Layihəyə xas təlimatlar üçün CLAUDE.md fayllarını konfiqurasiya edin.

Komandalar server tərəfindən idarə olunan ayarları və plugin marketlərini araşdıra bilərlər. Fərdi geliştiricilər tez-tez istifadə olunan nümunələrə uyğunlaşdırılmış bacarıqlar və xüsusi komandalardan faydalana bilərlər.

anthropics/claude-code ünvanındakı GitHub repozitoriyası əlavə nümunələr, icma pluginləri və troubleshooting resursları ehtiva edir. docs.anthropic.com ünvanındakı rəsmi sənədlər hərtərəfli texniki istinadlar təmin edir.

İndi kodlaşdırmağa başlamağın vaxtıdır. Bir layihəyə gedin, Claude Code-u işlədin və AI-köməyi ilə inkişafın iş axınınızı necə dəyişdiyini görün.