Блог

Claude Code-тағы Plan Mode: қадамдық нұсқаулық және 2026 жылғы 4 кезең

Markdown

Claude Code-тағы Plan Mode: оның не екенін, Shift+Tab арқылы қалай қосылатынын, Anthropic-тің 4 кезеңін, дайын сұрау үлгілерін және түнгі автономды тапсырмаларға арналған /goal командасын қарастырады.

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

Қосымша нұсқаулар Ailoot құжаттамасында берілген.

Plan Mode деген не және неге оның өзі жеткіліксіз?

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

Claude Code-тағы Plan Mode — AI файлдарды оқып, кодты талдап, өзгерістер жоспарын ұсынатын, бірақ сіз мақұлдағанша ештеңе жазбайтын режим. Оны Shift+Tab пернесін екі рет басу немесе --permission-mode plan жалаушасын пайдалану арқылы қосуға болады. Тәсіл белгісіз, код таныс емес не өзгерісте елеулі файлдар арасындағы немесе операциялық тәуекел болса, ол пайдалы. Анық әрі тәуекелі төмен әріп қатесін түзетуге бөлек жоспар кезеңі әдетте қажет емес.

Қалыпты режимде Claude Code кодты бірден жазады, ал жұмысты бақыламасаңыз, аяқ астынан көптеген файлды қамтитын diff пайда болуы мүмкін. Plan Mode қадамдардың ретін өзгертеді: алдымен зерттеу мен жоспарлау, содан кейін мақұлдау, содан соң өзгерістер.

Anthropic ресми құжаттамасында Plan Mode-ты былай сипаттайды:

Plan mode Claude-ға өзгеріс енгізбей, зерттеу жүргізіп, өзгерістер ұсынуды тапсырады. Claude файлдарды оқиды, ортаны зерттеу үшін shell командаларын іске қосады және жоспар жазады, бірақ кодыңызды өңдемейді.

— Anthropic Docs, https://code.claude.com/docs/en/permission-modes

Қарапайым естіледі, бірақ мұнда жұмыстың негізгі ырғағы өзгеретіні жасырын. Plan Mode алдымен келісіп, содан кейін әрекет етуге мүмкіндік береді. Бұл — косметикалық түзету емес, режимнің өзгеруі. Vibe coding-пен айналысатындарға қиындық тудыратын нәрсе — AI агенттері асығуға бейім. «Google арқылы аутентификация қосуды» сұрасаңыз, қалыпты режимде Claude кодты бір минутта жазады, бірақ файлдардың жартысы қате болады. Plan Mode-та сол сұрау кодқа тимей тұрып екі минутта оқып, түзетуге болатын мәтіндік жоспарға айналады.

Халықаралық нұсқаулықтарда ешкім жазбайтын бір тұзақ бар. Plan Mode жеке қолданылғанда әлсіз құрал: жоспар тек ағымдағы әңгімеде сақталады. Терезені жапсаңыз, жоспар жоғалады. Оны басқа агентке бере алмайсыз. Нұсқалары мен тарихы жоқ. Тапсырма ауқымды болса (30 файлдан тұратын модульді рефакторлау, жаңа дерекқорға көшіру), жоспар контекст терезесінің шегіне тез жетіп, сапасы төмендей бастайды.

Сондықтан Plan Mode репозиторийдегі plans/ қалтасымен бірге жақсы жұмыс істейді. Жоспар plans/2026-05-21-google-oauth.md файлына сақталып, кезеңдерге бөлінеді және құсбелгілермен белгіленеді, ал келесі агент оны жалғастыра алады. Контекст инженериясы осылай жұмыс істейді: сұрау кезінде емес, оған дейін контексті басқару.

Claude Code-та Plan Mode-ты қалай қосуға болады?

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

Plan Mode-ты қосудың төрт ресми жолы бар. Сеанс кезінде Shift+Tab пернесін екі рет басыңыз немесе сұраудың алдына /plan префиксін қойыңыз. Іске қосқанда claude --permission-mode plan жалаушасын пайдаланыңыз. Әдепкі режимді жаһандық деңгейде .claude/settings.json файлындағы defaultMode өрісі арқылы орнатыңыз. Белсенді режим көрсеткіші — терминалдың төменгі жағындағы ⏸ plan mode on жазуы.

Сеанс кезінде ең жылдам жолы — пернетақтаны пайдалану:

Shift+Tab           # cycles through modes: default → acceptEdits → plan

Екі рет басқаннан кейін терминалдың төменгі жағында ⏸ plan mode on көрсеткіші пайда болады. Үшінші рет бассаңыз, қалыпты режимге ораласыз. Бұл — ең ыңғайлы әдіс: тапсырманың ауқымы ұлғая бастағанын байқасаңыз, режимді бірден ауыстырасыз.

Екінші әдіс — бір сұраудың алдына префикс қосу:

/plan write a plan to migrate the database from MySQL to Postgres

Бұл тәсіл auto-accept режимінде болып, оны бүкіл сеансқа өзгерткіңіз келмегенде пайдалы. Бір сұрау Plan Mode-та орындалып, одан кейін жұмыс бұрынғыдай жалғасады.

Үшінші әдіс — сеансты іске қосқанда:

claude --permission-mode plan

