Блог

Claude Code-ты қалпына келтіру: қауіпсіз режим, /cd және қосалқы модельдер

Markdown

Claude Code-ты қауіпсіз режим, /cd пәрмені, қосалқы модельдер және баптауларды қалпына келтіру арқылы диагностикалау. Тексерулердің реті мен бастапқы шектеулер.

Мақаланы толық оқу

Агенттермен жұмыс істеуге арналған практикалық материалдар: Ailoot құжаттамасы.

2026 жылғы маусымда Claude Code-та не өзгерді?

Негізгі түйін

2026 жылғы 8 маусымда Anthropic Claude Code v2.1.169 нұсқасына --safe-mode жалаушасын және /cd пәрменін қосты. Одан екі күн бұрын, v2.1.166 нұсқасында қосалқы модельдер енгізілді: тізбекте 3 модельге дейін пайдалануға болады. Бұл үш мүмкіндік vibe coder-лердің жиі кездесетін мәселесін шешеді: «бәрі істемей қалды, кім кінәлі екенін білмеймін және қайта орнатуға бір сағат жоғалтқым келмейді».

Бұрын Claude Code оғаш әрекет ете бастағанда — жүктелу белгішесі шексіз айналса, іске қосылғанда істен шықса, агент CLAUDE.md ішіндегі ережелерді елемесе немесе hook үнсіз орындалмай қалса — шығудың бір-ақ жолы болатын: .claude/settings.json бөлімдерін қолмен түсініктеме ретінде белгілеу, MCP серверлерін бір-бірлеп өшіру немесе ең нашар жағдайда ~/.claude бумасын жойып, қайта орнату. Сипатталған бір жағдайда ~/.claude жойылып, бір жарым сағат құрастырылған MCP серверлерінің баптауы жоғалды. Кейін кінәлі CLAUDE.md ішіндегі бір жол екені және оны 10 секундта табуға болатыны анықталды — бірақ мұны толық қалпына келтіргеннен кейін ғана түсінді.

2026 жылғы маусымда Anthropic осы сценарийді өзгертетін үш тетікті іске қосты. Қысқаша айтқанда, не және қашан қосылды:

НұсқаКүніҚосылған мүмкіндік
2.1.1662026 жылғы 6 маусымfallbackModel баптауы және интерактивті сеанстарға арналған --fallback-model жалаушасы
2.1.1692026 жылғы 8 маусым--safe-mode жалаушасы және CLAUDE_CODE_SAFE_MODE орта айнымалысы, /cd пәрмені
2.1.1762026 жылғы 12 маусымТүзету: /cd және worktree ауысуы ескі git тармағын көрсетпейтін болды

Төменде әр тетік қадам-қадамымен түсіндіріледі, сондай-ақ Claude Code сеансы дұрыс жұмыс істемей қалғанда оларды қолдану реті берілген.

Claude Code көбіне неден істен шығады?

Негізгі түйін

Сипатталған тәжірибеге сүйенсек, Claude Code vibe coder-лерде көбіне төрт нәрседен істен шығады: ережелері бір-біріне қайшы, шамадан тыс үлкейген CLAUDE.md; қате шығу коды бар hook; үнсіз істен шығатын MCP сервері; және settings.json файлының үш деңгейіндегі қабаттасқан баптаулар. Кінәлі біреу-ақ, диагностикалауға бірнеше минут кетеді, ал үрей адамды бірден rm -rf пәрменін қолдануға итермелейді.

Сипатталған мысалда CLAUDE.md бастапқыда 80 жол етіп жасалып, бір ай бойы дұрыс жұмыс істеді. Екінші айда Claude аптасына бір рет барлық қойылған ережені бұзатыны байқалды: .env файлын ашу, git push --force орындау, node_modules бумасын ақтару. Әдейі емес — ол жай ғана ұмытып қалды. Бірде .gitignore жойылып кетті, себебін бірден түсінбедік. Бұл сценарий CLAUDE.md жөніндегі нұсқаулықта толығырақ қарастырылған.

CLAUDE.md 400+ жолға жеткенде, ол үнсіз қиындық туғыза бастайды: сеанс басталғанда контекст терезесінің едәуір бөлігін алады да, маңызды нұсқауларды екінші кезектегі нұсқаулар арасында сұйылтады. Claude файлды ресми түрде оқиды, сондықтан сырт көзге «ережелер бар, бірақ жұмыс істемейді» болып көрінеді — бұл шамадан тыс үлкейген келісімнің әдеттегі белгісі.

Екінші жиі кездесетін мәселе — hook-тар. Claude Code hooks туралы Anthropic баса айтпайтын бір жайт бар.

Демек, Python hook ішіндегі sys.exit(1) (немесе Unix жүйелерінде әдетте қолданылатын «қатемен аяқталды» коды) Claude-ты тоқтатпайды. Тек 2 коды бұғаттайды. Сипатталған жағдайда hook «қатаң тыйым» деп есептелгенімен, іс жүзінде ол шағымды журналға жазып, әрекетті орындауға рұқсат берген.

