Мухтасар: Claude Code CLI тавассути як фармони ягона насб карда мешавад, ки асбобро ба таври автоматӣ зеркашӣ ва танзим мекунад. Дар macOS ва Linux, скрипти расмии shell-ро аз ҳуҷҷатҳои Anthropic истифода баред, дар ҳоле ки корбарони Windows фармонҳои PowerShell ё WSL-ро иҷро мекунанд. Пас аз насб, бо калиди API-и худ барои оғози истифодаи ёвари барномасозии AI-и Claude дар терминали худ ворид шавед.
Claude Code як асбоби барномасозии агентӣ мебошад, ки дар терминали шумо ҷойгир аст ва тамоми кодекси шуморо мефаҳмад. Тибқи ҳуҷҷатҳои расмии Claude Code, он метавонад файлҳоро хонад, фармонҳоро иҷро кунад, кодро таҳрир кунад ва тавассути сӯҳбатҳои забони табиӣ бо асбобҳои таҳиягӣ ҳамгиро шавад.
Аммо, оғози кор насби дурустро талаб мекунад. Дар ин ҷо ҳама чизест, ки барои насб ва дуруст танзим кардани Claude Code CLI лозим аст.
Талаботҳои система пеш аз насб
Пеш аз насб кардани Claude Code, тасдиқ кунед, ки система ба талаботҳои асосӣ мувофиқат мекунад. Тибқи ҳуҷҷатҳои расмии насби пешрафта, ин ҷумларо пурра хориҷ кунед.
Насби Node.js-ро тавассути кушодани терминал ва иҷрои ин фармон санҷед:
| node –version |
Агар Node.js насб нашуда бошад ё версияи он аз 18 паст бошад, онро аз вебсайти расмии Node.js зеркашӣ кунед. Версияи Дастгирии Дарозмуддат (LTS) барои Claude Code хеле хуб кор мекунад.
Ба ғайр аз Node.js, система ба талаботҳои асосӣ ниёз дорад: macOS 13.0 ё баландтар барои корбарони Mac, Windows 10 ё баландтар барои системаҳои Windows ва аксари дистрибютсияҳои муосири Linux бе мушкилот кор мекунанд. Ҳисоби Claude аз Anthropic низ барои аутентификатсия пас аз насб лозим аст.
Насб кардани Claude Code дар macOS ва Linux
Раванди насб барои macOS ва Linux аз як фармони ягонаи shell истифода мебарад, ки ҳама чизро ба таври автоматӣ идора мекунад. Ин усул дар дастури оғози зудтарин Claude Code ба таври расмӣ ҳуҷҷатгузорӣ шудааст.
Терминалро кушоед ва скрипти насбро иҷро кунед:
| curl -fsSL claude.ai/install.sh | bash |
Скрипт файли иҷрошавандаи Claude Code-ро зеркашӣ мекунад, онро дар директорияи дуруст ҷойгир мекунад ва PATH-ро ба таври автоматӣ танзим мекунад. Тамоми раванд одатан дар муддати камтар аз як дақиқа анҷом меёбад.
Барои корбарони macOS, ки Homebrew-ро афзалтар медонанд, як усули алтернативии насб мавҷуд аст, гарчанде ки он дар манбаъҳои асосӣ ба таври расмӣ ҳуҷҷатгузорӣ нашудааст. Усули curl тибқи ҳуҷҷатҳои расмӣ усули тавсияшуда боқӣ мемонад.
Санҷиши насб
Пас аз анҷом ёфтани насб, тасдиқ кунед, ки Claude Code дастрас аст:
| claude –version |
Ин фармон бояд рақами версияи насбшударо нишон диҳад. Агар хатогӣ пайдо шавад, ки мегӯяд "фармон ёфт нашуд", танзими PATH бояд танзим карда шавад.
Тибқи ҳуҷҷатҳои расмии ҳалли мушкилот, мушкилоти PATH мушкилоти маъмултарини насб мебошанд. Ислоҳ ба илова кардани директорияи насби Claude ба файли танзимоти shell дахл дорад.
Насб кардани Claude Code дар macOS ва Linux
Раванди насб барои macOS ва Linux ба npm (Node Package Manager) такя мекунад. Тибқи ҳуҷҷатҳои расмӣ, шумо бояд пеш аз идома додан Node.js 18+ дар системаи худ насб карда бошед. Баръакси асбобҳои анъанавии CLI, ки скриптҳои shell-ро истифода мебаранд, Claude Code ба таври глобалӣ тавассути терминали шумо насб карда мешавад, то ҳама вобастагиҳо дуруст идора карда шаванд.
Терминали худро кушоед ва фармони зеринро барои насб кардани баста иҷро кунед:
| export CLAUDE_CODE_RELEASE_ALPHA=1 && npm install -g @anthropic-ai/claude-code |
Эзоҳ: Тағйирёбандаи муҳити зист CLAUDE_CODE_RELEASE_ALPHA=1 дар марҳилаи бета/алфаи ҷамъиятӣ барои эътирофи вазъияти пешнамоиши асбоб лозим аст.
Ин фармон бастаро аз феҳристи расмии npm зеркашӣ мекунад ва файли иҷрошавандаи claude-ро ба директорияи глобалии bin-и системаи шумо мепайвандад. Дар ҳоле ки баъзе корбарон метавонанд кӯшиш кунанд, ки формулаҳои Homebrew-ро пайдо кунанд, усули npm ягона роҳи насби расман дастгирӣ ва ҳуҷҷатгузорӣшуда мебошад.
Санҷиши насб
Пас аз анҷом ёфтани насб, тасдиқ кунед, ки CLI ба муҳити шумо дуруст харита карда шудааст:
| claude –version |
Ин фармон бояд рақами версияи ҷорӣ (масалан, 0.2.9) нишон диҳад. Агар шумо бо хатои "фармон ёфт нашуд" дучор шавед, ин одатан маънои онро дорад, ки директорияи глобалии npm-и шумо дар PATH-и системаи шумо нест.
Тибқи ҳуҷҷатҳои расмии ҳалли мушкилот, шумо метавонед инро бо муайян кардани префикси npm-и худ бо npm config get prefix ва боварӣ ҳосил кунед, ки директорияи /bin-и натиҷа ба файли .zshrc ё .bashrc-и шумо илова карда шудааст, ислоҳ кунед.
Насб кардани Claude Code дар Windows
Насбкунии Windows ду равиши асосӣ пешниҳод мекунад: насби native PowerShell ё истифодаи Windows Subsystem for Linux (WSL). Ҳуҷҷатҳои расмӣ PowerShell-ро барои аксари корбарон тавсия медиҳанд.
Усули насби PowerShell
PowerShell-ро ҳамчун Администратор кушоед (дар менюи Start рост пахш кунед ва "Windows PowerShell (Admin)" -ро интихоб кунед). Ин фармонро иҷро кунед:
| irm claude.ai/install.ps1 | iex |
Скрипти PowerShell зеркашӣ, насб ва танзими PATH-ро ба таври автоматӣ иҷро мекунад. Пас аз анҷом ёфтан, PowerShell-ро пӯшед ва дубора кушоед, то боварӣ ҳосил кунед, ки навсозиҳои PATH амалӣ мешаванд.
Усули насби WSL
Барномасозон, ки аллакай WSL-ро истифода мебаранд, метавонанд Claude Code-ро бо истифода аз усули Linux насб кунанд. Терминали WSL-ро кушоед ва ҳамон фармони curl-ро, ки барои Linux истифода мешавад, иҷро кунед:
| curl -fsSL claude.ai/install.sh | bash |
Равиши WSL ҳамон тавре ки насбҳои native Linux кор мекунад. Яке аз бартариятҳо: WSL муҳити монанди Unix-ро пешниҳод мекунад, ки ба танзимоти сервери истеҳсолӣ мувофиқат мекунад.
Тибқи ҳуҷҷатҳои расмии ҳалли мушкилот, корбарони WSL баъзан бо мушкилоти пайвасти шабака дучор мешаванд. Агар насб қатъ шавад, тасдиқ кунед, ки WSL метавонад ба шабакаҳои беруна дастрасӣ пайдо кунад ва қоидаҳои файрвол трафикро баста намекунанд.
Кредитҳо ва ҳар гуна асбобҳои AI-ро дар як ҷо пайдо кунед
Насб кардани Claude Code CLI як қадам аст. Пардохти нархи асбобҳои AI дар тӯли муддати тӯлонӣ як кори дигар аст. Get AI Perks кредитҳои оғозёбӣ ва тахфифҳои нармафзорро барои асбобҳои AI ва абрӣ дар як ҷо ҷамъ меорад. Он ба асосгузорон имконият медиҳад, ки ба 200+ имтиёзҳо, аз ҷумла пешниҳодҳо аз Anthropic, Claude, OpenAI, Gemini, ElevenLabs, Intercom ва дигарон дастрасӣ пайдо кунанд. Платформа инчунин шартҳои имтиёзҳо ва дастурҳоро барои гирифтани ҳар як пешниҳод нишон медиҳад.
Оё шумо кредитҳои Claude ё Anthropic-ро меҷӯед?
Get AI Perks-ро санҷед, то:
- кредитҳо ва тахфифҳои асбобҳои AI-ро дар як ҷо пайдо кунед
- шартҳои имтиёзҳоро пеш аз дархост баррасӣ кунед
- ба дастурҳо барои гирифтани пешниҳодҳои оғозёбӣ дастрасӣ пайдо кунед
👉 Ба Get AI Perks барои дидани имтиёзҳои мавҷудаи Claude, Anthropic ва дигар нармафзорҳои AI муроҷиат кунед.
Аутентификатсия ва танзимоти ибтидоӣ
Пас аз насб, Claude Code пеш аз он ки кор кунад, аутентификатсияро талаб мекунад. Ин асбоб барои тасдиқи дастрасӣ калидҳои API-и Anthropic-ро истифода мебарад.
Раванди аутентификатсияро бо иҷрои ин фармон оғоз кунед:
| claude |
Бори аввал ин фармон иҷро шавад, Claude Code барои аутентификатсия хоҳиш мекунад. Тибқи дастури расмии оғози зудтарин, ин равзанаи браузерро барои ворид шудан ба ҳисоби Anthropic мекушояд.
Пас аз ворид шудан тавассути браузер, CLI ба таври автоматӣ токени аутентификатсияро мегирад. Ин токен дар маҳаллӣ нигоҳ дошта мешавад ва дар байни сессияҳо нигоҳ дошта мешавад, аз ин рӯ аутентификатсияи такрорӣ лозим нест.
Танзими танзимоти сатҳи лоиҳа
Claude Code, тибқи ҳуҷҷатҳои расмии танзимот, аз танзимот дар сатҳҳои гуногун дастгирӣ мекунад. Сатҳҳои маъмултарини танзимот инҳоянд:
| Минтақа | Макон | Ҳолати истифода |
|---|---|---|
| Корбар | ~/.claude/ directory | Афзалиятҳои шахсӣ дар ҳама лоиҳаҳо |
| Лоиҳа | .claude/ in repository | Танзимоти муштараки даста |
| Маҳаллӣ | .claude/settings.local.json | Пӯшидаҳои мушаххаси мошин |
Барои танзимоти якумин, танзимоти сатҳи корбар кофӣ аст. Танзимоти сатҳи лоиҳа ҳангоми кор бо дастаҳое, ки стандартҳои кодгузориро мубодила мекунанд, муҳим мегарданд.
Оғози аввалин ҷаласаи Claude Code
Пас аз насб ва аутентификатсия, Claude Code-ро бо иҷрои фармон бе ягон далел идора кунед:
| claude |
Ин ҳолати интерактивӣ оғоз мекунад, ки дар он Claude ба дархостҳои забони табиӣ ҷавоб медиҳад. Ҳуҷҷатҳои расмӣ ҳолати интерактивӣ-ро ҳамчун роҳи асосии истифодаи Claude Code барои супоришҳои таҳия тавсиф мекунанд.
Як фармони санҷишии оддиро санҷед:
| Show me the structure of this project |
Claude Code директорияи ҷорӣ-ро таҳлил мекунад ва шарҳи сохтори кодекси шуморо пешниҳод мекунад. Ин нишон медиҳад, ки насб дуруст кор мекунад ва Claude ба хондани файлҳо дастрасӣ дорад.
Фармонҳои муҳим барои истифодаи ҳаррӯза
Ба ғайр аз ҳолати интерактивӣ, Claude Code якчанд намудҳои фармонҳоро, ки дар истиноди CLI ҳуҷҷатгузорӣ шудаанд, дастгирӣ мекунад:
| Намунаи фармон | Мақсад | Намуна |
|---|---|---|
| claude | Оғози ҷаласаи интерактивӣ | claude |
| claude “task” | Иҷро кардани супориши яквақта | claude “fix the linting errors” |
| claude -p “query” | Дархости зуд бе ҷаласа | claude -p “what does this function do” |
Намунаи супориши яквақта барои конвейерҳои CI/CD ва скриптҳои автоматизатсия, ки дар онҳо ҷаласаи интерактивӣ мувофиқ нест, махсусан муфид аст.
Мушкилоти маъмулии насб
Ҳатто бо скриптҳои насби автоматӣ, баъзан мушкилот рух медиҳанд. Ҳуҷҷатҳои расмии ҳалли мушкилот мушкилоти маъмултаринро дар бар мегиранд.
Хатоҳои "Фармон ёфт нашуд"
Агар терминал пас аз насб "command not found: claude" -ро нишон диҳад, танзими PATH дуруст анҷом наёфтааст. Барои macOS ва Linux, макони иҷрошавандаи Claude-ро ба файли танзимоти shell ба таври дастӣ илова кунед.
Барои корбарони bash, ~/.bashrc ё ~/.bash_profile-ро таҳрир кунед ва инро илова кунед:
| export PATH=”$HOME/.local/bin:$PATH” |
Барои корбарони zsh (пешфарз дар macOS-и муосир), ~/.zshrc-ро бо ҳамон хат таҳрир кунед. Пас аз сабт, танзимот-ро бо source ~/.zshrc бор кунед ё тирезаи нави терминалро кушоед.
Мушкилоти шабака ва файрвол
Шабакаҳои корпоративӣ ва файрволҳои маҳдудкунанда баъзан скрипти насбро мебанданд. Тибқи ҳуҷҷатҳои ҳалли мушкилот, агар насб қатъ шавад ё ба ҷои иҷро HTML баргардонида шавад, дастрасӣ ба шабака ба серверҳои Anthropic метавонад баста шавад.
Ҳалли мушкилот зеркашӣ кардани скрипти насбро алоҳида дар бар мегирад:
| curl -fsSL code.anthropic.com/install.sh -o install.sh chmod +x install.sh ./install.sh |
Ин равиш ба шумо имконият медиҳад, ки дар сурати рух додани хатогиҳо ҳангоми зеркашӣ ё иҷро, чӣ хато мешавад, бештар нишон диҳад.
Мушкилоти махсуси WSL
Корбарони Windows, ки WSL-ро истифода мебаранд, баъзан бо мушкилоти пайвастшавӣ байни зерсистемаи Linux ва Windows дучор мешаванд. Ҳуҷҷатҳои расмӣ зикр мекунанд, ки қоидаҳои файрвол метавонанд барои иҷозати трафики WSL танзим карда шаванд.
Агар Claude Code бомуваффақият насб шавад, аммо наметавонад ба серверҳои Anthropic барои аутентификатсия дастрасӣ пайдо кунад, тасдиқ кунед, ки файрволи Windows ба дастрасии шабакаи WSL иҷозат медиҳад. Дастури ҳалли мушкилот фармонҳои мушаххаси PowerShell-ро барои танзими қоидаҳои файрвол пешниҳод мекунад.
Навсозии Claude Code
Claude Code мунтазам бо хусусиятҳои нав ва такмилҳо навсозӣ мешавад. Тибқи ҳуҷҷатҳои расмӣ, навсозиҳо бо ҳамон фармон, ки барои насби аввалия истифода мешавад, насб карда мешаванд.
Скрипти насбро дубора иҷро кунед:
| curl -fsSL code.anthropic.com/install.sh | sh |
Скрипт насби мавҷударо муайян мекунад ва онро ба версияи охирин навсозӣ мекунад. Ҳеҷ танзимот ё аутентификатсия дар раванди навсозӣ гум намешавад.
Пеш аз ва баъд аз навсозӣ, версияи ҷорӣ-ро санҷед:
| claude –version |
Феҳристи тағйиротҳо дар ҳуҷҷатҳои расмии Claude Code ҳама тағйиротҳоро байни версияҳо номбар мекунад, ки ба муайян кардани он, ки навсозӣ хусусиятҳои марбут ба ҷараёнҳои кории мушаххасро ҷорӣ мекунад, кӯмак мекунад.
Қадамҳои минбаъда пас аз насб
Пас аз насб ва кор кардани Claude Code, омӯхтани хусусиятҳои пешрафта имконпазир мешавад. Ҳуҷҷатҳои расмӣ якчанд соҳаҳоро тавсиф мекунанд, ки арзандаи омӯзиш мебошанд:
- Маҳорат ва танзим: Тибқи ҳуҷҷатҳои расмии маҳорат, Claude Code аз маҳоратҳои фармоишӣ, ки дар файлҳои Markdown дар директорияи .claude/skills/ муайян шудаанд, дастгирӣ мекунад. Ин маҳоратҳо қобилиятҳои Claude-ро бо фармонҳо ва ҷараёнҳои кории махсуси лоиҳа васеъ мекунанд.
- Модели Протоколи Контекстӣ (MCP): Интегратсияи MCP ба Claude Code имкон медиҳад, ки бо асбобҳо ва хидматҳои беруна пайваст шавад. Ин Claude-ро ба як марказ табдил медиҳад, ки метавонад ба пойгоҳҳои додаҳо, APIҳо ва дигар захираҳои рушд дастрасӣ пайдо кунад.
- Ҳамкории даста: Файлҳои танзимоти сатҳи лоиҳа дар директорияи .claude/ метавонанд ба идоракунии версия ворид карда шаванд ва танзимоти Claude Code-ро дар байни дастаҳои таҳия мубодила кунанд.
- Ҳуҷҷатҳои расмӣ дастурҳои муфассалро барои ҳар яке аз ин соҳаҳо пешниҳод мекунанд, ки ба насби асосӣ, ки дар ин ҷо баррасӣ шудааст, асос ёфтаанд.
Саволҳои зуд-зуд пурсидашаванда
Оё барои истифодаи Claude Code CLI ба ман обунаи пулакии Claude лозим аст?
Claude Code ба ҳисоби Claude аз Anthropic ниёз дорад, аммо сатҳи обунаи мушаххаси лозимӣ ба истифода вобаста аст. Тибқи ҳуҷҷатҳои расмӣ, аутентификатсия лозим аст, аммо тафсилоти нархгузорӣ бояд дар вебсайти расмии Anthropic тасдиқ карда шаванд, зеро нақшаҳо дар тӯли вақт тағйир меёбанд.
Оё ман метавонам Claude Code-ро бе имтиёзҳои администратор насб кунам?
Дар macOS ва Linux, Claude Code ба таври пешфарз дар директорияи хонагии корбар насб карда мешавад ва ба дастрасии администратор ниёз надорад. Корбарони Windows метавонанд барои усули насби PowerShell ба имтиёзҳои администратор ниёз дошта бошанд, гарчанде ки насбҳои WSL ба дастрасии администратор ниёз надоранд.
Оё Claude Code офлайн кор мекунад?
Не. Claude Code як асбоби бо AI-и пурқувват аст, ки барои коркарди дархостҳо бо серверҳои Anthropic алоқа мекунад. Тибқи ҳуҷҷатҳои расмӣ, барои таҳлили код ва тавлиди посухҳо аз Claude пайвасти фаъоли интернет лозим аст.
Чӣ тавр ман Claude Code-ро нест кунам?
Ҳуҷҷатҳои расмии Advanced setup тавзеҳ медиҳанд, ки несткунӣ ба хориҷ кардани файлҳои иҷрошаванда ва танзимот дахл дорад. Дар macOS ва Linux, директорияи ~/.claude-ро нест кунед ва тағйири PATH-ро аз файлҳои танзимоти shell хориҷ кунед. Корбарони Windows бояд директорияи насбро нест кунанд ва тағйирёбандаи муҳити PATH-ро тоза кунанд.
Оё Claude Code метавонад ба тамоми файли системаи ман дастрасӣ пайдо кунад?
Ба таври пешфарз, Claude Code дар доираи директорияи кории ҷорӣ ва директорияҳои зертобеи он кор мекунад. Тибқи ҳуҷҷатҳои расмии иҷозатномаҳо, дастрасӣ метавонад бо истифода аз танзимоти sandbox дар файлҳои танзимот маҳдуд карда шавад. Claude ҳамеша пеш аз иҷрои амалҳои эҳтимолан харобиовар тасдиқ талаб мекунад.
Тафовут байни Claude Code CLI ва Claude Desktop чист?
Claude Code CLI дар терминал кор мекунад ва ба ҷараёнҳои кории рушд бо дастрасии мустақим ба файли система ва иҷрои фармонҳо тамаркуз мекунад. Claude Desktop як барномаи мустақил бо интерфейси графикӣ мебошад. Ҳарду асбобҳо ба ҳолатҳои истифодаи гуногун хизмат мерасонанд, CLI барои барномасозоне, ки ҷараёнҳои кории дар терминал бударо афзалтар медонанд, оптимизатсия шудааст.
Чанд вақт ман бояд Claude Code-ро навсозӣ кунам?
Навсозиҳоро ҳар вақте ки қулай бошад, насб кардан мумкин аст. Феҳристи тағйиротҳои расмӣ хусусиятҳои нав ва ислоҳи хатогиҳоро ҳуҷҷатгузорӣ мекунад. Барои дастаҳо, ҳамоҳангсозии навсозиҳо кафолат медиҳад, ки ҳама версияҳои мувофиқро истифода мебаранд, гарчанде ки Claude Code барои файлҳои танзимот дар байни версияҳо ҳамшарикии қафоро нигоҳ медорад.
Хулоса
Насб кардани Claude Code CLI дар ҳар системаи оператсионӣ танҳо чанд дақиқаро мегирад. Скриптҳои насби автоматӣ танзимот, танзими PATH ва ҷойгиркунии файлҳои иҷрошавандаро бидуни дахолати дастӣ иҷро мекунанд.
Пас аз насб ва аутентификатсия, Claude Code як ёвари пуриқтидори барномасозии AI мегардад, ки аз ҳама гуна терминал дастрас аст. Фармонҳои забони табиӣ ба барномасозон имкон медиҳанд, ки код нависанд, хатогиҳоро ислоҳ кунанд ва супоришҳоро бидуни тарк кардани хати фармон автоматӣ кунанд.
Омодаед, ки рушди бо ёрии AI-ро таҷриба кунед? Фармони насбро барои платформаи худ иҷро кунед ва имрӯз аввалин ҷаласаи Claude Code-и худро оғоз кунед. Ҳуҷҷатҳои расмӣ дар code.claude.com дастурҳои мукаммалро барои хусусиятҳои пешрафта пас аз анҷоми танзимоти асосӣ пешниҳод мекунанд.