Тапсырманы жоспарлау керегін алдын ала білсеңіз, осы әдісті қолданыңыз. Мысалы, ірі рефакторлау немесе көшіру алдында.

Төртінші әдіс — жобадағы .claude/settings.json файлына әдепкі режимді орнату:

{
  "permissions": {
    "defaultMode": "plan"
  }
}

Бұл қашан пайдалы? Кез келген өзгеріс көршілес модульдерге әсер етуі мүмкін күрделі жүйеде команда жұмыс істегенде. Мұндайда әдепкі Plan Mode барлығын кездейсоқ өзгерістерден қорғайды.

Көбіне еленбейтін бесінші амал: Ctrl+G жоспарды мәтіндік редакторда ашады. Жоспар негізінен дұрыс болғанымен, 2-3 тармақты қайта жазу немесе бір шектеу қосу керек кезде қолданыңыз. Қолмен өңдеп, сақтаңыз, сонда Claude сіздің нұсқаңызбен жалғастырады.

Anthropic ұсынған Plan Mode-тағы негізгі 4 кезең қандай: Explore, Plan, Implement, Commit?

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

Anthropic өз озық тәжірибелерінде төрт кезеңнен тұратын негізгі жұмыс барысын атайды: Explore (файлдарды оқу және контексті зерттеу), Plan (өңдемей-ақ өзгерістер жоспарын жасау), Implement (қалыпты режимге ауысып, жоспар бойынша іске асыру), Commit (сипаттамасы бар commit жасап, PR ашу). Әр кезеңде құралдарды қолдануға қойылатын өз шектеулері бар.

Көптеген нұсқаулықта 3 кезең (Explore-Plan-Execute) немесе тек 2 кезең (Plan-Implement) көрсетіледі. Бұл — ықшамдалған нұсқалар. Anthropic өзінің ресми озық тәжірибелер нұсқаулығында дәл 4 кезеңді сипаттайды. Айырмашылығы маңызды: Commit-ті жеке кезеңге шығару нәтижені тіркеуге мәжбүрлейді, әйтпесе «тағы бірнеше түзету енгіздім, кейін commit жасаймын» деген оймен қаласыз. Бұл — жоғалған жұмыстың ең жиі себебі.

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

Google OAuth қосудың 4 кезеңі мынадай (Anthropic Docs-тен алынған мысал):

КезеңClaude не істейдіСіз не істейсізРежим
Explore/src/auth ішін оқып, сеанстар мен орта айнымалылары қалай өңделетінін қарайдыЗерттеу ауқымын белгілейсізPlan Mode
PlanҚай файлдарды өзгерту, қай жаңаларын жасау және қандай тәуекелдер бар екенін көрсететін жоспар құрадыЖоспарды оқып, Ctrl+G арқылы өңдеп, мақұлдайсызPlan Mode
ImplementЖоспар бойынша OAuth ағынын, тестілерді және callback кодын жазадыӘр өзгерістің енгізілуін бақылайсызDefault немесе acceptEdits
CommitСипаттамасы бар commit жасап, Pull Request ашадыХабарламаны тексеріп, PR-ды қарайсызDefault

Әр кезеңде сұраулар да өзгеше болады. Explore кезеңінде: «/src/auth ішін оқып, сеанстар мен жүйеге кіруді қалай өңдейтінімізді түсін». Plan кезеңінде: «Google OAuth қосқым келеді. Қай файлдарды өзгерту керек? Жоспар құр». Implement кезеңінде: «Жоспарыңдағы OAuth ағынын іске асыр, тестілер жаз, жиынтықты іске қосып, қателерді түзет». Commit кезеңінде: «Сипаттамасы бар commit жасап, PR аш».

Маңызды жайт: Plan Mode Claude-ға зерттеу үшін командаларды іске қосуға тыйым салмайды. Read, LS, Glob, Grep, web fetch және зерттеуге арналған shell командаларын пайдалануға болады. Тек Edit, Write және файлдық жүйені өзгертетін кез келген әрекетке тыйым салынады. Демек, Claude жоба құрылымын оқып, git log іске қосып, тестілерді қарай алады, бірақ кездейсоқ ештеңе өзгерте алмайды.

Claude жоспарын қалай оқып, мақұлдау туралы шешім қабылдауға болады?

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

Жақсы Claude жоспары нақты файлдар тізімін және енгізілетін өзгерістерді, реттелген қадамдарды, анық тәуекелдерді және сәттілік өлшемдерін қамтиды. Нашар жоспарда нақты мәліметтің орнына «auth модулін жаңартамын» сияқты жалпы сөздер болады. Мақұлдау туралы шешім қабылдау үшін төмендегі 7 белгіні қолданыңыз. Кері байланыспен нақтылаңыз немесе Ctrl+G арқылы тікелей өңдеңіз.

Claude жоспар құрып болғанда, ары қарай не істеуге болатынын көрсетеді:

  • Мақұлдап, auto режимінде бастау
  • Мақұлдап, өңдеулерді қабылдау
  • Мақұлдап, әр өңдеуді қолмен қарап шығу
  • Кері байланыспен жоспарлауды жалғастыру
  • Ultraplan арқылы нақтылау (браузерде қарап шығу)