Үшінші қабат — MCP серверлері; олар да өз алдына істен шығады.

Белгі көбіне бірдей: MCP пәрмендері қолжетімді, бірақ traceback көрсетпей failed деп қайтарады. MCP баптау және claude mcp add арқылы сервер қосу туралы қосымша мәлімет бөлек нұсқаулықта берілген.

Төртінші мәселе — settings.json файлының үш деңгейлі иерархиясы. Сізде ~/.claude/settings.json (пайдаланушы деңгейі), жоба түбіріндегі .claude/settings.json (жоба деңгейі), .claude/settings.local.json (жергілікті деңгей) және корпоративтік әкімші басқаратын баптаулар болуы мүмкін. Олар басымдық ережелеріне сай біріктіріледі. Біреу жоба деңгейінде MCP серверін қосып, ал пайдаланушы деңгейінде іске қосу баптауы басқа ұқсас жазба болса, үнсіз қайшылық туып, «Claude Code істемей қалды» сияқты көрінеді.

--safe-mode қалай жұмыс істейді және нені өшіреді?

Негізгі түйін

claude --safe-mode Claude Code-ты барлық реттеулері толық өшірілген күйде іске қосады: CLAUDE.md, плагиндер, дағдылар, hook-тар, MCP серверлері, пайдаланушы пәрмендері, агенттер, шығыс стильдері, жұмыс ағындары және пернелер тіркесімдері. Авторизация, модель таңдау, кіріктірілген құралдар мен рұқсаттар сақталады. Бұл — диагностика құралы: мәселе қауіпсіз режимде жойылса, оған сіз қосқан қабаттардың бірі себеп болған.

Anthropic-тің v2.1.169 өзгерістер журналындағы бастапқы тұжырым мынадай:

Диагностика үшін Claude Code-ты реттеулері өшірілген күйде (CLAUDE.md, плагиндер, дағдылар, hook-тар, MCP серверлері) іске қосатын --safe-mode жалаушасы (және CLAUDE_CODE_SAFE_MODE) қосылды.

— Anthropic Claude Code Changelog, https://code.claude.com/docs/en/changelog

Anthropic модельді баптау құжаттамасында нақтылайды:

Мәселеге реттеулер себеп болғанын тексеру үшін claude --safe-mode пәрменімен сеанс бастаңыз. Ол CLAUDE.md, дағдылар, MCP серверлері және hook-тарды өшіреді. Git күйі мен бума атаулары реттеулерге жатпайды және қолжетімді болып қалады.

— Anthropic Docs - Model configuration, https://code.claude.com/docs/en/model-config

Бұл — диагностика құралы, «таза орта» емес. Қауіпсіз режим бір сұраққа жауап береді: мәселе Claude Code-тың бастапқы әрекетінде ме, әлде қосылған реттеулерде ме? Бұл — контекст инженериясының бір бөлігі: Claude дәл қазір нені көретінін және көрмейтінін басқару. Қауіпсіз режимде бәрі дұрыс жұмыс істесе, қабаттарды екіге бөліп іздеу әдісімен тексеру керек. Ал жұмыс істемесе, мәселе орнатуда, авторизацияда, желіде немесе инфрақұрылымда болуы мүмкін, сондықтан claude doctor пен журналдарды қараған жөн.

Қауіпсіз режим нені өшіреді (Anthropic-тің ресми тізіміндегі 5 негізгі қабат):

  • Барлық деңгейдегі CLAUDE.md (пайдаланушы / жоба)
  • Плагиндер
  • Дағдылар
  • Hook-тар
  • MCP серверлері

Жұмыс істей беретін нәрселер:

  • Авторизация (OAuth сеансыңыз немесе API кілті)
  • Модель таңдау (--model sonnet, --model opus)
  • Кіріктірілген құралдар (Read, Write, Bash, Grep және т.б.)
  • Рұқсаттар
  • Git күйі
  • Бума атаулары

Маңызды жайт: қауіпсіз режим корпоративтік әкімші басқаратын саясат баптауларын өшірмейді. Егер Bedrock GovCloud немесе MDM баптауы availableModels мәнін белгілейтін топта жұмыс істесеңіз, ол шектеулер сақталады — қауіпсіз режим тек сіздің реттеулеріңізді өшіреді, корпоративтік саясатты емес.

Қабатты бөліп, кінәліні 60 секундта қалай табуға болады?

Негізгі түйін

1-қадам: мәселе шыққан сол бумада claude --safe-mode орындаңыз. Жұмыс істесе, мәселе реттеулеріңізде, сондықтан оларды бір-бірден қосыңыз: CLAUDE.md -> hook-тар -> MCP -> дағдылар. Қауіпсіз режимде де жұмыс істемесе, мәселе авторизацияда, нұсқада, желіде немесе операциялық жүйеде. Мұндайда rm -rf пәрменін қолданбай, автоматты диагностика үшін claude doctor орындаңыз.

