2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
3> Use this file to discover all available pages before exploring further.3> Use this file to discover all available pages before exploring further.
4 4
5# Параметры Claude Code5# Файлы параметров и приоритет
6 6
7> Настройте Claude Code с помощью глобальных и проектных параметров, а также переменных окружения.7> Измените параметры Claude Code, выберите область, к которой принадлежит ключ, проверьте изменение и узнайте, какое значение Claude Code использует, когда ключ установлен в нескольких местах.
8 8
9Claude Code предлагает множество параметров для настройки его поведения в соответствии с вашими потребностями. Вы можете настроить Claude Code, выполнив команду `/config`, которая открывает интерфейс параметров с вкладками, где вы можете просмотреть информацию о состоянии и изменить параметры конфигурации. Начиная с версии 2.1.181, вы можете изменить один параметр без открытия интерфейса, передав `key=value` в `/config`, например `/config verbose=true`.9export const SettingsPrecedence = () => {
10 10 const LEVELS = [{
11<h2 id="configuration-scopes">11 n: 1,
12 Области конфигурации12 name: 'Managed settings',
13</h2>13 file: 'managed-settings.json, MDM, or the claude.ai console',
14 14 who: 'Your organization',
15Claude Code использует систему областей для определения того, где применяются конфигурации и с кем они совместно используются. Понимание областей помогает вам решить, как настроить Claude Code для личного использования, командного сотрудничества или развертывания на уровне предприятия.15 w: 390
16 16 }, {
17<h3 id="available-scopes">17 n: 2,
18 Доступные области18 name: 'Command line',
19</h3>19 file: 'claude --settings',
20 20 who: 'You, this session',
21| Область | Местоположение | На кого это влияет | Совместно используется с командой? |21 w: 420
22| :---------- | :-------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------- |22 }, {
23| **Managed** | Параметры, управляемые сервером, plist / реестр или системный уровень `managed-settings.json` | Все члены организации для доставки, управляемой сервером; все пользователи на машине для plist, реестра HKLM и доставки файлов; текущий пользователь для доставки реестра HKCU | Да (развернуто IT) |23 n: 3,
24| **User** | Каталог `~/.claude/` | Вы, во всех проектах | Нет |24 name: 'Project local',
25| **Project** | `.claude/` в репозитории | Все сотрудники этого репозитория | Да (зафиксировано в git) |25 file: '.claude/settings.local.json',
26| **Local** | `.claude/settings.local.json` | Вы, только в этом репозитории | Нет (игнорируется gitignore, когда Claude Code его создает) |26 who: 'You, this project',
27 27 w: 480
28<h3 id="when-to-use-each-scope">28 }, {
29 Когда использовать каждую область29 n: 4,
30</h3>30 name: 'Shared project',
31 31 file: '.claude/settings.json',
32**Область Managed** предназначена для:32 who: 'Everyone in the project',
33 33 w: 540
34* Политик безопасности, которые должны быть применены на уровне организации34 }, {
35* Требований соответствия, которые нельзя переопределить35 n: 5,
36* Стандартизированных конфигураций, развернутых IT/DevOps36 name: 'User',
37 37 file: '~/.claude/settings.json',
38**Область User** лучше всего подходит для:38 who: 'You, every project',
39 39 w: 600
40* Личных предпочтений, которые вы хотите везде (темы, параметры редактора)40 }];
41* Инструментов и plugins, которые вы используете во всех проектах41 const W = 760;
42* Ключей API и аутентификации (хранятся безопасно)42 const ROW = 58;
43 43 const GAP = 8;
44**Область Project** лучше всего подходит для:44 const TOP = 34;
45 45 const H = TOP + LEVELS.length * (ROW + GAP) + 30;
46* Параметров, совместно используемых командой (разрешения, hooks, MCP servers)46 const cx = W / 2;
47* Plugins, которые должна иметь вся команда47 const mono = 'var(--font-mono, ui-monospace, SFMono-Regular, Menlo, monospace)';
48* Стандартизации инструментов между сотрудниками48 const sans = 'var(--font-sans, system-ui, -apple-system, sans-serif)';
49 49 return <div className="sp-root not-prose" role="img" aria-label="Settings precedence, highest first: managed settings, command line, project local, shared project, user. A key set at a higher level overrides the same key set lower down.">
50**Область Local** лучше всего подходит для:50 <style>{`
51 51 .sp-root { --sp-text: #1A1918; --sp-sub: #5E5D59; --sp-faint: #8A8880; --sp-fill: #F5F4EF; --sp-stroke: rgba(0,0,0,0.12); --sp-top: #D97757; --sp-top-fill: rgba(217,119,87,0.14); --sp-arrow: #8A8880; margin: 1.25rem 0; }
52* Личных переопределений для конкретного проекта52 .dark .sp-root { --sp-text: #F1EFE9; --sp-sub: #B8B5AD; --sp-faint: #8A8880; --sp-fill: #24231F; --sp-stroke: rgba(255,255,255,0.12); --sp-top-fill: rgba(217,119,87,0.22); --sp-arrow: #8A8880; }
53* Тестирования конфигураций перед совместным использованием с командой53 .sp-root svg { width: 100%; height: auto; display: block; max-width: ${W}px; margin: 0 auto; }
54* Параметров, специфичных для машины, которые не будут работать для других54 `}</style>
55 55 <svg viewBox={`0 0 ${W} ${H}`} xmlns="http://www.w3.org/2000/svg">
56<h3 id="how-scopes-interact">56 <text x={cx} y={18} textAnchor="middle" fontFamily={sans} fontSize="12.5" fontWeight="600" fill="var(--sp-sub)">Highest precedence</text>
57 Как области взаимодействуют57 {LEVELS.map((l, i) => {
58</h3>58 const y = TOP + i * (ROW + GAP);
59 const x = cx - l.w / 2;
60 const top = i === 0;
61 return <g key={l.n}>
62 <rect x={x} y={y} width={l.w} height={ROW} rx={10} fill={top ? 'var(--sp-top-fill)' : 'var(--sp-fill)'} stroke={top ? 'var(--sp-top)' : 'var(--sp-stroke)'} strokeWidth={top ? 1.5 : 1} />
63 <text x={x + 14} y={y + 24} fontFamily={sans} fontSize="14" fontWeight="600" fill="var(--sp-text)">{l.n}. {l.name}</text>
64 <text x={x + 14} y={y + 43} fontFamily={mono} fontSize="11.5" fill="var(--sp-sub)">{l.file}</text>
65 <text x={x + l.w - 14} y={y + 24} textAnchor="end" fontFamily={sans} fontSize="12" fill="var(--sp-faint)">{l.who}</text>
66 </g>;
67 })}
68 <text x={cx} y={H - 10} textAnchor="middle" fontFamily={sans} fontSize="12.5" fontWeight="600" fill="var(--sp-sub)">Lowest precedence</text>
69 <g stroke="var(--sp-arrow)" strokeWidth="1.5" fill="none">
70 <line x1={W - 40} y1={TOP + 10} x2={W - 40} y2={H - 38} />
71 <path d={`M ${W - 46} ${TOP + 18} L ${W - 40} ${TOP + 10} L ${W - 34} ${TOP + 18}`} />
72 </g>
73 <text x={W - 40} y={H - 22} textAnchor="middle" fontFamily={sans} fontSize="10.5" fill="var(--sp-faint)">overrides</text>
74 </svg>
75 </div>;
76};
77
78export const SettingsScope = ({defaultSelected = 'project'}) => {
79 const FILES = [{
80 id: 'user',
81 path: '~/.claude/settings.json'
82 }, {
83 id: 'project',
84 path: 'acme-app/.claude/settings.json'
85 }, {
86 id: 'local',
87 path: 'acme-app/.claude/settings.local.json'
88 }, {
89 id: 'managed',
90 path: 'Managed settings',
91 ring: 'managed-settings.json, MDM, or the claude.ai console'
92 }];
93 const SHORT = {
94 user: '~/.claude/settings.json',
95 project: 'acme-app/.claude/settings.json',
96 local: 'acme-app/.claude/settings.local.json',
97 managed: 'managed-settings.json, MDM, or the claude.ai console'
98 };
99 const TILE_MARK = {
100 project: 'settings.json',
101 local: 'settings.local.json'
102 };
103 const initial = FILES.some(f => f.id === defaultSelected) ? defaultSelected : 'project';
104 const [sel, setSel] = useState(initial);
105 const [scale, setScale] = useState(1);
106 const [isFullscreen, setIsFullscreen] = useState(false);
107 const rootRef = useRef(null);
108 const frameRef = useRef(null);
109 const CANVAS_W = 862;
110 const CANVAS_H = 240;
111 useEffect(() => {
112 const el = frameRef.current;
113 if (!el) return;
114 const measure = () => setScale(Math.min(1, el.clientWidth / CANVAS_W));
115 measure();
116 if (typeof ResizeObserver === 'undefined') {
117 window.addEventListener('resize', measure);
118 return () => window.removeEventListener('resize', measure);
119 }
120 const ro = new ResizeObserver(measure);
121 ro.observe(el);
122 return () => ro.disconnect();
123 }, []);
124 useEffect(() => {
125 const onFsChange = () => setIsFullscreen(!!document.fullscreenElement);
126 document.addEventListener('fullscreenchange', onFsChange);
127 return () => document.removeEventListener('fullscreenchange', onFsChange);
128 }, []);
129 const toggleFullscreen = () => {
130 if (!rootRef.current) return;
131 if (document.fullscreenElement) document.exitFullscreen(); else rootRef.current.requestFullscreen().catch(() => {});
132 };
133 const COVERAGE = {
134 user: ['website', 'api', 'yacme'],
135 project: ['yacme', 'tacme', 'cacme'],
136 local: ['yacme'],
137 managed: ['website', 'api', 'yacme', 'tacme', 'cacme']
138 };
139 const RINGS = {
140 local: {
141 l: 282,
142 t: 50,
143 w: 142,
144 h: 124
145 },
146 project: {
147 l: 282,
148 t: 50,
149 w: 560,
150 h: 124
151 },
152 user: {
153 l: 2,
154 t: 34,
155 w: 446,
156 h: 198
157 },
158 managed: {
159 l: 0,
160 t: 32,
161 w: 862,
162 h: 204
163 }
164 };
165 const TILES = [{
166 id: 'website',
167 name: 'website/',
168 left: 30,
169 caption: ''
170 }, {
171 id: 'api',
172 name: 'api/',
173 left: 160,
174 caption: ''
175 }, {
176 id: 'yacme',
177 name: 'acme-app/',
178 left: 290,
179 caption: ''
180 }, {
181 id: 'tacme',
182 name: 'acme-app/',
183 left: 497,
184 caption: sel === 'project' ? 'their clone, once you commit the file' : 'their clone'
185 }, {
186 id: 'cacme',
187 name: 'acme-app/',
188 left: 704,
189 caption: sel === 'project' ? 'fresh clone, once you commit the file' : sel === 'managed' ? 'server-managed only' : 'fresh clone'
190 }];
191 const FILE_AT = {
192 user: {
193 machine: 'you',
194 tiles: []
195 },
196 project: {
197 machine: null,
198 tiles: ['yacme', 'tacme', 'cacme']
199 },
200 local: {
201 machine: null,
202 tiles: ['yacme']
203 },
204 managed: {
205 machine: null,
206 tiles: []
207 }
208 };
209 const fileAt = FILE_AT[sel];
210 const coverage = COVERAGE[sel];
211 const ring = RINGS[sel];
212 const selFile = FILES.find(f => f.id === sel);
213 const FolderIcon = ({open}) => <svg width="15" height="15" viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth="1.3" strokeLinejoin="round" aria-hidden="true">
214 <path d="M1.5 4.5a1 1 0 0 1 1-1h3.2l1.3 1.5h6a1 1 0 0 1 1 1V12a1 1 0 0 1-1 1h-10.5a1 1 0 0 1-1-1z" />
215 {open && <path d="M1.5 7.5h13" />}
216 </svg>;
217 const FileIcon = () => <svg width="10" height="10" viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth="1.3" strokeLinejoin="round" aria-hidden="true">
218 <path d="M4 1.5h5.5L13 5v9.5H4z" />
219 <path d="M9.5 1.5V5H13" />
220 </svg>;
221 const CloudIcon = () => <svg width="16" height="16" viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth="1.3" strokeLinejoin="round" aria-hidden="true">
222 <path d="M4.5 12.5h7a2.5 2.5 0 0 0 .4-4.97A3.5 3.5 0 0 0 5.2 6.6 3 3 0 0 0 4.5 12.5z" />
223 </svg>;
224 const LaptopIcon = () => <svg width="16" height="16" viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth="1.3" strokeLinejoin="round" aria-hidden="true">
225 <rect x="2.5" y="3" width="11" height="7.5" rx="1" />
226 <path d="M1 12.5h14" />
227 </svg>;
228 return <div ref={rootRef} className={'ssc-root not-prose' + (isFullscreen ? ' ssc-fs' : '')}>
229 <style>{`
230 .ssc-root {
231 --ssc-bg: #FFFFFF;
232 --ssc-text: #1A1918;
233 --ssc-sub: #5E5D59;
234 --ssc-faint: #8A8880;
235 --ssc-border: rgba(0,0,0,0.12);
236 --ssc-panel: #F5F4EF;
237 --ssc-tile: #FAFAF8;
238 --ssc-clay: #D97757;
239 --ssc-clay-bg: rgba(217,119,87,0.14);
240 --ssc-label: #B0562F;
241 --ssc-hover: rgba(115,114,108,0.10);
242 font-family: var(--font-sans, system-ui, -apple-system, sans-serif);
243 background: var(--ssc-bg);
244 color: var(--ssc-text);
245 border: 1px solid var(--ssc-border);
246 border-radius: 16px;
247 padding: 20px 24px 24px;
248 margin: 1.5rem 0;
249 box-sizing: border-box;
250 }
251 .dark .ssc-root {
252 --ssc-bg: #1B1A18;
253 --ssc-text: #F1EFE9;
254 --ssc-sub: #B8B5AD;
255 --ssc-faint: #8A8880;
256 --ssc-border: rgba(255,255,255,0.12);
257 --ssc-panel: #24231F;
258 --ssc-tile: #2A2925;
259 --ssc-clay-bg: rgba(217,119,87,0.20);
260 --ssc-label: #EBC9B7;
261 }
262 .ssc-fs { display: flex; flex-direction: column; justify-content: center; align-items: center; margin: 0; border-radius: 0; height: 100vh; }
263 .ssc-fs .ssc-head { width: 100%; max-width: ${CANVAS_W}px; }
264 .ssc-fs .ssc-frame { width: 100%; }
265 .ssc-mono { font-family: var(--font-mono, ui-monospace, SFMono-Regular, Menlo, monospace); }
266 .ssc-head { display: flex; align-items: flex-start; justify-content: space-between; gap: 12px; margin-bottom: 20px; }
267 .ssc-files { display: flex; gap: 8px; flex-wrap: wrap; }
268 .ssc-file {
269 font-size: 12.5px; font-weight: 430; padding: 8px 13px; border-radius: 10px; cursor: pointer;
270 border: 0.5px solid var(--ssc-border); background: var(--ssc-tile); color: var(--ssc-text);
271 white-space: nowrap; transition: background 0.2s, border-color 0.2s;
272 }
273 .ssc-file:hover { filter: brightness(0.97); }
274 .ssc-file[aria-pressed="true"] { font-weight: 600; border: 1.5px solid var(--ssc-clay); background: var(--ssc-clay-bg); }
275 .ssc-fsbtn {
276 display: flex; align-items: center; justify-content: center; width: 28px; height: 28px; flex-shrink: 0;
277 border: none; background: none; border-radius: 6px; cursor: pointer; color: var(--ssc-faint); font-size: 15px;
278 }
279 .ssc-fsbtn:hover { background: var(--ssc-hover); }
280 .ssc-frame { width: 100%; max-width: ${CANVAS_W}px; margin: 0 auto; }
281 .ssc-canvas { position: relative; width: ${CANVAS_W}px; height: ${CANVAS_H}px; transform-origin: top left; }
282 .ssc-machine { position: absolute; top: 42px; height: 182px; background: var(--ssc-panel); border-radius: 16px; }
283 .ssc-machine-label { position: absolute; top: 192px; display: flex; align-items: center; gap: 8px; font-size: 13.5px; font-weight: 600; }
284 .ssc-tile {
285 position: absolute; top: 58px; width: 126px; height: 108px; border-radius: 12px; padding: 11px 12px; box-sizing: border-box;
286 background: var(--ssc-tile); border: 0.5px solid var(--ssc-border); opacity: 0.6;
287 transition: background 0.25s, border-color 0.25s, opacity 0.25s;
288 }
289 .ssc-tile.ssc-on { background: var(--ssc-clay-bg); border: 1px solid var(--ssc-clay); opacity: 1; }
290 .ssc-tile-name { display: flex; align-items: center; gap: 6px; color: var(--ssc-faint); }
291 .ssc-tile.ssc-on .ssc-tile-name { color: var(--ssc-clay); }
292 .ssc-tile-name span { font-size: 12px; font-weight: 430; white-space: nowrap; color: var(--ssc-text); }
293 .ssc-tile.ssc-on .ssc-tile-name span { font-weight: 600; }
294 .ssc-tile-caption { font-size: 10.5px; color: var(--ssc-sub); margin-top: 5px; line-height: 1.35; }
295 .ssc-filemark {
296 position: absolute; left: 5px; right: 5px; bottom: 8px; display: inline-flex; align-items: center; justify-content: center; gap: 2px;
297 font-size: 8.5px; color: var(--ssc-label); background: var(--ssc-bg); border: 1px solid var(--ssc-clay);
298 border-radius: 6px; padding: 2px 3px; white-space: nowrap; overflow: hidden;
299 }
300 .ssc-filemark svg { flex-shrink: 0; }
301 .ssc-machine-filemark { display: inline-flex; align-items: center; gap: 4px; margin-left: 10px; font-size: 10.5px; font-weight: 500; color: var(--ssc-label); }
302 .ssc-ring {
303 position: absolute; border: 2px solid var(--ssc-clay); border-radius: 18px; pointer-events: none;
304 transition: left 0.35s ease, top 0.35s ease, width 0.35s ease, height 0.35s ease;
305 }
306 .ssc-ring-label {
307 position: absolute; font-size: 12px; font-weight: 600; color: var(--ssc-label); white-space: nowrap; pointer-events: none;
308 transition: left 0.35s ease, top 0.35s ease;
309 }
310 `}</style>
311
312 <div className="ssc-head">
313 <div className="ssc-files" role="group" aria-label="Settings file">
314 {FILES.map(f => <button key={f.id} type="button" className="ssc-file ssc-mono" aria-pressed={f.id === sel} onClick={() => setSel(f.id)}>{f.path}</button>)}
315 </div>
316 <button type="button" className="ssc-fsbtn" onClick={toggleFullscreen} aria-label={isFullscreen ? 'Exit fullscreen' : 'Enter fullscreen'} title={isFullscreen ? 'Exit fullscreen' : 'Fullscreen'}>{isFullscreen ? '⤡' : '⛶'}</button>
317 </div>
318
319 <div ref={frameRef} className="ssc-frame" style={{
320 height: CANVAS_H * scale + 'px'
321 }}>
322 <div className="ssc-canvas" style={{
323 transform: 'scale(' + scale + ')'
324 }}>
325 <div className="ssc-machine" style={{
326 left: '10px',
327 width: '430px'
328 }} />
329 <span className="ssc-machine-label" style={{
330 left: '30px'
331 }}><LaptopIcon />Your machine{fileAt.machine === 'you' && <span className="ssc-machine-filemark ssc-mono"><FileIcon />{selFile.path}</span>}</span>
332 <div className="ssc-machine" style={{
333 left: '460px',
334 width: '200px'
335 }} />
336 <span className="ssc-machine-label" style={{
337 left: '470px'
338 }}><LaptopIcon />A teammate’s machine</span>
339 <div className="ssc-machine" style={{
340 left: '682px',
341 width: '170px'
342 }} />
343 <span className="ssc-machine-label" style={{
344 left: '692px'
345 }}><CloudIcon />A cloud session</span>
346
347 {TILES.map(t => {
348 const on = coverage.includes(t.id);
349 return <div key={t.id} className={'ssc-tile' + (on ? ' ssc-on' : '')} style={{
350 left: t.left + 'px'
351 }}>
352 <div className="ssc-tile-name"><FolderIcon open={on} /><span className="ssc-mono">{t.name}</span></div>
353 {t.caption && <div className="ssc-tile-caption">{t.caption}</div>}
354 {fileAt.tiles.includes(t.id) && <span className="ssc-filemark ssc-mono" title={SHORT[sel]}><FileIcon />{TILE_MARK[sel]}</span>}
355 </div>;
356 })}
357
358 <div className="ssc-ring" style={{
359 left: ring.l + 'px',
360 top: ring.t + 'px',
361 width: ring.w + 'px',
362 height: ring.h + 'px'
363 }} />
364 <span className="ssc-ring-label ssc-mono" style={{
365 left: ring.l + 14 + 'px',
366 top: ring.t - 26 + 'px'
367 }}>{selFile.ring || selFile.path}</span>
368 </div>
369 </div>
370 </div>;
371};
372
373Параметры — это ключи JSON, которые изменяют поведение Claude Code: какую модель он запускает, что он может запустить без запроса, какие файлы он не может читать, как он выглядит в вашем терминале и что ваша организация требует.
374
375<Tip>
376 Чтобы найти конкретный ключ, перейдите на [Все параметры](/docs/ru/settings-reference), где перечислены все ключи с файлом, в котором вы их устанавливаете, значением по умолчанию и примером.
377</Tip>
378
379Claude Code читает параметры из файлов параметров JSON, таких как `~/.claude/settings.json`. Он ищет их в нескольких местах, и [файл, из которого он читает параметр, определяет, к кому применяется параметр](#settings-files-and-who-they-affect). На этой странице рассматриваются эти файлы: в какой из них поместить параметр, как изменить параметр и подтвердить его применение, и какое значение Claude Code использует, когда один и тот же ключ установлен в более чем одном файле. [Настройка разрешений](/docs/ru/permissions) охватывает то, что Claude Code может запустить без запроса, и как писать правила `allow`, `ask` и `deny`.
59 380
60Когда один и тот же параметр появляется в нескольких областях, Claude Code применяет их в порядке приоритета:381<Note>
382 На этой странице рассматривается Claude Code, работающий на вашей машине: терминал, расширения [VS Code](/docs/ru/vs-code) и [JetBrains](/docs/ru/jetbrains), а также [приложение desktop](/docs/ru/desktop), которые все читают одни и те же файлы параметров. Облачный сеанс на [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) работает на другой машине и читает только некоторые из них; см. [Параметры в облачных сеансах](#settings-in-cloud-sessions).
383</Note>
61 384
621. **Managed** (наивысший): не может быть переопределена ничем385<span id="settings-files" />
632. **Аргументы командной строки**: временные переопределения сеанса
643. **Local**: переопределяет параметры проекта и пользователя
654. **Project**: переопределяет параметры пользователя
665. **User** (наименьший): применяется, когда ничто другое не указывает параметр
67 386
68Например, если параметры пользователя устанавливают `spinnerTipsEnabled` в `true`, а параметры проекта устанавливают его в `false`, применяется значение проекта. Правила разрешений ведут себя иначе, потому что они объединяются в областях, а не переопределяют друг друга. См. [Приоритет параметров](#settings-precedence).387<span id="configuration-scopes" />
69 388
70<h3 id="what-uses-scopes">389<span id="available-scopes" />
71 Что использует области
72</h3>
73 390
74Области применяются ко многим функциям Claude Code:391<span id="when-to-use-each-scope" />
75 392
76| Функция | Местоположение пользователя | Местоположение проекта | Местоположение Local |393<span id="what-uses-scopes" />
77| :-------------- | :-------------------------- | :---------------------------------- | :------------------------------------- |
78| **Settings** | `~/.claude/settings.json` | `.claude/settings.json` | `.claude/settings.local.json` |
79| **Subagents** | `~/.claude/agents/` | `.claude/agents/` | Нет |
80| **MCP servers** | `~/.claude.json` | `.mcp.json` | `~/.claude.json` (для каждого проекта) |
81| **Plugins** | `~/.claude/settings.json` | `.claude/settings.json` | `.claude/settings.local.json` |
82| **CLAUDE.md** | `~/.claude/CLAUDE.md` | `CLAUDE.md` или `.claude/CLAUDE.md` | `CLAUDE.local.md` |
83 394
84На Windows пути, отображаемые как `~/.claude`, разрешаются в `%USERPROFILE%\.claude`.395<span id="subagent-configuration" />
85 396
86***397<span id="where-settings-live" />
87 398
88<h2 id="settings-files">399<h2 id="settings-files-and-who-they-affect">
89 Файлы параметров400 Файлы параметров и кого они затрагивают
90</h2>401</h2>
91 402
92Файл `settings.json` является официальным механизмом для настройки Claude Code через иерархические параметры:403Claude Code читает параметры из четырёх файлов, и организация также может доставлять управляемые параметры из консоли claude.ai. Каждый источник имеет область действия: набор людей и проектов, к которым применяется параметр, сохранённый в нём, будь то только вы, все в проекте или все в вашей организации.
93
94* **Параметры пользователя** определяются в `~/.claude/settings.json` и применяются ко всем проектам.
95* **Параметры проекта** сохраняются в каталоге вашего проекта:
96 * `.claude/settings.json` для параметров, которые проверяются в системе управления версиями и совместно используются с вашей командой
97 * `.claude/settings.local.json` для параметров, которые не проверяются, полезны для личных предпочтений и экспериментов. Когда Claude Code создает `.claude/settings.local.json`, он настраивает git на игнорирование файла. Если вы создаете файл самостоятельно, добавьте его в gitignore вручную.
98 404
99 Поскольку этот файл принадлежит вам, а не репозиторию, его правила разрешения `allow` вступают в силу без этапа [доверия рабочей области](/docs/ru/permissions#project-allow-rules-and-workspace-trust), который требуют правила разрешения `.claude/settings.json`. Если репозиторий предоставляет файл, например путем его фиксации, доверие рабочей области по-прежнему применяется.405| Область действия | Файл | Кого это затрагивает | Используйте для |
100* **Управляемые параметры**: Для организаций, которым требуется централизованное управление, Claude Code поддерживает несколько механизмов доставки управляемых параметров. Все используют один и тот же формат JSON и не могут быть переопределены параметрами пользователя или проекта:406| :--------------- | :------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------- |
407| Пользователь | `~/.claude/settings.json` | Вас, в каждом проекте на этой машине | Личные предпочтения: тема, режим редактора, модель по умолчанию, ваши собственные правила разрешений |
408| Общий проект | `.claude/settings.json` | Всех, кто работает в папке, которая его содержит. В репозитории git зафиксируйте его, чтобы товарищи по команде его получили | Разрешения команды, hooks, plugins и переменные окружения, которые нужны проекту |
409| Локальный проект | `.claude/settings.local.json` | Вас, только в этом одном проекте. Claude Code исключает его из git при создании файла; если вы создадите его вручную, добавьте его в `.gitignore` сами | Личные переопределения для одного проекта и тестирование перед тем, как вы поделитесь |
410| Управляемый | `managed-settings.json` и другие [управляемые источники](/docs/ru/managed-settings#delivery-mechanisms) | Всех, кому ваша организация его развёртывает; ничто из того, что вы установили, его не переопределяет, кроме нескольких [исключений, чувствительных к безопасности](#exceptions-to-managed-settings-precedence) | Требования политики безопасности и соответствия |
101 411
102 * **Параметры, управляемые сервером**: доставляются удаленно при входе либо с серверов Anthropic через консоль администратора claude.ai, либо с самостоятельно размещенного [Claude apps gateway](/docs/ru/claude-apps-gateway). См. [параметры, управляемые сервером](/docs/ru/server-managed-settings).412В столбце File `~/.claude` — это папка `.claude` в вашем домашнем каталоге, а простой `.claude` — это папка `.claude` внутри вашего проекта.
103 * **Политики MDM/OS-уровня**: доставляются через встроенное управление устройствами на macOS и Windows:
104 * macOS: домен управляемых предпочтений `com.anthropic.claudecode`. Ключи верхнего уровня plist отражают `managed-settings.json`, с вложенными параметрами как словари и массивы как plist массивы. Развертывание через профили конфигурации в Jamf, Iru (Kandji) или аналогичных инструментах MDM.
105 * Windows: ключ реестра `HKLM\SOFTWARE\Policies\ClaudeCode` со значением `Settings` (REG\_SZ или REG\_EXPAND\_SZ), содержащим JSON (развернуто через групповую политику или Intune)
106 * Windows (уровень пользователя): `HKCU\SOFTWARE\Policies\ClaudeCode` (наименьший приоритет политики, используется только при отсутствии источника на уровне администратора)
107 * **На основе файлов**: `managed-settings.json` и `managed-mcp.json`, развернутые в системные каталоги:
108 413
109 * macOS: `/Library/Application Support/ClaudeCode/`414<span id="where-each-file-applies" />
110 * Linux и WSL: `/etc/claude-code/`
111 * Windows: `C:\Program Files\ClaudeCode\`
112 415
113 <Warning>416<span id="compare-what-each-file-reaches" />
114 Устаревший путь Windows `C:\ProgramData\ClaudeCode\managed-settings.json` больше не поддерживается с версии v2.1.75. Администраторы, которые развернули параметры в этом местоположении, должны перенести файлы в `C:\Program Files\ClaudeCode\managed-settings.json`.
115 </Warning>
116 417
117 Управляемые параметры на основе файлов также поддерживают каталог drop-in в `managed-settings.d/` в том же системном каталоге рядом с `managed-settings.json`. Это позволяет отдельным командам развертывать независимые фрагменты политики без координации редактирования одного файла.418<h3 id="compare-the-scope-of-each-settings-file">
118 419 Сравните область действия каждого файла параметров
119 Следуя соглашению systemd, `managed-settings.json` объединяется первым как база, затем все файлы `*.json` в каталоге drop-in сортируются в алфавитном порядке и объединяются сверху. Более поздние файлы переопределяют более ранние для скалярных значений; массивы объединяются и дедублицируются; объекты глубоко объединяются. Скрытые файлы, начинающиеся с `.`, игнорируются.
120
121 Используйте числовые префиксы для управления порядком объединения, например `10-telemetry.json` и `20-security.json`.
122
123 См. [управляемые параметры](/docs/ru/permissions#managed-only-settings) и [Управляемая конфигурация MCP](/docs/ru/managed-mcp) для получения подробной информации.
124
125 Этот [репозиторий](https://github.com/anthropics/claude-code/tree/main/examples/mdm) включает начальные шаблоны развертывания для Jamf, Iru (Kandji), Intune и Group Policy. Используйте их как отправные точки и адаптируйте их в соответствии с вашими потребностями.
126
127 <Note>
128 Управляемые развертывания также могут ограничивать **добавления на marketplace plugins** с помощью `strictKnownMarketplaces`. Для получения дополнительной информации см. [Управляемые ограничения marketplace](/docs/ru/plugin-marketplaces#managed-marketplace-restrictions).
129 </Note>
130* **Другая конфигурация** хранится в `~/.claude.json`. Этот файл содержит ваш сеанс OAuth, конфигурации [MCP server](/docs/ru/mcp) для областей пользователя и локальной области, состояние для каждого проекта (разрешенные инструменты, параметры доверия) и различные кэши. MCP servers с областью проекта хранятся отдельно в `.mcp.json`.
131
132<Note>
133 Claude Code автоматически создает резервные копии файлов конфигурации с временными метками и сохраняет пять самых последних резервных копий для предотвращения потери данных.
134</Note>
135
136```JSON Пример settings.json theme={null}
137{
138 "$schema": "https://json.schemastore.org/claude-code-settings.json",
139 "permissions": {
140 "allow": [
141 "Bash(npm run lint)",
142 "Bash(npm run test *)",
143 "Read(~/.zshrc)"
144 ],
145 "deny": [
146 "Bash(curl *)",
147 "Read(./.env)",
148 "Read(./.env.*)",
149 "Read(./secrets/**)"
150 ]
151 },
152 "env": {
153 "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
154 "OTEL_METRICS_EXPORTER": "otlp"
155 },
156 "companyAnnouncements": [
157 "Welcome to Acme Corp! Review our code guidelines at docs.acme.com",
158 "Reminder: Code reviews required for all PRs",
159 "New security policy in effect"
160 ]
161}
162```
163
164Строка `$schema` в примере выше указывает на [официальную JSON-схему](https://json.schemastore.org/claude-code-settings.json) для параметров Claude Code. Добавление ее в ваш `settings.json` включает автодополнение и встроенную валидацию в VS Code, Cursor и любом другом редакторе, поддерживающем валидацию JSON-схемы.
165
166Опубликованная схема обновляется периодически и может не включать параметры, добавленные в самых последних выпусках CLI, поэтому предупреждение валидации о недавно задокументированном поле не обязательно означает, что ваша конфигурация недействительна.
167
168<h3 id="when-edits-take-effect">
169 Когда изменения вступают в силу
170</h3>
171
172Claude Code отслеживает ваши файлы параметров и перезагружает их при изменении, поэтому изменения большинства ключей применяются к текущему сеансу без перезагрузки. Это включает `permissions`, `hooks` и помощники учетных данных, такие как `apiKeyHelper`. Перезагрузка охватывает параметры пользователя, проекта, локальные и управляемые параметры, и [hook `ConfigChange`](/docs/ru/hooks#configchange) срабатывает для каждого обнаруженного изменения.
173
174Несколько ключей читаются один раз при запуске сеанса и применяются при следующей перезагрузке:
175
176* `model`: используйте [`/model`](/docs/ru/model-config#setting-your-model) для переключения в середине сеанса
177* [`outputStyle`](/docs/ru/output-styles): часть системного запроса, который перестраивается на `/clear` или перезагрузке
178
179<h3 id="invalid-entries-in-managed-settings">
180 Недействительные записи в управляемых параметрах
181</h3>420</h3>
182 421
183Управляемые параметры анализируются с допуском. Когда управляемая конфигурация содержит запись, которая не проходит валидацию схемы, Claude Code удаляет эту запись, записывает предупреждение и применяет каждую оставшуюся действительную политику. Одна опечатка не может отключить остальную политику вашей организации. Запустите [`/doctor`](/docs/ru/debug-your-config#check-resolved-settings), чтобы увидеть список удаленных записей с их исходным файлом и полем.422Предположим, у вас есть три проекта на вашей машине: `website/`, `api/` и `acme-app/`, товарищ по команде имеет свой собственный клон `acme-app/`, и вы запускаете [облачный сеанс](#settings-in-cloud-sessions) на `acme-app/`.
184 423
185Это поведение согласуется во всех трех механизмах доставки: [параметры, управляемые сервером](/docs/ru/server-managed-settings), политики plist и реестра, развернутые через MDM, и файлы `managed-settings.json`. Требует Claude Code v2.1.169 или позже.424На графике ниже показано, в каких из этих папок применяется параметр при запуске Claude Code из них. Нажмите на файл параметров, чтобы увидеть папки, которые он охватывает.
186 425
187Поля применения безопасности обрабатываются для каждого поля вместо полного удаления при наличии, но недействительности:426<SettingsScope />
188 427
189| Поле | Поведение при наличии, но недействительности |428* **`~/.claude/settings.json`**: каждый проект на вашей машине, и ничего на машине вашего товарища или в облачном сеансе
190| :--------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |429* **`acme-app/.claude/settings.json`**: ваш `acme-app/`. Он охватывает клон вашего товарища и облачный сеанс только если вы зафиксируете файл в системе контроля версий; до этого это файл на вашем диске, как и любой другой, и никто другой его не имеет
191| `allowedMcpServers` | Применяется как пустой список разрешений, поэтому MCP servers не допускаются до исправления значения. Отдельная недействительная запись удаляется и применяется действительное подмножество. |430* **`acme-app/.claude/settings.local.json`**: только ваш `acme-app/`. Claude Code добавляет его в ваши глобальные исключения git при первом написании файла, поэтому он остаётся вне ваших коммитов; если вы создадите файл вручную, [добавьте его в `.gitignore` сами](#keep-personal-settings-out-of-a-repository)
192| `allowManagedMcpServersOnly` | Обрабатывается как `true`. |431* **Управляемые параметры**, будь то файл `managed-settings.json`, политика MDM или [управляемые сервером параметры](/docs/ru/server-managed-settings) из консоли claude.ai: каждый проект на каждой машине, на которую ваша организация его развёртывает, или на которую вы входите с учётной записью вашей организации. Только управляемые сервером параметры охватывают облачный сеанс
193| `availableModels` | Применяется как пустой список разрешений, поэтому доступна только модель Default до исправления значения. Отдельная запись, не являющаяся строкой, удаляется и применяется действительное подмножество. Применяется в v2.1.175 и позже. |
194| `enforceAvailableModels` | Обрабатывается как `true`. Применяется в v2.1.175 и позже. |
195| `forceLoginOrgUUID` | Ни одна организация не может войти до исправления значения. |
196| `deniedMcpServers` | Отдельная недействительная запись удаляется и применяется действительное подмножество. Полностью недействительное значение отбрасывается с предупреждением, так как отрицание каждого server заблокировало бы servers, которые политика никогда не называла. |
197| `sandbox.credentials` | Отдельная недействительная запись в `files` или `envVars` удаляется с предупреждением и применяется действительное подмножество. Полностью недействительное значение `credentials` отбрасывается с предупреждением, пока остальная часть `sandbox` по-прежнему применяется. Применяется в v2.1.191 и позже. |
198 432
199`requiredMinimumVersion` и `requiredMaximumVersion` открываются по дизайну: недействительное значение удаляется, а не применяется, поэтому плохая политика не может предотвратить запуск Claude Code.433<span id="which-files-you-have" />
200 434
201Ошибки валидации появляются в трех местах:435<h3 id="find-or-create-your-settings-files">
436 Найдите или создайте ваши файлы параметров
437</h3>
202 438
203* Интерактивные сеансы показывают диалог при запуске, перечисляющий недействительные записи.439Установка Claude Code не создаёт никакой файл параметров. Если на вашей машине или в проекте уже есть один, он пришёл из одного из этих источников:
204* Headless запуски с `-p` выводят сводку в stderr.
205* [`claude doctor`](/docs/ru/debug-your-config) перечисляет каждую недействительную запись с ее источником и полем.
206 440
207Проверьте изменения политики, запустив `claude doctor` на тестовой машине перед развертыванием их по всему парку.441* **Управляемый**: ваша организация его развёртывает. Вы его не создаёте и не редактируете.
442* **Общий проект**: проект, который уже использует Claude Code, может иметь один зафиксированный. Если нет, создайте его в `.claude/settings.json` в папке проекта.
443* **Пользователь** и **Локальный проект**: создайте их сами или позвольте Claude Code их создать. Он записывает `~/.claude/settings.json` при первом изменении опции в меню `/config`, которую он сохраняет в пользовательские параметры, такой как тема, и `.claude/settings.local.json` при первом предоставлении постоянного одобрения на запрос разрешения, такой как "Да, и больше не спрашивайте" для команды Bash. Несколько опций `/config`, включая **Show tips**, сохраняются в `.claude/settings.local.json` вместо файла пользователя.
208 444
209Этот допуск применяется только к управляемым параметрам. Файлы параметров пользователя, проекта и локальные остаются строгими: файл, который не проходит валидацию, отклоняется целиком и сообщается.445<Info>
446 На Windows `~/.claude` означает `%USERPROFILE%\.claude`. Чтобы хранить файлы домашнего каталога в другом месте, установите [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars); Claude Code затем сохраняет ваши параметры, историю сеансов и plugins там вместо этого.
447</Info>
210 448
211<h3 id="available-settings">449Claude Code также хранит пятый файл, [`~/.claude.json`](/docs/ru/claude-directory#ce-claude-json), который он записывает для себя; вам не нужно его редактировать. Он содержит вашу сессию входа, конфигурации [MCP server](/docs/ru/mcp), состояние для каждого проекта, такое как решения о доверии, и [глобальные ключи конфигурации](/docs/ru/settings-reference#global-config-settings), которые `/config` записывает для вас.
212 Доступные параметры
213</h3>
214 450
215`settings.json` поддерживает ряд опций:451<h3 id="share-settings-with-your-team">
216 452 Поделитесь параметрами с вашей командой
217| Ключ | Описание | Пример |
218| :--------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |
219| `advisorModel` | Модель для серверного [инструмента advisor](/docs/ru/advisor). Принимает псевдоним модели, такой как `"opus"`, `"sonnet"` или `"fable"` (v2.1.170+), или полный ID модели. Записывается автоматически при запуске `/advisor`. Отключите, чтобы отключить advisor | `"opus"` |
220| `agent` | Запустить основной поток как именованный subagent и установить агента по умолчанию для сеансов, отправленных из `claude agents`. Применяет системный запрос, ограничения инструментов и модель этого subagent. См. [Явно вызывать subagents](/docs/ru/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |
221| `agentPushNotifEnabled` | **По умолчанию**: `false`. Когда [Remote Control](/docs/ru/remote-control) подключен, разрешить Claude отправлять проактивные push-уведомления на ваш телефон, например когда длительная задача завершается. Появляется в `/config` как **Push when Claude decides**. См. [Mobile push notifications](/docs/ru/remote-control#mobile-push-notifications). Требует Claude Code v2.1.119 или позже | `true` |
222| `allowAllClaudeAiMcps` | (Только управляемые параметры) Загружать разъемы claude.ai наряду с развернутым `managed-mcp.json`, который в противном случае берет исключительный контроль и подавляет их. См. [Управляемая конфигурация MCP](/docs/ru/managed-mcp) | `true` |
223| `allowedChannelPlugins` | (Только управляемые параметры) Список разрешений channel plugins, которые могут отправлять сообщения. Заменяет список разрешений Anthropic по умолчанию при установке. Не определено = вернуться к значению по умолчанию, пустой массив = блокировать все channel plugins. Требует `channelsEnabled: true`. См. [Ограничить, какие channel plugins могут запускаться](/docs/ru/channels#restrict-which-channel-plugins-can-run) | `[{ "marketplace": "claude-plugins-official", "plugin": "telegram" }]` |
224| `allowedHttpHookUrls` | Список разрешенных URL-шаблонов, на которые могут быть направлены HTTP hooks. Поддерживает `*` как подстановочный знак. При установке hooks с несовпадающими URL-адресами блокируются. Не определено = без ограничений, пустой массив = блокировать все HTTP hooks. Массивы объединяются в разных источниках параметров. См. [Конфигурация Hook](#hook-configuration) | `["https://hooks.example.com/*"]` |
225| `allowedMcpServers` | При установке в managed-settings.json, список разрешений MCP servers, которые пользователи могут настроить. Не определено = без ограничений, пустой массив = блокировка. Применяется ко всем областям. Список запретов имеет приоритет. См. [Управляемая конфигурация MCP](/docs/ru/managed-mcp) | `[{ "serverName": "github" }]` |
226| `allowManagedHooksOnly` | (Только управляемые параметры) Загружаются только управляемые hooks, SDK hooks и hooks из plugins, принудительно включенных в управляемых параметрах `enabledPlugins`. Пользовательские, проектные и все остальные plugin hooks блокируются. См. [Конфигурация Hook](#hook-configuration) | `true` |
227| `allowManagedMcpServersOnly` | (Только управляемые параметры) Только `allowedMcpServers` из управляемых параметров учитываются. `deniedMcpServers` по-прежнему объединяется из всех источников. Пользователи по-прежнему могут добавлять MCP servers, но применяется только определенный администратором список разрешений. См. [Управляемая конфигурация MCP](/docs/ru/managed-mcp) | `true` |
228| `allowManagedPermissionRulesOnly` | (Только управляемые параметры) Предотвратить определение правил разрешений `allow`, `ask` или `deny` в параметрах пользователя и проекта. Применяются только правила в управляемых параметрах. См. [Параметры только для управляемых](/docs/ru/permissions#managed-only-settings) | `true` |
229| `alwaysThinkingEnabled` | Включить [расширенное мышление](/docs/ru/model-config#extended-thinking) по умолчанию для всех сеансов. Обычно настраивается через команду `/config` вместо прямого редактирования. Чтобы принудительно отключить мышление независимо от этого параметра, установите [`MAX_THINKING_TOKENS=0`](/docs/ru/env-vars) в `env`, что отключает мышление на Anthropic API, кроме Fable 5, которая не может отключить мышление. На [поставщиках третьих сторон](/docs/ru/third-party-integrations) это опускает параметр `thinking` вместо этого, и модели адаптивного рассуждения все еще могут думать | `true` |
230| `apiKeyHelper` | Пользовательский скрипт, который будет выполнен в системной оболочке (`/bin/sh` на macOS и Linux, `cmd` на Windows), для создания значения аутентификации. Это значение будет отправлено как заголовки `X-Api-Key` и `Authorization: Bearer` для запросов модели. Установите интервал обновления с помощью [`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/docs/ru/env-vars) | `/bin/generate_temp_api_key.sh` |
231| `askUserQuestionTimeout` | **По умолчанию**: `"never"`. Время простоя перед тем, как неотвеченный диалог [`AskUserQuestion`](/docs/ru/tools-reference) автоматически продолжится с любыми уже выбранными вами опциями. Принимает `"60s"`, `"5m"`, `"10m"` или `"never"`. По умолчанию вопросы ждут, пока вы на них ответите. Появляется в `/config` как **Question auto-continue timeout**, который записывает этот ключ в параметры пользователя. Не читается из параметров проекта или локальных параметров. Требует Claude Code v2.1.200 или позже | `"5m"` |
232| `attribution` | Настройте атрибуцию для коммитов git и pull requests. См. [Параметры атрибуции](#attribution-settings) | `{"commit": "🤖 Generated with Claude Code", "pr": ""}` |
233| `autoCompactEnabled` | **По умолчанию**: `true`. Автоматически компактировать разговор, когда контекст приближается к лимиту. Появляется в `/config` как **Auto-compact**. Чтобы отключить через переменную окружения, установите [`DISABLE_AUTO_COMPACT`](/docs/ru/env-vars) в `env` | `false` |
234| `autoMemoryDirectory` | Пользовательский каталог для хранения [автоматической памяти](/docs/ru/memory#storage-location). Принимает абсолютный путь или путь с префиксом `~/`. Из параметров проекта или локальных параметров это учитывается только после того, как вы примете диалог доверия рабочей области, так как клонированный репозиторий может предоставить этот файл | `"~/my-memory-dir"` |
235| `autoMemoryEnabled` | **По умолчанию**: `true`. Включить [автоматическую память](/docs/ru/memory#enable-or-disable-auto-memory). Когда `false`, Claude не читает и не записывает в каталог автоматической памяти. Вы также можете переключить это с помощью `/memory` во время сеанса. Чтобы отключить через переменную окружения, установите [`CLAUDE_CODE_DISABLE_AUTO_MEMORY`](/docs/ru/env-vars) в `env` | `false` |
236| `autoMode` | Настройте, что классификатор [автоматического режима](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) блокирует и разрешает. Содержит массивы `environment`, `allow`, `soft_deny` и `hard_deny` правил в виде текста. Включите буквальную строку `"$defaults"` в массив для наследования встроенных правил в этой позиции. См. [Настройте автоматический режим](/docs/ru/auto-mode-config). Читается из параметров пользователя, флага `--settings` и управляемых параметров только. Игнорируется в проекте `.claude/settings.json` и локальном `.claude/settings.local.json`. До v2.1.207, `.claude/settings.local.json` также читался | `{"soft_deny": ["$defaults", "Never run terraform apply"]}` |
237| `autoMode.classifyAllShell` | **По умолчанию**: `false`. Когда `true`, приостанавливает каждое правило разрешения Bash и PowerShell, пока активен автоматический режим, поэтому все команды shell маршрутизируются через классификатор, а не только правила, которые соответствуют шаблонам произвольного выполнения кода. См. [Маршрутизировать все команды shell через классификатор](/docs/ru/auto-mode-config#route-all-shell-commands-through-the-classifier). Требует Claude Code v2.1.193 или позже | `true` |
238| `autoScrollEnabled` | **По умолчанию**: `true`. В [fullscreen rendering](/docs/ru/fullscreen), следить за новым выводом в конец разговора. Появляется в `/config` как **Auto-scroll**. Запросы разрешений по-прежнему прокручиваются в поле зрения, когда это отключено | `false` |
239| `autoUpdatesChannel` | **По умолчанию**: `"latest"`. Канал выпуска для отслеживания обновлений. Используйте `"stable"` для версии, которая обычно примерно на неделю старше и пропускает версии с серьезными регрессиями, или `"latest"` для самого последнего выпуска. Чтобы полностью отключить автоматические обновления, установите [`DISABLE_AUTOUPDATER`](/docs/ru/setup#disable-auto-updates) в `env` | `"stable"` |
240| `availableModels` | Ограничить, какие модели пользователи могут выбрать для основного сеанса, [subagents](/docs/ru/sub-agents), [skills](/docs/ru/skills) и [advisor](/docs/ru/advisor). Не влияет на опцию Default, если также не установлен `enforceAvailableModels`. См. [Ограничить выбор модели](/docs/ru/model-config#restrict-model-selection) | `["sonnet", "haiku"]` |
241| `awaySummaryEnabled` | Показать одностроковое резюме сеанса при возврате в терминал после нескольких минут отсутствия. Установите на `false` или отключите Session recap в `/config` для отключения. То же самое, что [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/docs/ru/env-vars) | `true` |
242| `awsAuthRefresh` | Пользовательский скрипт, который изменяет каталог `.aws` (см. [расширенная конфигурация учетных данных](/docs/ru/amazon-bedrock#advanced-credential-configuration)) | `aws sso login --profile myprofile` |
243| `awsCredentialExport` | Пользовательский скрипт, который выводит JSON с учетными данными AWS (см. [расширенная конфигурация учетных данных](/docs/ru/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |
244| `axScreenReader` | Отображать вывод, удобный для программ чтения с экрана: плоский текст без декоративных границ или анимаций. Режим программы чтения с экрана всегда использует классический рендерер, поэтому параметр `tui` не имеет эффекта, пока он активен; прикрепленные [фоновые сеансы](/docs/ru/agent-view) по-прежнему отображаются в полноэкранном режиме. Переменная окружения [`CLAUDE_AX_SCREEN_READER`](/docs/ru/env-vars) и флаг [`--ax-screen-reader`](/docs/ru/cli-reference#cli-flags) имеют приоритет. Требует Claude Code v2.1.181 или позже | `true` |
245| `blockedMarketplaces` | (Только управляемые параметры) Список запретов источников marketplace. Применяется при добавлении marketplace и при установке, обновлении, обновлении и автоматическом обновлении plugin, поэтому marketplace, добавленный до установки политики, не может быть использован для получения plugins. Заблокированные источники проверяются перед загрузкой, поэтому они никогда не касаются файловой системы. См. [Управляемые ограничения marketplace](/docs/ru/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |
246| `browserExternalPageTools` | (Только управляемые параметры) Установите на `"disabled"`, чтобы предотвратить использование Claude инструментов для чтения или действия на внешних страницах в [Browser pane](/docs/ru/desktop#browse-external-sites) приложения desktop. Пользователи по-прежнему могут самостоятельно переходить на внешние сайты, и локальные предпросмотры dev server не затронуты | `"disabled"` |
247| `channelsEnabled` | (Только управляемые параметры) Разрешить [channels](/docs/ru/channels) для организации. На планах Claude.ai Team и Enterprise, channels блокируются, когда это не установлено или `false`. Для учетных записей [Anthropic Console](/docs/ru/authentication#claude-console-authentication), использующих аутентификацию по ключу API, channels разрешены по умолчанию, если только ваша организация не развернула управляемые параметры, в этом случае этот ключ должен быть установлен на `true` | `true` |
248| `claudeMd` | (Только управляемые параметры) Инструкции в стиле CLAUDE.md, внедренные как организационная управляемая память. Учитываются только при установке в управляемых или политических параметрах и игнорируются в параметрах пользователя, проекта и локальных параметрах. См. [организационная CLAUDE.md](/docs/ru/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |
249| `claudeMdExcludes` | Glob шаблоны или абсолютные пути файлов `CLAUDE.md` для пропуска при загрузке [памяти](/docs/ru/memory). Шаблоны соответствуют абсолютным путям файлов. Применяется только к памяти пользователя, проекта и локальной памяти; файлы управляемой политики не могут быть исключены | `["**/vendor/**/CLAUDE.md"]` |
250| `cleanupPeriodDays` | **По умолчанию**: `30` дней, минимум `1`. Claude Code удаляет [файлы сеансов и другие данные приложения](/docs/ru/claude-directory#cleaned-up-automatically) старше этого периода при запуске. Установка `0` отклоняется с ошибкой валидации. Один и тот же возрастной порог применяется к автоматическому удалению [orphaned worktrees](/docs/ru/worktrees#clean-up-worktrees) при запуске. Если Claude Code не может прочитать или разобрать файл параметров, он приостанавливает очистку удержания и показывает предупреждение в `/status` до тех пор, пока вы не исправите файл, если только [управляемые параметры](/docs/ru/server-managed-settings) не предоставляют `cleanupPeriodDays`, в этом случае очистка выполняется при управляемом значении. До v2.1.203 очистка выполнялась при значении по умолчанию 30 дней в этом состоянии и могла удалить стенограммы, которые более длительный `cleanupPeriodDays` был предназначен для сохранения; файлы новее 30 дней никогда не удалялись. Чтобы полностью отключить запись стенограмм, установите переменную окружения [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/ru/env-vars). В неинтерактивном режиме передайте `--no-session-persistence` вместе с `-p` или установите `persistSession: false` в Agent SDK. | `20` |
251| `companyAnnouncements` | Объявление для отображения пользователям при запуске. Если предоставлено несколько объявлений, они будут циклически отображаться случайным образом. | `["Welcome to Acme Corp! Review our code guidelines at docs.acme.com"]` |
252| `defaultShell` | **По умолчанию**: `"bash"`, или `"powershell"` на Windows, когда Bash недоступен. Оболочка по умолчанию для команд `!` в поле ввода. Принимает `"bash"` или `"powershell"`. Установка `"powershell"` направляет интерактивные команды `!` через PowerShell на Windows. Требует `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. См. [Инструмент PowerShell](/docs/ru/tools-reference#powershell-tool) | `"powershell"` |
253| `deniedMcpServers` | При установке в managed-settings.json, список запретов MCP servers, которые явно заблокированы. Применяется ко всем областям, включая управляемые servers. Список запретов имеет приоритет над списком разрешений. См. [Управляемая конфигурация MCP](/docs/ru/managed-mcp) | `[{ "serverName": "filesystem" }]` |
254| `disableAgentView` | Установите на `true`, чтобы отключить [фоновые агенты и представление агента](/docs/ru/agent-view): `claude agents`, `--bg`, `/background` и супервизор по требованию. Обычно устанавливается в [управляемых параметрах](/docs/ru/permissions#managed-settings). Эквивалентно установке `CLAUDE_CODE_DISABLE_AGENT_VIEW` на `1` | `true` |
255| `disableAllHooks` | Отключить все [hooks](/docs/ru/hooks) и любую пользовательскую [строку состояния](/docs/ru/statusline) | `true` |
256| `disableArtifact` | Установите на `true`, чтобы отключить инструмент [Artifact](/docs/ru/artifacts), который публикует вывод сеанса как приватную веб-страницу на claude.ai. Эквивалентно установке `CLAUDE_CODE_DISABLE_ARTIFACT` на `1` | `true` |
257| `disableAutoMode` | Установите на `"disable"`, чтобы предотвратить активацию [автоматического режима](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode). Удаляет `auto` из цикла `Shift+Tab` и отклоняет `--permission-mode auto` при запуске. Наиболее полезно в [управляемых параметрах](/docs/ru/permissions#managed-settings), где пользователи не могут его переопределить | `"disable"` |
258| `disableBrowserExternalNavigation` | (Только управляемые параметры) Установите на `true`, чтобы отключить внешний просмотр в [Browser pane](/docs/ru/desktop#browse-external-sites) приложения desktop. Ни пользователи, ни Claude не могут переходить на внешние сайты, и локальные предпросмотры dev server не затронуты. Значение должно быть JSON логическое значение `true`; строка `"true"` игнорируется | `true` |
259| `disableBundledSkills` | Установите на `true`, чтобы отключить [skills](/docs/ru/skills) и workflows, которые поставляются с Claude Code: встроенные skills и workflows полностью удаляются, в то время как встроенные slash commands, такие как `/init`, остаются доступными для ввода, но скрыты от модели. `/doctor` остается доступным для ввода, как встроенные slash commands; скройте его с помощью [`DISABLE_DOCTOR_COMMAND`](/docs/ru/env-vars) вместо этого. Skills из plugins, `.claude/skills/` и `.claude/commands/` не затронуты. Эквивалентно установке `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` на `1` | `true` |
260| `disableClaudeAiConnectors` | Отключить [claude.ai MCP connectors](/docs/ru/mcp#use-mcp-servers-from-claude-ai), чтобы они не загружались автоматически и не подключались. Установите в любой области параметров. `true` в любом источнике имеет приоритет, поэтому проверенный в проекте `.claude/settings.json` может отключить репозиторий от облачных разъемов, но уровень проекта `false` не может переопределить уровень пользователя или политики `true`. Servers, переданные явно через `--mcp-config`, не затронуты. Чтобы запретить отдельные разъемы вместо всех, используйте [`deniedMcpServers`](/docs/ru/managed-mcp). Требует Claude Code v2.1.182 или позже | `true` |
261| `disableDeepLinkRegistration` | Установите на `"disable"`, чтобы предотвратить регистрацию Claude Code обработчика протокола `claude-cli://` с операционной системой при запуске. Deep links позволяют внешним инструментам открыть сеанс Claude Code с предварительно заполненным запросом. Полезно в окружениях, где регистрация обработчика протокола ограничена или управляется отдельно | `"disable"` |
262| `disabledMcpjsonServers` | Список конкретных MCP servers из файлов `.mcp.json` для отклонения | `["filesystem"]` |
263| `disableRemoteControl` | Отключить [Remote Control](/docs/ru/remote-control): блокирует `claude remote-control`, флаг `--remote-control`, автозапуск и переключение в сеансе. Обычно размещается в [управляемых параметрах](/docs/ru/permissions#managed-settings) для применения MDM на каждом устройстве, но работает из любой области. Требует Claude Code v2.1.128 или позже | `true` |
264| `disableSideloadFlags` | (Только управляемые параметры) Отклонить флаги CLI `--plugin-dir`, `--plugin-url`, `--agents` и `--mcp-config` при запуске, которые пользователи могли бы в противном случае передать для обхода [`strictKnownMarketplaces`](#strictknownmarketplaces) для одного запуска. Также отклоняет эти флаги из любой поверхности, которая порождает CLI с ними внутри, в настоящее время [Cowork](/docs/ru/desktop) локальные сеансы в приложении desktop. `--mcp-config`, чьи servers все являются in-process записями `type: "sdk"`, по-прежнему принимается, поэтому Agent SDK и расширение VS Code продолжают работать. Не блокирует `claude mcp add`, `.mcp.json` или SDK `setMcpServers()`; объедините с [`allowedMcpServers`](/docs/ru/managed-mcp) для управления MCP для каждого server. Требует Claude Code v2.1.193 или позже | `true` |
265| `disableSkillShellExecution` | Отключить встроенное выполнение shell для `` !`...` `` и ` ```! ` блоков в [skills](/ru/skills) и пользовательских команд из источников пользователя, проекта, plugin или дополнительного каталога. Команды заменяются на `[shell command execution disabled by policy]` вместо выполнения. Встроенные и управляемые skills не затронуты. Наиболее полезно в [управляемых параметрах](/ru/permissions#managed-settings), где пользователи не могут его переопределить | `true` |
266| `disableWorkflows` | **По умолчанию**: `false`. Отключить [динамические workflows](/docs/ru/workflows#turn-workflows-off) и встроенные команды workflow. Эквивалентно установке `CLAUDE_CODE_DISABLE_WORKFLOWS` на `1` | `true` |
267| `editorMode` | **По умолчанию**: `"normal"`. Режим сочетания клавиш для входного приглашения: `"normal"` или `"vim"`. Появляется в `/config` как **Editor mode** | `"vim"` |
268| `effortLevel` | Сохранить [уровень усилий](/docs/ru/model-config#adjust-effort-level) между сеансами. Принимает `"low"`, `"medium"`, `"high"` или `"xhigh"`. Записывается автоматически при запуске `/effort` с одним из этих значений. `--effort` и [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ru/env-vars) переопределяют это на один сеанс. См. [Отрегулировать уровень усилий](/docs/ru/model-config#adjust-effort-level) для поддерживаемых моделей | `"xhigh"` |
269| `enableAllProjectMcpServers` | Автоматически одобрить все MCP servers, определенные в файлах проекта `.mcp.json`. Начиная с v2.1.196, `claude mcp list` и `claude mcp get` учитывают этот ключ в ненадежной папке только из [файлов параметров, которые не проверяются в репозитории](/docs/ru/mcp#managing-your-servers) | `true` |
270| `enableArtifact` | Включить или отключить инструмент [Artifact](/docs/ru/artifacts) для этого пользователя. Когда не установлено, значение по умолчанию следует [доступности](/docs/ru/artifacts#availability) функции для вашей учетной записи. Строка **Artifacts** в `/config` записывает этот ключ. Управляемый `disableArtifact` и [параметр администратора](/docs/ru/artifacts#manage-artifacts-for-your-organization) вашей организации имеют приоритет, и ключ игнорируется в параметрах проекта и локальных параметрах (`.claude/settings.json`, `.claude/settings.local.json`), которые репозиторий мог бы в противном случае зафиксировать. Требует Claude Code v2.1.196 или позже | `true` |
271| `enabledMcpjsonServers` | Список конкретных MCP servers из файлов `.mcp.json` для одобрения. Начиная с v2.1.196, `claude mcp list` и `claude mcp get` учитывают этот ключ в ненадежной папке только из [файлов параметров, которые не проверяются в репозитории](/docs/ru/mcp#managing-your-servers) | `["memory", "github"]` |
272| `enforceAvailableModels` | Расширить список разрешений `availableModels` на модель Default. Когда `true` в управляемых параметрах и `availableModels` - это непустой массив, опция Default возвращается к первой разрешенной записи, которая доступна, но только когда модель Default, которая будет разрешена (организационное значение по умолчанию, когда оно применяется, иначе значение по умолчанию для типа учетной записи), не находится в списке разрешений; разрешенное значение по умолчанию сохраняется как есть. Не имеет эффекта, когда `availableModels` не установлен или пуст. См. [Ограничить выбор модели](/docs/ru/model-config#restrict-model-selection) для поддерживаемых моделей | `true` |
273| `env` | Переменные окружения, применяемые к каждому сеансу и к подпроцессам, которые Claude Code порождает из него. Установите переменную на `""`, чтобы переопределить экспорт оболочки пустой строкой, которую Claude Code обрабатывает как неустановленную для выбора поставщика. Подпроцессы по-прежнему наследуют пустое значение. `NO_COLOR` и `FORCE_COLOR`, установленные здесь, достигают только подпроцессов; чтобы изменить цвета собственного интерфейса Claude Code, установите их в вашей оболочке перед запуском `claude`. Начиная с v2.1.195, переменные идентификации, которые устанавливают окружения хостинга Claude Code, например `CLAUDE_CODE_REMOTE` и `CLAUDE_CODE_ACCOUNT_UUID`, игнорируются при установке здесь | `{"FOO": "bar"}` |
274| `fallbackModel` | Резервная модель(и) для попытки по порядку, когда основная модель перегружена или недоступна. Claude Code переключается на следующую доступную модель в цепи для остальной части хода и показывает уведомление. `"default"` расширяется до модели по умолчанию. Цепи ограничены тремя моделями; дополнительные записи игнорируются. В отличие от большинства параметров массива, этот ключ не объединяется в разных файлах параметров: файл с наивысшим приоритетом, который его определяет, предоставляет всю цепь. Флаг [`--fallback-model`](/docs/ru/cli-reference#cli-flags) переопределяет это на один сеанс. См. [Цепи резервных моделей](/docs/ru/model-config#fallback-model-chains) | `["claude-sonnet-5", "claude-haiku-4-5"]` |
275| `fastMode` | Включить [быстрый режим](/docs/ru/fast-mode) для сеансов, где он доступен. Переключение с помощью `/fast` записывает `true` здесь в параметры пользователя и удаляет ключ при отключении быстрого режима | `true` |
276| `fastModePerSessionOptIn` | Когда `true`, быстрый режим не сохраняется между сеансами. Каждый сеанс начинается с отключенным быстрым режимом, требуя от пользователей включить его с помощью `/fast`. Предпочтение быстрого режима пользователя по-прежнему сохраняется. См. [Требовать согласие для каждого сеанса](/docs/ru/fast-mode#require-per-session-opt-in) | `true` |
277| `feedbackSurveyRate` | Вероятность (0–1) того, что [опрос качества сеанса](/docs/ru/data-usage#session-quality-surveys) появится при наличии условий. Установите на `0`, чтобы полностью подавить, или установите [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](/docs/ru/env-vars) в `env`. Полезно при использовании Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, где частота выборки по умолчанию не применяется | `0.05` |
278| `fileCheckpointingEnabled` | **По умолчанию**: `true`. Снимок файлов перед каждым редактированием, чтобы [`/rewind`](/docs/ru/checkpointing) мог их восстановить. Появляется в `/config` как **Rewind code (checkpoints)**. Чтобы отключить через переменную окружения, установите [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](/docs/ru/env-vars) в `env` | `false` |
279| `fileSuggestion` | Настройте пользовательский скрипт для автодополнения файлов `@`. См. [Параметры предложения файлов](#file-suggestion-settings) | `{"type": "command", "command": "~/.claude/file-suggestion.sh"}` |
280| `footerLinksRegexes` | Отображать дополнительные кликабельные значки в нижнем колонтитуле, когда регулярное выражение совпадает с выводом хода. Каждая запись имеет `pattern`, шаблон `url` с заполняемыми `{name}` плейсхолдерами из именованных групп захвата и необязательный `label`. Читается из параметров пользователя, флага `--settings` и управляемых параметров только. См. [Значки ссылок нижнего колонтитула](#footer-link-badges) для ограничений URL, списка разрешений схемы и лимитов. Требует Claude Code v2.1.176 или позже | `[{"type": "regex", "pattern": "\\b(?<key>PROJ-\\d+)\\b", "url": "https://issues.example.com/browse/{key}", "label": "{key}"}]` |
281| `forceLoginMethod` | Используйте `claudeai` для ограничения входа учетными записями Claude.ai, `console` для ограничения входа учетными записями Claude Console, или `gateway` для ограничения входа на облачный шлюз; см. [Claude apps gateway](/docs/ru/claude-apps-gateway). Когда установлено в управляемых параметрах, сеансы, аутентифицированные по `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, блокируются при запуске, так как ни одно значение не может быть удовлетворено без первоначальной OAuth. Сеансы поставщиков третьих сторон, такие как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, не блокируются: они аутентифицируются против вашего облачного провайдера, а не Anthropic | `claudeai` |
282| `forceLoginGatewayUrl` | Предварительно заполняет и блокирует URL шлюза на экране `/login` Cloud gateway. Либо этот ключ, либо `forceLoginMethod: "gateway"` отображает этот экран; установите оба, чтобы URL был заполнен. Учитывается только на управляемом уровне политики; игнорируется в параметрах пользователя и проекта. См. [Claude apps gateway](/docs/ru/claude-apps-gateway#set-the-gateway-url) | `"https://claude-gateway.example.com"` |
283| `forceLoginOrgUUID` | Требовать, чтобы вход принадлежал определенной организации Anthropic. Принимает одну строку UUID, которая также предварительно выбирает эту организацию во время входа, или массив UUID, где любая указанная организация принимается без предварительного выбора. При установке в управляемых параметрах вход не удается, если аутентифицированная учетная запись не принадлежит указанной организации, и сеансы, аутентифицированные по `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, блокируются при запуске, так как членство в организации не может быть проверено для них. Сеансы поставщиков третьих сторон, такие как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, не блокируются: используйте IAM вашего облачного провайдера для ограничения того, какие облачные учетные записи могут быть использованы. Пустой массив не удается закрыто и блокирует вход с сообщением о неправильной конфигурации | `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"` или `["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"]` |
284| `forceRemoteSettingsRefresh` | (Только управляемые параметры) Блокировать запуск CLI до тех пор, пока удаленные управляемые параметры не будут свежо получены с сервера. Если получение не удается, CLI выходит вместо продолжения с кэшированными или отсутствующими параметрами. Когда не установлено, запуск продолжается без ожидания удаленных параметров. См. [fail-closed enforcement](/docs/ru/server-managed-settings#enforce-fail-closed-startup) | `true` |
285| `gcpAuthRefresh` | Пользовательский скрипт, который обновляет GCP Application Default Credentials при их истечении или невозможности загрузки. См. [расширенная конфигурация учетных данных](/docs/ru/google-vertex-ai#advanced-credential-configuration) | `gcloud auth application-default login` |
286| `hooks` | Настройте пользовательские команды для запуска при событиях жизненного цикла. См. [документацию hooks](/docs/ru/hooks) для формата | См. [hooks](/docs/ru/hooks) |
287| `httpHookAllowedEnvVars` | Список разрешенных имен переменных окружения, которые HTTP hooks могут интерполировать в заголовки. При установке эффективный `allowedEnvVars` каждого hook является пересечением с этим списком. Не определено = без ограничений. Массивы объединяются в разных источниках параметров. См. [Конфигурация Hook](#hook-configuration) | `["MY_TOKEN", "HOOK_SECRET"]` |
288| `includeGitInstructions` | **По умолчанию**: `true`. Включить встроенные инструкции рабочего процесса коммита и PR и снимок статуса git в системный запрос Claude. Установите на `false`, чтобы удалить оба, например при использовании собственных skills рабочего процесса git. Переменная окружения `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` имеет приоритет над этим параметром при установке | `false` |
289| `inputNeededNotifEnabled` | **По умолчанию**: `false`. Когда [Remote Control](/docs/ru/remote-control) подключен, отправить push-уведомление на ваш телефон, когда запрос разрешения или вопрос ожидает вашего ввода. Появляется в `/config` как **Push when actions required**. См. [Mobile push notifications](/docs/ru/remote-control#mobile-push-notifications). Требует Claude Code v2.1.119 или позже | `true` |
290| `language` | Настройте предпочитаемый язык ответов Claude (например, `"japanese"`, `"spanish"`, `"french"`). Claude будет отвечать на этом языке по умолчанию. Также устанавливает язык [голосового диктанта](/docs/ru/voice-dictation#change-the-dictation-language) и автоматически созданных названий сеансов. Начиная с v2.1.176, когда не установлено, названия сеансов соответствуют языку вашего разговора | `"japanese"` |
291| `minimumVersion` | Предотвратить понижение версии автоматического обновления ниже определенной версии. Переключение с канала `"latest"` на `"stable"` через `/config` предлагает вам остаться на текущей версии или разрешить понижение. Выбор остаться устанавливает это значение. Также полезно в [управляемых параметрах](/docs/ru/permissions#managed-settings) для закрепления организационного минимума. Для жесткого предела, который блокирует запуск целиком, см. `requiredMinimumVersion` | `"2.1.100"` |
292| `model` | Переопределить модель по умолчанию для использования в Claude Code. `--model` и [`ANTHROPIC_MODEL`](/docs/ru/model-config#environment-variables) переопределяют это на один сеанс | `"claude-sonnet-5"` |
293| `modelOverrides` | Сопоставить ID моделей Anthropic с ID моделей, специфичными для поставщика, такими как ARN профилей вывода Amazon Bedrock. Каждая запись средства выбора модели использует свое сопоставленное значение при вызове API поставщика. См. [Переопределить ID моделей для каждой версии](/docs/ru/model-config#override-model-ids-per-version) | `{"claude-opus-4-6": "arn:aws:bedrock:..."}` |
294| `otelHeadersHelper` | Скрипт для создания динамических заголовков OpenTelemetry. Запускается при запуске и периодически. Установите интервал обновления с помощью [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/docs/ru/env-vars). См. [Динамические заголовки](/docs/ru/monitoring-usage#dynamic-headers) | `/bin/generate_otel_headers.sh` |
295| `outputStyle` | Настройте стиль вывода для корректировки системного запроса. См. [документацию стилей вывода](/docs/ru/output-styles) | `"Explanatory"` |
296| `parentSettingsBehavior` | (Только управляемые параметры) **По умолчанию**: `"first-wins"`. Контролирует, применяются ли управляемые параметры, предоставленные программно процессом хоста встраивания, таким как Agent SDK или расширение IDE, когда также присутствует развернутый администратором управляемый уровень. `"first-wins"`: параметры, предоставленные родителем, отбрасываются и применяется только уровень администратора. `"merge"`: параметры, предоставленные родителем, применяются под уровнем администратора, отфильтрованные так, чтобы они могли ужесточить политику, но не ослабить ее. Не имеет эффекта, когда развернут администратором уровень. Требует Claude Code v2.1.133 или позже | `"merge"` |
297| `permissions` | См. таблицу ниже для структуры разрешений. | |
298| `plansDirectory` | **По умолчанию**: `~/.claude/plans`. Настройте, где хранятся файлы плана. Путь относительно корня проекта. | `"./plans"` |
299| `pluginSuggestionMarketplaces` | (Только управляемые параметры) Имена marketplace, чьи plugins могут появляться как контекстные предложения установки. Ни одно предложение, объявленное marketplace, не появляется без этого списка разрешений; встроенный совет по дизайну первой стороны не затронут. Предложения поступают из объявления `relevance` каждого plugin в его записи marketplace. Имя вступает в силу только когда marketplace зарегистрирован на машине и его зарегистрированный источник также объявлен в управляемых параметрах, либо как запись `extraKnownMarketplaces` для этого имени, либо как запись `strictKnownMarketplaces`. Marketplace, зарегистрированный из другого источника под разрешенным именем, игнорируется. Официальный marketplace освобожден от требования источника: разрешение его имени одного достаточно, так как это имя может регистрироваться только из официального источника Anthropic. | `["acme-corp-plugins"]` |
300| `pluginTrustMessage` | (Только управляемые параметры) Пользовательское сообщение, добавленное к предупреждению о доверии plugin, показываемому перед установкой. Используйте это для добавления контекста, специфичного для организации, например для подтверждения того, что plugins из вашего внутреннего marketplace проверены. | `"All plugins from our marketplace are approved by IT"` |
301| `policyHelper` | Развернутый администратором исполняемый файл, который вычисляет управляемые параметры динамически при запуске. Учитывается только из MDM или системного файла `managed-settings.json`. См. [Вычислить управляемые параметры с помощью помощника политики](#compute-managed-settings-with-a-policy-helper). Требует Claude Code v2.1.136 или позже | `{"path": "/usr/local/bin/claude-policy"}` |
302| `preferredNotifChannel` | **По умолчанию**: `"auto"`. Метод для уведомлений о завершении задачи и запросов разрешения: `"auto"`, `"terminal_bell"`, `"iterm2"`, `"iterm2_with_bell"`, `"kitty"`, `"ghostty"` или `"notifications_disabled"`. `"auto"` отправляет уведомление рабочего стола в iTerm2, Ghostty и Kitty и ничего не делает в других терминалах. Установите `"terminal_bell"` для звонка в любом терминале. Появляется в `/config` как **Notifications**. См. [Получить звонок терминала или уведомление](/docs/ru/terminal-config#get-a-terminal-bell-or-notification) | `"terminal_bell"` |
303| `prefersReducedMotion` | Уменьшить или отключить анимацию пользовательского интерфейса (спиннеры, shimmer, эффекты вспышки) для доступности | `true` |
304| `prUrlTemplate` | Шаблон URL для значка PR, показываемого в нижнем колонтитуле и в сводках результатов инструмента. Заменяет `{host}`, `{owner}`, `{repo}`, `{number}` и `{url}` из URL PR, сообщаемого `gh`. Используйте для указания ссылок PR на внутренний инструмент проверки кода вместо `github.com`. Не влияет на автоссылки `#123` в прозе Claude | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |
305| `remoteControlAtStartup` | Подключить [Remote Control](/docs/ru/remote-control) автоматически при запуске каждого интерактивного сеанса, вместо ожидания `/remote-control`. Установите на `true`, чтобы всегда автоподключаться, `false`, чтобы никогда не автоподключаться, или оставьте неустановленным, чтобы следовать значению по умолчанию вашей организации. Появляется в `/config` как **Enable Remote Control for all sessions**. См. [Enable Remote Control for all sessions](/docs/ru/remote-control#enable-remote-control-for-all-sessions) | `false` |
306| `requiredMaximumVersion` | Только управляемые параметры. Максимальная версия Claude Code, разрешенная для запуска. Если запущенная версия новее, Claude Code выходит при запуске и инструктирует пользователя установить одобренную версию через одобренный метод организации; `claude install <version>` также может работать. Фоновые автоматические обновления и `claude update` пропускают версии выше потолка, поэтому установка в диапазоне остается в диапазоне. `claude update`, `claude install` и `claude doctor` продолжают работать выше потолка, чтобы пользователи могли восстановиться. Версии, которые предшествуют этому параметру, игнорируют его | `"2.1.150"` |
307| `requiredMinimumVersion` | Только управляемые параметры. Минимальная версия Claude Code, требуемая для запуска. Если запущенная версия старше, Claude Code выходит при запуске и инструктирует пользователя обновить через одобренный метод организации. `claude update`, `claude install` и `claude doctor` продолжают работать ниже пола, чтобы пользователи могли восстановиться. Отличается от `minimumVersion`, который предотвращает понижение, но никогда не блокирует запуск. Версии, которые предшествуют этому параметру, игнорируют его | `"2.1.150"` |
308| `respectGitignore` | **По умолчанию**: `true`. Контролировать, соблюдает ли средство выбора файлов `@` шаблоны `.gitignore`. Когда `true`, файлы, соответствующие шаблонам `.gitignore`, исключаются из предложений | `false` |
309| `respondToBashCommands` | **По умолчанию**: `true`. Отвечает ли Claude после запуска команды shell с префиксом `!` в поле ввода. Установите на `false`, чтобы добавить вывод команды в контекст без ответа. См. [Shell mode with `!` prefix](/docs/ru/interactive-mode#shell-mode-with-prefix). Требует Claude Code v2.1.186 или позже | `false` |
310| `showClearContextOnPlanAccept` | **По умолчанию**: `false`. Показать опцию "очистить контекст" на экране принятия плана. Установите на `true`, чтобы восстановить опцию | `true` |
311| `showThinkingSummaries` | **По умолчанию**: `false`. Показать [расширенное мышление](/docs/ru/model-config#extended-thinking) резюме в интерактивных сеансах. Когда не установлено или `false`, блоки мышления редактируются API и показываются как свернутая заглушка. Редактирование изменяет только то, что вы видите, а не то, что генерирует модель: чтобы снизить расходы на мышление, [снизьте бюджет или отключите мышление](/docs/ru/model-config#extended-thinking) вместо этого. Этот параметр не имеет эффекта в неинтерактивном режиме (`-p`), Agent SDK или расширениях IDE, таких как VS Code | `true` |
312| `showTurnDuration` | **По умолчанию**: `true`. Показывать сообщения о продолжительности хода после ответов, например "Cooked for 1m 6s". Появляется в `/config` как **Show turn duration** | `false` |
313| `skillListingBudgetFraction` | **По умолчанию**: `0.01`. Доля окна контекста модели, зарезервированная для [списка skills](/docs/ru/skills#skill-descriptions-are-cut-short), который видит Claude каждый ход. Когда список превышает бюджет, описания для наименее используемых skills сворачиваются до простых имен, чтобы Claude все еще мог их вызывать, но не видел бы, почему. Увеличьте, чтобы сохранить больше описаний видимыми за счет большего контекста за ход. `/doctor` показывает текущее количество усечений и какие skills затронуты. Требует Claude Code v2.1.105 или позже | `0.02` |
314| `skillListingMaxDescChars` | **По умолчанию**: `1536`. Ограничение количества символов для каждого skill на объединенный текст `description` и `when_to_use` в [списке skills](/docs/ru/skills#skill-descriptions-are-cut-short), который видит Claude каждый ход. Текст длиннее этого усекается. Увеличьте, чтобы сохранить длинные описания в целости за счет большего контекста за ход; уменьшьте, чтобы вместить больше skills в рамках [`skillListingBudgetFraction`](#available-settings). Требует Claude Code v2.1.105 или позже | `2048` |
315| `skillOverrides` | {{/* min-version: 2.1.129 */}}Переопределения видимости для каждого skill, ключ которых - имя skill. Значение - `"on"`, `"name-only"`, `"user-invocable-only"` или `"off"`. Позволяет скрыть или свернуть skill без редактирования его SKILL.md. Не применяется к plugin skills, которые управляются через `/plugin`. Меню `/skills` записывает эти значения в `.claude/settings.local.json`. См. [Переопределить видимость skill из параметров](/docs/ru/skills#override-skill-visibility-from-settings). Требует Claude Code v2.1.129 или позже | `{"legacy-context": "name-only", "deploy": "off"}` |
316| `skipWebFetchPreflight` | Пропустить [проверку безопасности домена WebFetch](/docs/ru/data-usage#webfetch-domain-safety-check), которая отправляет каждое запрашиваемое имя хоста на `api.anthropic.com` перед выборкой. Установите на `true` в окружениях, которые блокируют трафик к Anthropic, таких как развертывания Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry с ограничивающим исходящим трафиком. При пропуске WebFetch пытается любой URL без консультации со списком блокировок | `true` |
317| `spinnerTipsEnabled` | **По умолчанию**: `true`. Показывать советы в спиннере, пока Claude работает. Установите на `false`, чтобы отключить советы | `false` |
318| `spinnerTipsOverride` | Переопределить советы спиннера пользовательскими строками. `tips`: массив строк советов. `excludeDefault`: если `true`, показывать только пользовательские советы; если `false` или отсутствует, пользовательские советы объединяются со встроенными советами | `{ "excludeDefault": true, "tips": ["Use our internal tool X"] }` |
319| `spinnerVerbs` | Настройте глаголы действия, показываемые в спиннере во время хода. Установите `mode` на `"replace"`, чтобы использовать только ваши глаголы, или `"append"`, чтобы добавить их к значениям по умолчанию | `{"mode": "append", "verbs": ["Pondering", "Crafting"]}` |
320| `sshConfigs` | SSH подключения для отображения в раскрывающемся списке окружения [Desktop](/docs/ru/desktop#pre-configure-ssh-connections-for-your-team). Каждая запись требует `id`, `name` и `sshHost`; `sshPort`, `sshIdentityFile` и `startDirectory` являются необязательными. При установке в управляемых параметрах подключения доступны только для чтения для пользователей. Читается только из управляемых и пользовательских параметров | `[{"id": "dev-vm", "name": "Dev VM", "sshHost": "user@dev.example.com"}]` |
321| `statusLine` | Настройте пользовательскую строку состояния для отображения контекста. Поле объекта `padding`, `refreshInterval` и `hideVimModeIndicator` управляют интервалом, периодическими повторными запусками и тем, скрыт ли встроенный индикатор режима vim ниже приглашения. См. [документацию `statusLine`](/docs/ru/statusline#manually-configure-a-status-line) | `{"type": "command", "command": "~/.claude/statusline.sh"}` |
322| `strictKnownMarketplaces` | (Только управляемые параметры) Список разрешений источников marketplace plugins. Не определено = без ограничений, пустой массив = блокировка. Применяется при добавлении marketplace и при установке, обновлении, обновлении и автоматическом обновлении plugin, поэтому marketplace, добавленный до установки политики, не может быть использован для получения plugins. Заблокированные источники проверяются перед загрузкой, поэтому они никогда не касаются файловой системы. См. [Управляемые ограничения marketplace](/docs/ru/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |
323| `strictPluginOnlyCustomization` | (Только управляемые параметры) Блокировать skills, agents, hooks и MCP servers из источников пользователя и проекта, поэтому они могут поступать только из plugins или управляемых параметров. `true` блокирует все четыре поверхности; массив блокирует только названные. См. [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | `["skills", "hooks"]` |
324| `syntaxHighlightingDisabled` | Отключить подсветку синтаксиса в дифах, блоках кода и предпросмотрах файлов | `true` |
325| `teammateMode` | **По умолчанию**: `in-process`. Как отображаются товарищи по [команде агентов](/docs/ru/agent-teams): `in-process`, `auto` (разделенные панели в tmux или iTerm2, в процессе в противном случае), `tmux` (разделенные панели с использованием tmux или iTerm2, обнаруженные из вашего терминала), или }`iterm2` (iTerm2 native split panes via the `it2` CLI, added in v2.1.186). По умолчанию изменилось с `auto` в v2.1.179. `--teammate-mode` переопределяет это на один сеанс. См. [выбрать режим отображения](/docs/ru/agent-teams#choose-a-display-mode) | `"auto"` |
326| `terminalProgressBarEnabled` | **По умолчанию**: `true`. Показывать полосу прогресса терминала в поддерживаемых терминалах: ConEmu, Ghostty 1.2.0+ и iTerm2 3.6.6+. Появляется в `/config` как **Terminal progress bar** | `false` |
327| `theme` | {{/* min-version: 2.1.119 */}}**По умолчанию**: `"dark"`. Цветовая тема для интерфейса: `"auto"`, `"dark"`, `"light"`, `"dark-daltonized"`, `"light-daltonized"`, `"dark-ansi"`, `"light-ansi"` или ссылка на пользовательскую тему, такая как `"custom:<slug>"` или `"custom:<plugin-name>:<slug>"`. См. [Создать пользовательскую тему](/docs/ru/terminal-config#create-a-custom-theme). Появляется в `/config` как **Theme** | `"dark"` |
328| `tui` | Средство визуализации Terminal UI. Используйте `"fullscreen"` для безмерцающего [alt-screen renderer](/docs/ru/fullscreen) с виртуализированной прокруткой. Используйте `"default"` для классического main-screen renderer. Установите через `/tui`. Вы также можете установить переменную окружения [`CLAUDE_CODE_NO_FLICKER`](/docs/ru/env-vars). Фоновые сеансы, открытые из [представления агента](/docs/ru/agent-view), всегда используют fullscreen renderer независимо от этого параметра | `"fullscreen"` |
329| `ultracode` | Включить [ultracode](/docs/ru/workflows#let-claude-decide-with-ultracode) для сеанса. Этот ключ не читается из `settings.json`. Установите через `/effort ultracode`, `--settings` или запрос управления Agent SDK. {{/* min-version: 2.1.203 */}}Чтобы запустить сеанс с уже включенным ultracode, запустите с `claude --effort ultracode`, что требует Claude Code v2.1.203 или позже | `true` |
330| `useAutoModeDuringPlan` | **По умолчанию**: `true`. Использует ли Plan Mode семантику автоматического режима, когда автоматический режим доступен. Не читается из общих параметров проекта. Появляется в `/config` как "Use auto mode during plan" | `false` |
331| `verbose` | {{/* min-version: 2.1.119 */}}**По умолчанию**: `false`. Показать полный вывод инструмента вместо усеченных сводок. Появляется в `/config` как **Verbose output**. Флаг `--verbose` переопределяет это на один сеанс | `true` |
332| `viewMode` | Режим просмотра стенограммы по умолчанию при запуске: `"default"`, `"verbose"` или `"focus"`. Переопределяет липкий выбор `/focus` при установке. Флаг `--verbose` переопределяет это на один сеанс | `"verbose"` |
333| `vimInsertModeRemaps` | {{/* min-version: 2.1.208 */}}Сопоставить двухклавишные последовательности режима INSERT с Escape в [режиме редактора vim](/docs/ru/interactive-mode#vim-editor-mode). Каждый ключ - это ровно два печатаемых символа, введенные последовательно, и `"<Esc>"` - единственная поддерживаемая цель; другие записи игнорируются. Читается из параметров пользователя, флага `--settings` и управляемых параметров только, поэтому проверенные в репозитории параметры не могут переопределить ваши сочетания клавиш. Не имеет эффекта, если `editorMode` не `"vim"`. См. [Переопределить сочетания клавиш режима INSERT](/docs/ru/interactive-mode#remap-insert-mode-key-sequences). Требует Claude Code v2.1.208 или позже | `{"jj": "<Esc>"}` |
334| `voice` | Параметры [голосового диктанта](/docs/ru/voice-dictation): `enabled` включает диктант, `mode` выбирает `"hold"` или `"tap"`, и `autoSubmit` отправляет запрос при отпускании клавиши в режиме hold. Записывается автоматически при запуске `/voice`. Требует учетную запись Claude.ai | `{ "enabled": true, "mode": "tap" }` |
335| `voiceEnabled` | Устаревший псевдоним для `voice.enabled`. Предпочитайте объект `voice` | `true` |
336| `wheelScrollAccelerationEnabled` | {{/* min-version: 2.1.174 */}}**По умолчанию**: `true`. В [fullscreen rendering](/docs/ru/fullscreen#mouse-wheel-scrolling), ускорить скорость прокрутки колеса мыши во время быстрой прокрутки. Установите на `false` для постоянной скорости прокрутки за один оборот колеса. Требует Claude Code v2.1.174 или позже | `false` |
337| `workflowKeywordTriggerEnabled` | {{/* min-version: 2.1.157 */}}**По умолчанию**: `true`. Вызывает ли слово `ultracode` в запросе [динамический workflow](/docs/ru/workflows#ask-for-a-workflow-in-your-prompt). Установите на `false`, чтобы вводить слово без срабатывания. Ultracode, `/workflows` и сохраненные команды workflow не затронуты. Появляется в `/config` как **Ultracode keyword trigger**. Добавлено в v2.1.157; до v2.1.160 ключевое слово триггера было `workflow` | `false` |
338| `wslInheritsWindowsSettings` | (Только управляемые параметры Windows) Когда `true`, Claude Code на WSL читает управляемые параметры из цепочки политик Windows в дополнение к `/etc/claude-code`, с приоритетом источников Windows. Учитывается только при установке в ключе реестра HKLM или `C:\Program Files\ClaudeCode\managed-settings.json`, оба из которых требуют администратора Windows для записи. Чтобы политика HKCU также применялась на WSL, флаг должен быть дополнительно установлен в самом HKCU. Не влияет на нативный Windows | `true` |
339
340<h3 id="global-config-settings">
341 Параметры глобальной конфигурации
342</h3>453</h3>
343 454
344Эти параметры хранятся в `~/.claude.json` вместо `settings.json`. Добавление их в `settings.json` вызовет ошибку валидации схемы.455Зафиксируйте `.claude/settings.json`, чтобы все, кто клонирует репозиторий, получили одинаковые разрешения, hooks, телеметрию и plugins. Каждый товарищ по команде всё ещё может переопределить его для себя в своём собственном `.claude/settings.local.json`, поэтому личные исключения не нуждаются в коммите. Для полного файла команды см. [общие параметры команды](/docs/ru/settings-example#a-teams-shared-settings).
345 456
346<Note>457Некоторые из того, что вы зафиксируете, ждут, пока каждый товарищ по команде [доверит папку](/docs/ru/permissions#project-allow-rules-and-workspace-trust), и несколько ключей никогда не вступают в силу из файла репозитория; [Troubleshoot a setting that doesn't apply](#common-cases) охватывает оба случая.
347 Версии до v2.1.119 также хранят ряд ключей предпочтений `/config` здесь вместо `settings.json`, включая `theme`, `verbose`, `editorMode`, `autoCompactEnabled` и `preferredNotifChannel`.
348</Note>
349 458
350| Ключ | Описание | Пример |459<span id="local-settings-file" />
351| :--------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- |
352| `autoConnectIde` | **По умолчанию**: `false`. Автоматически подключаться к запущенной IDE при запуске Claude Code из внешнего терминала. Появляется в `/config` как **Auto-connect to IDE (external terminal)** при запуске вне терминала VS Code или JetBrains. Переменная окружения [`CLAUDE_CODE_AUTO_CONNECT_IDE`](/docs/ru/env-vars) переопределяет это при установке | `true` |
353| `autoInstallIdeExtension` | **По умолчанию**: `true`. Автоматически устанавливать расширение Claude Code IDE при запуске из терминала VS Code. Появляется в `/config` как **Auto-install IDE extension** при запуске внутри терминала VS Code или JetBrains. Вы также можете установить переменную окружения [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/docs/ru/env-vars) на `1` | `false` |
354| `externalEditorContext` | **По умолчанию**: `false`. Добавить предыдущий ответ Claude как контекст с комментариями `#` при открытии внешнего редактора с помощью `Ctrl+G`. Появляется в `/config` как **Show last response in external editor** | `true` |
355| `permissionExplainerEnabled` | **По умолчанию**: `true`. Показать объяснение, созданное моделью, [команды](/docs/ru/permissions#permission-system) при нажатии `Ctrl+E` на запросе разрешения Bash или PowerShell. Установите на `false`, чтобы отключить сочетание клавиш | `false` |
356| `teammateDefaultModel` | Модель по умолчанию для товарищей по [команде агентов](/docs/ru/agent-teams) когда запрос порождения не указывает одну. Установите на псевдоним модели, такой как `"sonnet"`, или `null` для наследования текущего выбора `/model` лидера. Появляется в `/config` как **Default teammate model** | `"sonnet"` |
357| `workflowSizeGuideline` | {{/* min-version: 2.1.202 */}}**По умолчанию**: `unrestricted`, который не отправляет никакого руководства. Устанавливает [количество агентов, на которое Claude нацелен](/docs/ru/workflows#set-a-size-guideline) в динамических workflows, которые он пишет. Claude Code отправляет значение Claude как совет, а не как принудительный лимит. Принимает `unrestricted`, `small`, `medium` или `large`. Появляется в `/config` как **Dynamic workflow size**. Вы также можете установить его напрямую с помощью `/config workflowSizeGuideline=small`. Требует Claude Code v2.1.202 или позже. {{/* min-version: 2.1.203 */}}Руководство по количеству агентов также заменяет порог по умолчанию для [предупреждения `Large workflow`](/docs/ru/workflows#cost); это поведение требует Claude Code v2.1.203 или позже | `"small"` |
358
359<h3 id="worktree-settings">
360 Параметры Worktree
361</h3>
362 460
363Настройте, как `--worktree` создает и управляет git worktrees.461<span id="where-claude-code-saves-the-project-local-file" />
364 462
365| Ключ | Описание | Пример |463<span id="the-project-local-file" />
366| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |
367| `worktree.baseRef` | Какой ref новые worktrees ветвятся от. `"fresh"` (по умолчанию) ветвится от `origin/<default-branch>` для чистого дерева, соответствующего удаленному. `"head"` ветвится от вашего текущего локального `HEAD`, поэтому неотправленные коммиты и состояние ветки функции присутствуют в worktree. Внутри связанного worktree, `"head"` разрешается в `HEAD` этого worktree, а не в основной проверке. Применяется к `--worktree`, инструменту `EnterWorktree` и изоляции subagent | `"head"` |
368| `worktree.symlinkDirectories` | Каталоги для создания символических ссылок из основного репозитория в каждый worktree, чтобы избежать дублирования больших каталогов на диске. По умолчанию никакие каталоги не создаются символическими ссылками | `["node_modules", ".cache"]` |
369| `worktree.sparsePaths` | Каталоги для проверки в каждом worktree через git sparse-checkout. На диск записываются только перечисленные пути, что быстрее в больших монорепозиториях. Пока существует разреженный worktree, git включает `extensions.worktreeConfig` в общий файл `.git/config` репозитория; см. [Проверить только нужные вам каталоги](/docs/ru/large-codebases#check-out-only-the-directories-you-need) | `["packages/my-app", "shared/utils"]` |
370| `worktree.bgIsolation` | {{/* min-version: 2.1.143 */}}Режим изоляции для [фоновых сеансов](/docs/ru/agent-view#how-file-edits-are-isolated). `"worktree"` (по умолчанию) блокирует `Edit`/`Write` в основной проверке до вызова `EnterWorktree`. {{/* min-version: 2.1.203 */}}Вне git репозитория, [hook `WorktreeCreate`](/docs/ru/worktrees#non-git-version-control), который не удается, освобождает блок, чтобы сеанс мог редактировать рабочий каталог на месте; требует Claude Code v2.1.203 или позже. `"none"` позволяет фоновым заданиям редактировать рабочую копию напрямую. Требует Claude Code v2.1.143 или позже | `"none"` |
371 464
372Чтобы скопировать файлы, игнорируемые gitignore, такие как `.env`, в новые worktrees, используйте [файл `.worktreeinclude`](/docs/ru/worktrees#copy-gitignored-files-into-worktrees) в корне вашего проекта вместо параметра.465<span id="keep-personal-settings-out-of-the-repository" />
373 466
374<h3 id="permission-settings">467<h3 id="keep-personal-settings-out-of-a-repository">
375 Параметры разрешений468 Держите личные параметры вне репозитория
376</h3>469</h3>
377 470
378| Ключи | Описание | Пример |471Чтобы изменить параметр для себя в одном проекте без изменения его для товарищей по команде, сохраните его в `.claude/settings.local.json` внутри проекта. Claude Code применяет этот файл поверх зафиксированного `.claude/settings.json`, поэтому если файл вашей команды устанавливает `"model": "claude-sonnet-5"` и вы хотите Opus, поместите `"model": "claude-opus-4-8"` в ваш локальный файл и только ваши сеансы изменятся.
379| :---------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------- |
380| `allow` | Массив правил разрешений для разрешения использования инструмента. Глобусы имен инструментов поддерживаются только в позиции инструмента после буквального префикса `mcp__<server>__`, такого как `mcp__github__get_*`; сегмент сервера должен быть без глобусов. См. [Синтаксис правила разрешения](#permission-rule-syntax) ниже для деталей сопоставления шаблонов | `[ "Bash(git diff *)" ]` |
381| `ask` | Массив правил разрешений для запроса подтверждения при использовании инструмента. См. [Синтаксис правила разрешения](#permission-rule-syntax) ниже | `[ "Bash(git push *)" ]` |
382| `deny` | Массив правил разрешений для запрета использования инструмента. Используйте это для исключения чувствительных файлов из доступа Claude Code. Имена инструментов принимают глобусы: `"*"` запрещает каждый инструмент и `"mcp__*"` запрещает все MCP инструменты. См. [Синтаксис правила разрешения](#permission-rule-syntax) и [Ограничения разрешений Bash](/docs/ru/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |
383| `additionalDirectories` | Дополнительные [рабочие каталоги](/docs/ru/permissions#working-directories) для доступа к файлам. Большинство конфигурации `.claude/` [не обнаруживается](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) из этих каталогов | `[ "../docs/" ]` |
384| `defaultMode` | Режим [разрешения](/docs/ru/permission-modes) по умолчанию при открытии Claude Code. Допустимые значения: `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` и {{/* min-version: 2.1.200 */}}`manual` как псевдоним для `default`, режим, обозначенный как Manual в CLI и расширениях VS Code и JetBrains. Псевдоним `manual` требует Claude Code v2.1.200 или позже. {{/* min-version: 2.1.142 */}}`auto` игнорируется при установке в параметрах проекта или локальных параметрах, поэтому репозиторий не может предоставить себе автоматический режим; установите его в `~/.claude/settings.json` вместо этого. До v2.1.142 параметры проекта могли устанавливать `auto`. Флаг CLI `--permission-mode` переопределяет этот параметр для одного сеанса | `"acceptEdits"` |
385| `disableBypassPermissionsMode` | Установите на `"disable"`, чтобы предотвратить активацию режима `bypassPermissions`. Это отключает флаг командной строки `--dangerously-skip-permissions`. Обычно размещается в [управляемых параметрах](/docs/ru/permissions#managed-settings) для применения организационной политики, но работает из любой области | `"disable"` |
386| `skipDangerousModePermissionPrompt` | Пропустить подтверждение, показываемое перед входом в режим обхода разрешений через `--dangerously-skip-permissions` или `defaultMode: "bypassPermissions"`. Игнорируется при установке в параметрах проекта (`.claude/settings.json`) для предотвращения автоматического обхода подтверждения ненадежными репозиториями | `true` |
387
388<h3 id="permission-rule-syntax">
389 Синтаксис правила разрешения
390</h3>
391 472
392Правила разрешения следуют формату `Tool` или `Tool(specifier)`. Правила оцениваются по порядку: сначала правила deny, затем ask, затем allow. Первое совпадающее правило определяет результат независимо от специфичности правила. См. [порядок оценки правила разрешения](/docs/ru/permissions#manage-permissions) для деталей.473Три вещи, которые нужно знать о локальном файле:
393 474
394Быстрые примеры:475* **Claude Code также его записывает.** Когда Claude просит разрешение запустить команду Bash и вы выбираете "Да, и больше не спрашивайте", Claude Code сохраняет это [одобрение разрешения](/docs/ru/permissions#permission-system) здесь как правило `allow`.
476* **Вам не нужно его gitignore самостоятельно, если только вы не создали его вручную.** При первом написании файла Claude Code в репозитории git, который его ещё не игнорирует, он добавляет `**/.claude/settings.local.json` в ваш глобальный файл исключений git, поэтому файл остаётся вне ваших коммитов в каждом репозитории. Этот файл — это `core.excludesFile`, когда ваша глобальная конфигурация git устанавливает его на абсолютный путь или путь с префиксом `~`; в противном случае это `$XDG_CONFIG_HOME/git/ignore`, или `~/.config/git/ignore`, когда `XDG_CONFIG_HOME` не установлен. Если вы создали файл вручную и Claude Code ещё не писал в него, добавьте его в `.gitignore` сами.
477* **Его правила allow не ждут доверия, пока файл остаётся неотслеживаемым.** Поскольку файл принадлежит вам, а не репозиторию, Claude Code применяет его правила `allow` без шага [workspace trust](/docs/ru/permissions#project-allow-rules-and-workspace-trust), который он требует для зафиксированного файла. Если файл отслеживается git, шаг доверия применяется к нему также; см. [When your local settings file needs trust](/docs/ru/permissions#when-your-local-settings-file-needs-trust).
395 478
396| Правило | Эффект |479<span id="where-claude-code-looks-for-each-file" />
397| :----------------------------- | :----------------------------------------------- |
398| `Bash` | Соответствует всем командам Bash |
399| `Bash(npm run *)` | Соответствует командам, начинающимся с `npm run` |
400| `Read(./.env)` | Соответствует чтению файла `.env` |
401| `WebFetch(domain:example.com)` | Соответствует запросам fetch к example.com |
402 480
403Для полного справочника синтаксиса правил, включая поведение подстановочных знаков, шаблоны, специфичные для инструментов, для Read, Edit, WebFetch, MCP и Agent правил, а также ограничения безопасности шаблонов Bash, см. [Синтаксис правила разрешения](/docs/ru/permissions#permission-rule-syntax).481<span id="how-claude-code-keeps-the-local-file-out-of-git" />
404 482
405<h3 id="sandbox-settings">483<span id="local-allow-rules-dont-wait-for-workspace-trust" />
406 Параметры Sandbox
407</h3>
408 484
409Настройте расширенное поведение sandboxing. Sandboxing изолирует команды bash от вашей файловой системы и сети. См. [Sandboxing](/docs/ru/sandboxing) для деталей.485<h4 id="where-claude-code-keeps-the-local-file-in-a-git-repository">
410 486 Где Claude Code хранит локальный файл в репозитории git
411| Ключи | Описание | Пример |
412| :------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |
413| `enabled` | Включить bash sandboxing (macOS, Linux и WSL2). По умолчанию: false | `true` |
414| `failIfUnavailable` | Выход с ошибкой при запуске, если `sandbox.enabled` равно true, но sandbox не может запуститься (отсутствуют зависимости или неподдерживаемая платформа). Когда false (по умолчанию), выводится предупреждение и команды выполняются без sandbox. Предназначено для развертываний управляемых параметров, требующих sandboxing как жесткого шлюза | `true` |
415| `autoAllowBashIfSandboxed` | Автоматически одобрить команды bash при sandboxing. По умолчанию: true | `true` |
416| `excludedCommands` | Команды, которые должны выполняться вне sandbox | `["docker *"]` |
417| `allowUnsandboxedCommands` | Разрешить командам выполняться вне sandbox через параметр `dangerouslyDisableSandbox`. Когда установлено на `false`, люк `dangerouslyDisableSandbox` полностью отключен и все команды должны выполняться в sandbox (или быть в `excludedCommands`). Полезно для корпоративных политик, требующих строгого sandboxing. По умолчанию: true | `false` |
418| `filesystem.allowWrite` | Дополнительные пути, где команды в sandbox могут писать. Массивы объединяются во всех областях параметров: пути пользователя, проекта и управляемые пути объединяются, не заменяются. Также объединяются с путями из правил разрешения `Edit(...)`. См. [префиксы пути sandbox](#sandbox-path-prefixes) ниже. | `["/tmp/build", "~/.kube"]` |
419| `filesystem.denyWrite` | Пути, где команды в sandbox не могут писать. Массивы объединяются во всех областях параметров. Также объединяются с путями из правил разрешения `Edit(...)`. | `["/etc", "/usr/local/bin"]` |
420| `filesystem.denyRead` | Пути, где команды в sandbox не могут читать. Массивы объединяются во всех областях параметров. Также объединяются с путями из правил разрешения `Read(...)`. | `["~/.aws/credentials"]` |
421| `filesystem.allowRead` | Пути для повторного разрешения чтения в пределах регионов `denyRead`. Путь `allowRead` повторно открывает чтение внутри более широкого региона `denyRead`, и точный путь в `denyRead` остается заблокированным внутри более широкого `allowRead`; см. [таблицу перекрытия](/docs/ru/sandboxing#configure-sandboxing) для примеров. Массивы объединяются во всех областях параметров. Используйте это для создания шаблонов доступа для чтения только рабочей области. | `["."]` |
422| `filesystem.allowManagedReadPathsOnly` | (Только управляемые параметры) Только пути `allowRead` из управляемых параметров учитываются. `denyRead` по-прежнему объединяется из всех источников. По умолчанию: false | `true` |
423| `credentials.files` | {{/* min-version: 2.1.187 */}}Файлы учетных данных или каталоги, которые команды в sandbox не могут читать. Применяет тот же блок чтения, что и `filesystem.denyRead`; отдельный ключ держит пути учетных данных сгруппированными с `credentials.envVars` и отдельно от общих правил файловой системы. Каждая запись - это `{ "path": "...", "mode": "deny" }`, и `deny` - единственный поддерживаемый режим для файлов. Пути используют те же [префиксы](#sandbox-path-prefixes), что и параметры `filesystem.*`. Массивы объединяются во всех областях параметров. Требует Claude Code v2.1.187 или позже. | `[{ "path": "~/.aws/credentials", "mode": "deny" }]` |
424| `credentials.envVars` | {{/* min-version: 2.1.187 */}}Переменные окружения для [защиты от команд в sandbox](/docs/ru/sandboxing#protect-credentials). Каждая запись имеет `name` и `mode`; имя должно начинаться с буквы или подчеркивания и содержать только буквы, цифры и подчеркивания. `deny` удаляет переменную из окружения команд в sandbox. Требует Claude Code v2.1.187 или позже. {{/* min-version: 2.1.199 */}}`mask` заменяет переменную значением-дозорным для каждого сеанса внутри sandbox, пока прокси sandbox подставляет реальное значение на исходящих запросах к записям `injectHosts` этой записи; это требует `network.tlsTerminate` и Claude Code v2.1.199 или позже. Записи `mask` учитываются только из параметров пользователя, управляемых или CLI `--settings`, а не из `.claude/settings.json` или `.claude/settings.local.json`. Массивы объединяются во всех областях параметров, и `deny` имеет приоритет, когда одна переменная появляется с обоими режимами. | `[{ "name": "GITHUB_TOKEN", "mode": "deny" }]` |
425| `credentials.envVars[].injectHosts` | Хосты, где прокси sandbox подставляет реальное значение записи `mask`. Каждый хост также должен быть покрыт `network.allowedDomains`, либо точно, либо подстановочным знаком. Когда не установлено, прокси подставляет значение на запросы каждому хосту в `network.allowedDomains`. Принимается, но игнорируется, когда `mode` - `deny`. Требует Claude Code v2.1.199 или позже. {{/* min-version: 2.1.199 */}} | `["api.github.com"]` |
426| `credentials.allowPlaintextInject` | Разрешить подстановку `mask` на простых HTTP запросах, а также на TLS-завершенных HTTPS. На простом HTTP восходящая идентификация не проверена и учетные данные путешествуют в открытом виде, поэтому оставьте это отключенным вне доверенных тестовых сетей. Учитывается только из параметров пользователя, управляемых или CLI `--settings`, а не из `.claude/settings.json` или `.claude/settings.local.json`. По умолчанию: false. Требует Claude Code v2.1.199 или позже. {{/* min-version: 2.1.199 */}} | `true` |
427| `network.allowUnixSockets` | (Только macOS) Пути Unix socket, доступные в sandbox. Игнорируется на Linux и WSL2, где фильтр seccomp не может проверить пути socket; используйте `allowAllUnixSockets` вместо этого. | `["~/.ssh/agent-socket"]` |
428| `network.allowAllUnixSockets` | Разрешить все подключения Unix socket в sandbox. На Linux и WSL2 это единственный способ разрешить Unix sockets, так как он пропускает фильтр seccomp, который в противном случае блокирует вызовы `socket(AF_UNIX, ...)`. По умолчанию: false | `true` |
429| `network.allowLocalBinding` | Разрешить привязку к портам localhost (только macOS). По умолчанию: false | `true` |
430| `network.allowMachLookup` | Дополнительные имена сервисов XPC/Mach, которые sandbox может искать (только macOS). Поддерживает один завершающий `*` для сопоставления префикса. Требуется для инструментов, которые взаимодействуют через XPC, таких как iOS Simulator или Playwright. | `["com.apple.coresimulator.*"]` |
431| `network.allowedDomains` | Массив доменов для разрешения исходящего сетевого трафика. Поддерживает подстановочные знаки (например, `*.example.com`). | `["github.com", "*.npmjs.org"]` |
432| `network.deniedDomains` | Массив доменов для блокировки исходящего сетевого трафика. Поддерживает тот же синтаксис подстановочных знаков, что и `allowedDomains`. Имеет приоритет над `allowedDomains` при совпадении обоих. Объединяется из всех источников параметров независимо от `allowManagedDomainsOnly`. | `["sensitive.cloud.example.com"]` |
433| `network.allowManagedDomainsOnly` | (Только управляемые параметры) Только `allowedDomains` и правила разрешения `WebFetch(domain:...)` из управляемых параметров учитываются. Домены из параметров пользователя, проекта и локальной области игнорируются. Неразрешенные домены автоматически блокируются без запроса пользователя. Запрещенные домены по-прежнему учитываются из всех источников. По умолчанию: false | `true` |
434| `network.httpProxyPort` | Порт HTTP прокси, используемый, если вы хотите использовать собственный прокси. Если не указано, Claude запустит собственный прокси. | `8080` |
435| `network.socksProxyPort` | Порт SOCKS5 прокси, используемый, если вы хотите использовать собственный прокси. Если не указано, Claude запустит собственный прокси. | `8081` |
436| `network.tlsTerminate` | Экспериментально. Завершить TLS внутри прокси sandbox, чтобы он мог читать содержимое HTTPS запросов. Требуется для [подстановки учетных данных](/docs/ru/sandboxing#protect-credentials) `mask`. Установите `{}` для создания эфемерного центра сертификации для сеанса, или установите `caCertPath` и `caKeyPath` для использования вашего собственного. Учитывается только из параметров пользователя, управляемых или CLI `--settings`, а не из `.claude/settings.json` или `.claude/settings.local.json`. Требует Claude Code v2.1.199 или позже. {{/* min-version: 2.1.199 */}} | `{}` |
437| `enableWeakerNestedSandbox` | Включить более слабый sandbox для непривилегированных окружений Docker (только Linux и WSL2). **Снижает безопасность.** По умолчанию: false | `true` |
438| `enableWeakerNetworkIsolation` | (Только macOS) Разрешить доступ к системной службе доверия TLS (`com.apple.trustd.agent`) в sandbox. Требуется для инструментов на основе Go, таких как `gh`, `gcloud` и `terraform`, для проверки сертификатов TLS при использовании `httpProxyPort` с MITM прокси и пользовательским CA. **Снижает безопасность** путем открытия потенциального пути утечки данных. По умолчанию: false | `true` |
439| `allowAppleEvents` | (Только macOS) Разрешить команды в sandbox отправлять Apple Events. Требуется для `open`, `osascript` и инструментов, которые открывают URL в браузере, которые в противном случае не удаются с ошибкой `-600`. **Удаляет изоляцию выполнения кода.** Команды в sandbox могут запускать другие приложения без sandbox без запроса пользователя; они также могут отправлять команды AppleScript запущенным приложениям, таким как Terminal, в соответствии с запросом согласия на автоматизацию macOS для каждого приложения (TCC). Учитывается только из параметров пользователя, управляемых или CLI, а не из параметров проекта. По умолчанию: false | `true` |
440| `bwrapPath` | (Только управляемые параметры, Linux/WSL2) Абсолютный путь к двоичному файлу bubblewrap (`bwrap`). Переопределяет автоматическое обнаружение через `PATH`. Учитывается только из [управляемых параметров](/docs/ru/settings#settings-files), а не из параметров пользователя или проекта. Полезно, когда `bwrap` установлен в нестандартном местоположении в управляемых окружениях. | `/opt/admin/bwrap` |
441| `socatPath` | (Только управляемые параметры, Linux/WSL2) Абсолютный путь к двоичному файлу `socat`, используемому для прокси сети sandbox. Переопределяет автоматическое обнаружение через `PATH`. Учитывается только из управляемых параметров. | `/opt/admin/socat` |
442
443<h4 id="sandbox-path-prefixes">
444 Префиксы пути Sandbox
445</h4>487</h4>
446 488
447Пути в `filesystem.allowWrite`, `filesystem.denyWrite`, `filesystem.denyRead`, `filesystem.allowRead` и `credentials.files` поддерживают эти префиксы:489Когда Claude просит разрешение запустить команду Bash и вы выбираете "Да, и больше не спрашивайте", Claude Code сохраняет это одобрение как правило `allow` в `.claude/settings.local.json`. Если вы запускаете Claude Code в подкаталоге репозитория git, он читает и записывает этот файл в корень репозитория и применяет одобрение по всему репозиторию. В [worktree](/docs/ru/worktrees) он использует файл в корне основного checkout.
448 490
449| Префикс | Значение | Пример |491Два правила уточняют расположение корня:
450| :-------------------- | :----------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------- |
451| `/` | Абсолютный путь от корня файловой системы | `/tmp/build` остается `/tmp/build` |
452| `~/` | Относительно домашнего каталога | `~/.kube` становится `$HOME/.kube` |
453| `./` или без префикса | Относительно корня проекта для параметров проекта, или к `~/.claude` для параметров пользователя | `./output` в `.claude/settings.json` разрешается в `<project-root>/output` |
454 492
455Более старый префикс `//path` для абсолютных путей по-прежнему работает. Если вы ранее использовали одиночный слэш `/path`, ожидая разрешения относительно проекта, переключитесь на `./path`.493* **Когда файл остаётся с `.claude/settings.json` вместо этого**: вне репозитория git, когда корень репозитория — это ваш домашний каталог, на Windows или когда корень репозитория или его запись `.git` или `.claude` не принадлежит вашему пользователю.
494* **Пути в файле не привязаны к корню репозитория**: правило разрешения, которое начинается с `/` или относительный путь sandbox [привязывается к основному рабочему каталогу сеанса](/docs/ru/permissions#read-and-edit) вместо этого.
456 495
457Этот синтаксис отличается от [правил разрешения Read и Edit](/docs/ru/permissions#read-and-edit), которые используют `//path` для абсолютного и `/path` для относительного к проекту. Пути файловой системы sandbox используют стандартные соглашения: `/tmp/build` - это абсолютный путь.496До v2.1.211 Claude Code хранил файл в начальном каталоге. Он всё ещё читает файл, который более ранняя версия оставила там рядом с файлом корня; где оба устанавливают один и тот же ключ, применяется значение корня, и правила разрешений из обоих файлов применяются. Помощник Agent SDK [`resolveSettings()`](/docs/ru/agent-sdk/typescript#resolvesettings) всегда читает файл из начального каталога.
458 497
459**Пример конфигурации:**498Claude Code читает общий `.claude/settings.json` из [основного рабочего каталога](/docs/ru/permissions#working-directories) сеанса, поэтому для использования файла, зафиксированного в корне репозитория, запустите Claude Code там. После того как вы [переместите сеанс с `/cd`](/docs/ru/permissions#move-the-session-to-another-directory), Claude Code читает оба файла проекта из нового каталога вместо этого, размещая локальный файл по тем же правилам. Чтение их из каталога, в который вы переместились, требует Claude Code v2.1.246 или позже.
460 499
461```json theme={null}500<span id="managed-settings-delivery" />
462{
463 "sandbox": {
464 "enabled": true,
465 "autoAllowBashIfSandboxed": true,
466 "excludedCommands": ["docker *"],
467 "filesystem": {
468 "allowWrite": ["/tmp/build", "~/.kube"],
469 "denyRead": ["~/.aws/credentials"]
470 },
471 "network": {
472 "allowedDomains": ["github.com", "*.npmjs.org", "registry.yarnpkg.com"],
473 "deniedDomains": ["uploads.github.com"],
474 "allowUnixSockets": [
475 "/var/run/docker.sock"
476 ],
477 "allowLocalBinding": true
478 }
479 }
480}
481```
482 501
483**Ограничения файловой системы и сети** можно настроить двумя способами, которые объединяются вместе:502<span id="precedence-within-the-managed-tier" />
484 503
485* **Параметры `sandbox.filesystem`** (показаны выше): Контролируют пути на границе sandbox уровня ОС. Эти ограничения применяются ко всем командам подпроцесса (например, `kubectl`, `terraform`, `npm`), а не только к инструментам файлов Claude.504<span id="parent-settings-from-embedding-hosts" />
486* **Правила разрешений**: Используйте правила разрешения `Edit` allow/deny для управления доступом инструмента файлов Claude, правила `Read` deny для блокировки чтения и правила `WebFetch` allow/deny для управления доменами сети. Пути из этих правил также объединяются в конфигурацию sandbox.
487 505
488<h3 id="attribution-settings">506<span id="enforce-settings-for-an-organization" />
489 Параметры атрибуции
490</h3>
491 507
492Claude Code добавляет атрибуцию к коммитам git и pull requests. Они настраиваются отдельно:508<span id="settings-your-organization-manages" />
493 509
494* Коммиты используют [git trailers](https://git-scm.com/docs/git-interpret-trailers) (например, `Co-Authored-By`) по умолчанию, которые можно настроить или отключить510<h3 id="check-what-your-organization-enforces">
495* Описания pull request - это простой текст511 Проверьте, что ваша организация требует
512</h3>
496 513
497| Ключи | Описание |514Если ваша организация управляет Claude Code, некоторые параметры решены за вас и ничто из того, что вы поместили в ваши собственные файлы, их не изменяет. Чтобы увидеть, какие, запустите `/status`: строка `Setting sources` называет управляемый источник, который применяется к вам. Управляемые параметры применяются везде, где Claude Code работает на этой машине; [What a developer can change](/docs/ru/managed-settings#what-a-developer-can-change) охватывает права локального администратора и инструменты, отличные от Claude Code.
498| :----------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
499| `commit` | Атрибуция для коммитов git, включая любые trailers. Пустая строка скрывает атрибуцию коммита |
500| `pr` | Атрибуция для описаний pull request. Пустая строка скрывает атрибуцию pull request |
501| `sessionUrl` | Добавлять ли ссылку на сеанс claude.ai как trailer `Claude-Session` на коммитах и ссылку в описаниях pull request при запуске из веб-сеанса или сеанса Remote Control. По умолчанию: `true`. Установите на `false`, чтобы опустить ссылку |
502 515
503**Атрибуция коммита по умолчанию:**516Управляемые параметры достигают вас через [механизмы доставки](/docs/ru/managed-settings#delivery-mechanisms) на странице управляемых параметров, чаще всего:
504 517
505```text theme={null}518* [Server-managed settings](/docs/ru/server-managed-settings), которые Claude Code получает из консоли администратора claude.ai или самостоятельно размещённого [Claude apps gateway](/docs/ru/claude-apps-gateway)
506Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>519* Политики MDM или уровня ОС и файлы `managed-settings.json` в системном каталоге
507```520* Хост встраивания, такой как Claude Desktop, через опцию SDK `managedSettings`; см. [Control policy from an embedding host](/docs/ru/managed-settings#parent-settings-from-embedding-hosts)
508 521
509Имя модели в trailer отражает активную модель для сеанса.522В сеансе [Cowork](https://claude.com/docs/cowork/overview), который работает на вашей машине в приложении Claude Desktop, Claude Code не получает управляемые сервером параметры из консоли администратора claude.ai и читает политику, развёрнутую на вашем устройстве, если конфигурация Claude Desktop вашей организации не устанавливает `requireCoworkFullVmSandbox`. [Where and when a policy applies](/docs/ru/managed-settings#where-and-when-a-policy-applies) охватывает Cowork и облачные сеансы.
510 523
511**Атрибуция pull request по умолчанию:**524Если вы администратор, [Set up Claude Code for your organization](/docs/ru/admin-setup) проходит через выбор того, что требуется применить, и [Deploy managed settings](/docs/ru/managed-settings) охватывает доставку и как подтвердить, что политика действует.
512 525
513```text theme={null}526<h2 id="change-a-setting">
514🤖 Generated with [Claude Code](https://claude.com/claude-code)527 Измените параметр
515```528</h2>
516 529
517**Пример:**530Вы можете изменить параметр из меню `/config`, редактируя файл параметров или для одного сеанса из командной строки.
518 531
519```json theme={null}532<span id="system-prompt" />
520{
521 "attribution": {
522 "commit": "Generated with AI\n\nCo-Authored-By: AI <ai@example.com>",
523 "pr": ""
524 }
525}
526```
527 533
528<Note>534Системный запрос Claude Code не опубликован. Чтобы дать Claude постоянные инструкции, используйте файлы [`CLAUDE.md`](/docs/ru/memory) или флаг `--append-system-prompt`.
529 Параметр `attribution` имеет приоритет над устаревшим параметром `includeCoAuthoredBy`. Чтобы скрыть всю атрибуцию, установите `commit` и `pr` на пустые строки и `sessionUrl` на `false`.
530</Note>
531 535
532<h3 id="file-suggestion-settings">536<h3 id="use-the-/config-menu">
533 Параметры предложения файлов537 Используйте меню /config
534</h3>538</h3>
535 539
536Настройте пользовательскую команду для автодополнения пути файла `@`. Встроенное предложение файлов использует быстрый обход файловой системы, но большие монорепозитории могут выиграть от индексирования, специфичного для проекта, такого как предварительно построенный индекс файлов или пользовательские инструменты.540Запустите `/config` внутри Claude Code и откройте вкладку **Config**. Она перечисляет короткий набор личных опций, таких как тема, режим редактора и подробный вывод, не каждый ключ параметров. Выберите опцию для ее изменения; Claude Code сохраняет ее для вас:
537 541
538```json theme={null}542* **Большинство опций**: `~/.claude/settings.json`
539{543* **Несколько опций, таких как Show tips**: `.claude/settings.local.json`
540 "fileSuggestion": {544* **[Глобальные опции конфигурации](/docs/ru/settings-reference#global-config-settings)**: `~/.claude.json`
541 "type": "command",
542 "command": "~/.claude/file-suggestion.sh"
543 }
544}
545```
546
547Команда запускается с теми же переменными окружения, что и [hooks](/docs/ru/hooks), включая `CLAUDE_PROJECT_DIR`. Она получает JSON через stdin с полем `query`:
548
549```json theme={null}
550{"query": "src/comp"}
551```
552
553Выведите пути файлов, разделенные новой строкой, в stdout (в настоящее время ограничено 15):
554 545
555```text theme={null}546Чтобы установить одну опцию без меню, передайте `key=value`, такой как `/config verbose=true`.
556src/components/Button.tsx
557src/components/Modal.tsx
558src/components/Form.tsx
559```
560
561**Пример:**
562 547
563```bash theme={null}548<Note>
564#!/bin/bash549 `/config` является частью интерфейса терминала. Панель чата [VS Code](/docs/ru/vs-code) и [приложение desktop](/docs/ru/desktop) его не открывают; измените параметры там, отредактировав файл параметров или через собственные параметры этих приложений.
565query=$(cat | jq -r '.query')550</Note>
566# Замените your-repo-file-index на вашу собственную команду поиска файлов
567your-repo-file-index --query "$query" | head -20
568```
569 551
570<h3 id="footer-link-badges">552<h3 id="edit-a-settings-file">
571 Значки ссылок нижнего колонтитула553 Отредактируйте файл параметров
572</h3>554</h3>
573 555
574Параметр `footerLinksRegexes` отображает дополнительные кликабельные значки в нижнем колонтитуле ниже поля ввода. Используйте его для преобразования ID, выводимых проектными CLI, такими как инструменты проверки и трекеры проблем, в ссылки сеанса.556Откройте файл параметров для области, которую вы хотите, в вашем редакторе и добавьте или измените ключ. Файлы параметров — это строгий JSON: комментарий `//` или запятая в конце — это синтаксическая ошибка, и Claude Code сообщает файл как [Settings Error](#fix-a-broken-settings-file) при следующем запуске. Например, чтобы позволить Claude Code запускать ваши команды lint и test без запроса и остановить его чтение файлов `.env`, добавьте это в `~/.claude/settings.json`:
575
576Регулярное выражение `pattern` каждой записи сопоставляется с выводом хода: результаты инструментов, включая содержимое файлов и полученные страницы, и собственные ответы Claude. Плейсхолдеры `{name}` в `url` и `label` заполняются из именованных групп захвата в шаблоне.
577
578Следующий пример отображает значок всякий раз, когда ключ проблемы, такой как `PROJ-1234`, появляется в выводе хода. Именованная группа `(?<key>...)` захватывает ключ, и `{key}` подставляет его в URL и метку:
579 557
580```json ~/.claude/settings.json theme={null}558```json ~/.claude/settings.json theme={null}
581{559{
582 "footerLinksRegexes": [560 "$schema": "https://json.schemastore.org/claude-code-settings.json",
583 {561 "permissions": {
584 "type": "regex",562 "allow": [
585 "pattern": "\\b(?<key>PROJ-\\d+)\\b",563 "Bash(npm run lint)",
586 "url": "https://issues.example.com/browse/{key}",564 "Bash(npm run test *)"
587 "label": "{key}"565 ],
588 }566 "deny": [
567 "Read(./.env)",
568 "Read(./.env.*)"
589 ]569 ]
570 }
590}571}
591```572```
592 573
593С этой конфигурацией, когда `PROJ-1234` появляется в результате инструмента или в ответе Claude, чип `PROJ-1234` появляется в нижнем колонтитуле, ссылаясь на `https://issues.example.com/browse/PROJ-1234`.574Каждая запись под `permissions` — это правило, которое называет инструмент и что он может делать; [Настройка разрешений](/docs/ru/permissions) объясняет синтаксис. Строка `$schema` указывает на [опубликованную JSON схему](https://json.schemastore.org/claude-code-settings.json) для параметров Claude Code, которая дает вам автодополнение и встроенную валидацию в VS Code, Cursor и любом другом редакторе, поддерживающем JSON схему. Схема может отставать от самых новых выпусков CLI, поэтому предупреждение валидации на недавно задокументированном ключе не означает, что ваша конфигурация недействительна.
594
595Следующие ограничения применяются к каждой записи:
596 575
597| Ограничение | Поведение |576После сохранения запустите `/status` внутри Claude Code, чтобы подтвердить, что файл загружен; [Подтвердите, что загружено](#check-what-loaded) говорит, что показывает строка `Setting sources` и как сообщается о сломанном файле.
598| :----------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
599| Источник URL | Захваченные значения кодируются в URL, и построенный URL должен совместно использовать источник шаблона. Захват может заполнить сегмент пути или значение запроса, но не может изменить, на что указывает ссылка |
600| Длина URL | Построенные URL длиннее 2048 символов отбрасываются |
601| Схема URL | Должна быть `https`, `http` или признанная схема deep-link редактора или рабочей области: `vscode`, `vscode-insiders`, `cursor`, `windsurf`, `zed`, `jetbrains`, `idea`, `slack`, `linear`, `notion`, `figma` |
602| Метка | По умолчанию совпадает с текстом и усекается до 28 столбцов отображения |
603| Количество значков | Максимум 5 значков отображаются. Самый старый вытесняется новыми совпадениями и `/clear` удаляет их |
604| Область параметров | Читается из параметров пользователя, флага `--settings` и управляемых параметров только. Игнорируется в проекте `.claude/settings.json` и локальном `.claude/settings.local.json` |
605 577
606Когда ход завершается, Claude Code сопоставляет регулярное выражение `pattern` каждой записи с выводом хода на основном потоке, поэтому медленное регулярное выражение блокирует пользовательский интерфейс до завершения. Влож енные квантификаторы, такие как `(a+)+$`, могут занимать экспоненциально долго против определенных входов и замораживать сеанс, поэтому держите каждый `pattern` линейным и избегайте вложения `+` или `*`.578Для полного личного файла, файла команды и файла организации, каждый показан с комментарием на каждом ключе, который он устанавливает, см. [примеры файлов параметров](/docs/ru/settings-example).
607 579
608Значки нижнего колонтитула отображаются рядом с [пользовательской строкой состояния](/docs/ru/statusline), когда она настроена; ни один не заменяет другой. Используйте строку состояния для строки, управляемой скриптом, которая вычисляет свой собственный контент из данных сеанса, и значки нижнего колонтитула для преобразования ID из разговора в ссылки без скрипта.580<span id="pass-settings-for-one-session" />
609 581
610<h3 id="hook-configuration">582<h3 id="change-a-setting-for-one-session">
611 Конфигурация Hook583 Измените параметр для одного сеанса
612</h3>584</h3>
613 585
614Эти параметры контролируют, какие hooks разрешены для запуска и к чему могут получить доступ HTTP hooks. Параметр `allowManagedHooksOnly` можно настроить только в [управляемых параметрах](#settings-files). Списки разрешений URL и переменных окружения можно установить на любом уровне параметров и объединяются в разных источниках.586Чтобы попробовать значение без сохранения, установите его при запуске Claude Code. Значение применяется к этому сеансу, и ваши файлы параметров остаются такими, какими они были. У вас есть три способа это сделать:
615
616**Поведение, когда `allowManagedHooksOnly` равно `true`:**
617
618* Управляемые hooks и SDK hooks загружаются
619* Hooks из plugins, принудительно включенных в управляемых параметрах `enabledPlugins`, загружаются. Это позволяет администраторам распространять проверенные hooks через организационный marketplace, блокируя все остальное. Доверие предоставляется по полному ID `plugin@marketplace`, поэтому plugin с тем же именем из другого marketplace остается заблокированным
620* Пользовательские hooks, проектные hooks и все остальные plugin hooks блокируются
621 587
622**Ограничить URL HTTP hooks:**588* **`--settings`**: передайте ключ как JSON, встроенный или как путь к файлу. Claude Code применяет его выше ваших файлов пользователя, проекта и локальных и ниже управляемых параметров. Он может установить любой ключ, который может установить ваш файл параметров пользователя; он не может установить ключи `Managed` или `Global config`.
589* **Флаг для этого ключа**: некоторые ключи имеют свой собственный флаг, такой как `--model` для `model` и `--effort` для `effortLevel` и `modelSettings`.
590* **Переменная окружения**: экспортируйте переменную ключа перед запуском `claude`, такую как `ANTHROPIC_MODEL` для `model`.
623 591
624Ограничьте, на какие URL могут быть направлены HTTP hooks. Поддерживает `*` как подстановочный знак для сопоставления. Когда массив определен, HTTP hooks, направленные на несовпадающие URL-адреса, молча блокируются. Сопоставление имен хостов не чувствительно к регистру и игнорирует завершающую точку FQDN, соответствуя семантике DNS.592Каждая запись ключа на [справочнике параметров](/docs/ru/settings-reference) перечисляет его переопределения для каждого сеанса и какой имеет приоритет, поэтому проверьте запись для ключа, который вы хотите изменить.
625 593
626```json theme={null}594Команды, которые вы запускаете внутри сеанса, в основном сохраняют ваш выбор: когда вы изменяете параметр в `/config`, Claude Code записывает его в ваши файлы параметров, и `/model` сохраняет значение как ваше значение по умолчанию для новых сеансов.
627{
628 "allowedHttpHookUrls": ["https://hooks.example.com/*", "http://localhost:*"]
629}
630```
631 595
632**Ограничить переменные окружения HTTP hook:**596Если вы нажмете `s` в средстве выбора `/model`, Claude Code переключает модель без сохранения ее как вашего пользовательского значения по умолчанию. [Отрегулируйте уровень усилий](/docs/ru/model-config#adjust-effort-level) говорит, какие выборы `/effort` Claude Code сохраняет как ваше значение по умолчанию для модели, которую вы используете, и какие применяются только к текущему сеансу.
633 597
634Ограничьте, какие имена переменных окружения HTTP hooks могут интерполировать в значения заголовков. Эффективный `allowedEnvVars` каждого hook является пересечением его собственного списка и этого параметра.598Например, чтобы запустить один сеанс на Opus без изменения вашего значения по умолчанию:
635 599
636```json theme={null}600```bash theme={null}
637{601claude --settings '{"model": "claude-opus-4-8"}'
638 "httpHookAllowedEnvVars": ["MY_TOKEN", "HOOK_SECRET"]
639}
640```602```
641 603
642<h3 id="compute-managed-settings-with-a-policy-helper">604<h3 id="when-edits-take-effect">
643 Вычислить управляемые параметры с помощью помощника политики605 Когда изменения вступают в силу
644</h3>606</h3>
645 607
646Параметр `policyHelper` указывает на исполняемый файл, который вычисляет управляемые параметры при запуске, поэтому администраторы могут получить политику из состояния устройства, идентификации или удаленного сервиса вместо статического файла. Настройте его из MDM или системного файла `managed-settings.json`. Claude Code игнорирует `policyHelper`, когда он появляется в любой другой области, включая параметры пользователя, параметры проекта, куст реестра HKCU и [параметры, управляемые сервером](/docs/ru/server-managed-settings).608Claude Code отслеживает ваши файлы параметров и перезагружает их при изменении, поэтому он применяет большинство изменений к работающему сеансу без перезагрузки, включая изменения `permissions`, `hooks` и помощников учетных данных, таких как `apiKeyHelper`. Claude Code также загружает файл параметров, который вы создаете в середине сеанса, если его папка существовала при запуске сеанса. Для папки `.claude/` проекта он загружает файл даже когда вы создаете папку в том же сеансе.
647 609
648Параметр принимает эти ключи:610Перезагрузка охватывает параметры пользователя, проекта, локальные и управляемые параметры, и Claude Code запускает hook [`ConfigChange`](/docs/ru/hooks#configchange) для каждого изменения файла параметров, которое он обнаруживает, не для управляемых параметров, которые поступают из MDM или консоли claude.ai. Управляемые параметры, которые поступают через MDM или из консоли claude.ai, достигают работающего сеанса по расписанию, а не при сохранении; [таблица доставки](/docs/ru/managed-settings#choose-a-delivery-mechanism) дает это для каждого источника.
649 611
650| Ключ | Тип | Описание |612Claude Code читает некоторые ключи только один раз при запуске сеанса, поэтому изменение одного из них не достигает работающего сеанса. Ключи на стороне администратора, которые также ждут перезагрузки, такие как `requiredMinimumVersion`, перечислены в [где и когда применяется политика](/docs/ru/managed-settings#where-and-when-a-policy-applies). Те, которые вы, скорее всего, будете редактировать в середине сеанса:
651| ------------------- | ------ | -------------------------------------------------------------------------------------------------------------------- |
652| `path` | string | Абсолютный путь к исполняемому файлу помощника |
653| `timeoutMs` | number | Как долго ждать помощника перед обработкой запуска как неудачного |
654| `refreshIntervalMs` | number | Как часто повторно запускать помощника в фоне. Установите на `0`, чтобы отключить обновление, или на минимум `60000` |
655 613
656Помощник записывает конверт JSON в stdout. Поместите параметры под ключ `managedSettings` вместо верхнего уровня, так как объект параметров верхнего уровня анализируется с `managedSettings` неопределенным и не применяет ничего:614* [`model`](/docs/ru/settings-reference#model): используйте [`/model`](/docs/ru/model-config#setting-your-model) для переключения в середине сеанса. Каждая модель имеет свой собственный кэш подсказок, поэтому первый запрос после переключения повторно читает весь разговор без кэша; см. [Переключение моделей](/docs/ru/prompt-caching#switching-models)
615* [`effortLevel`](/docs/ru/settings-reference#effortlevel) и [`modelSettings`](/docs/ru/settings-reference#modelsettings): используйте [`/effort`](/docs/ru/model-config#adjust-effort-level) для изменения усилий в середине сеанса
657 616
658```json theme={null}617<span id="verify-active-settings" />
659{
660 "managedSettings": {
661 "permissions": { "deny": ["Read(//etc/secrets/**)"] }
662 },
663 "claudeMd": "# Organization context\n...",
664 "appendSystemPrompt": "Always cite the internal style guide."
665}
666```
667 618
668Когда помощник выдает `managedSettings`, этот объект заменяет параметры, управляемые на основе файлов, для запуска. Когда помощник выходит с ненулевым кодом при запуске, Claude Code выводит ошибку и отказывается запуститься, поэтому помощник, которому нужна устойчивость к сбоям, должен обслуживать из собственного кэша и выходить с `0`.619<span id="check-what-loaded" />
669 620
670<h3 id="settings-precedence">621<h3 id="confirm-what-loaded">
671 Приоритет параметров622 Подтвердите, что загружено
672</h3>623</h3>
673 624
674Параметры применяются в порядке приоритета. От наивысшего к наименьшему:625Запустите `/status` внутри Claude Code, чтобы увидеть, какие источники параметров активны. Вкладка **Status** включает строку `Setting sources`, которая перечисляет каждый файл параметров, который Claude Code загрузил для текущего сеанса, такой как `User settings` или `Project local settings`. Когда [управляемые параметры](/docs/ru/admin-setup#decide-how-settings-reach-devices) действуют, запись управляемых параметров показывает в скобках, как они достигли вашей машины.
675 626
6761. **Управляемые параметры** ([управляемые сервером](/docs/ru/server-managed-settings), [политики MDM/OS-уровня](#configuration-scopes) или [управляемые параметры](/docs/ru/settings#settings-files))627Строка подтверждает, какие файлы Claude Code прочитал; она не показывает, какой файл предоставил каждый ключ. Чтобы перечислить записи, которые Claude Code отклонил, запустите [`claude doctor`](/docs/ru/debug-your-config); для модели, которую установили параметры проекта или управляемые параметры, заголовок запуска называет файл, который ее установил. `/status` и `/config` открывают один и тот же диалог на разных вкладках, и вкладка **Config** не является представлением содержимого вашего `settings.json`.
677 * Политики, развернутые IT через доставку сервера, профили конфигурации MDM, политики реестра или файлы управляемых параметров
678 * Не могут быть переопределены никаким другим уровнем, включая аргументы командной строки
679 * В пределах управляемого уровня приоритет: [`policyHelper`](#compute-managed-settings-with-a-policy-helper) вывод, который при настройке является единственным используемым управляемым источником > удаленный (параметры, управляемые сервером claude.ai или [Claude apps gateway](/docs/ru/claude-apps-gateway)-доставленные) > политики MDM/OS-уровня > на основе файлов (`managed-settings.d/*.json` и `managed-settings.json`, объединенные вместе) > реестр HKCU (только Windows). Используется только один управляемый источник; источники не объединяются в разных уровнях, с одним исключением: ключи блокировки sandbox `sandbox.network.allowManagedDomainsOnly` и `sandbox.filesystem.allowManagedReadPathsOnly`, с их связанными списками разрешений, `allowAllClaudeAiMcps` и пути двоичных файлов sandbox `sandbox.bwrapPath` и `sandbox.socatPath` учитываются, когда любой управляемый источник, контролируемый администратором, их устанавливает; уровень HKCU, доступный для записи пользователем, исключен.
680 * Хосты встраивания, такие как Claude Desktop, могут предоставлять политику через опцию SDK `managedSettings`. По умолчанию это игнорируется, когда присутствует любой управляемый источник, развернутый администратором: параметры, управляемые сервером, политика MDM или OS-уровня, или файл управляемых параметров. Резервный реестр HKCU, доступный для записи пользователем, не считается управляемым источником, развернутым администратором. Администраторы могут согласиться, установив [`parentSettingsBehavior`](#available-settings) на `"merge"`. Значения встраивателя отфильтрованы, чтобы они могли ужесточить управляемую политику, но не ослабить ее.
681 628
6822. **Аргументы командной строки**629<h3 id="fix-a-broken-settings-file">
683 * Временные переопределения для конкретного сеанса. JSON, переданный через `--settings <file-or-json>`, объединяется с параметрами на основе файлов, используя те же правила, что и другие уровни: ключ, установленный здесь, переопределяет тот же ключ в локальных, проектных или пользовательских параметрах, и пропуск ключа оставляет значение нижнего уровня на месте630 Исправьте сломанный файл параметров
684 631</h3>
6853. **Локальные параметры проекта** (`.claude/settings.local.json`)
686 * Личные параметры, специфичные для проекта
687 632
6884. **Общие параметры проекта** (`.claude/settings.json`)633Если вы неправильно напечатаете JSON или установите ключ на значение, которое Claude Code не принимает, Claude Code сообщит вам при запуске интерактивного сеанса. То, что он показывает, зависит от того, сколько файла затронуто:
689 * Параметры проекта, совместно используемые командой в системе управления версиями
690 634
6915. **Параметры пользователя** (`~/.claude/settings.json`)635* **Settings Error**: файл пользователя, проекта или локальный имеет недействительный JSON или значение, которое схема отклоняет. При запуске интерактивного сеанса Claude Code показывает диалог, который позволяет вам исправить файл с помощью Claude, выйти или продолжить без сломанных параметров.
692 * Личные глобальные параметры636* **Settings Warning**: только отдельные записи не удаются, такие как неправильное правило разрешения или неизвестное имя события hook. Claude Code пропускает эти значения и держит остальную часть файла в силе.
637* **Managed settings**: Claude Code продолжает применять остальную часть файла. [Недействительные записи в управляемых параметрах](/docs/ru/managed-settings#invalid-entries-in-managed-settings) говорит, что он отбрасывает и какие ключи возвращаются к более строгому значению, пока вы их не исправите. Для документа управляемых параметров, который не является действительным JSON, см. [Документ управляемых параметров не может быть разобран](/docs/ru/errors#managed-settings-document-could-not-be-parsed).
638* **Configuration error**: `~/.claude.json` не может быть разобран. Claude Code копирует сломанный файл в `~/.claude/backups/.claude.json.corrupted.<timestamp>` и спрашивает, выйти и исправить его вручную или сбросить на конфигурацию по умолчанию; запуск `-p` выводит ошибку и выходит. Чтобы восстановить ваше предыдущее состояние, скопируйте обратно один из пяти самых последних файлов `.claude.json.backup.<timestamp>` в `~/.claude/backups/`, которые Claude Code сохраняет перед записью файла.
693 639
694Эта иерархия гарантирует, что организационные политики всегда применяются, при этом позволяя командам и отдельным лицам настраивать свой опыт. Один и тот же приоритет применяется независимо от того, запускаете ли вы Claude Code из CLI, [расширения VS Code](/docs/ru/vs-code) или [JetBrains IDE](/docs/ru/jetbrains).640После продолжения запустите `/status`, чтобы увидеть затронутые файлы, и `claude doctor` для деталей каждой ошибки.
695 641
696Например, если ваши параметры пользователя установили `permissions.defaultMode` на `acceptEdits` и параметры проекта установили его на `default`, применяется значение проекта. Пример ниже охватывает, как вместо этого объединяются параметры со значениями массива, такие как правила разрешений.642Запуск `-p` не показывает диалог. Если только [документ управляемых параметров не может быть разобран](/docs/ru/errors#managed-settings-document-could-not-be-parsed), Claude Code пропускает сломанный файл или значения и продолжает с остальным, поэтому после запуска `-p`, который игнорирует параметр, запустите `claude doctor`, чтобы увидеть, что он отбросил.
697 643
698<Note>644<span id="how-scopes-interact" />
699 **Параметры массива объединяются в разных областях.** Когда один и тот же параметр со значением массива (такой как `sandbox.filesystem.allowWrite` или `permissions.allow`) появляется в нескольких областях, массивы **объединяются и дедублицируются**, не заменяются. Это означает, что области с более низким приоритетом могут добавлять записи без переопределения установленных областями с более высоким приоритетом, и наоборот. Например, если управляемые параметры устанавливают `allowWrite` на `["/opt/company-tools"]` и пользователь добавляет `["~/.kube"]`, оба пути включены в окончательную конфигурацию.
700 645
701 Два параметра массива не объединяются таким образом:646<span id="key-points-about-the-configuration-system" />
702 647
703 * [`fallbackModel`](#available-settings) - это упорядоченная цепь, где позиция имеет значение: файл с наивысшим приоритетом, который его определяет, предоставляет всю цепь.648<span id="which-value-claude-code-uses" />
704 * [`availableModels`](#available-settings): {{/* min-version: 2.1.175 */}}когда [источник управляемых параметров с наивысшим приоритетом](/docs/ru/server-managed-settings#settings-precedence) его определяет, этот список применяется как есть и записи пользователя, проекта и локальной области не могут его расширить. В разных неуправляемых областях массивы объединяются как обычно. См. [Поведение объединения](/docs/ru/model-config#merge-behavior).
705</Note>
706 649
707<h3 id="verify-active-settings">650<span id="which-value-wins" />
708 Проверить активные параметры
709</h3>
710 651
711Запустите `/status` внутри Claude Code, чтобы увидеть, какие источники параметров активны. Внутри меню вкладка **Status** включает строку `Setting sources`, которая перечисляет каждый уровень Claude Code, загруженный для текущего сеанса, такой как `User settings` или `Project local settings`. Когда действуют [управляемые параметры](/docs/ru/admin-setup#decide-how-settings-reach-devices), запись показывает канал доставки в скобках, например `Enterprise managed settings (remote)`, `(plist)`, `(HKLM)`, `(HKCU)` или `(file)`. Уровень появляется в списке только когда этот источник загружается с по крайней мере одним ключом, поэтому пустой список означает, что источники параметров не были найдены.652<h2 id="settings-precedence">
653 Приоритет параметров
654</h2>
712 655
713Строка `Setting sources` подтверждает, какие источники читаются. Она не показывает, какой уровень предоставил каждый отдельный ключ. Вкладка **Config** в том же диалоге - это редактор для фиксированного набора переключателей, таких как тема и подробный вывод, а не представление содержимого вашего `settings.json`.656Когда один и тот же ключ появляется в более чем одном месте, Claude Code использует значение из наивысшего уровня, который его устанавливает. Стек ниже показывает уровни, наивысший вверху; ключ на более высоком уровне переопределяет один и тот же ключ где-либо ниже.
714 657
715Если файл параметров содержит ошибки, такие как недействительный JSON или значение, которое не прошло валидацию, `/status` перечисляет затронутые файлы. Запустите `/doctor` для деталей каждой ошибки.658<SettingsPrecedence />
716 659
717<h3 id="key-points-about-the-configuration-system">660По порядку, наивысший приоритет первым:
718 Ключевые моменты о системе конфигурации
719</h3>
720 661
721* **Файлы памяти (`CLAUDE.md`)**: Содержат инструкции и контекст, которые Claude загружает при запуске6621. **Managed settings**: параметры, которые ваша организация развертывает, файлом `managed-settings.json`, политикой MDM или [параметрами, управляемыми сервером](/docs/ru/server-managed-settings) из консоли claude.ai. Ничто, что вы устанавливаете, их не переопределяет: ключ, который вы передаете с `--settings`, не переопределяет один и тот же управляемый ключ, и флаг, такой как `--model`, выбирает только из моделей, которые ваша организация разрешает. Управляемый `model` устанавливает модель, с которой каждый сеанс начинается, и вы все еще можете переключаться с `/model`; блокировка — это [`availableModels`](/docs/ru/settings-reference#availablemodels), которая ограничивает `/model`, `--model` и ключ `model` в ваших собственных файлах. Когда ваша организация доставляет более одного управляемого источника, правила для [приоритета в пределах управляемого уровня](/docs/ru/managed-settings#precedence-within-the-managed-tier) говорят, что Claude Code читает из каждого.
722* **Файлы параметров (JSON)**: Настраивают разрешения, переменные окружения и поведение инструмента6632. **Command line arguments**: флаги, которые вы передаете при запуске `claude` из терминала, для одного сеанса; см. [Измените параметр для одного сеанса](#change-a-setting-for-one-session). Claude Code объединяет JSON, который вы передаете с `--settings <file-or-json>`, с вашими файлами параметров по тем же правилам, что и другие уровни: он берет ключ, который вы устанавливаете здесь, над один и тот же ключ в локальных, проектных или пользовательских параметрах, и держит значение нижнего уровня для ключа, который вы опускаете.
723* **Skills**: Пользовательские запросы, которые можно вызвать с помощью `/skill-name` или загружены Claude автоматически6643. **Project local settings** (`.claude/settings.local.json`): ваши личные параметры для этого проекта.
724* **MCP servers**: Расширяют Claude Code дополнительными инструментами и интеграциями6654. **Shared project settings** (`.claude/settings.json`): параметры, которые ваша команда проверяет в системе управления версиями.
725* **Приоритет**: Конфигурации более высокого уровня (Managed) переопределяют конфигурации более низкого уровня (User/Project)6665. **User settings** (`~/.claude/settings.json`): ваши личные параметры для каждого проекта.
726* **Наследование**: Параметры объединяются в разных областях; скалярные значения из областей с более высоким приоритетом переопределяют, и массивы объединяются, с двумя исключениями, описанными в [примечании об объединении массивов](#settings-precedence)
727 667
728<h3 id="system-prompt">668Переменные окружения не являются уровнем в этом стеке. Когда поведение имеет как переменную оболочки, так и ключ параметров, какой применяется, решается для каждой пары, не по уровню: `ANTHROPIC_MODEL`, экспортированная в вашей оболочке, применяется над ключом `model` из любого файла, в то время как `ANTHROPIC_DEFAULT_MODEL` применяется только когда никакой файл не устанавливает `model`. [Справочник переменных окружения](/docs/ru/env-vars#precedence) говорит, какие ключи имеют пару и какой Claude Code читает первым. Блок `env` внутри файла параметров — это обычный ключ и следует уровням выше.
729 Системный запрос
730</h3>
731 669
732Внутренний системный запрос Claude Code не опубликован. Чтобы добавить пользовательские инструкции, используйте файлы `CLAUDE.md` или флаг `--append-system-prompt`.670Для нескольких ключей, чувствительных к безопасности, Claude Code чтит более строгое значение из нижнего уровня над управляемым значением; [Исключения из приоритета управляемых параметров](#exceptions-to-managed-settings-precedence) перечисляет их.
733 671
734<h3 id="exclude-sensitive-files">672<h3 id="lists-merge-instead-of-overriding">
735 Исключение чувствительных файлов673 Списки объединяются вместо переопределения
736</h3>674</h3>
737 675
738Чтобы предотвратить доступ Claude Code к файлам, содержащим чувствительную информацию, такую как ключи API, секреты и файлы окружения, используйте параметр `permissions.deny` в вашем файле `.claude/settings.json`:676Когда вы устанавливаете один и тот же ключ списка, такой как `permissions.allow`, в более чем одном файле, Claude Code объединяет списки вместо выбора одного, поэтому каждый файл может добавлять записи без удаления записей другого файла. Четыре ключа, которые содержат списки моделей или записи для каждой модели, следуют своим собственным правилам:
739
740```json theme={null}
741{
742 "permissions": {
743 "deny": [
744 "Read(./.env)",
745 "Read(./.env.*)",
746 "Read(./secrets/**)",
747 "Read(./config/credentials.json)",
748 "Read(./build)"
749 ]
750 }
751}
752```
753
754Это заменяет устаревшую конфигурацию `ignorePatterns`. Файлы, соответствующие этим шаблонам, исключаются из обнаружения файлов и результатов поиска, и операции чтения этих файлов запрещены.
755
756<h2 id="subagent-configuration">
757 Конфигурация Subagent
758</h2>
759
760Claude Code поддерживает пользовательские AI subagents, которые можно настроить на уровне пользователя и проекта. Эти subagents хранятся как файлы Markdown с YAML frontmatter:
761 677
762* **Subagents пользователя**: `~/.claude/agents/`, доступны во всех ваших проектах678* [`fallbackModel`](/docs/ru/settings-reference#fallbackmodel) — это упорядоченная цепь, где позиция имеет значение, поэтому Claude Code берет все значение из файла с наивысшим приоритетом, который его определяет.
763* **Subagents проекта**: `.claude/agents/`, специфичны для вашего проекта и могут быть совместно использованы с вашей командой679* [`modelPicker`](/docs/ru/settings-reference#modelpicker) содержит один упорядоченный список строк плюс флаг замены, поэтому Claude Code никогда не объединяет строки из двух источников. Он берет все значение из наивысшего из управляемых параметров, `--settings` и параметров пользователя, которые его определяют, и игнорирует ключ в параметрах проекта и локальных. Требует Claude Code v2.1.242 или позже.
680* [`availableModels`](/docs/ru/settings-reference#availablemodels): когда управляемые параметры, которые Claude Code применяет, его определяют, Claude Code применяет этот список как есть и игнорирует записи, которые вы добавляете в параметры пользователя, проекта или локальные, если приложение, которое встраивает Claude Code, не предоставляет свой собственный список моделей; см. [Исключения из приоритета управляемых параметров](#exceptions-to-managed-settings-precedence). Через управляемые источники список никогда не объединяется либо; [как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) говорит, какой список источника применяется. Через неуправляемые области Claude Code объединяет массивы как обычно.
681* [`modelSettings`](/docs/ru/settings-reference#modelsettings): Claude Code разрешает его одну модель за раз, вместе с [`effortLevel`](/docs/ru/settings-reference#effortlevel). Запись `modelSettings` указывает, какой файл значение применяется к модели.
764 682
765Файлы Subagent определяют специализированных AI помощников с пользовательскими запросами и разрешениями инструментов. Узнайте больше о создании и использовании subagents в [документации subagents](/docs/ru/sub-agents).683<span id="examples" />
766 684
767<h2 id="plugin-configuration">685<h3 id="precedence-examples">
768 Конфигурация Plugin686 Примеры приоритета
769</h2>
770
771Claude Code поддерживает систему plugins, которая позволяет вам расширить функциональность с помощью skills, agents, hooks и MCP servers. Plugins распространяются через marketplaces и могут быть настроены на уровне пользователя и репозитория.
772
773<h3 id="plugin-settings">
774 Параметры Plugin
775</h3>687</h3>
776 688
777Параметры, связанные с plugins, в `settings.json`:689Пока Claude работает, Claude Code показывает совет в одну строку под спиннером, такой как "Use /config to change your default permission mode (including Plan Mode)". Предположим, вы хотите эти советы отключить, поэтому вы устанавливаете [`spinnerTipsEnabled`](/docs/ru/settings-reference#spinnertipsenabled) на `false` в `~/.claude/settings.json`. Каждый сценарий ниже — это что-то, что может их снова включить, и что вы можете с этим сделать.
778
779```json theme={null}
780{
781 "enabledPlugins": {
782 "formatter@acme-tools": true,
783 "deployer@acme-tools": true,
784 "analyzer@security-plugins": false
785 },
786 "extraKnownMarketplaces": {
787 "acme-tools": {
788 "source": {
789 "source": "github",
790 "repo": "acme-corp/claude-plugins"
791 }
792 }
793 }
794}
795```
796 690
797<h4 id="enabledplugins">691<h4 id="team-settings-override-personal-settings">
798 `enabledPlugins`692 Параметры команды переопределяют личные параметры
799</h4>693</h4>
800 694
801Контролирует, какие plugins включены. Формат: `"plugin-name@marketplace-name": true/false`. Plugin без записи в любой области возвращается к его значению [`defaultEnabled`](/docs/ru/plugins-reference#default-enablement).695Ваша команда `.claude/settings.json` устанавливает это на `true`. Claude Code использует значение проекта, потому что общий проект находится выше пользователя, поэтому вы видите советы в этом проекте и нигде больше.
802 696
803**Области**:697Вы можете получить ваше значение обратно: добавьте `"spinnerTipsEnabled": false` в `.claude/settings.local.json` в этом проекте. Локальный проект находится выше общего проекта, поэтому ваши сеансы там перестают показывать советы и сеансы ваших товарищей по команде не изменяются.
804 698
805* **Параметры пользователя** (`~/.claude/settings.json`): Личные предпочтения plugins699<h4 id="organization-settings-override-everything">
806* **Параметры проекта** (`.claude/settings.json`): Plugins, специфичные для проекта, совместно используемые с командой700 Параметры организации переопределяют все
807* **Локальные параметры** (`.claude/settings.local.json`): Переопределения для каждой машины, не зафиксированные, когда Claude Code их создает
808* **Управляемые параметры** (`managed-settings.json`): Переопределения организационной политики, которые блокируют установку на всех уровнях и скрывают plugin из marketplace
809
810<Note>
811 Параметры проекта имеют приоритет над параметрами пользователя, поэтому установка plugin на `false` в `~/.claude/settings.json` не отключает plugin, который параметры проекта `.claude/settings.json` включают. Чтобы отказаться от plugin, включенного проектом, на вашей машине, установите его на `false` в `.claude/settings.local.json` вместо этого.
812
813 Plugins, принудительно включенные управляемыми параметрами, не могут быть отключены таким образом, так как управляемые параметры переопределяют локальные параметры.
814
815 Включение plugin из внешнего источника, такого как репозиторий GitHub или пакет npm, в файле `.claude/settings.json` проекта не устанавливает его для других людей. Начиная с Claude Code v2.1.195, каждый путь, который загружает plugins, просит каждого пользователя [установить и доверить plugin](/docs/ru/discover-plugins#configure-team-marketplaces) перед его запуском.
816</Note>
817
818**Пример**:
819
820```json theme={null}
821{
822 "enabledPlugins": {
823 "code-formatter@team-tools": true,
824 "deployment-tools@team-tools": true,
825 "experimental-features@personal": false
826 }
827}
828```
829
830<h4 id="pluginconfigs">
831 `pluginConfigs`
832</h4>701</h4>
833 702
834Хранит значения параметров, не содержащих конфиденциальную информацию, которые собирает [`userConfig`](/docs/ru/plugins-reference#user-configuration) prompt plugin, индексированные по ID plugin. Claude Code записывает этот ключ в параметры пользователя, когда вы заполняете диалоговое окно конфигурации plugin, поэтому вам не нужно редактировать его вручную. Конфиденциальные параметры хранятся в macOS Keychain вместо этого, или в `~/.claude/.credentials.json` на платформах без поддерживаемого keychain.703Управляемые параметры вашей организации устанавливают это на `true`. Ничто, что вы помещаете в параметры пользователя, проекта или локальные, не отключает советы, и ни `--settings` не отключает. Managed — это наивысший уровень.
835
836Этот пример хранит один параметр для plugin, установленного из marketplace `acme-tools`:
837
838```json theme={null}
839{
840 "pluginConfigs": {
841 "deployer@acme-tools": {
842 "options": {
843 "api_endpoint": "https://api.example.com"
844 }
845 }
846 }
847}
848```
849 704
850`pluginConfigs` читается из параметров пользователя, флага `--settings` и управляемых параметров только. Записи в файле `.claude/settings.json` или `.claude/settings.local.json` проекта игнорируются, потому что эти значения подставляются в конфигурации hook, MCP и LSP plugin, и клонированный репозиторий не должен иметь возможность их предоставить. До v2.1.207 параметры проекта и локальные параметры также читались.705Вы не можете получить ваше значение обратно. Запустите `/status`, чтобы увидеть, какой управляемый источник применяется, и спросите вашего администратора, должна ли политика измениться.
851 706
852<h4 id="extraknownmarketplaces">707<h4 id="the-command-line-overrides-your-files-for-one-session">
853 `extraKnownMarketplaces`708 Командная строка переопределяет ваши файлы для одного сеанса
854</h4>709</h4>
855 710
856Определяет дополнительные marketplaces, которые должны быть доступны для репозитория. Обычно используется в параметрах уровня репозитория для обеспечения доступа членов команды к требуемым источникам plugins.711Вы запустили сеанс с `claude --settings '{"spinnerTipsEnabled": true}'`. Командная строка находится выше каждого файла, кроме управляемых, поэтому этот сеанс показывает советы, даже хотя ваши файлы говорят `false`.
857 712
858**Когда репозиторий включает `extraKnownMarketplaces`**:713Вы получаете ваше значение обратно на следующем сеансе; `--settings` длится один сеанс и не записывает в какой-либо файл.
859 714
8601. Членам команды предлагается установить marketplace при доверии папке715<h4 id="a-flag-or-environment-variable-sets-the-same-thing">
8612. Членам команды затем предлагается установить plugins из этого marketplace716 Флаг или переменная окружения устанавливает то же самое
8623. Пользователи могут пропустить нежелательные marketplaces или plugins (хранятся в параметрах пользователя)
8634. Установка соблюдает границы доверия и требует явного согласия
864
865**Пример**:
866
867```json theme={null}
868{
869 "extraKnownMarketplaces": {
870 "acme-tools": {
871 "source": {
872 "source": "github",
873 "repo": "acme-corp/claude-plugins"
874 }
875 },
876 "security-plugins": {
877 "source": {
878 "source": "git",
879 "url": "https://git.example.com/security/plugins.git"
880 }
881 }
882 }
883}
884```
885
886**Типы источников Marketplace**:
887
888* `github`: Репозиторий GitHub (использует `repo`)
889* `git`: Любой URL git (использует `url`)
890* `directory`: Путь локальной файловой системы (использует `path`, только для разработки)
891* `hostPattern`: Шаблон regex для сопоставления хостов marketplace (использует `hostPattern`)
892* `settings`: встроенный marketplace, объявленный непосредственно в settings.json без отдельного размещенного репозитория (использует `name` и `plugins`)
893
894Тип источника `git` работает с любым сервисом хостинга git, включая самостоятельно размещенные GitLab и Bitbucket. Claude Code клонирует репозиторий с той же аутентификацией, которую использовал бы `git clone` на этой машине: настроенные помощники учетных данных или ключи SSH. Токен поставщика, такой как `GITHUB_TOKEN`, вступает в силу только через помощника учетных данных, который его читает. См. [Приватные репозитории](/docs/ru/plugin-marketplaces#private-repositories) для деталей настройки.
895
896Для источников `github` и `git` установите `"skipLfs": true` внутри объекта `source` (рядом с `repo` или `url`) для пропуска загрузок Git LFS, когда Claude Code клонирует или обновляет репозиторий marketplace. Файлы указателей LFS остаются указателями вместо загрузки их содержимого. Используйте это, когда репозиторий содержит большие объекты LFS, не связанные с содержимым plugin. Требует Claude Code v2.1.153 или позже.
897
898Каждая запись marketplace также принимает опциональное логическое значение `autoUpdate`. Установите `"autoUpdate": true` рядом с `source`, чтобы Claude Code обновлял этот marketplace и обновлял его установленные plugins при запуске. Если опущено, официальные marketplaces Anthropic по умолчанию имеют значение `true`, а все остальные marketplaces по умолчанию имеют значение `false`. См. [Настройка автоматических обновлений](/docs/ru/discover-plugins#configure-auto-updates).
899
900Используйте `source: 'settings'` для объявления небольшого набора plugins встроенным образом без настройки размещенного репозитория marketplace. Plugins, указанные здесь, должны ссылаться на внешние источники, такие как GitHub или npm. Вам по-прежнему нужно включить каждый plugin отдельно в `enabledPlugins`.
901
902```json theme={null}
903{
904 "extraKnownMarketplaces": {
905 "team-tools": {
906 "source": {
907 "source": "settings",
908 "name": "team-tools",
909 "plugins": [
910 {
911 "name": "code-formatter",
912 "source": {
913 "source": "github",
914 "repo": "acme-corp/code-formatter"
915 }
916 }
917 ]
918 }
919 }
920 }
921}
922```
923
924<h4 id="strictknownmarketplaces">
925 `strictKnownMarketplaces`
926</h4>717</h4>
927 718
928**Только управляемые параметры**: Контролирует, какие marketplaces plugins пользователи могут добавить и установить plugins из них. Этот параметр можно настроить только в [управляемых параметрах](/docs/ru/settings#settings-files) и предоставляет администраторам строгий контроль над источниками marketplace.719Некоторые ключи имеют флаг командной строки или переменную окружения, которая переопределяет значение параметров независимо от того, какой файл его установил: `ANTHROPIC_MODEL` переопределяет параметр [`model`](/docs/ru/settings-reference#model), и `--model` переопределяет оба для сеанса.
929
930**Местоположения файлов управляемых параметров**:
931
932* **macOS**: `/Library/Application Support/ClaudeCode/managed-settings.json`
933* **Linux и WSL**: `/etc/claude-code/managed-settings.json`
934* **Windows**: `C:\Program Files\ClaudeCode\managed-settings.json`
935
936**Ключевые характеристики**:
937 720
938* Доступно только в управляемых параметрах (`managed-settings.json`)721Можете ли вы получить ваше значение обратно, зависит от ключа: отмените переменную или отбросьте флаг, и проверьте запись ключа на [справочнике параметров](/docs/ru/settings-reference) и строку переменной на [справочнике переменных окружения](/docs/ru/env-vars) для того, какой Claude Code использует.
939* Не может быть переопределено параметрами пользователя или проекта (наивысший приоритет)
940* Применяется ДО операций сети/файловой системы (заблокированные источники никогда не выполняются)
941* Использует точное сопоставление для спецификаций источников (включая `ref`, `path` для источников git), кроме `hostPattern` и `pathPattern`, которые используют сопоставление regex
942 722
943**Поведение списка разрешений**:723<span id="keys-ignored-in-a-repository-file" />
944 724
945* `undefined` (по умолчанию): Без ограничений - пользователи могут добавить любой marketplace725<span id="keys-only-you-or-your-organization-can-set" />
946* Пустой массив `[]`: Полная блокировка - пользователи не могут добавить новые marketplaces
947* Список источников: Пользователи могут добавить только marketplaces, которые точно совпадают
948
949**Все поддерживаемые типы источников**:
950
951Список разрешений поддерживает несколько типов источников marketplace. Большинство источников используют точное сопоставление, в то время как `hostPattern` и `pathPattern` используют сопоставление regex с хостом marketplace и путем файловой системы соответственно.
952
9531. **Репозитории GitHub**:
954
955```json theme={null}
956{ "source": "github", "repo": "acme-corp/approved-plugins" }
957{ "source": "github", "repo": "acme-corp/security-tools", "ref": "v2.0" }
958{ "source": "github", "repo": "acme-corp/plugins", "ref": "main", "path": "marketplace" }
959```
960
961Поля: `repo` (обязательно), `ref` (опционально: ветка или тег), `path` (опционально: подкаталог)
962
9632. **Репозитории Git**:
964
965```json theme={null}
966{ "source": "git", "url": "https://gitlab.example.com/tools/plugins.git" }
967{ "source": "git", "url": "https://bitbucket.org/acme-corp/plugins.git", "ref": "production" }
968{ "source": "git", "url": "ssh://git@git.example.com/plugins.git", "ref": "v3.1", "path": "approved" }
969```
970
971Поля: `url` (обязательно), `ref` (опционально: ветка или тег), `path` (опционально: подкаталог)
972
9733. **Marketplaces на основе URL**:
974
975```json theme={null}
976{ "source": "url", "url": "https://plugins.example.com/marketplace.json" }
977{ "source": "url", "url": "https://cdn.example.com/marketplace.json", "headers": { "Authorization": "Bearer ${TOKEN}" } }
978```
979
980Поля: `url` (обязательно), `headers` (опционально: HTTP заголовки для аутентифицированного доступа)
981
982<Note>
983 Marketplaces на основе URL загружают только файл `marketplace.json`. Они не загружают файлы plugins с сервера. Plugins в marketplaces на основе URL должны использовать внешние источники (GitHub, npm или URL git) вместо относительных путей. Для plugins с относительными путями используйте marketplace на основе Git. См. [Troubleshooting](/docs/ru/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces) для деталей.
984</Note>
985
9864. **Пакеты NPM**:
987
988```json theme={null}
989{ "source": "npm", "package": "@acme-corp/claude-plugins" }
990{ "source": "npm", "package": "@acme-corp/approved-marketplace" }
991```
992 726
993Поля: `package` (обязательно, поддерживает scoped пакеты)727<span id="common-cases" />
994 728
9955. **Пути файлов**:729<span id="which-value-applies-in-common-situations" />
996 730
997```json theme={null}731<h3 id="troubleshoot-a-setting-that-doesn’t-apply">
998{ "source": "file", "path": "/usr/local/share/claude/acme-marketplace.json" }732 Устранение неполадок параметра, который не применяется
999{ "source": "file", "path": "/opt/acme-corp/plugins/marketplace.json" }733</h3>
1000```
1001
1002Поля: `path` (обязательно: абсолютный путь к файлу marketplace.json)
1003
10046. **Пути каталогов**:
1005
1006```json theme={null}
1007{ "source": "directory", "path": "/usr/local/share/claude/acme-plugins" }
1008{ "source": "directory", "path": "/opt/acme-corp/approved-marketplaces" }
1009```
1010
1011Поля: `path` (обязательно: абсолютный путь к каталогу, содержащему `.claude-plugin/marketplace.json`)
1012
10137. **Сопоставление шаблона хоста**:
1014
1015```json theme={null}
1016{ "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }
1017{ "source": "hostPattern", "hostPattern": "^gitlab\\.internal\\.example\\.com$" }
1018```
1019
1020Поля: `hostPattern` (обязательно: шаблон regex для сопоставления с хостом marketplace)
1021
1022Используйте сопоставление шаблона хоста, когда вы хотите разрешить все marketplaces с определенного хоста без перечисления каждого репозитория отдельно. Это полезно для организаций с внутренними серверами GitHub Enterprise или GitLab, где разработчики создают свои собственные marketplaces.
1023
1024Извлечение хоста по типу источника:
1025
1026* `github`: всегда сопоставляется с `github.com`
1027* `git`: извлекает имя хоста из URL (поддерживает форматы HTTPS и SSH)
1028* `url`: извлекает имя хоста из URL
1029* `npm`, `file`, `directory`: не поддерживается для сопоставления шаблона хоста
1030
10318. **Сопоставление шаблона пути**:
1032
1033```json theme={null}
1034{ "source": "pathPattern", "pathPattern": "^/opt/approved/" }
1035{ "source": "pathPattern", "pathPattern": ".*" }
1036```
1037
1038Поля: `pathPattern` (обязательно: шаблон regex, сопоставляемый с полем `path` источников `file` и `directory`)
1039
1040Используйте сопоставление шаблона пути для разрешения marketplaces на основе файловой системы наряду с ограничениями `hostPattern` для сетевых источников. Установите `".*"` для разрешения всех локальных путей или более узкий шаблон для ограничения определенными каталогами.
1041
1042**Примеры конфигурации**:
1043
1044Пример: разрешить только определенные marketplaces:
1045
1046```json theme={null}
1047{
1048 "strictKnownMarketplaces": [
1049 {
1050 "source": "github",
1051 "repo": "acme-corp/approved-plugins"
1052 },
1053 {
1054 "source": "github",
1055 "repo": "acme-corp/security-tools",
1056 "ref": "v2.0"
1057 },
1058 {
1059 "source": "url",
1060 "url": "https://plugins.example.com/marketplace.json"
1061 },
1062 {
1063 "source": "npm",
1064 "package": "@acme-corp/compliance-plugins"
1065 }
1066 ]
1067}
1068```
1069
1070Пример: отключить все добавления marketplace:
1071
1072```json theme={null}
1073{
1074 "strictKnownMarketplaces": []
1075}
1076```
1077
1078Пример: разрешить все marketplaces с внутреннего git сервера:
1079
1080```json theme={null}
1081{
1082 "strictKnownMarketplaces": [
1083 {
1084 "source": "hostPattern",
1085 "hostPattern": "^github\\.example\\.com$"
1086 }
1087 ]
1088}
1089```
1090
1091**Требования точного сопоставления**:
1092
1093Источники marketplace должны совпадать точно для разрешения добавления пользователем. Для источников на основе git (`github` и `git`), это включает все опциональные поля:
1094
1095* `repo` или `url` должны совпадать точно
1096* Поле `ref` должно совпадать точно (или оба быть не определены)
1097* Поле `path` должно совпадать точно (или оба быть не определены)
1098
1099Примеры источников, которые не совпадают:
1100
1101```json theme={null}
1102// Это РАЗНЫЕ источники:
1103{ "source": "github", "repo": "acme-corp/plugins" }
1104{ "source": "github", "repo": "acme-corp/plugins", "ref": "main" }
1105
1106// Это также РАЗНЫЕ:
1107{ "source": "github", "repo": "acme-corp/plugins", "path": "marketplace" }
1108{ "source": "github", "repo": "acme-corp/plugins" }
1109```
1110
1111**Сравнение с `extraKnownMarketplaces`**:
1112
1113| Аспект | `strictKnownMarketplaces` | `extraKnownMarketplaces` |
1114| ----------------------------- | ----------------------------------------------------- | ------------------------------------------------------ |
1115| **Назначение** | Применение организационной политики | Удобство команды |
1116| **Файл параметров** | Только `managed-settings.json` | Любой файл параметров |
1117| **Поведение** | Блокирует добавления, не входящие в список разрешений | Автоматически устанавливает отсутствующие marketplaces |
1118| **Когда применяется** | До операций сети/файловой системы | После запроса доверия пользователя |
1119| **Может быть переопределено** | Нет (наивысший приоритет) | Да (параметрами с более высоким приоритетом) |
1120| **Формат источника** | Прямой объект источника | Именованный marketplace с вложенным источником |
1121| **Случай использования** | Соответствие, ограничения безопасности | Адаптация, стандартизация |
1122
1123**Различие формата**:
1124
1125`strictKnownMarketplaces` использует прямые объекты источников:
1126
1127```json theme={null}
1128{
1129 "strictKnownMarketplaces": [
1130 { "source": "github", "repo": "acme-corp/plugins" }
1131 ]
1132}
1133```
1134 734
1135`extraKnownMarketplaces` требует именованные marketplaces:735Когда вы устанавливаете ключ и Claude Code не ведет себя так, как если бы вы это сделали, начните с `/status`, чтобы увидеть, какие файлы он загрузил, затем найдите ваш симптом ниже. [Отладьте вашу конфигурацию](/docs/ru/debug-your-config) охватывает более широкие проверки, включая тест чистой конфигурации.
1136 736
1137```json theme={null}737<h4 id="a-value-you-set-is-ignored">
1138{738 Значение, которое вы установили, игнорируется
1139 "extraKnownMarketplaces": {739</h4>
1140 "acme-tools": {
1141 "source": { "source": "github", "repo": "acme-corp/plugins" }
1142 }
1143 }
1144}
1145```
1146 740
1147**Использование обоих вместе**:741Что-то еще устанавливает один и тот же ключ, файл не может установить это значение, или файл не загружен:
1148 742
1149`strictKnownMarketplaces` - это политический шлюз: он контролирует, что пользователи могут добавить, но не регистрирует никакие marketplaces. Чтобы одновременно ограничить и предварительно зарегистрировать marketplace для всех пользователей, установите оба в `managed-settings.json`:743* **Более высокий уровень его устанавливает.** Другой файл параметров, флаг `--settings` или управляемый источник устанавливает ключ выше вашего; [стек](#settings-precedence) говорит, какой. Флаг или переменная окружения также может переопределить ключ самостоятельно, решено ключ за ключом; запись ключа на [справочнике параметров](/docs/ru/settings-reference) говорит, какой Claude Code использует, и запись [`env`](/docs/ru/settings-reference#env) охватывает управляемое значение `env` против экспорта оболочки.
744* **Ключ безопасности держит его строгое значение.** Для нескольких ключей Claude Code чтит ограничивающее значение из любого файла, поэтому проект `true` для [`disableClaudeAiConnectors`](/docs/ru/settings-reference#disableclaudeaiconnectors) остается включенным; см. [Исключения из приоритета управляемых параметров](#exceptions-to-managed-settings-precedence).
745* **Файл не может установить это значение.** Значения [`permissions.defaultMode`](/docs/ru/settings-reference#permissions-defaultmode) `auto` и `bypassPermissions` не вступают в силу из параметров проекта или локальных; установите их в параметры пользователя или управляемые вместо этого, или передайте `--permission-mode` для одного сеанса. До v2.1.257 `bypassPermissions` вступал в силу из любого файла.
746* **Файл сломан.** Недействительный JSON или отклоненное значение заставляет Claude Code пропустить файл или запись; см. [Исправьте сломанный файл параметров](#fix-a-broken-settings-file).
1150 747
1151```json theme={null}748<h4 id="a-change-you-made-in-claude-code-is-lost-in-new-sessions">
1152{749 Изменение, которое вы сделали в Claude Code, потеряно в новых сеансах
1153 "strictKnownMarketplaces": [750</h4>
1154 { "source": "github", "repo": "acme-corp/plugins" }
1155 ],
1156 "extraKnownMarketplaces": {
1157 "acme-tools": {
1158 "source": { "source": "github", "repo": "acme-corp/plugins" }
1159 }
1160 }
1161}
1162```
1163 751
1164Если установлен только `strictKnownMarketplaces`, пользователи по-прежнему могут добавить разрешенный marketplace вручную через `/plugin marketplace add`, но он не доступен автоматически.752Когда вы сохраняете выбор для новых сеансов из Claude Code, такой как модель по умолчанию с `/model`, Claude Code записывает его в ваш файл параметров пользователя, `~/.claude/settings.json`. Если вы не можете писать в этот файл, например потому что другой инструмент его генерирует или связывает его с копией только для чтения, изменение применяется к текущему сеансу и исчезает в следующем. Установите ключ в инструмент, который генерирует файл, или замените файл на тот, в который вы можете писать.
1165 753
1166**Важные примечания**:754Если вы можете писать в файл и изменение все еще не длится, проверьте, было ли изменение [только для одного сеанса](#change-a-setting-for-one-session) или [более высокий уровень устанавливает один и тот же ключ](#a-value-you-set-is-ignored). Для ключа `model`, [Новый сеанс начинается на другой модели, чем вы выбрали](/docs/ru/model-config#a-new-session-starts-on-a-different-model-than-you-picked) перечисляет больше причин.
1167 755
1168* Ограничения проверяются ДО любых запросов сети или операций файловой системы756<h4 id="a-managed-change-hasn’t-reached-you">
1169* При блокировке пользователи видят четкие сообщения об ошибках, указывающие, что источник заблокирован управляемой политикой757 Управляемое изменение не достигло вас
1170* Ограничение применяется при добавлении marketplace и при установке, обновлении, обновлении и автоматическом обновлении plugin. Marketplace, добавленный до установки политики, не может быть использован для установки или обновления plugins после того, как его источник больше не совпадает со списком разрешений758</h4>
1171* Управляемые параметры имеют наивысший приоритет и не могут быть переопределены
1172 759
1173См. [Управляемые ограничения marketplace](/docs/ru/plugin-marketplaces#managed-marketplace-restrictions) для документации, ориентированной на пользователя.760Управляемые источники достигают работающего сеанса по расписанию в [таблице доставки](/docs/ru/managed-settings#choose-a-delivery-mechanism), поэтому сначала перезагрузите сеанс. Если `/status` затем называет другой источник, чем тот, который ваш администратор изменил, применяется более высокий приоритет источника; [Как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) дает порядок.
1174 761
1175<h4 id="strictpluginonlycustomization">762<h4 id="a-committed-key-doesn’t-reach-teammates">
1176 `strictPluginOnlyCustomization`763 Зафиксированный ключ не достигает товарищей по команде
1177</h4>764</h4>
1178 765
1179**Только управляемые параметры**: блокирует skills, agents, hooks и MCP servers из источников пользователя и проекта, поэтому они могут поступать только из plugins или управляемых параметров. Объедините это с `strictKnownMarketplaces` для контроля полной цепочки поставок настройки: список разрешений marketplace контролирует, какие plugins пользователи могут установить, и этот параметр блокирует все, что не поступает из plugin или из управляемых параметров.766Две вещи держат ключ в `.claude/settings.json` от применения для всех, кто его клонирует:
1180
1181Значение либо `true` для блокировки всех четырех поверхностей, либо массив, называющий поверхности для блокировки:
1182 767
1183```json theme={null}768* **Claude Code игнорирует ключ в файле репозитория.** Ищите `User, local, or managed`, `User or managed`, `Managed` или `Global config` в столбце Scope [индекса параметров](/docs/ru/settings-reference#settings-index); эти ключи никогда не применяются из общего файла, кроме [`autoContinueAtUsageLimit`](/docs/ru/settings-reference#autocontinueatusagelimit), который файл репозитория все еще может отключить: пока файл устанавливает ключ и никакое пользовательское значение, `--settings` или управляемое значение не делает, Claude Code читает параметр как отключенный. Ключи `Global config` применяются только из `~/.claude.json`.
1184{769* **Ключ ждет доверия.** Правила `permissions.allow`, `permissions.additionalDirectories`, `extraKnownMarketplaces` и большинство значений [`env`](/docs/ru/settings-reference#env) применяются только после того, как каждый товарищ по команде [доверит папке](/docs/ru/permissions#project-allow-rules-and-workspace-trust). До этого они все еще видят подсказки и не получают plugins из marketplace, который файл объявляет. Правила `deny` и `ask` применяются сразу же.
1185 "strictPluginOnlyCustomization": ["skills", "hooks"]
1186}
1187```
1188 770
1189Для каждой заблокированной поверхности Claude Code пропускает источники уровня пользователя и проекта и загружает только plugin-предоставленные и управляемые источники:771<h4 id="permission-rules-combine-differently-than-you-expected">
772 Правила разрешений объединяются иначе, чем вы ожидали
773</h4>
1190 774
1191| Поверхность | Заблокировано при блокировке | Все еще загружает |775* **Вы выбрали "Да, и больше не спрашивай" на подсказке разрешения, но все еще получаете подсказку для одного и того же инструмента.** Этот выбор сохранил правило `allow` в ваш локальный файл, и правило `allow` там не превосходит правило `ask` из файла проекта или управляемого; [как правила разрешений объединяются](/docs/ru/permissions#settings-precedence) объясняет порядок. В расширении VS Code карточка одобрения позволяет вам выбрать файл назначения, включая общий файл проекта, который изменяет правило для всех; в CLI Claude Code записывает только в ваш локальный файл.
1192| :---------- | :-------------------------------------------------------------- | :----------------------------------------------------------------------- |776* **Правила allow вашей организации все еще применяются рядом с вашими.** Это ожидается: Claude Code объединяет [`permissions.allow`](/docs/ru/settings-reference#permissions-allow) через области, если только ваша организация не устанавливает [`allowManagedPermissionRulesOnly`](/docs/ru/settings-reference#allowmanagedpermissionrulesonly).
1193| `skills` | `~/.claude/skills/`, `.claude/skills/` | Plugin skills, встроенные skills, skills в каталоге управляемой политики |
1194| `agents` | `~/.claude/agents/`, `.claude/agents/` | Plugin agents, встроенные agents, agents в каталоге управляемой политики |
1195| `hooks` | Hooks в пользовательских, проектных и локальных `settings.json` | Plugin hooks, hooks в управляемых параметрах |
1196| `mcp` | Servers в `~/.claude.json` и `.mcp.json` | Plugin MCP servers, [`managed-mcp.json`](/docs/ru/managed-mcp) servers |
1197 777
1198Имена поверхностей, которые версия Claude Code не распознает, игнорируются, а не вызывают ошибку файла параметров, поэтому вы можете добавить новые имена поверхностей до того, как все клиенты обновятся.778<span id="security-keys-where-the-stricter-value-applies" />
1199 779
1200<h3 id="manage-plugins">780<h3 id="exceptions-to-managed-settings-precedence">
1201 Управление Plugins781 Исключения из приоритета управляемых параметров
1202</h3>782</h3>
1203 783
1204Используйте команду `/plugin` для интерактивного управления plugins:784Для нескольких ключей, чьи значения ограничивают сеанс, Claude Code чтит ограничивающее значение из области, которая в противном случае не могла бы переопределить управляемые параметры. Найдите ключ в этой таблице, чтобы увидеть, какое значение он чтит и откуда.
1205 785
1206* Просмотрите доступные plugins из marketplaces786| Ключ | Значение, которое Claude Code чтит | Примечания |
1207* Установите/удалите plugins787| :------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
1208* Включите/отключите plugins788| [`disableClaudeAiConnectors`](/docs/ru/settings-reference#disableclaudeaiconnectors) | `true` из любой области | Чтится даже когда управляемый источник устанавливает `false` |
1209* Просмотрите детали plugins (skills, agents, hooks, предоставляемые)789| [`enableArtifact`](/docs/ru/settings-reference#enableartifact) | `false` из любой области и `disableArtifact: true` из любой области | Чтится даже когда управляемый источник устанавливает `true`; ничто не включает [инструмент Artifact](/docs/ru/artifacts#disable-artifacts) обратно. Требует Claude Code v2.1.242 или позже |
1210* Добавьте/удалите marketplaces790| [`isolatePeerMachines`](/docs/ru/settings-reference#isolatepeermachines) | `true` из любой области | Чтится даже когда управляемый источник устанавливает `false` |
791| [`remoteControlAtStartup`](/docs/ru/settings-reference#remotecontrolatstartup) | `false` из `.claude/settings.json` или `.claude/settings.local.json` | Чтится даже когда управляемый источник устанавливает `true`; проект или локальный `true` игнорируется |
792| [`crossSessionInbound`](/docs/ru/settings-reference#crosssessioninbound) | Более строгое значение из `.claude/settings.json` или `.claude/settings.local.json`, на лестнице `accept` \< `hold` \< `refuse` | Чтится над управляемыми, `--settings` и пользовательскими значениями; проект или локальное значение, которое не более строгое, игнорируется |
793| [`useAutoModeDuringPlan`](/docs/ru/settings-reference#useautomodeduringplan) | `false` из любого управляемого источника, `--settings`, `~/.claude/settings.json` или `.claude/settings.local.json` | Чтится даже когда выигрывающий управляемый источник устанавливает `true`; `false` в `.claude/settings.json` игнорируется |
794| [`syncClaudeAiSkills`](/docs/ru/settings-reference#syncclaudeaiskills) | `false` из любого управляемого источника, `--settings`, `~/.claude/settings.json` или `.claude/settings.local.json` | Чтится даже когда выигрывающий управляемый источник устанавливает `true`; `false` в `.claude/settings.json` игнорируется |
795| [`maxEffortLevel`](/docs/ru/settings-reference#maxeffortlevel) | Более низкий лимит из любой области, включая `--settings` | Чтится даже когда управляемые параметры, которые Claude Code применяет, устанавливают более высокий лимит; применяется самый низкий лимит. Требует Claude Code v2.1.267 или позже |
1211 796
1212Узнайте больше о системе plugins в [документации plugins](/docs/ru/plugins).797Приложение, которое запускает Claude Code внутри себя и устанавливает [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars), также является исключением. Claude Code берет конфигурацию модели этого приложения над ключами `model`, `fallbackModel`, `modelPicker` и `modelOverrides` из каждого управляемого источника, и над переменными выбора модели в управляемом блоке `env`, такими как `ANTHROPIC_MODEL` и семейство `ANTHROPIC_DEFAULT_*_MODEL`. Claude Code держит управляемый [`availableModels`](/docs/ru/settings-reference#availablemodels) список разрешений в силе, если только приложение не предоставляет свой собственный.
1213 798
1214<h2 id="environment-variables">799<h2 id="settings-in-cloud-sessions">
1215 Переменные окружения800 Параметры в облачных сеансах
1216</h2>801</h2>
1217 802
1218Переменные окружения позволяют вам управлять поведением Claude Code без редактирования файлов параметров. Любая переменная также может быть настроена в [`settings.json`](#available-settings) под ключом `env` для применения к каждому сеансу или развертывания для вашей команды.803Облачный сеанс, на [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) или из [`claude --cloud`](/docs/ru/claude-code-on-the-web#from-terminal-to-web), работает в [облачной среде](/docs/ru/cloud-environments) на свежем клоне вашего репозитория, не на вашей машине. Это изменяет, какие параметры его достигают:
1219
1220См. [справочник переменных окружения](/docs/ru/env-vars) для полного списка.
1221
1222<h2 id="tools-available-to-claude">
1223 Инструменты, доступные Claude
1224</h2>
1225 804
1226Claude Code имеет доступ к набору инструментов для чтения, редактирования, поиска, запуска команд и организации subagents. Имена инструментов - это точные строки, которые вы используете в правилах разрешений и сопоставителях hooks.805* **Общие параметры проекта** (`.claude/settings.json`): читаются, потому что файл является частью клона. Зафиксируйте параметр там, чтобы применить его в облачных сеансах.
806* **Параметры пользователя и локальные параметры проекта** (`~/.claude/settings.json` и `.claude/settings.local.json`): не читаются. Оба остаются на вашей машине, и локальный файл не находится в клоне.
807* **Managed settings**: только [параметры, управляемые сервером](/docs/ru/server-managed-settings), достигают облачного сеанса; файл `managed-settings.json` или профиль MDM на вашем устройстве не достигают. [Самостоятельно размещенная среда](/docs/ru/self-hosted-environments) также читает файл управляемых параметров в образе своего runner. [Как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) говорит, когда этот файл применяется.
808* **`/config`**: в веб-версии открывает раздел Claude Code ваших параметров claude.ai вместо изменения значения. Чтобы изменить параметр для облачного сеанса, установите [переменную окружения](/docs/ru/cloud-environments#set-environment-variables) в среде или зафиксируйте ключ в `.claude/settings.json` репозитория.
1227 809
1228См. [справочник инструментов](/docs/ru/tools-reference) для полного списка и деталей поведения инструмента Bash.810[Что переносится из вашей установки](/docs/ru/cloud-environments#what-carries-over-from-your-setup) перечисляет остальное: `CLAUDE.md`, skills, MCP servers, plugins и учетные данные.
1229 811
1230<h2 id="see-also">812<h2 id="what’s-next">
1231 См. также813 Что дальше
1232</h2>814</h2>
1233 815
1234* [Permissions](/docs/ru/permissions): система разрешений, синтаксис правил, шаблоны, специфичные для инструментов, и управляемые политики816* [Все параметры](/docs/ru/settings-reference): каждый ключ, с местом, где вы его устанавливаете и примером
1235* [Authentication](/docs/ru/authentication): настройка доступа пользователей к Claude Code817* [Примеры файлов параметров](/docs/ru/settings-example): личный файл, файл команды и файл управляемых параметров организации
1236* [Debug your configuration](/docs/ru/debug-your-config): диагностика причин, по которым параметр, hook или MCP сервер не вступают в силу818* [Настройка разрешений](/docs/ru/permissions): правила allow, ask и deny, и что Claude Code запускает без запроса
1237* [Troubleshoot installation and login](/docs/ru/troubleshoot-install): установка, аутентификация и проблемы платформы819* [Переменные окружения](/docs/ru/env-vars): переменные, которые Claude Code читает и блок `env`
820* [Отладьте вашу конфигурацию](/docs/ru/debug-your-config): когда параметр не применяется
821* [Справочник каталога Claude](/docs/ru/claude-directory): каждый файл, который Claude Code читает, включая subagents, MCP servers, plugins и `CLAUDE.md`