Жоспарды мақұлдау керек-керегін білу — Plan Mode-тағы негізгі дағды. Автоматты түрде «Approve» басып, кейін commit-терді кері қайтаруға мәжбүр болу оңай. AI жағымпазы тез жауап бергісі келеді, ал сіз кодқа жылдам өтуді қалайсыз. Екеуіңіз де қателесесіздер.

Жақсы жоспар 7 өлшемге сай келеді:

  1. Нақты файл атаулары. «auth жаңартамын» емес, «src/auth/login.ts:42-58 файлын өзгертемін, src/auth/oauth-callback.ts жасаймын және src/auth/session.ts:103 жолын жаңартамын» деп көрсетіледі.
  2. Қадамдардың реті көрсетілген. Жоспар «бәрін бір жерде істеймін» демей, кезеңдерге немесе қадамдарға бөлінеді.
  3. Сыртқы тәуелділіктер аталады. Жаңа кітапхана қажет болса, тізімге қосылады. Орта айнымалылары керек болса, олар да көрсетіледі.
  4. Тәуекелдер тізімделген. Жақсы жоспарда «Көшіру бұрынғы сеанстарды бұзуы мүмкін; X-ті тексеру керек» делінген. Нашар жоспар жанама әсерлер туралы үндемейді.
  5. Сәттілік өлшемдері бар. «test/auth тестілері өтеді, линтер таза, әзірлеу сервері қатесіз іске қосылады».
  6. «Ауадан алынған» жорамалдар жоқ. Claude «Z кітапханасын қолданамын» десе, оны тексеріңіз: ол жобаға орнатылған ба? AI мұны ойдан шығарса, package.json ішінде аталмағанын көресіз.
  7. Жоспар экранға сыяды. Қарапайым мүмкіндікке арналған жоспар 200 жол болса, тапсырма бір жоспар үшін тым ауқымды болуы мүмкін. Оны бөліктерге бөліңіз.

Жоспар тексеруден өтпесе, үш нұсқа бар:

  • Кері байланыспен жоспарлауды жалғастыру — ұнамаған тұсы туралы Claude-ға нақты пікір беріңіз, сонда ол жоспарды қайта жазады.
  • Ctrl+G — жоспарды редакторда ашып, қолмен өңдеп, сақтаңыз. Claude сіздің нұсқаңызбен жалғастырады.
  • Ultraplan арқылы нақтылау — жоспар Claude Code веб-нұсқасының браузер режиміне жіберіледі. Онда бөлімдерді қарап, пікір қалдырасыз, содан соң оны жергілікті ортада немесе бұлтта іске қосасыз.

Іске асыру ортасында бірдеңе дұрыс болмаса, оны күшпен жалғастырмаңыз. Plan Mode-қа қайтып, жоспарды қайта жазыңыз. Бұл кейін 40 commit-ті кері қайтарудан 10 есе арзан.

Plan Mode + plans/ қалтасы: ұзақ контексті басқару тәсілі

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

Plan Mode жеке қолданылғанда тек ағымдағы әңгімеде жұмыс істейді. Терезені жапсаңыз, жоспар жоғалады. Репозиторийдегі plans/YYYY-MM-DD-feature.md қалтасы жоспарды тұрақты артефактқа айналдырады: кезеңдері, құсбелгілері және мәртебелері бар файлды келесі кез келген агент жалғастыра алады. Бұл «жоспар жадта» дегеннен «жоспар кодта» дегенге ауысу.

Plan Mode — Claude Code-тың режимі. plans/ қалтасы — оның үстіне құрылған әдістеме. Егер қалтасыз Plan Mode қолдансаңыз, бір сағаттық жұмыстан кейін шектеуге жетесіз.

Логикасы мынадай. Claude-тың контекст терезесі — сеанс жады. Opus 4.7 нұсқасына 1 миллион токен сыяды, бірақ бұл — бүкіл әңгімеңіздің көлемі. Күрделі тапсырманы бір әңгімеде жоспарлап, іске асыруды сұрап, содан кейін қатені талқылап, басқа мәселеге өтсеңіз, терезе «ісініп» кетеді. Claude бастапқы шешімдерді ұмытып, контекстерді шатастырып, сұрақтарды қайта қоя бастайды.

Шешімі — алтын ереже: бір тапсырма — бір әңгіме.

Мұны былай істеңіз:

  1. 1-әңгіме — жоспар құру. Plan Mode-ты қосып, тапсырманы сипаттаңыз, сонда Claude жоспар жасайды. Жоспарды plans/2026-05-21-feature-name.md файлына сақтаңыз. Терезені жабыңыз.
  2. 2-әңгіме — жоспарды кезеңдерге бөлу. Жаңа чат ашыңыз. «plans/2026-05-21-feature-name.md файлын алып, оны кезеңдерге бөл» деп сұраңыз. Жаңартылған файлды сақтаңыз.
  3. 3-әңгіме — 1-кезеңді іске асыру. Жаңа чат ашыңыз. «plans/2026-05-21-feature-name.md файлындағы 1-кезеңді іске асырып, аяқтаған тармақтарды белгіле» деп сұраңыз. Терезені жабыңыз.
  4. 4-әңгіме — 2-кезеңді іске асыру. Дәл осылай істеңіз.