Claude Code «тыңдамай қойған» жағдайға арналған диагностикалық сценарий. Төмендегі пәрмендердің ең төменгі нұсқасы — Claude Code v2.1.169. Сіздегі нұсқа ескі болса, алдымен жаңартыңыз (npm update -g @anthropic-ai/claude-code немесе Anthropic-тің жергілікті орнатқышы арқылы).

  1. Мәселе шыққан сол буманы ашыңыз.
  2. claude --safe-mode пәрменін орындаңыз.
  3. Таза іске қосылса, бастапқы сұрауыңызды тексеріңіз. Ол орындалды ма? Онда мәселе қабаттардың бірінде. 4-қадамға өтіңіз.
  4. Қауіпсіз режимде де істемесе, баптауларды қозғамаңыз. Алдымен claude doctor орындап, авторизацияны, нұсқаны және қайшы орнатылымдарды тексеріңіз.

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

  1. CLAUDE.md. Қауіпсіз режимсіз claude пәрменін орындаңыз, бірақ файлдың атын уақытша өзгертіңіз: mv CLAUDE.md CLAUDE.md.bak. Жұмыс істесе, себеп сол файлда. Содан кейін екіге бөліп іздеуге болады: жолдардың жартысын қалдырып, тексеріңіз.
  2. Hook-тар. .claude/settings.json файлын ашып, hooks бөліміндегі мәнді уақытша [] етіп қойыңыз. claude пәрменін қайта іске қосыңыз. Енді жұмыс істей ме? Онда кінәлі hook-тардың бірі. Оларды бір-бірден қосыңыз.
  3. MCP серверлері. Сол сияқты, ~/.claude.json немесе .claude/settings.json ішінде mcpServers бөлімін уақытша бос объект етіп қойып, қайта іске қосып, тексеріңіз.
  4. Дағдылар. .claude/skills/ бумасын уақытша бумаға жылжытыңыз. Іске қосып, тексеріңіз.

«Уақытша атын өзгерту» дегеніміз — диагностика кезінде файлдар жойылмайды. mv немесе git stash арқылы қабат кінәлі болмаса, бәрін бір пәрменмен қалпына келтіруге болады.

Контексті жоғалтпай, жұмыс бумасын /cd арқылы қалай ауыстыруға болады?

Негізгі түйін

Claude Code 2.1.169+ нұсқасындағы /cd <path> пәрмені prompt cache-ті жоғалтпай, белсенді сеанстағы жұмыс бумасын ауыстырады. Ағымдағы жобаның баптауы бұзылғанда пайдалы: таза бумаға ауысып, Claude жұмыс істейтінін тексеріп, қайта орала аласыз. Бұрын сеансты жауып, қайта бастау керек болатын.

8 маусымдағы v2.1.169 өзгерістер журналында:

Сеанс ортасында prompt cache-ті қалпына келтірмей, жаңа жұмыс бумасына ауысатын /cd пәрмені қосылды.

— Anthropic Claude Code Changelog, https://code.claude.com/docs/en/changelog

Мәселені түзеткенде оның пайдасы неде? ~/work/myapp жобасының бумасындасыз делік, ал Claude Code оғаш әрекет етіп жатыр. Бұрын «ол жалпы жұмыс істей ме?» деп тексерудің жалғыз жолы сеансты жауып, басқа бумаға өтіп, қайта бастау болатын. Контекст, журнал және қыздырылған prompt cache жоғалатын. Енді:

# Сол сеанстың ішінде:
/cd ~/sandbox/test

Claude жаңа бумаға ауысып, оның CLAUDE.md файлын (бар болса) жүйелік сұрауды алмастыру ретінде емес, хабарлама ретінде оқиды — осылайша кэш сақталады. ~/sandbox/test ішінде бәрі жұмыс істесе, мәселе ~/work/myapp бумасының баптауында екені белгілі.

12 маусымда v2.1.176 бір жағымсыз кері өзгерісті түзетті: /cd толық қайта іске қосқанша ескі git тармағын көрсететін. Нұсқаңыз ескі болса, жаңартыңыз немесе ауысқаннан кейінгі алғашқы бірнеше хабарламада git status мәнін елемей тұрыңыз — ол кейін жаңарады.

529 қатесіне қосалқы модельдерді қалай баптауға болады?

Негізгі түйін

v2.1.166 нұсқасында Anthropic fallbackModel параметрін қосты: негізгі модель шамадан тыс жүктелгенде немесе қолжетімсіз болғанда кезекпен тексерілетін 3 модельге дейінгі тізбек. Тізбек тек шамадан тыс жүктелу және қайта әрекет етуге келмейтін сервер қателері кезінде іске қосылады. Авторизация, төлем, сұрау жиілігі шегі және тасымалдау қателері қосалқы модельдер тізбегін қоспайды — олар әдеттегі қайталау логикасына бағынады.

