Հաշիվ, մուտք և մոդելների մատակարարներ

Claude Code-ով աշխատելու համար հաշիվ է պետք։ Հաշվից է կախված, թե ով է վճարում մոդելի հարցումների համար և ինչ հնարավորություններ կունենաս։ Այս դասում կծանոթանանք մուտքի տարբերակներին և /login-ի ու claude auth-ի հրամաններին։ Կտեսնենք նաև, թե ինչ է անում Claude Code-ը, երբ համակարգչում միանգամից մի քանի մուտքի միջոց կա։ Այս մասը կարևոր է, որովհետև սխալ կարգավորման դեպքում կարող ես աննկատ սկսել վճարել ուրիշ հաշվով։

Մուտքի երեք հիմնական ճանապարհ

Claude Code-ի համար պետք է Pro, Max, Team, Enterprise կամ Console հաշիվ։ claude.ai-ի անվճար պլանում Claude Code չկա։ Մոդելներին կարող ես միանալ նաև քո կազմակերպության cloud մատակարարի միջոցով։

Subscription-ը (բաժանորդագրություն) claude.ai-ի վճարովի պլանն է։ Նույն հաշիվն աշխատում է և՛ chat-ում, և՛ Claude Code-ում։ Team և Enterprise պլաններում ադմինիստրատորը քեզ հրավիրում է, և դու մուտք ես գործում հենց այդ claude.ai հաշվով։

Claude Console-ը Anthropic-ի հարթակն է ծրագրավորողների համար։ Այստեղ վճարում ես այնքան, որքան իրականում օգտագործել ես API-ը։ Եթե թիմում ես, ադմինիստրատորը նախ պետք է քեզ հրավիրի և տա «Claude Code» կամ «Developer» դերը։

Cloud մատակարարներին սովորաբար կազմակերպություններն են ընտրում։ Google Cloud-ի տարբերակը նախկինում կոչվում էր Vertex AI, իսկ հիմա փաստաթղթերում այն Google Cloud's Agent Platform է։ Այս դեպքում բրաուզերով մուտք գործել պետք չէ։ Ադմինիստրատորը քեզ է տալիս environment variable-ները (միջավայրի փոփոխականները) և cloud-ի credential-ները։ Կարող ես նաև մուտքի էկրանին ընտրել 3rd-party platform տարբերակը։ Այն բացում է Bedrock-ի և Vertex AI-ի կարգավորման օգնականը (wizard)։

Պլանների անուններն ու պայմանները հաճախ են փոխվում, գները՝ նույնպես։ Դրա համար այս դասընթացում գներ չենք նշում։ Թարմ տվյալները նայիր claude.com/pricing էջում։

Ինչ է հասանելի և ինչ՝ ոչ

Մուտքի եղանակից կախված է նաև, թե որ հնարավորությունները կունենաս։ CLI-ը և IDE-ների extension-ները աշխատում են բոլոր մատակարարների հետ։ Նույնը վերաբերում է hook-երին, skill-երին, subagent-ներին և MCP server-ներին։

Բայց որոշ հնարավորությունների համար պետք է մուտք գործել claude.ai հաշվով։ Console API key-ով կամ cloud մատակարարով դրանք չեն աշխատում։ Դրանցից են cloud session-ները (claude.ai/code) և mobile-ը։ Desktop հավելվածն էլ է այդպիսին։ Նույնը վերաբերում է Remote Control-ին և Chrome extension-ին, ինչպես նաև /schedule routine-ներին և /ultrareview-ին։

Հենց դրա համար էլ նախորդ դասի հրամաններից շատերը (/teleport, /remote-control, /desktop) API key-ով չեն աշխատում։ Ամբողջական ու թարմ աղյուսակը Feature availability էջում է։

Առաջին մուտքը

Տեղադրելուց հետո (դա հաջորդ դասում է) գործարկում ես claude։ Առաջին անգամ Claude Code-ը մուտքի համար բացում է բրաուզերը։

• Եթե բրաուզերն ինքը չի բացվում, սեղմիր c։ Մուտքի հղումը կպատճենվի, և այն կարող ես տեղադրել բրաուզերում։