Мұның пайдасы қандай? Әр әңгіменің контекст терезесі жаңадан ашылғандай күйде қалады. 3-кезеңдегі Claude 1-кезеңнің егжей-тегжейін білмейді, бірақ plans/ файлы репозиторийде тұрғандықтан, жоспардан хабардар. Келесі кез келген агент (subagent, жаңа сеанс немесе /goal арқылы іске қосылған жұмыс) жоспарды жалғастыра алады.

Тәсілдерді салыстыру:

МүмкіндікТек Plan ModePlan Mode + plans/ қалтасы
ТұрақтылығыТек ағымдағы чаттаРепозиторийде мәңгі қалады
Басқа агентке беруМүмкін емесcat plans/file.md
Нұсқалары мен тарихыЖоқgit diff арқылы
Subagent қолдауыТек ағымдағы сеанстаӘр кезең → жеке subagent
Құсбелгілер мен мәртебелерТек мәтінMarkdown құсбелгісі [ ] / [x]
Жоспар көлеміТерезе шектейдіКез келген көлемде

Әр мүмкіндіктің өз жоспар файлы болады. Үш айдан кейін неге бір төлем провайдерін баламасынан таңдағаныңызды еске түсіру қажет болса, тиісті жоспарды ашып, шешімдер тарихын оқуға болады: не талқыланды, қандай нұсқалар қаралды және неге дәл осы жол таңдалды.

Бұл — тірі жұмыс жоспарлары; статикалық құжаттама бірнеше айда ескіреді.

Plan Mode пен /goal арқылы Claude-ты ұйықтап жатқанда қалай жұмыс істетуге болады?

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

/goal — Anthropic бір жылдан бері айтып келе жатқан автономды цикл. /goal командасы Claude Code v2.1.139 нұсқасында (2026 жылғы 11 мамырда) пайда болды. Ол аяқтау шартын белгілейді, ал Claude шарт орындалғанша адамның қатысуынсыз жұмыс істейді. Шағын evaluator моделі әр айналымнан кейін шарт орындалған-орындалмағанын тексереді.

Ұзақ AI сеанстарындағы негізгі шектеу — модельдің өзі емес, Enter пернесін басып отырған адам. Claude әр айналымның соңына жеткен сайын сіздің жауабыңызды күтеді. /goal осы күтуді жояды.

Жазылуы қарапайым:

/goal all tests in test/auth pass and lint is clean, or stop after 20 turns

Шарттың ұзындығы 4000 таңбаға дейін болуы мүмкін. Бір сеанста бір ғана мақсат қойылады. Әр айналымнан кейін Haiku шағын моделі транскриптті қарап, «шарт орындалды — аяқта» немесе «орындалмады — келесі айналым» деп шешеді. Evaluator құрал шақырмайды, тек оқиды.

Оны тазалауға арналған бүркеншік пәрмендер: /goal stop, /goal off, /goal reset, /goal none, /goal cancel.

Plan Mode-пен үйлесімі мынадай:

  1. Plan Mode-ты қосыңыз (Shift+Tab пернесін екі рет басыңыз).
  2. «Дерекқорды MySQL-ден Postgres-ке көшіру жоспарын құрып, оны кезеңдері мен өлшемдері бар plans/2026-05-21-postgres-migration.md файлына сақта» деп сұраңыз.
  3. Жоспарды қарап, өңдеп, мақұлдаңыз.
  4. Plan Mode-тан шығыңыз (Shift+Tab пернесін тағы бір рет басыңыз).
  5. Мақсат орнатыңыз: «plans/2026-05-21-postgres-migration.md файлындағы барлық кезеңді аяқта, құсбелгілерді қой, барлық тест өтсін немесе 50 айналымнан кейін тоқта».
  6. Ноутбугыңызды жауып, ұйықтаңыз.

Таңертең нәтижені тексеріңіз: не «✓ мақсат орындалды», не «◎ 50 айналымнан кейін тоқтады» деген белгі және орындалған жұмыстың тарихы болады.

Токенді бекер жұмсамау үшін /goal қолданудың үш негізгі ережесі бар:

1-ереже: өлшенетін соңғы күй. «Әдемі көрінсін» деген шарт жарамайды. «npm test 0 қайтарады, npm run lint 0 қайтарады және CHANGELOG.md файлына жазба қосылды» деген дұрыс.

2-ереже: нақты тексеру. Шарт тексеруге болатын нәрсеге сілтеме жасауы керек: командаға, файлға немесе endpoint-ке. «Бәрі жұмыс істейді» емес, «curl localhost:3000/api/users 200 қайтарады».

3-ереже: айналым санын шектеу. Әрқашан or stop after N turns деп қосыңыз. Anthropic ресми құжаттамасында былай ұсынады:

Мақсаттың қанша уақыт орындалатынын шектеу үшін шартқа айналым санын немесе уақытты шектейтін сөйлем қосыңыз, мысалы, 'немесе 20 айналымнан кейін тоқта'.

— Anthropic Docs, https://code.claude.com/docs/en/goal

/goal-ды or stop after шектеуінсіз қоссаңыз, бюджетіңіз бір түнде таусылуы мүмкін.

Plan Mode-ты инженерлік процеске айналдыратын 4 қадамдық цикл қандай?

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