Сипатталған жағдайда ұзақ тапсырма жоба ішінде аптасына бір рет Opus-та орындалады; 10 минуттан кейін API 529 Overloaded қайтарады да, сеанс істен шығады. Бұрын күтуге немесе --model sonnet арқылы Sonnet-ке қолмен ауысып, қыздырылған контекстің бәрін жоғалтуға тура келетін. Екінші ми құрылымы бар үлкен business/ бумасында бұл шамамен жиырма минут жұмыс алады. Енді мұның арнайы тетігі бар.

Ресми құжаттамадан дәлме-дәл дәйексөз:

Негізгі модель шамадан тыс жүктелгенде, қолжетімсіз болғанда немесе қайта әрекет етуге келмейтін басқа сервер қатесін қайтарғанда, Claude Code сұрау сәтсіз аяқталмай, қосалқы модельге ауыса алады. Авторизация, төлем, сұрау жиілігінің шегі, сұрау өлшемі және тасымалдау қателері ауысуды ешқашан іске қоспайды — олар әдеттегі қайталау және қателерді өңдеу жолымен жүреді.

— Anthropic Docs - Model configuration, https://code.claude.com/docs/en/model-config

Ал тізбектің жұмысы бөлек былай түсіндіріледі:

Бір немесе бірнеше қосалқы модельді баптаңыз, сонда Claude Code оларды ретімен байқап, ауысқан кезде хабарлама көрсетеді. Ауысу тек ағымдағы кезекке қолданылады — келесі хабарлама негізгі модельді қайта сынайды. Қайталанатын мәндерді алып тастағаннан кейін тізбек үш модельмен шектеледі; артық жазбалар еленбейді.

— Anthropic Docs - Model configuration, https://code.claude.com/docs/en/model-config

Баптаудың екі жолы бар. CLI арқылы:

claude --fallback-model sonnet,haiku

~/.claude/settings.json арқылы:

{
  "fallbackModel": ["claude-sonnet-4-6", "claude-haiku-4-5"]
}

Сұрау жиілігінің шегіне қатысты бөлек жайт бар. Anthropic 429 қатесін әдейі тізбекке қоспайды, сондықтан келесі модельге ауысып, сұрау шегін айналып өту мүмкін емес. Қосалқы модель тек негізгісі шамадан тыс жүктелгенде, қолжетімсіз болғанда немесе қайта әрекет етуге келмейтін сервер қатесін қайтарғанда жұмыс істейді (мысалы, 529 Overloaded). Сұрау жиілігінің шегінде әдеттегі қайталау логикасы мен күту аралығы қолданылады.

Тағы бір жайт: 12 маусымда v2.1.174 нұсқасы бір кері өзгерісті түзетті — ықшамдау --fallback-model баптауын ескермеген еді. Ұзақ сеансыңыз шамадан тыс жүктелу кезінде ықшамдалса, осы түзетуге дейін қосалқы модель шақырылмайтын. Ұзақ сеанстармен (/compact, түнгі /loop) жұмыс істесеңіз, кемінде v2.1.174 нұсқасына жаңартыңыз.

Кінәлі CLAUDE.md, hook, MCP немесе дағды болса, нені түзету керек?

Негізгі түйін

Қауіпсіз режим кінәлі қабатты анықтағаннан кейін, түзету жолы қабатқа байланысты. CLAUDE.md үшін екіге бөліп іздеу әдісін қолданыңыз немесе 200 жолдан қысқа дайын үлгіге оралыңыз. Hook үшін шығу кодын (2 бұғаттайды, 1 бұғаттамайды) және логиканы тексеріңіз. MCP үшін бір серверді алып тастап, тексеріңіз. Дағды үшін SKILL.md файлының CLAUDE.md ішіндегі ережелермен қайшы келмейтінін тексеріңіз.

Әр қабатқа арналған нақты тәсілдер төменде берілген.

Кінәлі CLAUDE.md болса

Файлды ашып, көлемін тексеріңіз. Сипатталған тәжірибеге сүйенсек, белсенді CLAUDE.md файлын 200 жолдан асырмаңыз; қалғанын жоба жанындағы маршрутизаторлар мен қосымша құжаттарға көшіріңіз (екінші мидың толық құрылымы екінші ми жөніндегі нұсқаулықта берілген). 400+ жол болса, мәселенің себебі сол болуы әбден ықтимал. Қадамдар:

  1. Сақтық көшірме жасаңыз: cp CLAUDE.md CLAUDE.md.full.
  2. Қысқа, жұмыс істейтін үлгіге оралыңыз. Дайын үлгі «CLAUDE.md файлын қалай баптауға болады» нұсқаулығында бар.
  3. Claude Code-ты қайта іске қосып, тексеріңіз.
  4. Жұмыс істесе, ережелерді 10–20 жолдан тұратын шағын блоктармен қайтарып, әр блоктан кейін тексеріңіз.
  5. Мінез-құлықты бұзатын блокты табыңыз. Оны шығу коды дұрыс hook ретінде қайта жазыңыз (hook-тардың шығу кодтары осы H2 бөлімінің келесі ішкі бөлімінде қарастырылады).