• Երբեմն մուտքից հետո բրաուզերը քեզ հետ չի ուղարկում, այլ ցույց է տալիս կոդ։ Սա սովորական է WSL2-ում և container-ներում, SSH-ով աշխատելիս էլ է այդպես լինում։ Այդ կոդը տեղադրիր terminal-ում՝ այն դաշտում, որտեղ Claude Code-ը կոդն է խնդրում։

• Մուտքը հաջողվելուց հետո terminal-ը կգրի այդ մասին և կխնդրի սեղմել Enter։

Մուտքի տվյալները (credential-ները) պահվում են անվտանգ տեղում։ macOS-ում դա Keychain-ն է։ Linux-ում դա ~/.claude/.credentials.json ֆայլն է, որը հասանելի է միայն քեզ, իսկ Windows-ում՝ %USERPROFILE%\.claude\.credentials.json ֆայլը։ Ամեն անգամ նորից մուտք գործել պետք չէ։

Հրամաններ՝ session-ի ներսում և դրսում

Session-ի ներսում․

Terminal-ից, առանց session բացելու․

claude auth status-ը հարմար է script-երի համար։ Օրինակ՝ ավտոմատ աշխատանքից առաջ կարող ես ստուգել, որ մուտք գործած ես։

claude auth status --text

claude setup-token՝ CI-ի և script-երի համար

Որոշ միջավայրերում բրաուզեր չկա, օրինակ՝ CI pipeline-ներում կամ server-ի վրա աշխատող script-երում։ Այդ դեպքերի համար կա claude setup-token հրամանը։ Այն բացում է մուտքի նույն էջը, ինչ /login-ը։ Հաստատելուց հետո terminal-ում տպում է մեկ տարի գործող OAuth token։

Token-ը ոչ մի տեղ չի պահվում։ Պատճենում ես այն և այն միջավայրում, որտեղ Claude Code-ը պետք է աշխատի, դնում CLAUDE_CODE_OAUTH_TOKEN environment variable-ի մեջ․

export CLAUDE_CODE_OAUTH_TOKEN=your-token

Այս token-ն ունի իր սահմանափակումները։ Այն աշխատում է միայն Pro, Max, Team կամ Enterprise պլանով։ Դրանով կարելի է միայն հարցումներ ուղարկել մոդելին, այսինքն՝ Remote Control և claude.ai-ի connector-ներ չես ունենա։ Եվ հիշիր, որ token-ը գաղտնաբառի պես արժեքավոր գաղտնիք է։ Մի պահիր այն repository-ում, այլ օգտագործիր CI համակարգի secret-ների պահոցը։

Ավտոմատացմանը մանրամասն կանդրադառնանք 12-րդ մոդուլում։

Ինչ է լինում, երբ մի քանի credential կա

Համակարգչում միաժամանակ կարող են լինել մի քանի մուտքի տվյալներ։ Օրինակ՝ claude.ai-ի մուտքի կողքին կարող է լինել environment variable-ով API key կամ CI-ի token։ Claude Code-ը դրանցից միայն մեկն է ընտրում՝ այս հերթականությամբ (հաղթում է առաջինը, որը գտնվում է)․

Ուշադրություն դարձրու, որ քո սովորական subscription մուտքը ամենավերջինն է։ Վերևի աղբյուրներից ցանկացածը, եթե կա, կարող է դրա տեղը զբաղեցնել։

Զգուշացում․ ANTHROPIC_API_KEY-ը և անսպասելի վճարումը

Սկսնակները այս սխալը շատ հաճախ են անում։ Ասենք՝ ունես Max subscription, բայց ~/.zshrc ֆայլում ինչ-որ հին նախագծից մնացել է export ANTHROPIC_API_KEY=... տողը։

Ինտերակտիվ ռեժիմում Claude Code-ը մեկ անգամ կհարցնի՝ օգտագործե՞լ այդ key-ը։ Եթե համաձայնես, ընտրությունը կհիշվի։ Դրանից հետո key-ը կօգտագործվի subscription-ի փոխարեն, նույնիսկ եթե /login-ով մուտք ես գործել։ Ոչ ինտերակտիվ ռեժիմում (claude -p) key-ը, եթե կա, միշտ է օգտագործվում, առանց հարցնելու։