Құрылымсыз қарапайым Plan Mode орташа нәтиже береді. Мықты жұмыс барысы бір терезеде 4 қадамнан тұрады: шешім ұсынбай фактілерді анықтау, интернеттегі мысалдар негізінде нұсқаларды қарастыру, 2-3 қадам алға көз тастап, тәуекелдері бар егжей-тегжейлі жоспар жасау және жоспардан «ауадан алынған» жорамалдарды өзі тексеруді талап ету. Бұл реттілік AI жағымпаздығына тосқауыл қояды.

Жиі кездесетін қате — «мұны қалай түзетемін?» деп сұрау. Claude шешім береді, сіз оны қолданасыз, бірақ ештеңе жұмыс істемейді немесе жағдай нашарлайды. Бұл — «AI жағымпазы»: ол жылдам жауап беруге үйретілген, ал сіз кодқа тезірек өткіңіз келеді. Мұны 4 қадамдық цикл шешеді.

4 қадамдық цикл осындай әрекетке тосқауыл қояды. Ол бір Plan Mode сеансы ішінде ретімен орындалады:

1-қадам. Шешім ұсынбай фактілерді анықтау.

Сұрау: «Менде мынадай мәселе болып жатыр: [белгінің сипаттамасы]. Қазір сенің міндетің — фактілерді анықтау. Кез келген шешім, идея және кеңес ұсынуға тыйым салынады. Тек мыналар: мен не байқадым, қандай қадамдарды қайталауға болады, қандай дерек бар және қандай дерек жетіспейді. Қатаң тоқтау шарты: шешім ұсынба; тек диагнозды тірке».

Бұл AI-дың алғашқы әдетін — «міне шешім» деуін — тежейді. Claude «не белгілі, не белгісіз» деген тұста тоқтауы керек.

2-қадам. Мысалдарға сүйеніп, нұсқаларды әзірлеу.

Сұрау: «Диагноз анықталған соң, ұқсас мәселелерді шешу жөніндегі мысалдарды интернеттен ізде. Кемінде 3 түрлі тәсіл тап. Әрқайсысына негізгі дереккөзге сілтеме, қысқаша сипаттама және біздің жағдайға қатысты артықшылықтары мен кемшіліктерін бер».

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

3-қадам. Тәуекелдері бар егжей-тегжейлі жоспар.

Сұрау: «2-қадамдағы ең жақсы нұсқаны алып, егжей-тегжейлі жоспар құр: қай нақты файлдарға тию керек, нені қосу, нені жою, қандай тест жазу қажет, не бұзылуы мүмкін және 2-3 қадамнан кейін қандай тәуекелдер туындауы ықтимал».

Бұл — таныс Plan кезеңі, бірақ бір айырмашылығы бар: ол Claude-тың болжамдарына емес, 2-қадамда тексерілген нұсқаларға сүйенеді.

4-қадам. Жоспарды өзі тексеру.

Сұрау: «Енді міндетті түрде өзің тексер. Жоспарыңды адал қайта қарап шық: кодпен, құжаттамамен немесе 2-қадамдағы мысалмен тексермей, бірдеңені ауадан алған жерің бар ма? Бар болса, оларды белгілеп, жоспарды қайта қара».

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

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

Бұл әдіс күрделі қателерді анықтауға және архитектуралық шешім қабылдауға арналған — қате құны жоғары жағдайларда. Plan Mode-та қолданғанда, ол vibe coding-пен айналысатындардың негізгі мәселесін жояды: «AI шешім берді, мен қолдандым, бәрі бұзылды».

Әдеттегі тапсырмаларға арналған дайын 5 сұраудың қайсысы Plan Mode-та жұмыс істейді?

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

Дайын сұраулар әр тапсырмаға 10-15 минут үнемдеп, жоспар сапасын жақсартады. Модульді рефакторлау, дерекқорды көшіру, жаңа мүмкіндік қосу, тест жазу және күрделі қатені жөндеуге арналған бес әмбебап үлгі бар. Әрқайсысы 4 қадамдық циклге енгізіліп, plans/ қалтасымен байланыстырылады.

1-үлгі. Модульді рефакторлау.

I'm enabling Plan Mode. Task: refactor the {module-name} module.

Step 1: Study the current structure of the {module-path} module. Describe:
- which files are part of the module
- which external dependencies it has
- which parts are duplicated
- which functions are overcomplicated

Step 2: Find 2-3 examples online of refactoring similar modules.
At least 1 source must be official Anthropic or related framework documentation.

Step 3: Create a refactoring plan in plans/YYYY-MM-DD-refactor-{module}.md:
- which files to rename
- which functions to extract into separate modules
- which tests to keep and which to rewrite
- risks: what could break for users

Step 4: Self-check. Are there any assumptions in the plan that are "pulled out of thin air"?
Rewrite or remove them.

2-үлгі. Дерекқорды көшіру.

I'm enabling Plan Mode. Task: migrate the database from {old} to {new}.

Step 1: Study the current database schema using {schema-reading-command}. Describe:
- which tables exist and their size
- which relationships, indexes, and constraints there are
- where migrations are stored
- which data is critical

Step 2: Find precedents for {old → new} migrations in production projects.
At least 3 different approaches: pg_dump, dual-write, blue-green.
For each, list the pros and risks for our data size.