Кінәлі hook болса

Негізгі сұрақ — шығу коды дұрыс па? Claude Code hook-тарында:

  • Шығу коды 0 — бәрі дұрыс; әрекет жалғасады.
  • Шығу коды 1 — қате, бірақ бұғаттамайды. Claude ештеңе болмағандай жұмысын жалғастырады.
  • Шығу коды 2 — бұғаттайтын қате. Әрекетті тек осы код тоқтатады.

Shell hook ішінде sys.exit(1) немесе exit 1 жазып, әрекетті бұғаттайды деп ойласаңыз, Claude Code-та бұл код әрекетті тоқтатпай, ескерту жазбасын ғана қалдырады. Оны 2 мәніне өзгертіңіз. Hook-тар туралы және осы қателікке жол бермей баптау жайында қосымша ақпаратты бөлек нұсқаулықтан қараңыз.

Екінші жиі кездесетін жағдай — hook stdout-қа жарамсыз JSON қайтарады. Claude Code hook жауабын JSON ретінде талдайды; ішінде бөтен мәтін болса (журнал жазбасы, орындалу барысының белгісі, emoji), hook сәтсіз деп есептеліп, әрекет жалғасады. Ереже: stdout-та тек JSON болуы керек; қалғанының бәрі stderr-ке жазылсын.

Үшінші жағдай — hook қауіпсіз режим жасырып қойған ~/.claude/ ішіндегі бір нәрсені оқиды. Бұл қалыпты сценарий; hook-ты өзгертіп түзетпей, басында os.environ.get('CLAUDE_CODE_SAFE_MODE') мәнін тексеріп, 0 кодымен шығыңыз.

Кінәлі MCP сервері болса

Белгілері: MCP пәрмендері қолжетімді, бірақ анық traceback көрсетпей failed деп қайтарады. Қадамдар:

  1. claude mcp list пәрменін орындап, қандай серверлер анықталғанын тексеріңіз.
  2. Серверлерді ~/.claude.json ішінде бір-бірден өшіріңіз: claude-server-A кілтін _claude-server-A деп өзгертіңіз (бұл оны жоймай, белсенділігін тоқтатады).
  3. claude пәрменін қайта іске қосып, қай шақырулардың жұмыс істейтінін тексеріңіз.
  4. Кінәлі серверді тапқан соң, журналын тексеріңіз: claude mcp logs <name>.
  5. Бұл үшінші тарап сервері болса (@modelcontextprotocol/server-postgres және басқалары), жаңа нұсқасы шыққан-шықпағанын тексеріңіз. MCP экожүйесі әлі де тұрақсыз; Claude Code жаңартылған сайын серверлер жиі істен шығады.

«Тек екі MCP қосылғанда іске қосылмайды» деген жағдай болса, MCP жоқ қауіпсіз режимдегі әрекетімен салыстырыңыз.

Кінәлі дағды болса

Дағды — .claude/skills/<name>/ ішіндегі SKILL.md файлы мен код. Белгілері: Claude дағдыны елемейді, орынсыз кезде қолданады немесе қолданып, бірақ сапасыз нәтиже береді. Қадамдар:

  1. SKILL.md файлын ашыңыз. Сипаттамасын тексеріңіз — ол 1–2 сөйлемнен тұрып, дағдыны қашан қолдану керегін нақты айтуы керек. «Бәріне арналған әмбебап көмекші» десе, Claude оны қай кезде шақыру керегін түсінбейді.
  2. CLAUDE.md файлымен қайшылығы бар-жоғын тексеріңіз. CLAUDE.md «әрқашан тест жазыңыз» десе, ал дағды сипаттамасы «тестсіз жылдам прототип жасау үшін қолданыңыз» десе, қайшылық бар.
  3. Дағды сыртқы пәрмендерді (npm, python, git) пайдаланса, олардың жүйелік PATH ішінде қолжетімді екенін тексеріңіз. Дағдының өзіне арналған ең аз орта болады.

Қауіпсіз режим көмектеспесе не істеу керек: жөндеуден бұрын себебін анықтап, күйді сақтау

Негізгі түйін

Қауіпсіз режим де істемесе, орнату, авторизация, желі не инфрақұрылым себептері әлі мүмкін. claude doctor орындап, дәлелін қараңыз. Анық емес есеп баптаулар мен сеанстарды жоюға негіз емес: алдымен толық күйді сақтап, тексеріңіз, кейін себебі анықталған орнатылымды ғана жөндеңіз.

