Ноутбугыңды жұмысқа дайында

Бұл практикада ақылды ештеңе жоқ. Бұл — алдағы үш сағат бағдарлама жасауға кете ме, әлде неге ештеңе жұмыс істемейтінін іздеуге кете ме, соны шешетін жиырма минут.

Төмендегі әр қадам бірдеңе басып шығаратын пәрменмен аяқталады. Басып шығарса — орнату шын. Басып шығармаса, сенде нақты мәселе бар, оның нақты шешімі де бар, әрі ол шешім осы бетте тұр.

Үш орнату, бір аккаунт — ал агент бұл тізімде жоқ

Сен Node, git және VS Code орнатасың әрі GitHub аккаунтын ашасың. Бүкіл құрал-сайманың — осы. Агент 01-практикада келеді, ол бұл жерде әдейі жоқ.

Claude Code-тың өз құжаттамасы себебін тура айтады: оның меншікті орнатушысы 4 ГБ жады бар Windows 10 1809 немесе одан жаңа нұсқада жұмыс істейді, оған әкімші құқығы да, WSL де, тіпті Node.js та мүлдем қажет емес (орнату нұсқаулығы). Оның үстіне Code қойындысы терминалсыз ашылатын жұмыс үстелі қолданбасы да бар (жұмыс үстелі нұсқаулығы).

Демек, мұның бірде-бірі агент үшін емес. Бәрі — сенің жобаң үшін. Осы курс бойы жасайтын QAIRU Event Sign-up қолданбасына іске қосылу үшін Node, не өзгергенін есте сақтау үшін git және агент не жазғанын оқып отыру үшін редактор керек.

Терминал қай жерде тұрады және сенде қайсысы бар

Терминал — пәрмен орындайтын терезе. Қалған істің бәрінен бұрын сол терезені ашып алу керек.

• Windows — Start түймесін басып, terminal деп тер де, Windows Terminal-ды аш. Ол жоқ па? Онда powershell деп тер, не болмаса winget install Microsoft.WindowsTerminal пәрменімен орнатып ал. Ол тегін әрі ашық бастапқы кодты (microsoft/terminal), ал кейінірек оның бөлінетін панельдері керек болады: Alt+Shift+D тіркесімі агентті сол жаққа, журналдарды оң жаққа қояды.
• macOS — Cmd+Space басып, terminal деп теріп, Enter пернесін бас.
• Linux — көп ортада Ctrl+Alt+T.

Енді курсор тұрған жолды оқып шық. Windows-та ол сенің қай shell-де тұрғаныңды айтады, ал пәрменді жаңылысып басқасына қою — алғашқы сағаттың ең үйреншікті сәтсіздігі. Anthropic құжаттамасының өзінде осыдан шығатын екі қате хабары тізіліп тұр (орнату нұсқаулығы).

Орнат, содан соң дәлелде

1. Node орнат — npm онымен бірге келеді

   Node.js-тің ресми жүктеп алу бетіне кір де, операциялық жүйеңе арналған LTS нұсқасын ал: Windows-та .msi орнатушысы, macOS-та .pkg орнатушысы, Linux-та сол бет өз дистрибутивіңе беретін нұсқау. Әдепкі параметрлерді өзгертпе.

   LTS — long-term support, яғни ұзақ мерзімді қолдау: ең қызықсыз нұсқа, ал саған дәл сол керек. Мұнда 20-нұсқадан жоғарысының бәрі жарайды. Сонда да ең жаңа LTS-ті ал: егер Claude Code-ты оның меншікті орнатушысының орнына npm арқылы орнатсаң, ол жол Node.js 22 немесе одан жаңасын сұрайды (орнату нұсқаулығы).

   Содан соң ашық тұрған терминалды жауып, жаңасын аш. Бұл ырым емес: жаңа орнатылған бағдарламаның бұзылған болып көрінуінің ең жиі себебі — дәл осы. Жұмыс істеп тұрған терминал өзі ашылған сәттегі ортаны сақтап қалады да, оны орнатушының өзгерткенін ешқашан байқамайды.

   тексеру

   > node -v
   v22.20.0
   
   > npm -v
   10.9.3

   Сенде сандар басқаша болады, әрі жоғарырақ болуы ықтимал. Маңыздысы — пішіні: node -v жауабы v әрпі мен цифрлардан тұрады, ал npm -v жауабы — цифрлар. npm — Node-пен бірге келетін пакет менеджері, оны бөлек орнатпайсың.

2. git орнат

   Windows: Git for Windows жүктеп алып, іске қос. Әдепкі параметрлерді қалдыр. Anthropic құжаттамасы мұны Claude Code үшін міндетті емес дейді де, сонда да орнатуға кеңес береді: Git for Windows тұрса, Claude Code өзінің Bash құралы үшін Git Bash-ті пайдаланады; ол болмаса, PowerShell құралына ауысады (орнату нұсқаулығы). git саған 02-практикадан бастап бәрібір керек, сондықтан қазір орнатып ал.

   macOS: git --version пәрменін орында. git жоқ болса, macOS әзірлеушіге арналған пәрмен жолы құралдарын орнатуды ұсынады — келіс, күте тұр да, пәрменді қайта орында.

   Linux (Debian/Ubuntu): sudo apt install git.

   тексеру

   > git --version
   git version 2.51.0

   Тағы да: нақты нөмірдің маңызы жоқ. Маңыздысы — git version деген сөздер және олардан кейінгі цифрлар.

