SpyBara
Go Premium

Documentation 2026-07-27 21:02 UTC to 2026-07-28 23:57 UTC

4 files changed +60 −60. View all changes and history on the product overview
2026
Wed 29 07:01 Tue 28 23:57 Mon 27 21:02 Sun 26 19:02 Sat 25 21:59 Fri 24 23:01 Thu 23 23:57 Wed 22 23:59 Tue 21 23:00 Mon 20 23:01 Sat 18 16:02 Fri 17 22:57 Thu 16 22:59 Wed 15 22:00 Tue 14 23:01 Mon 13 23:57 Sat 11 19:03 Fri 10 17:00 Thu 9 23:58 Wed 8 16:02 Tue 7 16:02 Mon 6 23:57 Sat 4 03:01 Fri 3 23:00 Thu 2 23:59 Wed 1 21:01
Details

20 background: 'var(--ce-surface)',20 background: 'var(--ce-surface)',

21 border: '0.5px solid var(--ce-border-subtle)'21 border: '0.5px solid var(--ce-border-subtle)'

22 }}>{children}</code>, []);22 }}>{children}</code>, []);

23 const commandsNote = useMemo(() => <>Commands and skills are now the same mechanism. For new workflows, use <A href="/en/skills">skills/</A> instead: same <C>/name</C> invocation, plus you can bundle supporting files.</>, []);23 const commandsNote = useMemo(() => <>Commands and skills are now the same mechanism. For new workflows, use <A href="/docs/en/skills">skills/</A> instead: same <C>/name</C> invocation, plus you can bundle supporting files.</>, []);