Пайдаланушы күйін жою — диагностиканы қысқарту жолы емес. Төмендегі тексерулермен себебін анықтаңыз; нәтиже анық болмаса, дәлелдерді сақтап, зерттеуді жалғастырыңыз. Орнатылымды жөндеу тексерілген сақтық көшірмеден басталып, бар аккаунт пен credential-store identity-ін сақтайды. Реті:

  1. claude doctor — автоматты диагностика. Anthropic құжаттамасында былай делінген:

claude --version жұмыс істеп, бірақ басқа нәрсе дұрыс болмаса, автоматты диагностика есебін жасау үшін claude doctor орындаңыз.

— Anthropic Docs - Troubleshoot installation, https://code.claude.com/docs/en/troubleshoot-install
  1. Қайшы орнатылымдарды тексеріңіз. Көп адамда npm арқылы жаһандық орнатылған нұсқа мен жергілікті орнатқышпен орнатылған нұсқа қатар болады:

Claude Code-тың бірнеше орнатылымы нұсқалардың сәйкес келмеуіне немесе күтпеген әрекетке әкелуі мүмкін.

— Anthropic Docs - Troubleshoot installation, https://code.claude.com/docs/en/troubleshoot-install
  1. ANTHROPIC_API_KEY OAuth сеансыңызды алмастырып тұрмағанын тексеріңіз. Бұл «ештеңе істемейді, кілттің мерзімі өтіп кеткен» деген жағдайдың жиі себебі:

`ANTHROPIC_API_KEY` орнатылып, оны растаған болсаңыз, Claude Code жазылымдағы OAuth тіркелгі деректерінің орнына сол кілтті пайдаланады.

— Anthropic Docs - Troubleshoot installation, https://code.claude.com/docs/en/troubleshoot-install

Шешімі: ағымдағы shell сеансында unset ANTHROPIC_API_KEY орындаңыз немесе оны ~/.zshrc / ~/.bashrc файлынан алып тастаңыз.

  1. Диагностика көрсеткен орнатылымды ғана жөндеңіз; алдымен пайдаланушы күйін толық сақтаңыз. Қауіпсіз режимдегі қате не анық емес doctor есебі пайдаланушы деректерін жою керегін дәлелдемейді. Бірізді сақтық көшірме үшін барлық Claude сеанстары мен басқа жазушыларды тоқтатыңыз. Сол Unix аккаунтын, HOME, операциялық жүйенің credential store-ын және Anthropic аккаунтын сақтаңыз; кілт ауыстырмаңыз, алмастырушы identity жасамаңыз.

Төмендегі көшірме мысалы GNU tar бар Linux-қа арналған. macOS не Windows-та сол платформаның ACL, кеңейтілген атрибут, сілтеме және метадеректерін сақтайтын құралды қолданып, жалғастырмас бұрын қалпына келтіруді тексеріңіз; GNU-ға ғана тән жалаушалар басқа жерде істейді деп санамаңыз. Архивте кіру деректері мен сеанс мәтіндері бар: оны жеке және репозиторийден тыс сақтаңыз.

# Run as the same user who owns the Claude state, after stopping writers.
set -eu
umask 077
backup_dir=$(mktemp -d "$HOME/.claude-recovery-XXXXXXXX")
set --
if [ -e "$HOME/.claude" ] || [ -L "$HOME/.claude" ]; then
  set -- "$@" .claude
fi
if [ -e "$HOME/.claude.json" ] || [ -L "$HOME/.claude.json" ]; then
  set -- "$@" .claude.json
fi
[ "$#" -gt 0 ] || exit 1
tar --acls --xattrs --numeric-owner -cpf "$backup_dir/claude-state.tar" -C "$HOME" "$@"
tar --acls --xattrs --compare -f "$backup_dir/claude-state.tar" -C "$HOME"
sha256sum "$backup_dir/claude-state.tar" > "$backup_dir/claude-state.sha256"
(cd "$backup_dir" && sha256sum -c claude-state.sha256)
mkdir "$backup_dir/restore-check"
tar --acls --xattrs -xpf "$backup_dir/claude-state.tar" -C "$backup_dir/restore-check"
tar --acls --xattrs --compare -f "$backup_dir/claude-state.tar" -C "$backup_dir/restore-check"
printf 'Verified recovery directory: %s\n' "$backup_dir"

Барлық пәрмен сәтті өтуі керек. Архив тек Git бақылайтын баптауларды емес, еленбейтін/бақыланбайтын сеанстар мен плагин күйін қоса бүкіл бар .claude ағашын және .claude.json файлын қамтиды. Екі жолдың бірі символдық сілтеме болса не дерек басқа бапталған жерде тұрса, тоқтап, шешілген нысанасын сол тексерілген көшірмеге қосыңыз: жалғыз сілтемені архивтеу оның нысанасын сақтамайды. Архивте macOS Keychain не басқа сыртқы credential store жоқ, сондықтан олардың identity-лерін орнында ұстаңыз.