3. VS Code орнат және онымен қалта аш

   VS Code — тегін редактор, оның өзегі ашық бастапқы кодты (microsoft/vscode). Microsoft сайтынан операциялық жүйеңе арналған нұсқасын жүктеп алып орнат, не болмаса Windows-та winget install Microsoft.VisualStudioCode пәрменін орында.

   Содан кейін шын мәнінде маңызды жалғыз істі орында: File → Open Folder дегенді басып, қалта таңда. Файлды емес — қалтаны. Осы курстағы бәрі де, агенттің кез келген әрекеті де бір қалтаның шегінде жүреді. Оның орнына жеке файлдарды ашсаң, курстың қалған бөлігі сәйкеспей қалады.

4. Курстың соңына дейін өмір сүретін қалтаңды жаса

   Бір жоба — бір қалта. Жұмыс үстелі емес, үй каталогы емес — аты бар бөлек қалта.

   powershellКөшіру

   cd $HOME\Documents
   mkdir qairu-event
   cd qairu-event

   bashКөшіру

   cd ~/Documents
   mkdir qairu-event
   cd qairu-event

   Осы жолдарды бір қатарға біріктірсең, есіңде болсын: PowerShell пәрмендерді ; арқылы, ал Bash && арқылы бөледі — келесі бөлімдегі екі қате хабарының түп-төркіні де осы айырмашылықта.

   Бұл көрінгеннен маңыздырақ. Агентті үй қалтаңда немесе жұмыс үстелінде іске қоссаң, өзіңдегі барлық файлды оқуға және индекстеуге бергенің. Алдымен cd арқылы жоба қалтасына кір — әр жолы.

5. Бәрін бір жаңа терминалда дәлелде

   Барлық орнатудан кейін ашылған терминалда, qairu-event қалтасының ішінде тұрып:

   тексеруКөшіру

   node -v
   git --version

   Екі нұсқа нөмірі, қатесіз. Содан соң осы қалтаны VS Code-та аш — File → Open Folder арқылы, немесе орнатушы code пәрменін қосқан болса, code . деп тер — және сол жақта (бос) файлдар ағашын көріп тұрғаныңа көз жеткіз.

   Дайын болудың толық анықтамасы — осы. Екі сан және бір қалта.

Windows қарсыласа

Бұл залдағылардың басым бөлігі Windows-та отыр, ал оқулықтардың көбін Windows-та отырмайтындар жазады. Пәрменді қайта-қайта орындағанның орнына хабарды оқып шық. Төмендегі әр жол Anthropic-тің орнату және орнату ақауларын жою беттерінен алынған, ал олардың әрқайсысы Claude Code шеңберінен шығып, биыл орнататын кез келген дүниеге бірдей қатысты.

Бүгін кешке ашып қоятын аккаунттар

Бұл төртеуі де тегін, әрі бірде-бірі банк картасын сұрамайды.

Ақшаны жоспарламас бұрын екі адал ескерту.

Қазақстан Anthropic-тің қолдау көрсетілетін елдер тізімінде тұр — Claude.ai бойынша да, API бойынша да (қолдау көрсетілетін елдер), сондықтан VPN қажет емес. Бірақ тегін Claude тарифіне Claude Code кірмейді — оған Pro, Max, Team, Enterprise немесе Console төлемі керек (орнату нұсқаулығы). Pro — айына $20, жылдық төлеммен айына $17 (бағалар). Осы шеберлік сабағына бір ай жетеді.

Ал «студенттік тариф» дегеніміз «сол өнімнің өзі, бірақ тегін» дегенді білдірмейді. GitHub пакеті Copilot Pro емес, Copilot Student береді. Студенттер енді GPT-5.3-Codex, GPT-5.4, Claude Opus немесе Claude Sonnet модельдерін қолмен таңдай алмайды — оларға тек Auto режимі арқылы жетуге болады — ал тарифтің лимиті айына 200 ЖИ-кредит, бір кредит — бір цент қолданыс. Жарияланымға 6 796 «ұнатпадым» реакциясы жиналды (GitHub қауымдастығындағы талқылау, Copilot тарифтері). Тегін — әлі де тегін; ол жай ғана жарнама меңзегеннен кішірек.

Орнатуыңды ЖИ-ге тапсырып, жұмысыңды тексерт

Сенде әзірге агент жоқ — ол 01-практикада — бірақ чат терезесі бар. Пәрмендерді орында, нақты нәтижені көшіріп ал да, мынаның қасына қой.

Мен веб-әзірлеу курсына ноутбук дайындап жатырмын, оған Node, npm және git керек.
Менің операциялық жүйем: [Windows 11 / macOS / Ubuntu].

Терминалым дәл мынаны басып шығарды, ештеңесін өзгертпей көшірдім:

[мұнда node -v нәтижесін қой]
[мұнда npm -v нәтижесін қой]
[мұнда git --version нәтижесін қой]

Мына үш істі осы ретпен орында:
1. Node, npm және git-тің қайсысы дұрыс орнатылған, қайсысы орнатылмаған — соны айт.
2. Жоқ немесе тым ескі нәрсенің әрқайсысы үшін (маған Node 20 немесе жоғары керек)
   менің операциялық жүйеме арналған бір ғана келесі әрекетті бер. Нұсқалар тізімі емес,
   бір әрекет.
3. Егер нәтиженің орнына қате хабары тұрса, сол нақты хабардың нені білдіретінін және
   неден шығатынын бір сөйлеммен түсіндір.

Маған бәрін қайта орнат деме. Мен атамаған операциялық жүйеге арналған пәрмен берме.

Бұл промпт әдейі шағын. Операциялық жүйеңді атау, нәтижені сипаттамай, нақты көшіріп қою және «бәрін қайта орнат» деген жауаптың жолын алдын ала кесу — осы курстағы әр промптта қайталайтын үш әдет.