* docs: sync to Claude Code v2.1.257 Audit against Claude Code v2.1.257 (repo baseline was v2.1.245, 12 releases behind). Facts verified against the official docs and cross-checked against the locally installed 2.1.257 binary. Critical (P0): - lesson-quiz L06 Q9 asked how many hook events exist, offering 16/25/31/40. With the real answer now 33, no option was correct. Option C 31 -> 33; answer letter unchanged. - 03-skills taught SKILL.md `name`/`description` as required. Official docs now state all frontmatter fields are optional and `name` defaults to the directory name. Corrected in all five languages. Hook events 31 -> 33 (PreModelSwitch/PostModelSwitch, v2.1.251) across 30 occurrences in 22 files, including three that read 25. Delta proved by set-diff against the official event table: no phantom events. Both events added to the 06-hooks tables with matcher, blocking behavior and 30s timeout, plus detailed per-event sections. CLI corrections verified against the binary: - `claude plugin tag` takes a path, not a version - `claude plugin init` / `validate` require their arguments - `plugin init` scaffolds at ~/.claude/skills/<name>/, not project-local - `--channels` entries must be tagged plugin:<name>@<marketplace> - `--remote` is a deprecated alias for `--cloud` - no `claude remote-control` subcommand exists, only the --remote-control flag Also: CATALOG summary-table totals recomputed in all five languages (column 4 is a derived total, so the count change invalidated it); stale Opus 4.6/4.7 rosters aligned to canonical; self-assessment Advanced Features rescored 0-3 to stop a real gap being graded as mastery; 9 dangling quiz Review pointers repaired; new features documented (--restricted, Fable 5.1, experimental.cacheTtl, CLAUDE_CODE_SUBAGENT_MODEL_FORCE). Deliberately out of scope: pre-existing translation staleness whose fix is translation authorship rather than correction (ja/uk April-2026 root-doc bodies, zh stubs, vi/README stub, translated CATALOG "New Features"). Claude-Session: https://claude.ai/code/session_01128xfEd8W7c2cMRw6N7uiF * fix(hooks): complete the 31 → 33 hook-event propagation across all languages The v2.1.257 sync bumped the hook-event count in the lesson and catalog summaries but left 14 files still asserting 31, four of which the same commit restamped 2.1.257. It also bumped the prose count in claude_concepts_guide.md without adding the two rows, making that file contradict itself where it had been internally consistent before. Adds PreModelSwitch and PostModelSwitch (v2.1.251) everywhere an exhaustive enumeration exists, and corrects the count wherever a list is deliberately partial: - README.md / INDEX.md in en, ja, zh, uk and vi/INDEX.md — count 31 → 33 and both events added to the lifecycle group - resources.md in all five languages — count only; these lists end in "and more" and are partial by design - claude_concepts_guide.md — the two missing table rows Also brings every hook-event table up to the 33 its own summary row claims. The English CATALOG.md listed 29; the translated catalogs listed 25 and the ja/uk concept guides 27 and 28. Completing them required translating six events that had never reached the mirrors: Setup, UserPromptExpansion, PermissionDenied, PostToolBatch, MessageDisplay and DirectoryAdded. Summary-table arithmetic is untouched — those columns count example scripts, not events. Verified: no stale count survives outside CHANGELOG history, every exhaustive enumeration lists exactly 33, and pre-commit passes 23/23. Claude-Session: https://claude.ai/code/session_01UXmqJZNk1BR4uerJA85NiW
20 KiB
Список корисних ресурсів
Офіційна документація
| Ресурс | Опис | Посилання |
|---|---|---|
| Claude Code Docs | Офіційна документація Claude Code | code.claude.com/docs/en/overview |
| Anthropic Docs | Повна документація Anthropic | docs.anthropic.com |
| MCP Protocol | Специфікація Model Context Protocol | modelcontextprotocol.io |
| MCP Servers | Офіційні реалізації MCP-серверів | github.com/modelcontextprotocol/servers |
| Anthropic Cookbook | Приклади коду та туторіали | github.com/anthropics/anthropic-cookbook |
| Claude Code Skills | Репозиторій навичок спільноти | github.com/anthropics/skills |
| Agent Teams | Координація та співпраця кількох агентів | code.claude.com/docs/en/agent-teams |
| Scheduled Tasks | Повторювані завдання з /loop та cron | code.claude.com/docs/en/scheduled-tasks |
| Chrome Integration | Автоматизація браузера | code.claude.com/docs/en/chrome |
| Keybindings | Налаштування клавіатурних скорочень | code.claude.com/docs/en/keybindings |
| Desktop App | Нативний десктопний додаток | code.claude.com/docs/en/desktop |
| Remote Control | Віддалене управління сесіями | code.claude.com/docs/en/remote-control |
| Auto Mode | Автоматичне управління дозволами | code.claude.com/docs/en/permissions |
| Channels | Багатоканальна комунікація | code.claude.com/docs/en/channels |
| Voice Dictation | Голосовий ввід для Claude Code | code.claude.com/docs/en/voice-dictation |
Інженерний блог Anthropic
| Стаття | Опис | Посилання |
|---|---|---|
| Code Execution with MCP | Як вирішити проблему роздування контексту MCP за допомогою виконання коду — 98.7% зменшення токенів | anthropic.com/engineering/code-execution-with-mcp |
Опанування Claude Code за 30 хвилин
Відео: https://www.youtube.com/watch?v=6eBSHbLKuN0
Усі поради
-
Досліджуйте просунуті функції та скорочення
- Регулярно перевіряйте нові функції редагування коду та контексту Claude в їхніх нотатках до випусків.
- Вивчіть клавіатурні скорочення для швидкого перемикання між чатом, файлами та редактором.
-
Ефективне налаштування
- Створюйте проєктно-специфічні сесії з чіткими назвами/описами для легкого пошуку.
- Закріпіть найчастіше використовувані файли або папки, щоб Claude мав до них доступ у будь-який час.
- Налаштуйте інтеграції Claude (напр., GitHub, популярні IDE) для оптимізації процесу кодування.
-
Ефективне Q&A по кодовій базі
- Ставте Claude детальні запитання про архітектуру, патерни проєктування та конкретні модулі.
- Використовуйте посилання на файли та рядки у запитаннях (напр., "Що робить логіка в
app/models/user.py?"). - Для великих кодових баз надайте резюме або маніфест, щоб допомогти Claude зосередитись.
- Приклад промпту: "Can you explain the authentication flow implemented in src/auth/AuthService.ts:45-120? How does it integrate with the middleware in src/middleware/auth.ts?"
-
Редагування та рефакторинг коду
- Використовуйте інлайн-коментарі або запити в блоках коду для отримання цілеспрямованих правок ("Refactor this function for clarity").
- Запитуйте порівняння до/після.
- Дозвольте Claude генерувати тести або документацію після значних правок для забезпечення якості.
- Приклад промпту: "Refactor the getUserData function in api/users.js to use async/await instead of promises. Show me a before/after comparison and generate unit tests for the refactored version."
-
Управління контекстом
- Обмежуйте вставлений код/контекст лише тим, що стосується поточного завдання.
- Використовуйте структуровані промпти ("Here's file A, here's function B, my question is X") для найкращої продуктивності.
- Видаляйте або згортайте великі файли у вікні промпту, щоб не перевищувати ліміти контексту.
- Приклад промпту: "Here's the User model from models/User.js and the validateUser function from utils/validation.js. My question is: how can I add email validation while maintaining backward compatibility?"
-
Інтеграція командних інструментів
- Підключайте сесії Claude до репозиторіїв та документації вашої команди.
- Використовуйте вбудовані шаблони або створюйте власні для повторюваних інженерних завдань.
- Співпрацюйте, діляться стенограмами сесій та промптами з колегами.
-
Підвищення продуктивності
- Давайте Claude чіткі, цілеорієнтовані інструкції (напр., "Summarize this class in five bullet points").
- Видаляйте зайві коментарі та шаблонний код з вікон контексту.
- Якщо вивід Claude збився з курсу, скиньте контекст або переформулюйте запитання.
- Приклад промпту: "Summarize the DatabaseManager class in src/db/Manager.ts in five bullet points, focusing on its main responsibilities and key methods."
-
Практичні приклади використання
- Дебаг: Вставте помилки та стек-трейси, потім запитайте можливі причини та виправлення.
- Генерація тестів: Запитайте property-based, юніт або інтеграційні тести для складної логіки.
- Код-рев'ю: Попросіть Claude виявити ризиковані зміни, граничні випадки або code smells.
- Приклади промптів:
- "I'm getting this error: 'TypeError: Cannot read property 'map' of undefined at line 42 in components/UserList.jsx'. Here's the stack trace and the relevant code. What's causing this and how can I fix it?"
- "Generate comprehensive unit tests for the PaymentProcessor class, including edge cases for failed transactions, timeouts, and invalid inputs."
- "Review this pull request diff and identify potential security issues, performance bottlenecks, and code smells."
-
Автоматизація робочих процесів
- Скриптуйте повторювані завдання (форматування, очищення, перейменування) за допомогою промптів Claude.
- Використовуйте Claude для створення описів PR, нотаток до релізів або документації на основі git diff.
- Приклад промпту: "Based on the git diff, create a detailed PR description with a summary of changes, list of modified files, testing steps, and potential impacts. Also generate release notes for version 2.3.0."
Порада: Для найкращих результатів комбінуйте кілька цих практик — почніть з закріплення критичних файлів та резюмування цілей, потім використовуйте цілеспрямовані промпти та інструменти рефакторингу Claude для поступового покращення кодової бази та автоматизації.
Рекомендований робочий процес з Claude Code
Рекомендований робочий процес з Claude Code
Для нового репозиторію
-
Ініціалізація репо та інтеграція Claude
- Налаштуйте новий репозиторій з базовою структурою: README, LICENSE, .gitignore, кореневі конфіги.
- Створіть файл
CLAUDE.mdз описом архітектури, високорівневих цілей та настанов кодування. - Встановіть Claude Code та підключіть до репозиторію для пропозицій коду, створення тестів та автоматизації.
-
Використовуйте режим плану та специфікації
- Використовуйте режим плану (
shift-tabабо/plan) для створення детальної специфікації перед реалізацією. - Запитайте Claude про пропозиції архітектури та початкове компонування проєкту.
- Тримайте чітку, цілеорієнтовану послідовність промптів — запитуйте контури компонентів, основні модулі та відповідальності.
- Використовуйте режим плану (
-
Ітеративна розробка та рев'ю
- Реалізуйте основні функції маленькими частинами, запитуючи Claude про генерацію коду, рефакторинг та документацію.
- Запитуйте юніт-тести та приклади після кожного інкременту.
- Підтримуйте поточний список завдань у CLAUDE.md.
-
Автоматизація CI/CD та деплою
- Використовуйте Claude для створення каркасу GitHub Actions, npm/yarn скриптів або робочих процесів деплою.
- Легко адаптуйте конвеєри, оновлюючи CLAUDE.md та запитуючи відповідні команди/скрипти.
graph TD
A[Start New Repository] --> B[Initialize Repository Structure]
B --> C[Create README, LICENSE, .gitignore]
C --> D[Create CLAUDE.md]
D --> E[Document Architecture & Guidelines]
E --> F[Install & Link Claude Code]
F --> G[Enter Plan Mode]
G --> H[Draft Feature Specification]
H --> I[Get Architecture Suggestions]
I --> J[Define Components & Modules]
J --> K[Implement Feature Chunk]
K --> L[Generate Code with Claude]
L --> M[Request Unit Tests]
M --> N[Review & Refactor]
N --> O{More Features?}
O -->|Yes| K
O -->|No| P[Update Task List in CLAUDE.md]
P --> Q[Setup CI/CD Pipeline]
Q --> R[Scaffold GitHub Actions]
R --> S[Create Deployment Scripts]
S --> T[Test Automation]
T --> U[Repository Ready]
style A fill:#e1f5fe,stroke:#333,color:#333
style G fill:#fff9c4,stroke:#333,color:#333
style K fill:#e8f5e9,stroke:#333,color:#333
style Q fill:#f3e5f5,stroke:#333,color:#333
style U fill:#e8f5e9,stroke:#333,color:#333
Для існуючого репозиторію
-
Налаштування репо та контексту
- Додайте або оновіть
CLAUDE.mdз документацією структури репо, патернів кодування та ключових файлів. Для legacy-репозиторіїв використовуйтеCLAUDE_LEGACY.mdз описом фреймворків, карт версій, інструкцій, багів та нотаток оновлення. - Закріпіть або виділіть основні файли, які Claude повинен використовувати для контексту.
- Додайте або оновіть
-
Контекстне Q&A по коду
- Запитуйте Claude про код-рев'ю, пояснення багів, рефакторинг або плани міграції з посиланням на конкретні файли/функції.
- Давайте Claude чіткі межі (напр., "modify only these files" або "no new dependencies").
-
Управління гілками, worktree та кількома сесіями
- Використовуйте кілька git worktree для ізольованих функцій або виправлень та запускайте окремі сесії Claude на кожен worktree.
- Тримайте вкладки/вікна терміналу організованими за гілкою або функцією для паралельних робочих процесів.
-
Командні інструменти та автоматизація
- Синхронізуйте власні команди через
.claude/commands/для крос-командної консистентності. - Автоматизуйте повторювані завдання, створення PR та форматування коду через слеш-команди або хуки Claude.
- Діліться сесіями та контекстом з членами команди для спільного усунення проблем та рев'ю.
- Синхронізуйте власні команди через
graph TD
A[Start with Existing Repository] --> B{Legacy Codebase?}
B -->|Yes| C[Create CLAUDE_LEGACY.md]
B -->|No| D[Create/Update CLAUDE.md]
C --> E[Document Frameworks & Version Maps]
D --> F[Document Structure & Patterns]
E --> G[Pin Key Files for Context]
F --> G
G --> H[Identify Task Type]
H --> I{Task Category}
I -->|Bug Fix| J[Ask Claude for Bug Analysis]
I -->|Code Review| K[Request Code Review]
I -->|Refactor| L[Plan Refactoring Strategy]
I -->|Migration| M[Create Migration Plan]
J --> N[Set Explicit Boundaries]
K --> N
L --> N
M --> N
N --> O{Multiple Features?}
O -->|Yes| P[Create Git Worktrees]
O -->|No| Q[Work on Main Branch]
P --> R[Launch Separate Claude Sessions]
R --> S[Organize Terminal Tabs]
Q --> S
S --> T[Setup Team Automation]
T --> U[Sync .claude/commands/]
U --> V[Configure Slash Commands]
V --> W[Setup Hooks for Automation]
W --> X[Share Session Context with Team]
X --> Y{More Tasks?}
Y -->|Yes| H
Y -->|No| Z[Workflow Complete]
style A fill:#e1f5fe,stroke:#333,color:#333
style C fill:#fce4ec,stroke:#333,color:#333
style D fill:#fff9c4,stroke:#333,color:#333
style P fill:#e8f5e9,stroke:#333,color:#333
style T fill:#f3e5f5,stroke:#333,color:#333
style Z fill:#e8f5e9,stroke:#333,color:#333
Поради:
- Починайте кожну нову функцію або виправлення зі специфікації та промпту в режимі плану.
- Для legacy та складних репозиторіїв зберігайте детальні настанови в CLAUDE.md/CLAUDE_LEGACY.md.
- Давайте чіткі, зосереджені інструкції та розбивайте складну роботу на багатофазні плани.
- Регулярно очищайте сесії, обрізайте контекст та видаляйте завершені worktree, щоб уникнути безладу.
Ці кроки описують основні рекомендації для плавних робочих процесів з Claude Code як у нових, так і в існуючих кодових базах.
Нові функції та можливості (Березень 2026)
Ключові ресурси функцій
| Функція | Опис | Дізнатися більше |
|---|---|---|
| Auto Memory | Claude автоматично вивчає та запам'ятовує ваші уподобання між сесіями | Посібник з пам'яті |
| Remote Control | Програмне управління сесіями Claude Code із зовнішніх інструментів та скриптів | Просунуті функції |
| Web Sessions | Доступ до Claude Code через браузерні інтерфейси для віддаленої розробки | Довідник CLI |
| Desktop App | Нативний десктопний додаток Claude Code з покращеним UI | Claude Code Docs |
| Extended Thinking | Перемикання глибокого мислення через Alt+T/Option+T або змінну MAX_THINKING_TOKENS |
Просунуті функції |
| Permission Modes | Тонке управління: default, acceptEdits, plan, auto, dontAsk, bypassPermissions | Просунуті функції |
| 7-Tier Memory | Managed Policy, Project, Project Rules, User, User Rules, Local, Auto Memory | Посібник з пам'яті |
| Hook Events | 33 події: PreToolUse, PostToolUse, PostToolUseFailure, Stop, StopFailure, SubagentStart, SubagentStop, Notification, Elicitation та інші | Посібник з хуків |
| Agent Teams | Координація кількох агентів для складних завдань | Посібник з субагентів |
| Scheduled Tasks | Налаштування повторюваних завдань з /loop та cron |
Просунуті функції |
| Chrome Integration | Автоматизація браузера з headless Chromium | Просунуті функції |
| Keyboard Customization | Налаштування клавіатурних скорочень включаючи chord-послідовності | Просунуті функції |
Останнє оновлення: Квітень 2026