Диагностика ескі жергілікті орнатылымды қайшы көшірме деп нақты көрсетсе, конфигурация мен сеанстарды жоймай, тек сол орнатылымды жеке қалпына келтіру қалтасына жылжытыңыз:

# Use the verified backup_dir from the previous block.
if [ -d "$HOME/.claude/local" ]; then
  mv "$HOME/.claude/local" "$backup_dir/legacy-local"
fi

npm орнатылымын диагностика оны қайшы көшірме деп көрсеткенде және жергілікті орнатылымды сақтағыңыз келгенде ғана алыңыз. Кейін .claude не .claude.json жоймай, құжатталған жергілікті орнатқышты қолданыңыз:

curl -fsSL https://claude.ai/install.sh | bash
claude --version
claude doctor

Windows-та жергілікті орнату пәрмені:

irm https://claude.ai/install.ps1 | iex

Қалпына келтіруді бөлек орындаңыз. Жазушыларды тағы тоқтатыңыз. Архив бақылау сомасын тексеріп, жоғарыдағыдай бос қалпына келтіру қалтасына шығарыңыз; файлдарды қолданбас бұрын салыстыру сәтті өтсін. Жылжытылған ескі орнатылымды қайтару қажет болса, алдымен $HOME/.claude/local жоқ екенін растаңыз да, $backup_dir/legacy-local жолын дәл сол орынға жылжытыңыз. Себебі анықталған баптау файлын тексерілген шығарылымнан қайтарғанда қазіргі алмастырушыны алдымен сақтаңыз; бүкіл ағаштың үстіне соқыр жазбаңыз. Сеанстар, MCP баптаулары және бастапқы identity сақталады. Жалғыз git күйі еленбейтін/бақыланбайтын мәтіндерді, кіру деректерін не файлдық метадеректерді қамтымайды.

Claude Code бұзылғанда НЕ ІСТЕМЕУ керек?

Негізгі түйін

Сипатталған қолдау жағдайларында кездескен алты тиімсіз әрекет: диагностикаға дейін кілттерді өзгерту, бірден толық қалпына келтіру, hook-тағы интерфейс қатесіне бола абыржу, логиканы түзетпей тұрып hook-тың шығу кодын көтеру, қауіпсіз режимді қолданбай CLAUDE.md өңдеу және «Claude өз MCP-сін өзі түзетеді» деп сену. Әрқайсысы сағаттап уақыт алады, ал ешқайсысы қажет емес.

Диагностикаға дейін кілттерді өзгертпеңіз

«Авторизация жұмыс істемейді» деген жағдайлардың 90%-ында не ANTHROPIC_API_KEY жазылымды алмастырады, не hook интерфейсінде қате бар, не MCP істен шыққан. Кілттерді ауыстыру бұлардың ешқайсысын түзетпейді, бірақ тағы бір сағат үзіліске әкеледі: ескі кілтті жою, жаңасын шығару, CI жүйесінде қайта баптау және өндірістік ортадағы айнымалыларды жаңарту керек. Алдымен claude --safe-mode орындаңыз. Жұмыс істей ме? Онда мәселе реттеулерде; кілттерге тиіспеу керек.

Қауіпсіз режимді қолданбай тұрып толық қалпына келтірмеңіз

Қауіпсіз режим оқшауланған ортаны 1 секундта береді. .claude жою сеанстарды, MCP конфигурациясын және басқа бақыланбайтын күйді құртуы мүмкін. Алдымен себебін анықтап, жеке сақтық көшірмені тексеріңіз; тек қатысы дәлелденген орнатылым не конфигурация қабатын қайтымды жылжытыңыз.

Hook-тағы интерфейс қатесіне бола абыржымаңыз

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

Логиканы түзетпей тұрып hook-тың шығу кодын көтермеңіз

Бұғаттайтын hook әрекетті бұғаттамаса, exit 2 орнатып, бітті деу оңай. Бұл жұмыс істейтін уақытша түзету, бірақ басқа мәселені жасырады: hook бір ай бойы істемесе, тыйым салуы тиіс әрекеттердің бәрі орындалған. Алдымен git журналын қарап, нақты ненің өтіп кеткенін анықтаңыз. Содан кейін ғана бұғаттауды қосыңыз. Әйтпесе кейін енгізілген тыйым бұрын болған жағдайларды кері қайтармайды.

Өндірістік CLAUDE.md файлын қауіпсіз режимді қолданбай өңдемеңіз

Сипатталған жағдайда: CLAUDE.md файлын өңдейсіз, Claude оғаш әрекет ете бастайды, git diff пәрменін орындағанда біреудің сол кеште репозиторийге MCP сервері мен hook та қосқанын көресіз. Өзгерісіңізді кінәлап, кері қайтарасыз, бірақ Claude әлі де оғаш әрекет етеді. Ереже: git revert пәрменіне дейін claude --safe-mode ажиллуул. Қауіпсіз режимде де мәселе сақталса, өңдеген файлыңыздың оған қатысы жоқ; оны кері қайтарудың қажеті жоқ.