Step 3: Create a migration plan in plans/YYYY-MM-DD-db-migration.md:
- phases (backup, migration, verification, switchover)
- success criteria for each phase
- rollback plan if something goes wrong
- downtime or no downtime

Step 4: Self-check. Are all figures supported by documentation?
Have all steps been mentally checked against the dev environment?

3-үлгі. Жаңа мүмкіндік қосу.

I'm enabling Plan Mode. Task: add the {description} feature to the project.

Step 1: Study how similar features currently work in the project.
Specifically, look at:
- {file-1}
- {file-2}
- which architectural patterns are used
- which tests are written for similar features

Step 2: Find how this feature is implemented in open-source projects
with a similar architecture. At least 2 different approaches.

Step 3: Create a plan in plans/YYYY-MM-DD-feature-{name}.md:
- list of new files
- list of changed files with specific lines
- implementation sequence
- which tests to add
- what to add to CLAUDE.md as a rule for future sessions

Step 4: Self-check. Does the plan follow the project's architecture?
Does it assume libraries that haven't been installed yet?

4-үлгі. Тест жазу.

I'm enabling Plan Mode. Task: cover the {name} module with tests.

Step 1: Study the {path} module. Identify:
- public functions and their signatures
- internal functions we will NOT test (implementation details)
- edge cases: empty input, errors, concurrent access

Step 2: Find test examples for a similar class of tasks
in popular open-source projects using the same framework.

Step 3: Create a test plan in plans/YYYY-MM-DD-tests-{module}.md:
- for each public function, a list of tests
- which mocks are needed
- which fixtures
- which verification approach (assertion style)

Step 4: Self-check. Do all tests check behavior rather than implementation?
Does the coverage include edge cases?

5-үлгі. Күрделі қатені жөндеу.

I'm enabling Plan Mode. Task: understand the cause of the error {symptom-description}.

Step 1: ESTABLISH THE FACTS. Solutions and ideas are prohibited. Only:
- what I observe (exact wording of the error)
- reproducible steps
- what data is available (logs, traces, library versions)
- what data is missing (what needs to be collected additionally)

Step 2: Find precedents for this error.
At least 3 sources: GitHub issues, documentation.
For each, provide a link and a brief summary of the solution.

Step 3: Create a diagnostic plan in plans/YYYY-MM-DD-bug-{name}.md:
- which hypotheses to check (sorted by likelihood)
- which commands/scripts to run to check each one
- the expected result of each check

Step 4: Self-check. Are there any hypotheses in the plan that are "pulled out of thin air"?
Are all hypotheses tied to facts from Step 1?

Әр үлгіні көшіріп, {parameters} орынбасарларын өз мәндеріңізбен ауыстырыңыз да, Claude Code-та Plan Mode қосулы кезде қойыңыз. Нәтижесінде plans/ қалтасында мақұлдап, іске асыру үшін пайдаланатын жұмыс жоспары пайда болады.

Plan Mode пен қалыпты режим: қайсысын таңдау керек?

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

Тәсіл белгісіз, код таныс емес, архитектуралық шешім, миграция не елеулі жанама әсер болса, Plan Mode қолданыңыз. Файл саны — тәуелділікті ойлауға белгі, қатаң ереже емес. Шағын, түсінікті, тәуекелі төмен diff-ті тікелей орындауға болады; бір сөйлемдік сипаттама авторизацияны не миграцияны өздігінен қауіпсіз етпейді.

Anthropic мұны құжаттамасында тікелей айтады:

Plan mode пайдалы, бірақ қосымша жұмыс талап етеді. Ауқымы анық әрі өзгерісі шағын тапсырмаларда (қате жазу, лог жолы, айнымалы атауын өзгерту) Claude-тан бірден орындауды сұраңыз. Тәсілге сенімсіз болсаңыз, өзгеріс бірнеше файлға әсер етсе немесе кодпен таныс болмасаңыз, жоспарлау әсіресе пайдалы. Diff-ті бір тіркеспен сипаттай алсаңыз, жоспарды өткізіп жіберіңіз.

— Anthropic Docs, https://www.anthropic.com/engineering/claude-code-best-practices

Бөлек жоспарды нақты diff шағын, түсінікті және тәуекелі төмен болғанда ғана өткізіңіз. Тәсілді табу не компоненттер арасындағы қауіпті өзгерісті үйлестіру қажет болса, жоспарлаңыз. Файл атауларын білу немесе мақсатты бір сөйлемге сыйғызу миграция, авторизация не дерек тұтастығы тәуекелдерін жоймайды.

Шешім кестесі:

ТапсырмаРежимСебебі
README ішіндегі қате жазуDefaultБір файл, бір өзгеріс, diff айқын
Бір файлдағы айнымалы атауын өзгертуDefaultАуқымы түсінікті, сілтемелерін тексеруге болады; жанама әсерлерін бағалаңыз
Лог жолын қосуDefaultЛогикаға әсер етпейтін бір жолдық өзгеріс
Бетке жаңа батырма қосуDefaultБатырма біреу болса әрі қайда баратынын көріп тұрсаңыз, жоспар қажет емес
Модульді рефакторлауPlan Mode5+ файл, жанама әсерлер қаупі бар
Дерекқорды көшіруPlan Mode + /goalБірнеше қадамды процесс, кері қайтару жоспары қажет
Аутентификация қосуPlan Mode10+ файлға әсер етеді; қауіпсіздік маңызды
Модульге тест жазуPlan ModeНені тестілеу керек екенін анықтау қажет
Түсініксіз қатені жөндеуPlan Mode + 4-қадамдық циклДиагнозсыз шешімдер нысанаға тимейді
Фреймворкты толық көшіруPlan Mode + plans/ + түнгі /goalКезеңдер мен автономды цикл қажет ететін ұзақ тапсырма