API key-ը պատկանում է Console հաշվին։ Այնպես որ հարցումները հաշվարկվում են որպես API usage, այսինքն՝ ըստ օգտագործման, և ոչ թե պլանիդ սահմաններում։

Եթե key-ը պատկանում է կազմակերպության, որն անջատված է կամ որի ժամկետն անցել է, մուտքի սխալներ կստանաս։ Օրինակ՝ նախկին աշխատավայրից մնացած key-ի դեպքում սխալը հաճախ ասում է, որ կազմակերպությունն անջատված է (disabled)։

Ինչպես ստուգել և ուղղել․

1. Session-ում գործարկիր /status։ Այն ցույց է տալիս, թե մուտքի որ եղանակն է ակտիվ։ Եթե կան և՛ login, և՛ API key, կնշի նաև, թե դրանցից որը չի օգտագործվում։

2. Եթե ուզում ես վերադառնալ subscription-ին, ընթացիկ terminal-ից հեռացրու փոփոխականը․

unset ANTHROPIC_API_KEY

PowerShell-ում՝ Remove-Item Env:ANTHROPIC_API_KEY։

3. Որպեսզի փոփոխականը նորից չհայտնվի, ջնջիր export ANTHROPIC_API_KEY=... տողը ~/.zshrc, ~/.bashrc կամ ~/.profile ֆայլից։ Windows-ում ստուգիր PowerShell-ի $PROFILE-ը և User environment variable-ները։

4. Եթե key-ը դիտմամբ ես պահում, ինտերակտիվ ռեժիմի ընտրությունը կարող ես փոխել /config-ում՝ «Use custom API key» կարգավորմամբ։ Այն երևում է միայն այն դեպքում, երբ ANTHROPIC_API_KEY-ը սահմանված է։

Եվ մի մանրուք էլ։ Cloud session-ները և Desktop հավելվածը այս environment variable-ները չեն կարդում։ Դրանք օգտագործում են քո claude.ai մուտքը։

Մի քանի հաշիվ մեկ համակարգչում

Եթե աշխատանքային և անձնական հաշիվ ունես, կարող ես երկուսն էլ օգտագործել զուգահեռ։ Ամեն մեկի համար կարգավորումների առանձին պանակ նշիր CLAUDE_CONFIG_DIR փոփոխականով։ Օրինակ՝ ~/.zshrc-ում․

alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'

claude-work-ը կօգտագործի աշխատանքային հաշիվը՝ իր կարգավորումներով և session-ների պատմությամբ, իսկ սովորական claude-ը՝ անձնականը։

Փոքր առաջադրանք

Ընկերդ գրում է․ «Ունեմ Pro պլան, /login-ով մուտք եմ գործել, բայց Console-ում տեսնում եմ, որ իմ հին API key-ով ծախս է գրանցվում։ Իսկ CI-ում claude -p-ն ընդհանրապես չի օգտագործում իմ պլանը»։ Բացատրիր պատճառը և առաջարկիր երեք քայլ, որոնցով նա կստուգի և կուղղի խնդիրը։

Պատասխանի օրինակ

Հավանաբար ընկերոջդ միջավայրում սահմանված է ANTHROPIC_API_KEY։ Credential-ների հերթականությունում այն ավելի բարձր է, քան /login-ի subscription մուտքը։ Ինտերակտիվ ռեժիմում նա մի անգամ հաստատել է key-ը, իսկ -p ռեժիմում key-ը միշտ է օգտագործվում։ Քայլերը․

1. Session-ում գործարկել /status և տեսնել, թե մուտքի որ եղանակն է ակտիվ։

2. Գործարկել unset ANTHROPIC_API_KEY և ջնջել export տողը shell-ի profile ֆայլից։ Հետո բացել նոր terminal և նորից ստուգել /status-ով։

3. CI-ի համար claude setup-token-ով ստեղծել token և այն պահել CI-ի secret-ներում որպես CLAUDE_CODE_OAUTH_TOKEN։ CI-ի միջավայրից էլ պետք է հեռացնել ANTHROPIC_API_KEY-ը։ Թե չէ key-ը կհաղթի, որովհետև հերթականությունում այն token-ից բարձր է։

Մանրամասն՝ Authentication և Feature availability։