«Claude өз MCP-сін өзі түзетеді» дегенге сенбеңіз

Әдеттегі сценарий: сіз Claude-тан «MCP серверіне бір құрал қос» деп сұрайсыз, Claude жұмыс істеп тұрған баптауды қайта жазып, бәрін бұзады, кейін бірнеше кезек бойы өзі келтірген зақымды түзетуге тырысып, сеанс квотасын тауысады. MCP бұзылғанда баптауды қолмен алыңыз; оны агентке тапсырмаңыз. Оның құралдарының бір бөлігі де MCP арқылы жұмыс істейді, сондықтан бұзылған MCP диагностиканы да бұзады.

Түзеткеннен кейін қайда өту керек?

Негізгі түйін

Claude Code-ты қалпына келтірген соң, қайта бұзылмауы үшін алдын алу шараларын қосыңыз. Ең азы: пайдаланушы баптауларында disableBypassPermissionsMode: "disable" параметрін орнату, .env файлына қол жеткізу мен git push --force пәрменін бұғаттайтын hook-тар және ұзақ автономды іске қосуларға арналған sandbox. Алдын алу туралы нұсқаулық — осы нұсқаулықтың жалғасы.

Оқиғаны талдап болған соң, бірден жұмысқа кіріспеңіз. Алдымен оның қайталануына жол бермейтін шараларды қосыңыз. Екінші миға (business/ қалтасындағы жоба құрылымы) және CLAUDE.md файлына бірнеше сағат жұмсауға болады, ал оларды қолмен қалпына келтіру қиын — мұның өзі алдын алу шараларын қосуға жеткілікті себеп. Ең аз қажет жиынтық:

  1. ~/.claude/settings.json файлындағы permissions.disableBypassPermissionsMode: "disable" — bypass режиміне архитектуралық деңгейде тыйым салады. Осылайша, кездейсоқ іске қосылған --dangerously-skip-permissions пәрмені жұмыс істемейді.
  2. Read(./env*), Bash(git push --force), Write(./node_modules/**) әрекеттеріне арналған hook-тар — тілекке емес, қатаң ережеге сай бұғатталуы тиіс әрекеттер.
  3. Ұзақ автономды іске қосуларға арналған sandbox баптаулары (/loop, /schedule).
  4. Контекстен нені алып тастау керегін көрсететін өз ережелеріңіз жазылған /compact — Claude контексті сарқып алмауы үшін.

Қорғаудың төрт қабатты толық схемасы «Жобаңызды түн ішінде бұзбайтындай етіп Claude Code-ты баптау» нұсқаулығында берілген. Бір нұсқаулықта /loop іске қосылғанға дейінгі алдын алу шаралары, ал екіншісінде /loop әлденені бұзып қойғаннан кейінгі қалпына келтіру жолы түсіндіріледі. Мағыналық тұрғыдан — бірін-бірі толықтыратын екі нұсқаулық.

Дереккөздер

  • Anthropic Claude Code Changelog — v2.1.166 (fallbackModel), v2.1.169 (қауіпсіз режим, /cd), v2.1.174 (контексті ықшамдау түзетуі), v2.1.176 (/cd кезіндегі git тармағын көрсету түзетуі) сипатталған ресми өзгерістер журналы.
  • Anthropic Docs - Model configuration — “Fallback model chains,” “Check what triggered fallback,” “Setting your model” бөлімдері.
  • Anthropic Docs - Troubleshoot installation and login — қайшы орнатылымдар, claude doctor, ANTHROPIC_API_KEY кілтінің OAuth сеансына кедергі келтіруі.

Vibe coding-тің жұмыс істейтін формуласы: дағды + Екінші ми + контекст инженериясы. Практикалық материалдар: Ailoot құжаттамасы.

Қосымша материалдар мен құралдар: Ailoot.

Толығырақ

Жиі қойылатын сұрақтар

Қауіпсіз режимдегі қате ~/.claude қалтасын жою керек деген сөз бе?

Жоқ. Орнату, авторизация, желі және инфрақұрылым себептерін әлі зерттеу керек. Анық қорытындысы жоқ doctor есебі баптауларды не сеанстарды жоюға дәлел емес; тек себебі анықталған қабатты жөндеңіз.

Орнатуды жөндеуден бұрын не сақталуы керек?

Жазушыларды тоқтатып, сеанстарды, plugin/MCP конфигурациясын, еленбейтін файлдарды және файлдық метадеректерді қоса бүкіл Claude күйінің көшірмесін жасаңыз. Жалғастырмас бұрын бақылау сомасы мен ашып шығаруды тексеріңіз, бар аккаунт пен credential store-ды сақтаңыз. Қазіргі күйдің үстінен соқыр жазбай, тек себебі анықталған қабатты қалпына келтіріңіз.

Барлық мақалалар