Режим таңдаудан бұрын тәсіл, жанама әсерлер және тексеру түсінікті ме деп сұраңыз. Тексеруі анық, шағын, жергілікті әрі тәуекелі төмен өзгерісті тікелей орындаңыз. Белгісіздік, таныс емес код, миграция, авторизация не компоненттерді үйлестіру болса, әсер ететін барлық 3–5 файлды атасаңыз да алдымен жоспарлаңыз.

Сенімді жұмыс үшін Plan Mode + CLAUDE.md + subagent-терді қалай үйлестіруге болады?

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

Plan Mode дұрыс бапталған CLAUDE.md және subagent-термен бірге қолданылғанда 10 есе күшейеді. CLAUDE.md Claude жоспар құру кезінде ұстанатын ережелерді белгілейді. Subagent-тер жоспар кезеңдерін параллель агенттерге бөлуге мүмкіндік береді. Бұл үйлесімсіз Plan Mode бір реттік құрал болып қалады.

CLAUDE.md — Claude әр сеанстың басында, соның ішінде Plan Mode кезінде оқитын файл. Онда «күндерді ешқашан кодқа тікелей енгізбе; оларды әрдайым дерекқордан ал» делінсе, жоспарда күнді кодқа тікелей енгізу ұсынылмайды. Мұндай ереже болмаса, жоспар кез келген нәрсені ұсынуы мүмкін.

Үйлесімі мынадай:

1-қабат. CLAUDE.md ережелерді белгілейді.

Файл жобаның технологиялар жиынтығын, архитектуралық қағидаларды, тыйымдарды («ескірген API-ларды қолданба») және талаптарды («барлық хат ортақ layout арқылы жіберілсін») көрсетеді. Толық нұсқаулық: CLAUDE.md файлын қалай баптау керек.

2-қабат. Plan Mode ережелерді тапсырмаға қолданады.

Plan Mode қосып, «OAuth қос» деп сұрасаңыз, Claude CLAUDE.md файлын оқып, «токендерді дерекқорда емес, Redis-те сақта» деген ережені көріп, оны жоспарға бірден қосады. Жоспар жоба архитектурасына сәйкес келеді.

3-қабат. Subagent-тер жұмысты бөледі.

Жоспар кезеңдерге бөлінсе, әр кезеңді бөлек subagent-ке тапсыруға болады. Әр subagent негізгі терезені толтырмай, өз контекст терезесінде жұмыс істейді. plans/ ішіндегі жоспар негізгі шындық көзі болып қалады: subagent-тер оны оқып, өз кезеңін орындап, құсбелгілерді жаңартады.

Plan Mode-ты бұзатын 7 қате қандай?

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

Plan Mode көбіне құралдың әлсіздігінен емес, қолданудағы жиі қателерден нәтиже бермейді. Негізгі жеті қате: жоспарды файлға емес, жадта сақтау; барлық тапсырманы бір чатта орындау; кезеңдерсіз жоспар құру; терең зерттеуді өткізіп жіберу; AI жағымпазының диагнозсыз шешім ұсынуына жол беру; өзіндік тексеруді өткізіп жіберу; және /goal ішінде шарттарды бұлыңғыр жазу.

1-қате. Жоспар тек чатта сақталады.

Белгісі: жоспар жазып, терезені жаптыңыз, келесі күні оған қайта оралғыңыз келеді, бірақ ештеңе жоқ; контекст жоғалған. Шешімі: жоспарды репозиторийдегі plans/YYYY-MM-DD-feature-name.md файлына әрдайым сақтаңыз. Чат — жұмыс үстелі, ал файл — архив.

2-қате. Барлық тапсырма бір чатта.

Белгісі: бір сеанста аутентификацияны, содан кейін көшіруді, UI дизайнын және қатені талқылайсыз. Контекст терезесі «ісініп», Claude бұрынғы мәліметтерді ұмытады. Шешімі: бір тапсырма — бір әңгіме. Жоспар аяқталды ма? Терезені жабыңыз. Іске асыруды бастайсыз ба? Жаңасын ашыңыз.

3-қате. Кезеңдерсіз 3000 жолдық жоспар.

Белгісі: жоспар бар, бірақ онда құсбелгілер мен бөлімдер жоқ. Не істелгенін, не істелмегенін білу мүмкін емес. Тапсыру да мүмкін емес. Шешімі: әр жоспарды 3-7 кезеңге бөліңіз. Әр кезең нақты әрекеттер тізімі мен құсбелгілерден тұрсын.

4-қате. Жоспар алдында терең зерттеу жүргізілмейді.