24 const FILE_TREE = useMemo(() => ({24 const FILE_TREE = useMemo(() => ({

25 project: {25 project: {

26 label: 'your-project/',26 label: 'your-project/',


34 oneLiner: 'Project instructions Claude reads every session',34 oneLiner: 'Project instructions Claude reads every session',

35 when: 'Loaded into context at the start of every session',35 when: 'Loaded into context at the start of every session',

36 description: 'Project-specific instructions that shape how Claude works in this repository. Put your conventions, common commands, and architectural context here so Claude operates with the same assumptions your team does.',36 description: 'Project-specific instructions that shape how Claude works in this repository. Put your conventions, common commands, and architectural context here so Claude operates with the same assumptions your team does.',

37 tips: ['Target under 200 lines. Longer files still load in full but may reduce adherence', <>CLAUDE.md loads into every session. If something only matters for specific tasks, move it to a <A href="/en/skills">skill</A> or a path-scoped <A href="/en/memory#organize-rules-with-claude/rules/">rule</A> so it loads only when needed</>, 'List the commands you run most, like build, test, and format, so Claude knows them without you spelling them out each time', <>Run <C>/memory</C> to open and edit CLAUDE.md from within a session</>, <>Also works at <C>.claude/CLAUDE.md</C> if you prefer to keep the project root clean</>],37 tips: ['Target under 200 lines. Longer files still load in full but may reduce adherence', <>CLAUDE.md loads into every session. If something only matters for specific tasks, move it to a <A href="/docs/en/skills">skill</A> or a path-scoped <A href="/docs/en/memory#organize-rules-with-claude/rules/">rule</A> so it loads only when needed</>, 'List the commands you run most, like build, test, and format, so Claude knows them without you spelling them out each time', <>Run <C>/memory</C> to open and edit CLAUDE.md from within a session</>, <>Also works at <C>.claude/CLAUDE.md</C> if you prefer to keep the project root clean</>],

38 exampleIntro: 'This example is for a TypeScript and React project. It lists the build and test commands, the framework conventions Claude should follow, and project-specific rules like export style and file layout.',38 exampleIntro: 'This example is for a TypeScript and React project. It lists the build and test commands, the framework conventions Claude should follow, and project-specific rules like export style and file layout.',

39 example: `# Project conventions39 example: `# Project conventions

40 40 


60 color: '#9B7BC4',60 color: '#9B7BC4',

61 badge: 'committed',61 badge: 'committed',

62 oneLiner: 'Project-scoped MCP servers, shared with your team',62 oneLiner: 'Project-scoped MCP servers, shared with your team',

63 when: <>Servers connect when the session begins. Tool schemas are deferred by default and load on demand via <A href="/en/mcp#scale-with-mcp-tool-search">tool search</A></>,63 when: <>Servers connect when the session begins. Tool schemas are deferred by default and load on demand via <A href="/docs/en/mcp#scale-with-mcp-tool-search">tool search</A></>,

64 description: <>Configures Model Context Protocol (MCP) servers that give Claude access to external tools: databases, APIs, browsers, and more. This file holds the project-scoped servers your whole team uses. Personal servers you want to keep to yourself go in <C>~/.claude.json</C> instead.</>,64 description: <>Configures Model Context Protocol (MCP) servers that give Claude access to external tools: databases, APIs, browsers, and more. This file holds the project-scoped servers your whole team uses. Personal servers you want to keep to yourself go in <C>~/.claude.json</C> instead.</>,

65 tips: [<>Use environment variable references for secrets: <C>{'${NOTION_TOKEN}'}</C></>, <>Lives at the project root, not inside <C>.claude/</C></>, <>For servers only you need, run <C>claude mcp add --scope user</C>. This writes to <C>~/.claude.json</C> instead of <C>.mcp.json</C></>],65 tips: [<>Use environment variable references for secrets: <C>{'${NOTION_TOKEN}'}</C></>, <>Lives at the project root, not inside <C>.claude/</C></>, <>For servers only you need, run <C>claude mcp add --scope user</C>. This writes to <C>~/.claude.json</C> instead of <C>.mcp.json</C></>],

66 exampleIntro: <>This example configures the Notion MCP server so Claude can read and update pages in your workspace. The <C>{'${NOTION_TOKEN}'}</C> reference is read from your shell environment when Claude Code starts the server, so the token never lands in the file.</>,66 exampleIntro: <>This example configures the Notion MCP server so Claude can read and update pages in your workspace. The <C>{'${NOTION_TOKEN}'}</C> reference is read from your shell environment when Claude Code starts the server, so the token never lands in the file.</>,


86 oneLiner: 'Gitignored files to copy into new worktrees',86 oneLiner: 'Gitignored files to copy into new worktrees',

87 when: <>Read when Claude creates a git worktree via <C>--worktree</C>, the <C>EnterWorktree</C> tool, or subagent <C>isolation: worktree</C></>,87 when: <>Read when Claude creates a git worktree via <C>--worktree</C>, the <C>EnterWorktree</C> tool, or subagent <C>isolation: worktree</C></>,

88 description: <>Lists gitignored files to copy from your main repository into each new worktree. Worktrees are fresh checkouts, so untracked files like <C>.env</C> are missing by default. Patterns here use <C>.gitignore</C> syntax. Only files that match a pattern and are also gitignored get copied, so tracked files are never duplicated.</>,88 description: <>Lists gitignored files to copy from your main repository into each new worktree. Worktrees are fresh checkouts, so untracked files like <C>.env</C> are missing by default. Patterns here use <C>.gitignore</C> syntax. Only files that match a pattern and are also gitignored get copied, so tracked files are never duplicated.</>,

89 tips: [<>Lives at the project root, not inside <C>.claude/</C></>, <>Git-only: if you configure a <A href="/en/hooks#worktreecreate">WorktreeCreate hook</A> for a different VCS, this file is not read. Copy files inside your hook script instead</>, <>Also applies to parallel sessions in the <A href="/en/desktop#work-in-parallel-with-sessions">desktop app</A></>],89 tips: [<>Lives at the project root, not inside <C>.claude/</C></>, <>Git-only: if you configure a <A href="/docs/en/hooks#worktreecreate">WorktreeCreate hook</A> for a different VCS, this file is not read. Copy files inside your hook script instead</>, <>Also applies to parallel sessions in the <A href="/docs/en/desktop#work-in-parallel-with-sessions">desktop app</A></>],

90 exampleIntro: 'This example copies your local environment files and a secrets config into every worktree Claude creates. Comments start with # and blank lines are ignored, same as .gitignore.',90 exampleIntro: 'This example copies your local environment files and a secrets config into every worktree Claude creates. Comments start with # and blank lines are ignored, same as .gitignore.',

91 example: `# Local environment91 example: `# Local environment

92.env92.env


102 icon: 'folder',102 icon: 'folder',

103 color: 'var(--ce-accent)',103 color: 'var(--ce-accent)',

104 oneLiner: 'Project-level configuration, rules, and extensions',104 oneLiner: 'Project-level configuration, rules, and extensions',

105 description: 'Everything Claude Code reads that is specific to this project. If you use git, commit most files here so your team shares them; a few, like settings.local.json, are automatically gitignored. Each file badge shows which.',105 description: 'Everything Claude Code reads that is specific to this project. If you use git, commit most files here so your team shares them; a few, like settings.local.json, are gitignored when Claude Code saves settings to them. Each file badge shows which.',

106 children: [{106 children: [{

107 id: 'settings-json',107 id: 'settings-json',

108 label: 'settings.json',108 label: 'settings.json',


113 oneLiner: 'Permissions, hooks, and configuration',113 oneLiner: 'Permissions, hooks, and configuration',

114 when: <>Overrides global <C>~/.claude/settings.json</C>. Local settings, CLI flags, and managed settings override this</>,114 when: <>Overrides global <C>~/.claude/settings.json</C>. Local settings, CLI flags, and managed settings override this</>,

115 description: 'Settings that Claude Code applies directly. Permissions control which commands and tools Claude can use; hooks run your scripts at specific points in a session. Unlike CLAUDE.md, which Claude reads as guidance, these are enforced whether Claude follows them or not.',115 description: 'Settings that Claude Code applies directly. Permissions control which commands and tools Claude can use; hooks run your scripts at specific points in a session. Unlike CLAUDE.md, which Claude reads as guidance, these are enforced whether Claude follows them or not.',

116 contains: [<><A href="/en/permissions">permissions</A>: allow, deny, or prompt before Claude uses specific tools or commands</>, <><A href="/en/hooks">hooks</A>: run your own scripts on events like before a tool call or after a file edit</>, <><A href="/en/statusline">statusLine</A>: customize the line shown at the bottom while Claude works</>, <><A href="/en/settings#available-settings">model</A>: pick a default model for this project</>, <><A href="/en/settings#environment-variables">env</A>: environment variables set in every session</>, <><A href="/en/output-styles">outputStyle</A>: select a custom system-prompt style from output-styles/</>],116 contains: [<><A href="/docs/en/permissions">permissions</A>: allow, deny, or prompt before Claude uses specific tools or commands</>, <><A href="/docs/en/hooks">hooks</A>: run your own scripts on events like before a tool call or after a file edit</>, <><A href="/docs/en/statusline">statusLine</A>: customize the line shown at the bottom while Claude works</>, <><A href="/docs/en/settings#available-settings">model</A>: pick a default model for this project</>, <><A href="/docs/en/settings#environment-variables">env</A>: environment variables set in every session</>, <><A href="/docs/en/output-styles">outputStyle</A>: select a custom system-prompt style from output-styles/</>],

117 tips: [<>Bash permission patterns support wildcards: <C>Bash(npm test *)</C> matches any command starting with <C>npm test</C></>, <>Array settings like <C>permissions.allow</C> combine across all scopes; scalar settings like <C>model</C> use the most specific value</>],117 tips: [<>Bash permission patterns support wildcards: <C>Bash(npm test *)</C> matches any command starting with <C>npm test</C></>, <>Array settings like <C>permissions.allow</C> combine across all scopes; scalar settings like <C>model</C> use the most specific value</>],

118 exampleIntro: <>This example allows <C>npm test</C> and <C>npm run</C> commands without prompting, blocks <C>rm -rf</C>, and runs Prettier on files after Claude edits or writes them.</>,118 exampleIntro: <>This example allows <C>npm test</C> and <C>npm run</C> commands without prompting, blocks <C>rm -rf</C>, and runs Prettier on files after Claude edits or writes them.</>,

119 example: `{119 example: `{


146 badge: 'gitignored',146 badge: 'gitignored',

147 oneLiner: 'Your personal settings overrides for this project',147 oneLiner: 'Your personal settings overrides for this project',

148 when: 'Highest of the user-editable settings files; CLI flags and managed settings still take precedence',148 when: 'Highest of the user-editable settings files; CLI flags and managed settings still take precedence',

149 description: 'Personal settings that take precedence over the project defaults. Same JSON format as settings.json, but not committed. Use this when you need different permissions or defaults than the team config.',149 description: 'Personal settings that take precedence over the project defaults. Same JSON format as settings.json, gitignored when Claude Code saves a setting to it. Use this when you need different permissions or defaults than the team config.',

150 tips: [<>Same schema as settings.json. Array settings like <C>permissions.allow</C> combine across scopes; scalar settings like <C>model</C> use the local value</>, <>Claude Code adds this file to <C>~/.config/git/ignore</C> the first time it writes one. If you use a custom <C>core.excludesFile</C>, add the pattern there too. To share the ignore rule with your team, also add it to the project <C>.gitignore</C></>],150 tips: [<>Same schema as settings.json. Array settings like <C>permissions.allow</C> combine across scopes; scalar settings like <C>model</C> use the local value</>, <>When Claude Code saves a setting to this file in a repository that doesn't already ignore it, it adds <C>**/.claude/settings.local.json</C> to your global git excludes file: <C>core.excludesFile</C> from your global git config when it's set to an absolute or <C>~</C>-prefixed path, otherwise <C>$XDG_CONFIG_HOME/git/ignore</C>, or <C>~/.config/git/ignore</C>. To share the ignore rule with your team, also add it to the project <C>.gitignore</C></>],

151 exampleIntro: 'This example adds Docker permissions on top of whatever the team settings.json allows.',151 exampleIntro: 'This example adds Docker permissions on top of whatever the team settings.json allows.',

152 example: `{152 example: `{

153 "permissions": {153 "permissions": {


165 color: '#9B7BC4',165 color: '#9B7BC4',

166 oneLiner: 'Topic-scoped instructions, optionally gated by file paths',166 oneLiner: 'Topic-scoped instructions, optionally gated by file paths',

167 when: <>Rules without <C>paths:</C> load at session start. Rules with <C>paths:</C> load when a matching file enters context</>,167 when: <>Rules without <C>paths:</C> load at session start. Rules with <C>paths:</C> load when a matching file enters context</>,

168 description: [<>Project instructions split into topic files that can load conditionally based on file paths. A rule without <C>paths:</C> frontmatter loads at session start like CLAUDE.md; a rule with <C>paths:</C> loads only when Claude reads a matching file.</>, <>Like CLAUDE.md, rules are guidance Claude reads, not configuration Claude Code enforces. For guaranteed behavior use <A href="/en/hooks">hooks</A> or <A href="/en/permissions">permissions</A>.</>],168 description: [<>Project instructions split into topic files that can load conditionally based on file paths. A rule without <C>paths:</C> frontmatter loads at session start like CLAUDE.md; a rule with <C>paths:</C> loads only when Claude reads a matching file.</>, <>Like CLAUDE.md, rules are guidance Claude reads, not configuration Claude Code enforces. For guaranteed behavior use <A href="/docs/en/hooks">hooks</A> or <A href="/docs/en/permissions">permissions</A>.</>],

169 tips: [<>Use <C>paths:</C> frontmatter with globs to scope rules to directories or file types</>, <>Subdirectories work: <C>.claude/rules/frontend/react.md</C> is discovered automatically</>, 'When CLAUDE.md approaches 200 lines, start splitting into rules'],169 tips: [<>Use <C>paths:</C> frontmatter with globs to scope rules to directories or file types</>, <>Subdirectories work: <C>.claude/rules/frontend/react.md</C> is discovered automatically</>, 'When CLAUDE.md approaches 200 lines, start splitting into rules'],

170 docsLink: '/en/memory#organize-rules-with-claude/rules/',170 docsLink: '/en/memory#organize-rules-with-claude/rules/',

171 children: [{171 children: [{


369 color: '#C46686',369 color: '#C46686',

370 oneLiner: 'Dynamic workflow scripts that orchestrate many subagents',370 oneLiner: 'Dynamic workflow scripts that orchestrate many subagents',

371 when: 'Loaded at startup; each file becomes a /<name> command',371 when: 'Loaded at startup; each file becomes a /<name> command',

372 description: <>Each <C>.js</C> file is a <A href="/en/workflows">dynamic workflow</A>: a script the runtime executes to spawn and coordinate many subagents. Workflows are written by Claude and saved here from <C>/workflows</C> rather than authored from scratch.</>,372 description: <>Each <C>.js</C> file is a <A href="/docs/en/workflows">dynamic workflow</A>: a script the runtime executes to spawn and coordinate many subagents. Workflows are written by Claude and saved here from <C>/workflows</C> rather than authored from scratch.</>,

373 tips: [<>Save a run from <C>/workflows</C> with <C>s</C> to create one of these</>, <>A project workflow takes precedence over a personal one in <C>~/.claude/workflows/</C> with the same name</>],373 tips: [<>Save a run from <C>/workflows</C> with <C>s</C> to create one of these</>, <>A project workflow takes precedence over a personal one in <C>~/.claude/workflows/</C> with the same name</>],

374 docsLink: '/en/workflows'374 docsLink: '/en/workflows'

375 }, {375 }, {


382 autogen: true,382 autogen: true,

383 oneLiner: 'Subagent persistent memory, separate from your main session auto memory',383 oneLiner: 'Subagent persistent memory, separate from your main session auto memory',

384 when: 'First 200 lines (capped at 25KB) of MEMORY.md loaded into the subagent system prompt when it runs',384 when: 'First 200 lines (capped at 25KB) of MEMORY.md loaded into the subagent system prompt when it runs',

385 description: <>Subagents with <C>memory: project</C> in their frontmatter get a dedicated memory directory here. This is distinct from your <A href="/en/memory#auto-memory">main session auto memory</A> at <C>~/.claude/projects/</C>: each subagent reads and writes its own MEMORY.md, not yours.</>,385 description: <>Subagents with <C>memory: project</C> in their frontmatter get a dedicated memory directory here. This is distinct from your <A href="/docs/en/memory#auto-memory">main session auto memory</A> at <C>~/.claude/projects/</C>: each subagent reads and writes its own MEMORY.md, not yours.</>,

386 tips: [<>Only created for subagents that set the <C>memory:</C> frontmatter field</>, <>This directory holds project-scoped subagent memory, meant to be shared with your team. To keep memory out of version control use <C>memory: local</C>, which writes to <C>.claude/agent-memory-local/</C> instead. For cross-project memory use <C>memory: user</C>, which writes to <C>~/.claude/agent-memory/</C></>, <>The main session auto memory is a different feature; see <C>~/.claude/projects/</C> in the Global tab</>],386 tips: [<>Only created for subagents that set the <C>memory:</C> frontmatter field</>, <>This directory holds project-scoped subagent memory, meant to be shared with your team. To keep memory out of version control use <C>memory: local</C>, which writes to <C>.claude/agent-memory-local/</C> instead. For cross-project memory use <C>memory: user</C>, which writes to <C>~/.claude/agent-memory/</C></>, <>The main session auto memory is a different feature; see <C>~/.claude/projects/</C> in the Global tab</>],

387 docsLink: '/en/sub-agents#enable-persistent-memory',387 docsLink: '/en/sub-agents#enable-persistent-memory',

388 children: [{388 children: [{


402 autogen: true,402 autogen: true,

403 oneLiner: 'The subagent writes and maintains this file automatically',403 oneLiner: 'The subagent writes and maintains this file automatically',

404 when: 'Loaded into the subagent system prompt when the subagent starts',404 when: 'Loaded into the subagent system prompt when the subagent starts',

405 description: <>Works the same as your <A href="/en/memory#auto-memory">main auto memory</A>: the subagent creates and updates this file itself. You do not write it. The subagent reads it at the start of each task and writes back what it learns.</>,405 description: <>Works the same as your <A href="/docs/en/memory#auto-memory">main auto memory</A>: the subagent creates and updates this file itself. You do not write it. The subagent reads it at the start of each task and writes back what it learns.</>,

406 example: `# code-reviewer memory406 example: `# code-reviewer memory

407 407 

408## Patterns seen408## Patterns seen


1432 1432 

1433Claude Code читает инструкции, параметры, skills, subagents и память из директории вашего проекта и из `~/.claude` в вашей домашней директории. Зафиксируйте файлы проекта в git, чтобы поделиться ими с вашей командой; файлы в `~/.claude` — это личная конфигурация, которая применяется ко всем вашим проектам.1433Claude Code читает инструкции, параметры, skills, subagents и память из директории вашего проекта и из `~/.claude` в вашей домашней директории. Зафиксируйте файлы проекта в git, чтобы поделиться ими с вашей командой; файлы в `~/.claude` — это личная конфигурация, которая применяется ко всем вашим проектам.

1434 1434 

1435На Windows `~/.claude` разрешается в `%USERPROFILE%\.claude`. Если вы установите [`CLAUDE_CONFIG_DIR`](/ru/env-vars), каждый путь `~/.claude` на этой странице будет находиться в этой директории вместо этого.1435На Windows `~/.claude` разрешается в `%USERPROFILE%\.claude`. Если вы установите [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars), каждый путь `~/.claude` на этой странице будет находиться в этой директории вместо этого.

1436 1436 

1437Большинство пользователей редактируют только `CLAUDE.md` и `settings.json`. Остальная часть директории опциональна: добавляйте skills, rules или subagents по мере необходимости.1437Большинство пользователей редактируют только `CLAUDE.md` и `settings.json`. Остальная часть директории опциональна: добавляйте skills, rules или subagents по мере необходимости.

1438 1438 


1452 1452 

1453| Файл | Местоположение | Назначение |1453| Файл | Местоположение | Назначение |

1454| ----------------------- | -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1454| ----------------------- | -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1455| `managed-settings.json` | Системный уровень, варьируется в зависимости от ОС | Параметры, установленные предприятием, которые вы не можете переопределить. См. [параметры, управляемые сервером](/ru/server-managed-settings). |1455| `managed-settings.json` | Системный уровень, варьируется в зависимости от ОС | Параметры, установленные предприятием, которые вы не можете переопределить. См. [параметры, управляемые сервером](/docs/ru/server-managed-settings). |

1456| `CLAUDE.local.md` | Корень проекта | Ваши личные предпочтения для этого проекта, загруженные вместе с CLAUDE.md. Создайте его вручную и добавьте в `.gitignore`. |1456| `CLAUDE.local.md` | Корень проекта | Ваши личные предпочтения для этого проекта, загруженные вместе с CLAUDE.md. Создайте его вручную и добавьте в `.gitignore`. |

1457| Установленные plugins | `~/.claude/plugins` | Клонированные маркетплейсы, установленные версии plugins и данные для каждого plugin, управляемые командами `claude plugin`. Сиротские версии удаляются через 7 дней после обновления или удаления plugin. См. [кэширование plugins](/ru/plugins-reference#plugin-caching-and-file-resolution). |1457| Установленные plugins | `~/.claude/plugins` | Клонированные маркетплейсы, установленные версии plugins и данные для каждого plugin, управляемые командами `claude plugin`. Сиротские версии удаляются через 7 дней после обновления или удаления plugin. См. [кэширование plugins](/docs/ru/plugins-reference#plugin-caching-and-file-resolution). |

1458 1458 

1459`~/.claude` также содержит данные, которые Claude Code записывает во время работы: стенограммы, историю подсказок, снимки файлов, кэши и журналы. См. [данные приложения](#application-data) ниже.1459`~/.claude` также содержит данные, которые Claude Code записывает во время работы: стенограммы, историю подсказок, снимки файлов, кэши и журналы. См. [данные приложения](#application-data) ниже.

1460 1460 


1466 1466 

1467| Вы хотите | Редактировать | Область | Справочник |1467| Вы хотите | Редактировать | Область | Справочник |

1468| :---------------------------------------------------------------------- | :---------------------------------------- | :------------------- | :------------------------------------------------- |1468| :---------------------------------------------------------------------- | :---------------------------------------- | :------------------- | :------------------------------------------------- |

1469| Дать Claude контекст проекта и соглашения | `CLAUDE.md` | проект или глобально | [Memory](/ru/memory) |1469| Дать Claude контекст проекта и соглашения | `CLAUDE.md` | проект или глобально | [Memory](/docs/ru/memory) |

1470| Разрешить или заблокировать определённые вызовы инструментов | `settings.json` `permissions` или `hooks` | проект или глобально | [Permissions](/ru/permissions), [Hooks](/ru/hooks) |1470| Разрешить или заблокировать определённые вызовы инструментов | `settings.json` `permissions` или `hooks` | проект или глобально | [Permissions](/docs/ru/permissions), [Hooks](/docs/ru/hooks) |

1471| Запустить скрипт до или после вызовов инструментов | `settings.json` `hooks` | проект или глобально | [Hooks](/ru/hooks) |1471| Запустить скрипт до или после вызовов инструментов | `settings.json` `hooks` | проект или глобально | [Hooks](/docs/ru/hooks) |

1472| Установить переменные окружения для сеанса | `settings.json` `env` | проект или глобально | [Settings](/ru/settings#available-settings) |1472| Установить переменные окружения для сеанса | `settings.json` `env` | проект или глобально | [Settings](/docs/ru/settings#available-settings) |

1473| Сохранить личные переопределения вне git | `settings.local.json` | только проект | [Области параметров](/ru/settings#settings-files) |1473| Сохранить личные переопределения вне git | `settings.local.json` | только проект | [Области параметров](/docs/ru/settings#settings-files) |

1474| Добавить подсказку или возможность, которую вы вызываете с `/name` | `skills/<name>/SKILL.md` | проект или глобально | [Skills](/ru/skills) |1474| Добавить подсказку или возможность, которую вы вызываете с `/name` | `skills/<name>/SKILL.md` | проект или глобально | [Skills](/docs/ru/skills) |

1475| Определить специализированный subagent с его собственными инструментами | `agents/*.md` | проект или глобально | [Subagents](/ru/sub-agents) |1475| Определить специализированный subagent с его собственными инструментами | `agents/*.md` | проект или глобально | [Subagents](/docs/ru/sub-agents) |

1476| Организовать множество subagents из скрипта | `workflows/*.js` | проект или глобально | [Dynamic workflows](/ru/workflows) |1476| Организовать множество subagents из скрипта | `workflows/*.js` | проект или глобально | [Dynamic workflows](/docs/ru/workflows) |

1477| Подключить внешние инструменты через MCP | `.mcp.json` | только проект | [MCP](/ru/mcp) |1477| Подключить внешние инструменты через MCP | `.mcp.json` | только проект | [MCP](/docs/ru/mcp) |

1478| Изменить способ форматирования ответов Claude | `output-styles/*.md` | проект или глобально | [Output styles](/ru/output-styles) |1478| Изменить способ форматирования ответов Claude | `output-styles/*.md` | проект или глобально | [Output styles](/docs/ru/output-styles) |

1479 1479 

1480<h2 id="file-reference">1480<h2 id="file-reference">

1481 Справочник файлов1481 Справочник файлов


1486<Note>1486<Note>

1487 Несколько вещей могут переопределить то, что вы поместили в эти файлы:1487 Несколько вещей могут переопределить то, что вы поместили в эти файлы:

1488 1488 

1489 * [Управляемые параметры](/ru/server-managed-settings), развёрнутые вашей организацией, имеют приоритет над всем остальным1489 * [Управляемые параметры](/docs/ru/server-managed-settings), развёрнутые вашей организацией, имеют приоритет над всем остальным

1490 * Флаги CLI, такие как `--permission-mode` или `--settings`, переопределяют `settings.json` для этого сеанса1490 * Флаги CLI, такие как `--permission-mode` или `--settings`, переопределяют `settings.json` для этого сеанса

1491 * Некоторые переменные окружения имеют приоритет над их эквивалентным параметром, но это варьируется: проверьте [справочник переменных окружения](/ru/env-vars) для каждого из них1491 * Некоторые переменные окружения имеют приоритет над их эквивалентным параметром, но это варьируется: проверьте [справочник переменных окружения](/docs/ru/env-vars) для каждого из них

1492 1492 

1493 См. [приоритет параметров](/ru/settings#settings-precedence) для полного порядка.1493 См. [приоритет параметров](/docs/ru/settings#settings-precedence) для полного порядка.

1494</Note>1494</Note>

1495 1495 

1496Нажмите на имя файла, чтобы открыть этот узел в обозревателе выше.1496Нажмите на имя файла, чтобы открыть этот узел в обозревателе выше.

1497 1497 

1498| Файл | Область | Зафиксировать | Что он делает | Справочник |1498| Файл | Область | Зафиксировать | Что он делает | Справочник |

1499| --------------------------------------------------- | ------------------ | ------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |1499| --------------------------------------------------- | ------------------ | ------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |

1500| [`CLAUDE.md`](#ce-claude-md) | Проект и глобально | ✓ | Инструкции, загруженные каждый сеанс | [Memory](/ru/memory) |1500| [`CLAUDE.md`](#ce-claude-md) | Проект и глобально | ✓ | Инструкции, загруженные каждый сеанс | [Memory](/docs/ru/memory) |

1501| [`rules/*.md`](#ce-rules) | Проект и глобально | ✓ | Инструкции с областью действия темы, опционально с ограничением по пути | [Rules](/ru/memory#organize-rules-with-claude/rules/) |1501| [`rules/*.md`](#ce-rules) | Проект и глобально | ✓ | Инструкции с областью действия темы, опционально с ограничением по пути | [Rules](/docs/ru/memory#organize-rules-with-claude/rules/) |

1502| [`settings.json`](#ce-settings-json) | Проект и глобально | ✓ | Разрешения, hooks, переменные окружения, значения по умолчанию модели | [Settings](/ru/settings) |1502| [`settings.json`](#ce-settings-json) | Проект и глобально | ✓ | Разрешения, hooks, переменные окружения, значения по умолчанию модели | [Settings](/docs/ru/settings) |

1503| [`settings.local.json`](#ce-settings-local-json) | Только проект | | Ваши личные переопределения, автоматически добавлены в .gitignore | [Области параметров](/ru/settings#settings-files) |1503| [`settings.local.json`](#ce-settings-local-json) | Только проект | | Ваши личные переопределения, автоматически добавлены в .gitignore | [Области параметров](/docs/ru/settings#settings-files) |

1504| [`.mcp.json`](#ce-mcp-json) | Только проект | ✓ | Серверы MCP, общие для команды | [Области MCP](/ru/mcp#mcp-installation-scopes) |1504| [`.mcp.json`](#ce-mcp-json) | Только проект | ✓ | Серверы MCP, общие для команды | [Области MCP](/docs/ru/mcp#mcp-installation-scopes) |

1505| [`.worktreeinclude`](#ce-worktreeinclude) | Только проект | ✓ | Файлы, игнорируемые Git, для копирования в новые worktrees | [Worktrees](/ru/worktrees#copy-gitignored-files-into-worktrees) |1505| [`.worktreeinclude`](#ce-worktreeinclude) | Только проект | ✓ | Файлы, игнорируемые Git, для копирования в новые worktrees | [Worktrees](/docs/ru/worktrees#copy-gitignored-files-into-worktrees) |

1506| [`skills/<name>/SKILL.md`](#ce-skills) | Проект и глобально | ✓ | Переиспользуемые подсказки, вызываемые с `/name` или автоматически вызываемые | [Skills](/ru/skills) |1506| [`skills/<name>/SKILL.md`](#ce-skills) | Проект и глобально | ✓ | Переиспользуемые подсказки, вызываемые с `/name` или автоматически вызываемые | [Skills](/docs/ru/skills) |

1507| [`commands/*.md`](#ce-commands) | Проект и глобально | ✓ | Подсказки в одном файле; тот же механизм, что и skills | [Skills](/ru/skills) |1507| [`commands/*.md`](#ce-commands) | Проект и глобально | ✓ | Подсказки в одном файле; тот же механизм, что и skills | [Skills](/docs/ru/skills) |

1508| [`output-styles/*.md`](#ce-output-styles) | Проект и глобально | ✓ | Пользовательские разделы системной подсказки | [Output styles](/ru/output-styles) |1508| [`output-styles/*.md`](#ce-output-styles) | Проект и глобально | ✓ | Пользовательские разделы системной подсказки | [Output styles](/docs/ru/output-styles) |

1509| [`agents/*.md`](#ce-agents) | Проект и глобально | ✓ | Определения subagents с их собственной подсказкой и инструментами | [Subagents](/ru/sub-agents) |1509| [`agents/*.md`](#ce-agents) | Проект и глобально | ✓ | Определения subagents с их собственной подсказкой и инструментами | [Subagents](/docs/ru/sub-agents) |

1510| [`workflows/*.js`](#ce-workflows) | Проект и глобально | ✓ | Динамические скрипты рабочего процесса, написанные Claude и сохранённые из `/workflows`; каждый файл становится командой `/<name>` | [Dynamic workflows](/ru/workflows) |1510| [`workflows/*.js`](#ce-workflows) | Проект и глобально | ✓ | Динамические скрипты рабочего процесса, написанные Claude и сохранённые из `/workflows`; каждый файл становится командой `/<name>` | [Dynamic workflows](/docs/ru/workflows) |

1511| [`agent-memory/<name>/`](#ce-agent-memory) | Проект и глобально | ✓ | Постоянная память для subagents | [Постоянная память](/ru/sub-agents#enable-persistent-memory) |1511| [`agent-memory/<name>/`](#ce-agent-memory) | Проект и глобально | ✓ | Постоянная память для subagents | [Постоянная память](/docs/ru/sub-agents#enable-persistent-memory) |

1512| [`~/.claude.json`](#ce-claude-json) | Только глобально | | Состояние приложения, OAuth, переключатели UI, личные серверы MCP | [Глобальная конфигурация](/ru/settings#global-config-settings) |1512| [`~/.claude.json`](#ce-claude-json) | Только глобально | | Состояние приложения, OAuth, переключатели UI, личные серверы MCP | [Глобальная конфигурация](/docs/ru/settings#global-config-settings) |

1513| [`projects/<project>/memory/`](#ce-global-projects) | Только глобально | | Auto memory: заметки Claude самому себе между сеансами | [Auto memory](/ru/memory#auto-memory) |1513| [`projects/<project>/memory/`](#ce-global-projects) | Только глобально | | Auto memory: заметки Claude самому себе между сеансами | [Auto memory](/docs/ru/memory#auto-memory) |

1514| [`keybindings.json`](#ce-keybindings) | Только глобально | | Пользовательские сочетания клавиш | [Keybindings](/ru/keybindings) |1514| [`keybindings.json`](#ce-keybindings) | Только глобально | | Пользовательские сочетания клавиш | [Keybindings](/docs/ru/keybindings) |

1515| [`themes/*.json`](#ce-themes) | Только глобально | | Пользовательские цветовые темы | [Пользовательские темы](/ru/terminal-config#create-a-custom-theme) |1515| [`themes/*.json`](#ce-themes) | Только глобально | | Пользовательские цветовые темы | [Пользовательские темы](/docs/ru/terminal-config#create-a-custom-theme) |

1516 1516 

1517<h2 id="troubleshoot-configuration">1517<h2 id="troubleshoot-configuration">

1518 Устранение неполадок конфигурации1518 Устранение неполадок конфигурации

1519</h2>1519</h2>

1520 1520 

1521Если параметр, hook или файл не вступает в силу, см. [Отладка вашей конфигурации](/ru/debug-your-config) для команд проверки и таблицы поиска по симптомам.1521Если параметр, hook или файл не вступает в силу, см. [Отладка вашей конфигурации](/docs/ru/debug-your-config) для команд проверки и таблицы поиска по симптомам.

1522 1522 

1523<h2 id="application-data">1523<h2 id="application-data">

1524 Данные приложения1524 Данные приложения


1530 Автоматически очищается1530 Автоматически очищается

1531</h3>1531</h3>

1532 1532 

1533Файлы в путях ниже удаляются при запуске, как только им исполняется больше [`cleanupPeriodDays`](/ru/settings#available-settings). По умолчанию это 30 дней.1533Файлы в путях ниже удаляются при запуске, как только им исполняется больше [`cleanupPeriodDays`](/docs/ru/settings#available-settings). По умолчанию это 30 дней.

1534 1534 

1535| Путь под `~/.claude/` | Содержимое |1535| Путь под `~/.claude/` | Содержимое |

1536| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1536| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1537| `projects/<project>/<session>.jsonl` | Полная стенограмма разговора: каждое сообщение, вызов инструмента и результат инструмента |1537| `projects/<project>/<session>.jsonl` | Полная стенограмма разговора: каждое сообщение, вызов инструмента и результат инструмента |

1538| `projects/<project>/<session>/subagents/` | Стенограммы разговоров [Subagent](/ru/sub-agents), удаляемые вместе со стенограммой родительского сеанса, когда она устаревает |1538| `projects/<project>/<session>/subagents/` | Стенограммы разговоров [Subagent](/docs/ru/sub-agents), удаляемые вместе со стенограммой родительского сеанса, когда она устаревает |

1539| `projects/<project>/<session>/tool-results/` | Большие выходные данные инструмента разлиты в отдельные файлы |1539| `projects/<project>/<session>/tool-results/` | Большие выходные данные инструмента разлиты в отдельные файлы |

1540| `file-history/<session>/` | Снимки файлов перед редактированием, которые Claude изменил, используемые для [восстановления checkpoint](/ru/checkpointing). Содержит снимки для 100 самых последних контрольных точек; файлы снимков, на которые не ссылается ни один сохранённый checkpoint, удаляются, за исключением первого снимка каждого файла |1540| `file-history/<session>/` | Снимки файлов перед редактированием, которые Claude изменил, используемые для [восстановления checkpoint](/docs/ru/checkpointing). Содержит снимки для 100 самых последних контрольных точек; файлы снимков, на которые не ссылается ни один сохранённый checkpoint, удаляются, за исключением первого снимка каждого файла |

1541| `plans/` | Файлы плана, написанные во время [plan mode](/ru/permission-modes#analyze-before-you-edit-with-plan-mode) |1541| `plans/` | Файлы плана, написанные во время [plan mode](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) |

1542| `debug/` | Журналы отладки для каждого сеанса, написанные только при запуске с `--debug` или запуске `/debug` |1542| `debug/` | Журналы отладки для каждого сеанса, написанные только при запуске с `--debug` или запуске `/debug` |

1543| `paste-cache/`, `image-cache/` | Содержимое больших вставок и прикреплённых изображений |1543| `paste-cache/`, `image-cache/` | Содержимое больших вставок и прикреплённых изображений |

1544| `session-env/` | Метаданные окружения для каждого сеанса |1544| `session-env/` | Метаданные окружения для каждого сеанса |

1545| `tasks/` | Списки задач для каждого сеанса, написанные инструментами задач |1545| `tasks/` | Списки задач для каждого сеанса, написанные инструментами задач |

1546| `shell-snapshots/` | Псевдонимы, функции и параметры оболочки, захваченные при запуске и применяемые инструментом [Bash](/ru/tools-reference#bash-tool-behavior) к каждой команде. Удаляется при чистом выходе. Очистка удаляет любые оставшиеся после сбоя. |1546| `shell-snapshots/` | Псевдонимы, функции и параметры оболочки, захваченные при запуске и применяемые инструментом [Bash](/docs/ru/tools-reference#bash-tool-behavior) к каждой команде. Удаляется при чистом выходе. Очистка удаляет любые оставшиеся после сбоя. |

1547| `backups/` | Временные копии `~/.claude.json`, сделанные перед миграциями конфигурации |1547| `backups/` | Временные копии `~/.claude.json`, сделанные перед миграциями конфигурации |

1548| `feedback-bundles/` | Отредактированные архивы стенограмм, написанные `/feedback` на сторонних поставщиков или когда не настроены учётные данные Anthropic, для отправки команде вашего аккаунта Anthropic |1548| `feedback-bundles/` | Отредактированные архивы стенограмм, написанные `/feedback` на сторонних поставщиков или когда не настроены учётные данные Anthropic, для отправки команде вашего аккаунта Anthropic |

1549| `todos/`, `statsig/`, `logs/` | Устаревшие директории из более старых версий. Больше не записываются. Очистка удаляет их содержимое, а затем пустую директорию. |1549| `todos/`, `statsig/`, `logs/` | Устаревшие директории из более старых версий. Больше не записываются. Очистка удаляет их содержимое, а затем пустую директорию. |


1558| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |1558| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

1559| `history.jsonl` | Каждая подсказка, которую вы ввели, с временной меткой и путём проекта. Используется для отзыва стрелки вверх. |1559| `history.jsonl` | Каждая подсказка, которую вы ввели, с временной меткой и путём проекта. Используется для отзыва стрелки вверх. |

1560| `stats-cache.json` | Агрегированные подсчёты токенов и затрат, показанные `/usage` |1560| `stats-cache.json` | Агрегированные подсчёты токенов и затрат, показанные `/usage` |

1561| `remote-settings.json` | Кэшированная копия [управляемых сервером параметров](/ru/server-managed-settings) для вашей организации. Присутствует только если ваша организация их настроила. Обновляется при каждом запуске. |1561| `remote-settings.json` | Кэшированная копия [управляемых сервером параметров](/docs/ru/server-managed-settings) для вашей организации. Присутствует только если ваша организация их настроила. Обновляется при каждом запуске. |

1562 1562 

1563Другие небольшие файлы кэша и блокировки появляются в зависимости от того, какие функции вы используете, и безопасны для удаления.1563Другие небольшие файлы кэша и блокировки появляются в зависимости от того, какие функции вы используете, и безопасны для удаления.

1564 1564 


1569Стенограммы и история не зашифрованы в покое. Разрешения файлов ОС — единственная защита. Если инструмент читает файл `.env` или команда выводит учётные данные, это значение записывается в `projects/<project>/<session>.jsonl`. Чтобы снизить риск:1569Стенограммы и история не зашифрованы в покое. Разрешения файлов ОС — единственная защита. Если инструмент читает файл `.env` или команда выводит учётные данные, это значение записывается в `projects/<project>/<session>.jsonl`. Чтобы снизить риск:

1570 1570 

1571* Снизьте `cleanupPeriodDays`, чтобы сократить время хранения стенограмм1571* Снизьте `cleanupPeriodDays`, чтобы сократить время хранения стенограмм

1572* Установите переменную окружения [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/ru/env-vars), чтобы пропустить запись стенограмм и истории подсказок в любом режиме. В неинтерактивном режиме вы можете вместо этого передать `--no-session-persistence` вместе с `-p` или установить `persistSession: false` в Agent SDK.1572* Установите переменную окружения [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/ru/env-vars), чтобы пропустить запись стенограмм и истории подсказок в любом режиме. В неинтерактивном режиме вы можете вместо этого передать `--no-session-persistence` вместе с `-p` или установить `persistSession: false` в Agent SDK.

1573* Используйте [правила разрешений](/ru/permissions) для запрета чтения файлов учётных данных1573* Используйте [правила разрешений](/docs/ru/permissions) для запрета чтения файлов учётных данных

1574 1574 

1575<h3 id="clear-local-data">1575<h3 id="clear-local-data">

1576 Очистить локальные данные1576 Очистить локальные данные


1627 Связанные ресурсы1627 Связанные ресурсы

1628</h2>1628</h2>

1629 1629 

1630* [Управляйте памятью Claude](/ru/memory): пишите и организуйте CLAUDE.md, rules и auto memory1630* [Управляйте памятью Claude](/docs/ru/memory): пишите и организуйте CLAUDE.md, rules и auto memory

1631* [Настройте параметры](/ru/settings): установите разрешения, hooks, переменные окружения и значения по умолчанию модели1631* [Настройте параметры](/docs/ru/settings): установите разрешения, hooks, переменные окружения и значения по умолчанию модели

1632* [Создавайте skills](/ru/skills): создавайте переиспользуемые подсказки и рабочие процессы1632* [Создавайте skills](/docs/ru/skills): создавайте переиспользуемые подсказки и рабочие процессы

1633* [Настройте subagents](/ru/sub-agents): определите специализированные агенты с их собственным контекстом1633* [Настройте subagents](/docs/ru/sub-agents): определите специализированные агенты с их собственным контекстом

hooks.md +1 −1

Details

39| `UserPromptSubmit` | When you submit a prompt, before Claude processes it |39| `UserPromptSubmit` | When you submit a prompt, before Claude processes it |

40| `UserPromptExpansion` | When a user-typed command expands into a prompt, before it reaches Claude. Can block the expansion |40| `UserPromptExpansion` | When a user-typed command expands into a prompt, before it reaches Claude. Can block the expansion |

41| `PreToolUse` | Before a tool call executes. Can block it |41| `PreToolUse` | Before a tool call executes. Can block it |

42| `PermissionRequest` | When a permission dialog appears |42| `PermissionRequest` | When a tool call needs a permission decision |

43| `PermissionDenied` | When a tool call is denied by the auto mode classifier. Return `{retry: true}` to tell the model it may retry the denied tool call |43| `PermissionDenied` | When a tool call is denied by the auto mode classifier. Return `{retry: true}` to tell the model it may retry the denied tool call |

44| `PostToolUse` | After a tool call succeeds |44| `PostToolUse` | After a tool call succeeds |

45| `PostToolUseFailure` | After a tool call fails |45| `PostToolUseFailure` | After a tool call fails |

hooks-guide.md +1 −1

Details

465| `UserPromptSubmit` | When you submit a prompt, before Claude processes it |465| `UserPromptSubmit` | When you submit a prompt, before Claude processes it |

466| `UserPromptExpansion` | When a user-typed command expands into a prompt, before it reaches Claude. Can block the expansion |466| `UserPromptExpansion` | When a user-typed command expands into a prompt, before it reaches Claude. Can block the expansion |

467| `PreToolUse` | Before a tool call executes. Can block it |467| `PreToolUse` | Before a tool call executes. Can block it |

468| `PermissionRequest` | When a permission dialog appears |468| `PermissionRequest` | When a tool call needs a permission decision |

469| `PermissionDenied` | When a tool call is denied by the auto mode classifier. Return `{retry: true}` to tell the model it may retry the denied tool call |469| `PermissionDenied` | When a tool call is denied by the auto mode classifier. Return `{retry: true}` to tell the model it may retry the denied tool call |

470| `PostToolUse` | After a tool call succeeds |470| `PostToolUse` | After a tool call succeeds |

471| `PostToolUseFailure` | After a tool call fails |471| `PostToolUseFailure` | After a tool call fails |

Details

125| `UserPromptSubmit` | When you submit a prompt, before Claude processes it |125| `UserPromptSubmit` | When you submit a prompt, before Claude processes it |

126| `UserPromptExpansion` | When a user-typed command expands into a prompt, before it reaches Claude. Can block the expansion |126| `UserPromptExpansion` | When a user-typed command expands into a prompt, before it reaches Claude. Can block the expansion |

127| `PreToolUse` | Before a tool call executes. Can block it |127| `PreToolUse` | Before a tool call executes. Can block it |

128| `PermissionRequest` | When a permission dialog appears |128| `PermissionRequest` | When a tool call needs a permission decision |

129| `PermissionDenied` | When a tool call is denied by the auto mode classifier. Return `{retry: true}` to tell the model it may retry the denied tool call |129| `PermissionDenied` | When a tool call is denied by the auto mode classifier. Return `{retry: true}` to tell the model it may retry the denied tool call |

130| `PostToolUse` | After a tool call succeeds |130| `PostToolUse` | After a tool call succeeds |

131| `PostToolUseFailure` | After a tool call fails |131| `PostToolUseFailure` | After a tool call fails |