Белгісі: Claude мысал іздеуді сұрамағандықтан, шешімді өзінен ойлап табады. Бір аптадан кейін ашық бастапқы кодта әлдеқашан жақсырақ тәсіл барын білесіз. Шешімі: 4 қадамдық циклдің 2-қадамы бойынша жоспар жасамас бұрын Claude-ға интернеттен 2-3 мысал тапқызыңыз.

5-қате. AI жағымпазы диагнозсыз шешім береді.

Белгісі: «X қатесін қалай түзетемін?» деп сұрайсыз, Claude шешім береді, сіз оны қолданасыз, бірақ ештеңе жұмыс істемейді немесе жағдай нашарлайды. Шешімі: әрдайым «алдымен фактілерді анықта; шешім ұсынуға тыйым салынады» деп бастаңыз. Нұсқаларға диагноздан кейін ғана көшіңіз.

6-қате. Өзіндік тексеруді өткізіп жіберу.

Белгісі: жоспар нанымды көрінеді, бірақ ішінде 2-3 «ауадан алынған» жорамал бар (ойдан шығарылған кітапхана, жоқ API немесе қате нұсқа). Іске асыру осы тұстардан бұзылады. Шешімі: 4 қадамдық циклдің 4-қадамы бойынша Claude-ға жоспарын адал қайта тексертіп, жорамалдарды белгілеңіз.

7-қате. /goal ішіндегі бұлыңғыр шарттар.

Белгісі: /goal make it look nice деп орнатып, түнге қалдырасыз да, таңертең квотаның $200 жұмсалғанын көресіз. Шешімі: тек өлшенетін шарттарды, тексеру командасын және міндетті or stop after N turns шектеуін қолданыңыз. «Жақсы қыл» немесе «әдемілеп шық» демеңіз.

Сегізінші қате — vibe coding-пен айналысатындардың жиі жіберетіні — plans/ қалтасының маңызын елемеу. plans/ қалтасы жоқ Plan Mode — әдістеме емес, ойыншық. Plan Mode қолданып, файл жасамасаңыз, оның мүмкіндіктерінің 10%-ын ғана пайдаланасыз.

Plan Mode-пен алғашқы тәжірибеден кейін не істеу керек?

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

Plan Mode-пен алғашқы тәжірибе — бастама ғана. Келесі қадамдар: әлі жоқ болса, CLAUDE.md файлын баптау (онсыз жоспар ауада қалады), жұмыс әдістемесі ретінде репозиторийде plans/ қалтасын құру және ұйықтар алдында бір автономды тапсырмада /goal қолданып көру. Үшеуінің — Plan Mode, CLAUDE.md және plans/ — үйлесімі жұмыс істейтін жүйе құрайды.

Қиындығы біртіндеп артатын үш нақты қадам:

1-қадам. Әлі жоқ болса, CLAUDE.md файлын баптаңыз.

CLAUDE.md болмаса, Plan Mode «бос кеңістікте» жұмыс істейді: Claude жоба ережелерін білмей, архитектураны бұзатын жоспарлар ұсынады. Толық нұсқаулық: CLAUDE.md файлын қалай баптау керек. Ең қарапайым CLAUDE.md — технологиялар жиынтығын, ережелер мен тыйымдарды сипаттайтын 50-80 жол. Ұзындығы маңызды емес. Нақтылығы маңызды.

2-қадам. Репозиторийде plans/ қалтасын жасаңыз.

Жоба түбіріне plans/ қалтасын қосыңыз. Атау пішімін бекітіңіз: YYYY-MM-DD-feature-name.md. Әр жоспарға жеке файл арналады. Бір айдан кейін 20-30 файл, ал алты айдан кейін 100+ файл болады. Бұл — жобаның үнемі жаңарып отыратын шешімдер тарихы.

3-қадам. Бір тапсырмада /goal қолданып көріңіз.

Әдетте қолмен 30-40 минутта істейтін тапсырманы таңдаңыз. Plan Mode-ты қосып, жоспар құрыңыз да, plans/ қалтасына сақтаңыз. Plan Mode-тан шығыңыз. /goal complete all phases in plans/file.md, all tests pass, or stop after 30 turns деп орнатыңыз. Ноутбугыңызды бір сағатқа жауып, басқа нәрсемен айналысыңыз. Қайтып келіп, нәтижені тексеріңіз.

Осы үш қадам — ең аз қажеттісі. Мұның бәрі біртіндеп қалыптасады; бір кеште бәрін жинауға тырыспаңыз. Алдымен CLAUDE.md орнатыңыз, бір аптадан кейін plans/ қосыңыз, бір айдан кейін түнгі /goal қолданып көріңіз.

Дайын болғанда, Ailoot-пен танысыңыз.

Толығырақ

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

Қай файл өзгеретінін білсем, жоспарлауды өткізе аламын ба?

Жоқ. Файл атауларын білу жанама әсер мен тексерудегі белгісіздікті жоймайды. Миграцияны, авторизация өзгерісін және үйлескен компонент өзгерістерін файл тізімі анық болса да жоспарлаңыз.

Бөлек Plan Mode кезеңі қашан қажет емес?

Жергілікті әріп қатесі сияқты тексеруі анық, түсінікті және тәуекелі төмен шағын diff үшін тікелей жұмыс орынды. Тәсіл белгісіз, код таныс емес не операциялық және файлдар арасындағы тәуекелді ойластыру керек болса, жоспарлауды қолданыңыз.

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