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 Code の設定5# 設定ファイルと優先順位
6 6
7> Claude Code をグローバル設定とプロジェクトレベルの設定、および環境変数で構成します。7> Claude Code の設定を変更し、キーが属するスコープを選択し、変更を確認し、複数の場所でキーが設定されている場合に Claude Code が使用する値を学びます。
8 8
9Claude Code は、ニーズに合わせて動作を構成するためのさまざまな設定を提供しています。`/config` コマンドを実行することで Claude Code を構成できます。これにより、ステータス情報を表示し、構成オプションを変更できるタブ付き設定インターフェースが開きます。v2.1.181 以降では、`/config` に `key=value` を渡すことで、インターフェースを開かずに単一のオプションを変更できます。例えば `/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 who: 'You, this session',
21 w: 420
22 }, {
23 n: 3,
24 name: 'Project local',
25 file: '.claude/settings.local.json',
26 who: 'You, this project',
27 w: 480
28 }, {
29 n: 4,
30 name: 'Shared project',
31 file: '.claude/settings.json',
32 who: 'Everyone in the project',
33 w: 540
34 }, {
35 n: 5,
36 name: 'User',
37 file: '~/.claude/settings.json',
38 who: 'You, every project',
39 w: 600
40 }];
41 const W = 760;
42 const ROW = 58;
43 const GAP = 8;
44 const TOP = 34;
45 const H = TOP + LEVELS.length * (ROW + GAP) + 30;
46 const cx = W / 2;
47 const mono = 'var(--font-mono, ui-monospace, SFMono-Regular, Menlo, monospace)';
48 const sans = 'var(--font-sans, system-ui, -apple-system, sans-serif)';
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 <style>{`
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 .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 .sp-root svg { width: 100%; height: auto; display: block; max-width: ${W}px; margin: 0 auto; }
54 `}</style>
55 <svg viewBox={`0 0 ${W} ${H}`} xmlns="http://www.w3.org/2000/svg">
56 <text x={cx} y={18} textAnchor="middle" fontFamily={sans} fontSize="12.5" fontWeight="600" fill="var(--sp-sub)">Highest precedence</text>
57 {LEVELS.map((l, i) => {
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設定は、Claude Code の動作を変更する JSON キーです。どのモデルで開始するか、何を確認なしで実行できるか、どのファイルを読み取れないか、ターミナルでどのように見えるか、および組織が強制する内容を決定します。
374
375<Tip>
376 特定のキーを検索するには、[すべての設定](/docs/ja/settings-reference)に移動してください。すべてのキーが、設定するファイル、デフォルト、および例とともにリストされています。
377</Tip>
378
379Claude Code は `~/.claude/settings.json` などの JSON 設定ファイルから設定を読み込みます。いくつかの場所でそれらを探し、[設定を読み込むファイルが、その設定が誰に適用されるかを決定します](#settings-files-and-who-they-affect)。このページでは、これらのファイルについて説明します。設定をどのファイルに入れるか、設定を変更して適用されたことを確認する方法、および同じキーが複数のファイルで設定されている場合に Claude Code が使用する値について説明します。[権限を構成する](/docs/ja/permissions)では、Claude Code が確認なしで実行できる内容と、`allow`、`ask`、および `deny` ルールを記述する方法について説明します。
20 380
21| スコープ | 場所 | 影響を受けるユーザー | チームと共有? |381<Note>
22| :---------- | :--------------------------------------------------------- | :-------------------------------------------------------------------------------------- | :----------------------------------- |382 このページでは、マシンで実行されている Claude Code について説明します。ターミナル、[VS Code](/docs/ja/vs-code) および [JetBrains](/docs/ja/jetbrains) 拡張機能、および [デスクトップアプリ](/docs/ja/desktop)は、すべて同じ設定ファイルを読み込みます。[Claude Code on the web](/docs/ja/claude-code-on-the-web) のクラウドセッションは別のマシンで実行され、そのうちのいくつかのみを読み込みます。[クラウドセッションの設定](#settings-in-cloud-sessions)を参照してください。
23| **Managed** | サーバー管理設定、plist / レジストリ、またはシステムレベルの `managed-settings.json` | サーバー管理配信の場合はすべての組織メンバー、plist、HKLM レジストリ、ファイル配信の場合はマシン上のすべてのユーザー、HKCU レジストリ配信の場合は現在のユーザー | はい(IT により展開) |383</Note>
24| **User** | `~/.claude/` ディレクトリ | すべてのプロジェクト全体でのあなた | いいえ |
25| **Project** | リポジトリ内の `.claude/` | このリポジトリのすべてのコラボレーター | はい(git にコミット) |
26| **Local** | `.claude/settings.local.json` | このリポジトリ内のあなたのみ | いいえ(Claude Code が作成する場合は gitignored) |
27 384
28<h3 id="when-to-use-each-scope">385<span id="settings-files" />
29 各スコープを使用する場合
30</h3>
31 386
32**Managed スコープ**は以下の用途です:387<span id="configuration-scopes" />
33 388
34* 組織全体で強制する必要があるセキュリティポリシー389<span id="available-scopes" />
35* オーバーライドできないコンプライアンス要件
36* IT/DevOps により展開される標準化された構成
37 390
38**User スコープ**は以下の用途に最適です:391<span id="when-to-use-each-scope" />
39 392
40* すべての場所で必要な個人設定(テーマ、エディター設定)393<span id="what-uses-scopes" />
41* すべてのプロジェクト全体で使用するツールとプラグイン
42* API キーと認証(安全に保存)
43 394
44**Project スコープ**は以下の用途に最適です:395<span id="subagent-configuration" />
45 396
46* チーム共有設定(権限、hooks、MCP サーバー)397<span id="where-settings-live" />
47* チーム全体が持つべきプラグイン
48* コラボレーター全体でのツール標準化
49 398
50**Local スコープ**は以下の用途に最適です:399<h2 id="settings-files-and-who-they-affect">
400 設定ファイルと誰に影響するか
401</h2>
51 402
52* 特定のプロジェクトの個人的なオーバーライド403Claude Code は 4 つのファイルから設定を読み込み、組織は claude.ai コンソールから管理設定を配信することもできます。各ソースにはスコープがあります。スコープは、その中に保存された設定が適用される人とプロジェクトのセット。それがあなただけ、プロジェクト内のすべての人、またはあなたの組織内のすべての人であるかどうか。
53* チームと共有する前に構成をテストする
54* 他のユーザーには機能しないマシン固有の設定
55 404
56<h3 id="how-scopes-interact">405| スコープ | ファイル | 誰に影響するか | 用途 |
57 スコープの相互作用406| :--------- | :------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------- | :------------------------------------ |
58</h3>407| ユーザー | `~/.claude/settings.json` | あなた、このマシン上のすべてのプロジェクト | 個人設定:テーマ、エディターモード、デフォルトモデル、独自の権限ルール |
408| 共有プロジェクト | `.claude/settings.json` | このフォルダを含むフォルダで作業しているすべての人。git リポジトリでは、コミットしてチームメイトが取得できるようにします | チーム権限、hooks、プラグイン、およびプロジェクトが必要とする環境変数 |
409| プロジェクトローカル | `.claude/settings.local.json` | あなた、このプロジェクトのみ。Claude Code はファイルを作成するときに git から除外します。手動で作成する場合は、自分で `.gitignore` に追加してください | 1 つのプロジェクトの個人的なオーバーライド、および共有する前のテスト |
410| 管理 | `managed-settings.json` およびその他の[管理ソース](/docs/ja/managed-settings#delivery-mechanisms) | 組織がデプロイするすべての人。あなたが設定するものは何もそれをオーバーライドしません。いくつかの[セキュリティに敏感な例外](#exceptions-to-managed-settings-precedence)を除いて | セキュリティポリシーおよびコンプライアンス要件 |
59 411
60同じ設定が複数のスコープで構成されている場合、Claude Code は優先順位の順序でそれらを適用します:412ファイル列では、`~/.claude` はホームディレクトリの `.claude` フォルダ、ベアの `.claude` はプロジェクト内の `.claude` フォルダです。
61 413
621. **Managed**(最高) - 何によってもオーバーライドできない414<span id="where-each-file-applies" />
632. **コマンドライン引数** - 一時的なセッションオーバーライド
643. **Local** - プロジェクトとユーザー設定をオーバーライド
654. **Project** - ユーザー設定をオーバーライド
665. **User**(最低) - 他に何も設定を指定しない場合に適用
67 415
68たとえば、ユーザー設定で `spinnerTipsEnabled` が `true` に設定されており、プロジェクト設定で `false` に設定されている場合、プロジェクト値が適用されます。権限ルールはオーバーライドするのではなく、スコープ全体でマージされるため、異なる動作をします。[設定の優先順位](#settings-precedence)を参照してください。416<span id="compare-what-each-file-reaches" />
69 417
70<h3 id="what-uses-scopes">418<h3 id="compare-the-scope-of-each-settings-file">
71 スコープを使用する機能419 各設定ファイルのスコープを比較する
72</h3>420</h3>
73 421
74スコープは多くの Claude Code 機能に適用されます:422マシン上に 3 つのプロジェクト `website/`、`api/`、および `acme-app/` があり、チームメイトが `acme-app/` の独自のクローンを持ち、`acme-app/` で[クラウドセッション](#settings-in-cloud-sessions)を開始するとします。
75
76| 機能 | ユーザーの場所 | プロジェクトの場所 | ローカルの場所 |
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
84Windows では、`~/.claude` として表示されるパスは `%USERPROFILE%\.claude` に解決されます。
85 423
86***424下のグラフィックは、それらのフォルダから Claude Code を開始するときに設定が適用されるフォルダを示しています。設定ファイルをクリックして、到達するフォルダを確認してください。
87 425
88<h2 id="settings-files">426<SettingsScope />
89 設定ファイル
90</h2>
91
92`settings.json` ファイルは、階層的な設定を通じて Claude Code を構成するための公式メカニズムです:
93
94* **ユーザー設定**は `~/.claude/settings.json` で定義され、すべてのプロジェクトに適用されます。
95* **プロジェクト設定**はプロジェクトディレクトリに保存されます:
96 * `.claude/settings.json` ソース管理にチェックインされ、チームと共有される設定用
97 * `.claude/settings.local.json` チェックインされない設定用。個人設定と実験に役立ちます。Claude Code は作成時に `.claude/settings.local.json` を無視するように git を構成します。自分でファイルを作成する場合は、gitignore に手動で追加してください。
98
99 このファイルはリポジトリのものではなく、あなたのものであるため、その権限 `allow` ルールは、`.claude/settings.json` allow ルールが必要とする[ワークスペース信頼](/docs/ja/permissions#project-allow-rules-and-workspace-trust)ステップなしで有効になります。リポジトリがファイルを提供する場合(たとえば、コミットすることで)、ワークスペース信頼は引き続き適用されます。
100* **Managed 設定**:集中管理が必要な組織向けに、Claude Code は managed 設定の複数の配信メカニズムをサポートしています。すべて同じ JSON 形式を使用し、ユーザー設定またはプロジェクト設定でオーバーライドできません:
101
102 * **サーバー管理設定**:Anthropic のサーバーから Claude.ai 管理コンソール経由で配信されるか、自己ホスト型の [Claude apps gateway](/docs/ja/claude-apps-gateway)から配信されます。[サーバー管理設定](/docs/ja/server-managed-settings)を参照してください。
103 * **MDM/OS レベルのポリシー**:macOS と Windows のネイティブデバイス管理を通じて配信されます:
104 * macOS:`com.anthropic.claudecode` managed preferences ドメイン。plist のトップレベルキーは `managed-settings.json` をミラーリングし、ネストされた設定は辞書として、配列は plist 配列として機能します。Jamf、Iru(Kandji)、または同様の MDM ツールの構成プロファイルを通じて展開します。
105 * Windows:`HKLM\SOFTWARE\Policies\ClaudeCode` レジストリキーと JSON を含む `Settings` 値(REG\_SZ または REG\_EXPAND\_SZ)。グループポリシーまたは Intune を通じて展開します
106 * Windows(ユーザーレベル):`HKCU\SOFTWARE\Policies\ClaudeCode`(最低ポリシー優先度、管理者レベルのソースが存在しない場合のみ使用)
107 * **ファイルベース**:`managed-settings.json` と `managed-mcp.json` をシステムディレクトリに展開:
108 427
109 * macOS:`/Library/Application Support/ClaudeCode/`428* **`~/.claude/settings.json`**:マシン上のすべてのプロジェクト、チームメイトまたはクラウドセッションには何もありません
110 * Linux と WSL:`/etc/claude-code/`429* **`acme-app/.claude/settings.json`**:あなたの `acme-app/`。バージョン管理にファイルをコミットする場合のみ、チームメイトのクローンとクラウドセッションに到達します。それまでは、他のファイルのようにディスク上のファイルであり、誰も持っていません
111 * Windows:`C:\Program Files\ClaudeCode\`430* **`acme-app/.claude/settings.local.json`**:あなたの `acme-app/` のみ。Claude Code はファイルを初めて書き込むときに、グローバル git 除外に追加するため、コミットから除外されます。手動でファイルを作成する場合は、[自分で `.gitignore` に追加してください](#keep-personal-settings-out-of-a-repository)
431* **管理設定**。`managed-settings.json` ファイル、MDM ポリシー、または claude.ai コンソールからの[サーバー管理設定](/docs/ja/server-managed-settings):組織がデプロイするすべてのマシン上のすべてのプロジェクト、またはあなたの組織アカウントでサインインするマシン。サーバー管理設定のみがクラウドセッションに到達します
112 432
113 <Warning>433<span id="which-files-you-have" />
114 レガシー Windows パス `C:\ProgramData\ClaudeCode\managed-settings.json` は v2.1.75 以降サポートされなくなりました。そのロケーションに設定を展開した管理者は、ファイルを `C:\Program Files\ClaudeCode\managed-settings.json` に移行する必要があります。
115 </Warning>
116 434
117 ファイルベースの managed 設定は、`managed-settings.json` と同じシステムディレクトリ内の `managed-settings.d/` ドロップインディレクトリもサポートしています。これにより、別々のチームが単一ファイルの編集を調整することなく、独立したポリシーフラグメントを展開できます。435<h3 id="find-or-create-your-settings-files">
118 436 設定ファイルを見つけるか作成する
119 systemd 規則に従い、`managed-settings.json` が最初にベースとしてマージされ、その後、ドロップインディレクトリ内のすべての `*.json` ファイルがアルファベット順にソートされてマージされます。スカラー値の場合、後のファイルが前のファイルをオーバーライドします。配列は連結され、重複排除されます。オブジェクトはディープマージされます。`.` で始まる隠しファイルは無視されます。437</h3>
120
121 マージ順序を制御するには、数値プレフィックスを使用します。たとえば、`10-telemetry.json` と `20-security.json` です。
122 438
123 [managed 設定](/docs/ja/permissions#managed-only-settings)と [Managed MCP 構成](/docs/ja/managed-mcp)の詳細を参照してください。439Claude Code をインストールしても、設定ファイルは作成されません。マシンまたはプロジェクトに既に 1 つある場合は、これらのソースの 1 つから来ました:
124 440
125 このリポジトリには、Jamf、Iru(Kandji)、Intune、およびグループポリシー用のスターターデプロイメントテンプレートが含まれています。これらを出発点として使用し、ニーズに合わせて調整してください。441* **管理**:組織がデプロイします。作成または編集しません。
442* **共有プロジェクト**:Claude Code を既に使用しているプロジェクトにはコミットされたものがあるかもしれません。ない場合は、プロジェクトフォルダに `.claude/settings.json` で作成してください。
443* **ユーザー**および**プロジェクトローカル**:自分で作成するか、Claude Code に作成させます。テーマなどのユーザー設定に保存する `/config` メニューのオプションを初めて変更するときに `~/.claude/settings.json` を書き込み、Bash コマンドに対して「はい、今後は聞かないでください」などの権限プロンプトで立ったままの承認を初めて与えるときに `.claude/settings.local.json` を書き込みます。**ヒントを表示**を含むいくつかの `/config` オプションは、ユーザーファイルの代わりに `.claude/settings.local.json` に保存されます。
126 444
127 <Note>445<Info>
128 Managed デプロイメントは、`strictKnownMarketplaces` を使用して**プラグインマーケットプレイスの追加**を制限することもできます。詳細については、[Managed マーケットプレイス制限](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions)を参照してください。446 Windows では、`~/.claude` は `%USERPROFILE%\.claude` を意味します。ホームディレクトリファイルを別の場所に保つには、[`CLAUDE_CONFIG_DIR`](/docs/ja/env-vars) を設定してください。Claude Code はその代わりに設定、セッション履歴、およびプラグインをそこに保存します。
129 </Note>447</Info>
130* **その他の構成**は `~/.claude.json` に保存されます。このファイルには、OAuth セッション、[MCP サーバー](/docs/ja/mcp)ユーザーおよびローカルスコープの構成、プロジェクトごとの状態(許可されたツール、信頼設定)、およびさまざまなキャッシュが含まれます。プロジェクトスコープの MCP サーバーは `.mcp.json` に別途保存されます。
131 448
132<Note>449Claude Code は、[`~/.claude.json`](/docs/ja/claude-directory#ce-claude-json) という 5 番目のファイルも保持します。これは自分で書き込みます。編集する必要はありません。サインインセッション、[MCP サーバー](/docs/ja/mcp)構成、信頼決定などのプロジェクトごとの状態、および `/config` があなたのために書き込む[グローバル構成キー](/docs/ja/settings-reference#global-config-settings)を保持します。
133 Claude Code は構成ファイルのタイムスタンプ付きバックアップを自動的に作成し、データ損失を防ぐために最新の 5 つのバックアップを保持します。
134</Note>
135 450
136```JSON Example settings.json theme={null}451<h3 id="share-settings-with-your-team">
137{452 チームと設定を共有する
138 "$schema": "https://json.schemastore.org/claude-code-settings.json",453</h3>
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 454
164上記の例の `$schema` 行は、Claude Code 設定の[公式 JSON スキーマ](https://json.schemastore.org/claude-code-settings.json)を指しています。これを `settings.json` に追加すると、VS Code、Cursor、および JSON スキーマ検証をサポートする他のエディターでオートコンプリートとインライン検証が有効になります。455`.claude/settings.json` をコミットして、リポジトリをクローンするすべての人が同じ権限、hooks、テレメトリ、およびプラグインを取得するようにします。各チームメイトは、個人的な例外がコミットを必要としないように、独自の `.claude/settings.local.json` でそれをオーバーライドできます。完全なチームファイルについては、[チームの共有設定](/docs/ja/settings-example#a-teams-shared-settings)を参照してください。
165 456
166公開されたスキーマは定期的に更新され、最新の CLI リリースで追加された設定を含まない場合があるため、最近ドキュメント化されたフィールドの検証警告は、必ずしも構成が無効であることを意味しません。457コミットするものの一部は、各チームメイトが[フォルダを信頼する](/docs/ja/permissions#project-allow-rules-and-workspace-trust)まで待機し、いくつかのキーはリポジトリファイルから効果を発揮しません。[適用されない設定をトラブルシューティングする](#common-cases)は両方をカバーしています。
167 458
168<h3 id="when-edits-take-effect">459<span id="local-settings-file" />
169 編集がいつ有効になるか
170</h3>
171 460
172Claude Code は設定ファイルを監視し、変更時に再読み込みするため、ほとんどのキーへの編集は再起動なしで実行中のセッションに適用されます。これには `permissions`、`hooks`、および `apiKeyHelper` などの認証情報ヘルパーが含まれます。再読み込みはユーザー、プロジェクト、ローカル、および managed 設定をカバーし、[`ConfigChange` hook](/docs/ja/hooks#configchange)が検出された各変更に対して発火します。461<span id="where-claude-code-saves-the-project-local-file" />
173 462
174いくつかのキーはセッション開始時に 1 回読み込まれ、次の再起動時に適用されます:463<span id="the-project-local-file" />
175 464
176* `model`:セッション中に切り替えるには [`/model`](/docs/ja/model-config#setting-your-model)を使用します465<span id="keep-personal-settings-out-of-the-repository" />
177* [`outputStyle`](/docs/ja/output-styles):システムプロンプトの一部。`/clear` または再起動時に再構築されます
178 466
179<h3 id="invalid-entries-in-managed-settings">467<h3 id="keep-personal-settings-out-of-a-repository">
180 Managed 設定の無効なエントリ468 リポジトリから個人設定を除外する
181</h3>469</h3>
182 470
183Managed 設定は寛容に解析されます。managed 構成にスキーマ検証に失敗するエントリが含まれている場合、Claude Code はそのエントリを削除し、警告を記録し、残りのすべての有効なポリシーを強制します。単一のタイプミスが組織のポリシーの残りを無効にすることはできません。[`/doctor`](/docs/ja/debug-your-config#check-resolved-settings)を実行して、削除されたエントリをそのソースファイルとフィールドとともにリストします。471プロジェクト内で自分の設定を変更し、チームメイトの設定を変更しないようにするには、プロジェクト内の `.claude/settings.local.json` に保存してください。Claude Code はそのファイルをコミットされた `.claude/settings.json` に適用するため、チームのファイルが `"model": "claude-sonnet-5"` を設定し、Opus が必要な場合は、ローカルファイルに `"model": "claude-opus-4-8"` を入れて、セッションのみを変更します。
184 472
185この動作は、3 つすべての配信メカニズム全体で一貫しています:[サーバー管理設定](/docs/ja/server-managed-settings)、MDM を通じてデプロイされた plist およびレジストリポリシー、および `managed-settings.json` ファイル。Claude Code v2.1.169 以降が必要です。473ローカルファイルについて 3 つのことを知ってください:
186 474
187セキュリティ強制フィールドは、存在するが無効な場合、全体的に削除されるのではなく、フィールドごとに処理されます:475* **Claude Code もそれを書き込みます。** Claude が Bash コマンドを実行する権限を求め、「はい、今後は聞かないでください」を選択すると、Claude Code はその[権限承認](/docs/ja/permissions#permission-system)をここに `allow` ルールとして保存します。
476* **手動で作成した場合を除き、自分で gitignore する必要はありません。** Claude Code がリポジトリでファイルを初めて書き込むときに、既にそれを無視していない場合、グローバル git 除外ファイルに `**/.claude/settings.local.json` を追加するため、ファイルはすべてのリポジトリのコミットから除外されます。そのファイルは、グローバル git 構成がそれを絶対パスまたは `~` プレフィックス付きパスに設定する場合は `core.excludesFile`。それ以外の場合は `$XDG_CONFIG_HOME/git/ignore`、または `XDG_CONFIG_HOME` が設定されていない場合は `~/.config/git/ignore`。手動でファイルを作成し、Claude Code がまだそれに書き込んでいない場合は、自分で `.gitignore` に追加してください。
477* **ファイルが追跡されていない間、その allow ルールは信頼を待ちません。** ファイルはリポジトリのものではなくあなたのものであるため、Claude Code はコミットされたファイルが必要とする[ワークスペース信頼](/docs/ja/permissions#project-allow-rules-and-workspace-trust)ステップなしにその `allow` ルールを適用します。ファイルが git で追跡されている場合、信頼ステップもそれに適用されます。[ローカル設定ファイルが信頼を必要とする場合](/docs/ja/permissions#when-your-local-settings-file-needs-trust)を参照してください。
188 478
189| フィールド | 存在するが無効な場合の動作 |479<span id="where-claude-code-looks-for-each-file" />
190| :--------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------- |
191| `allowedMcpServers` | 空のホワイトリストとして強制されるため、値が修正されるまで MCP サーバーは許可されません。個別の無効なエントリは削除され、有効なサブセットが強制されます。 |
192| `allowManagedMcpServersOnly` | `true` として扱われます。 |
193| `availableModels` | 空のホワイトリストとして強制されるため、値が修正されるまでデフォルトモデルのみが利用可能です。文字列以外の個別エントリは削除され、有効なサブセットが強制されます。v2.1.175 以降に適用されます。 |
194| `enforceAvailableModels` | }`true` として扱われます。v2.1.175 以降に適用されます。 |
195| `forceLoginOrgUUID` | 値が修正されるまで、どの組織もログインを許可されません。 |
196| `deniedMcpServers` | 個別の無効なエントリは削除され、有効なサブセットが強制されます。完全に無効な値は警告とともに削除されます。すべてのサーバーを拒否するとポリシーが名前を付けなかったサーバーをブロックするため。 |
197| `sandbox.credentials` | 個別の無効なエントリが `files` または `envVars` に含まれている場合は、警告とともに削除され、有効なサブセットが強制されます。完全に無効な `credentials` 値は警告とともに削除されますが、`sandbox` の残りは引き続き適用されます。v2.1.191 以降に適用されます。 |
198 480
199`requiredMinimumVersion` と `requiredMaximumVersion` は設計上失敗して開きます:無効な値は強制されるのではなく削除されるため、不正なポリシープッシュが Claude Code の起動を防ぐことはできません。481<span id="how-claude-code-keeps-the-local-file-out-of-git" />
200 482
201検証エラーは 3 つの場所に表示されます:483<span id="local-allow-rules-dont-wait-for-workspace-trust" />
202 484
203* インタラクティブセッションは起動時に無効なエントリをリストするダイアログを表示します。485<h4 id="where-claude-code-keeps-the-local-file-in-a-git-repository">
204* `-p` を使用したヘッドレス実行は stderr にサマリーを出力します。486 Claude Code が git リポジトリでローカルファイルを保持する場所
205* [`claude doctor`](/docs/ja/debug-your-config)は各無効なエントリをそのソースとフィールドとともにリストします。487</h4>
206
207ポリシー変更をテストマシンで `claude doctor` を実行して検証してから、フロート全体に展開します。
208 488
209この寛容さは managed 設定にのみ適用されます。ユーザー、プロジェクト、およびローカル設定ファイルは厳密なままです:検証に失敗するファイルは全体として拒否され、報告されます。489Claude が Bash コマンドを実行する権限を求め、「はい、今後は聞かないでください」を選択すると、Claude Code はその承認を `.claude/settings.local.json` の `allow` ルールとして保存します。git リポジトリのサブディレクトリから Claude Code を開始する場合、リポジトリルートでそのファイルを読み取り、書き込み、リポジトリ全体に承認を適用します。[worktree](/docs/ja/worktrees) では、メインチェックアウトのルートのファイルを使用します。
210 490
211<h3 id="available-settings">4912 つのルールがルートの場所を適格にします:
212 利用可能な設定
213</h3>
214 492
215`settings.json` は多くのオプションをサポートしています:493* **ファイルが `.claude/settings.json` の代わりに留まる場合**:git リポジトリの外、リポジトリルートがホームディレクトリ、Windows、またはリポジトリルート、その `.git` またはその `.claude` エントリがユーザーによって所有されていない場合。
216 494* **ファイル内のパスはリポジトリルートに固定されません**:`/` で始まる権限ルール、または相対サンドボックスパスは、[セッションのプライマリ作業ディレクトリ](/docs/ja/permissions#read-and-edit)に固定されます。
217| キー | 説明 | 例 |
218| :--------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |
219| `advisorModel` | サーバー側[advisor ツール](/docs/ja/advisor)用のモデル。`"opus"`、`"sonnet"`、または `"fable"`(v2.1.170 以降)などのモデルエイリアス、または完全なモデル ID を受け入れます。`/advisor` を実行すると自動的に書き込まれます。advisor を無効にするには未設定のままにします | `"opus"` |
220| `agent` | メインスレッドを名前付き subagent として実行し、`claude agents` から派遣されたセッションのデフォルト agent を設定します。その subagent のシステムプロンプト、ツール制限、およびモデルを適用します。[subagents を明示的に呼び出す](/docs/ja/sub-agents#invoke-subagents-explicitly)を参照してください | `"code-reviewer"` |
221| `agentPushNotifEnabled` | **デフォルト**:`false`。[リモートコントロール](/docs/ja/remote-control)が接続されている場合、Claude がプロアクティブなプッシュ通知をスマートフォンに送信することを許可します。たとえば、長いタスクが完了したときなど。`/config` に**Claude が決定したときにプッシュ**として表示されます。[モバイルプッシュ通知](/docs/ja/remote-control#mobile-push-notifications)を参照してください。Claude Code v2.1.119 以降が必要です | `true` |
222| `allowAllClaudeAiMcps` | (Managed 設定のみ)デプロイされた `managed-mcp.json` と共に claude.ai コネクタを読み込みます。これ以外の場合は排他的な制御を取得し、それらを抑制します。[Managed MCP 構成](/docs/ja/managed-mcp)を参照してください | `true` |
223| `allowedChannelPlugins` | (Managed 設定のみ)メッセージをプッシュできるチャネルプラグインのホワイトリスト。設定されている場合、デフォルトの Anthropic ホワイトリストを置き換えます。未定義 = デフォルトにフォールバック、空配列 = すべてのチャネルプラグインをブロック。`channelsEnabled: true` が必要です。[チャネルプラグインが実行できるものを制限](/docs/ja/channels#restrict-which-channel-plugins-can-run)を参照してください | `[{ "marketplace": "claude-plugins-official", "plugin": "telegram" }]` |
224| `allowedHttpHookUrls` | HTTP hooks がターゲットにできる URL パターンのホワイトリスト。`*` をワイルドカードとしてサポートします。設定されている場合、一致しない URL を持つ hooks はブロックされます。未定義 = 制限なし、空配列 = すべての HTTP hooks をブロック。配列はすべての設定ソース全体でマージされます。[Hook 構成](#hook-configuration)を参照してください | `["https://hooks.example.com/*"]` |
225| `allowedMcpServers` | managed-settings.json で設定されている場合、ユーザーが構成できる MCP サーバーのホワイトリスト。未定義 = 制限なし、空配列 = ロックダウン。すべてのスコープに適用されます。拒否リストが優先されます。[Managed MCP 構成](/docs/ja/managed-mcp)を参照してください | `[{ "serverName": "github" }]` |
226| `allowManagedHooksOnly` | (Managed 設定のみ)managed hooks、SDK hooks、および managed 設定 `enabledPlugins` で強制的に有効にされたプラグインからの hooks のみが読み込まれます。ユーザー、プロジェクト、およびその他すべてのプラグイン hooks はブロックされます。[Hook 構成](#hook-configuration)を参照してください | `true` |
227| `allowManagedMcpServersOnly` | (Managed 設定のみ)managed 設定からの `allowedMcpServers` のみが尊重されます。`deniedMcpServers` はすべてのソースからマージされます。ユーザーは引き続き MCP サーバーを追加できますが、管理者定義のホワイトリストのみが適用されます。[Managed MCP 構成](/docs/ja/managed-mcp)を参照してください | `true` |
228| `allowManagedPermissionRulesOnly` | (Managed 設定のみ)ユーザーおよびプロジェクト設定が `allow`、`ask`、または `deny` 権限ルールを定義するのを防止します。managed 設定のルールのみが適用されます。[Managed のみの設定](/docs/ja/permissions#managed-only-settings)を参照してください | `true` |
229| `alwaysThinkingEnabled` | すべてのセッションに対してデフォルトで[拡張思考](/docs/ja/model-config#extended-thinking)を有効にします。通常は直接編集するのではなく `/config` コマンドを通じて構成されます。思考をオフにするには、`env` で [`MAX_THINKING_TOKENS=0`](/docs/ja/env-vars)を設定します。これにより Anthropic API での思考が無効になります。ただし Fable 5 では思考をオフにすることはできません。[サードパーティプロバイダー](/docs/ja/third-party-integrations)では、代わりに `thinking` パラメータを省略し、適応推論モデルは引き続き思考する可能性があります | `true` |
230| `apiKeyHelper` | システムシェル(macOS と Linux では `/bin/sh`、Windows では `cmd`)を通じて実行される認証値を生成するカスタムコマンド。この値は、モデルリクエストの `X-Api-Key` および `Authorization: Bearer` ヘッダーとして送信されます。[`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/docs/ja/env-vars)でリフレッシュ間隔を設定します | `/bin/generate_temp_api_key.sh` |
231| `askUserQuestionTimeout` | **デフォルト**:`"never"`。アイドル時間。未回答の [`AskUserQuestion`](/docs/ja/tools-reference)ダイアログが、既に選択したオプションで自動的に続行するまで。`"60s"`、`"5m"`、`"10m"`、または `"never"` を受け入れます。デフォルトでは、質問は回答するまで待機します。`/config` に**質問自動継続タイムアウト**として表示されます。プロジェクトまたはローカル設定から読み込まれません。Claude Code v2.1.200 以降が必要です | `"5m"` |
232| `attribution` | git コミットとプルリクエストの属性をカスタマイズします。[属性設定](#attribution-settings)を参照してください | `{"commit": "🤖 Generated with Claude Code", "pr": ""}` |
233| `autoCompactEnabled` | **デフォルト**:`true`。コンテキストが制限に近づくと、会話を自動的にコンパクトにします。`/config` に**自動コンパクト**として表示されます。環境変数で無効にするには、`env` で [`DISABLE_AUTO_COMPACT`](/docs/ja/env-vars)を設定します | `false` |
234| `autoMemoryDirectory` | [自動メモリ](/docs/ja/memory#storage-location)ストレージ用のカスタムディレクトリ。絶対パスまたは `~/` プレフィックス付きパスを受け入れます。プロジェクトまたはローカル設定からは、ワークスペース信頼ダイアログを受け入れた後にのみ尊重されます。クローンされたリポジトリがこのファイルを提供できるため | `"~/my-memory-dir"` |
235| `autoMemoryEnabled` | **デフォルト**:`true`。[自動メモリ](/docs/ja/memory#enable-or-disable-auto-memory)を有効にします。`false` の場合、Claude は自動メモリディレクトリから読み込んだり、書き込んだりしません。セッション中に `/memory` でこれを切り替えることもできます。環境変数で無効にするには、`env` で [`CLAUDE_CODE_DISABLE_AUTO_MEMORY`](/docs/ja/env-vars)を設定します | `false` |
236| `autoMode` | [自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)分類器がブロックおよび許可するものをカスタマイズします。`environment`、`allow`、`soft_deny`、および `hard_deny` 配列の散文ルールを含みます。リテラル文字列 `"$defaults"` を配列に含めて、その位置で組み込みルールを継承します。[自動モードを構成](/docs/ja/auto-mode-config)を参照してください。ユーザー設定、`--settings` フラグ、および managed 設定からのみ読み込まれます。プロジェクト `.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 allow ルールを一時停止して、すべてのシェルコマンドが分類器を通じてルーティングされるようにします。任意のコード実行パターンに一致するルールだけではなく。[すべてのシェルコマンドを分類器を通じてルーティング](/docs/ja/auto-mode-config#route-all-shell-commands-through-the-classifier)を参照してください。Claude Code v2.1.193 以降が必要です | `true` |
238| `autoScrollEnabled` | **デフォルト**:`true`。[フルスクリーンレンダリング](/docs/ja/fullscreen)で、新しい出力を会話の下部に追従します。`/config` に**自動スクロール**として表示されます。権限プロンプトはこれがオフの場合でもビューにスクロールします | `false` |
239| `autoUpdatesChannel` | **デフォルト**:`"latest"`。更新に従うリリースチャネル。約 1 週間古いバージョンで、大きな回帰のあるバージョンをスキップする `"stable"` を使用するか、最新リリースの `"latest"` を使用します。自動更新を完全に無効にするには、`env` で [`DISABLE_AUTOUPDATER`](/docs/ja/setup#disable-auto-updates)を設定します | `"stable"` |
240| `availableModels` | ユーザーがメインセッション、[subagents](/docs/ja/sub-agents)、[skills](/docs/ja/skills)、および [advisor](/docs/ja/advisor)用に選択できるモデルを制限します。`enforceAvailableModels` も設定されている場合を除き、デフォルトオプションには影響しません。[モデル選択を制限](/docs/ja/model-config#restrict-model-selection)を参照してください | `["sonnet", "haiku"]` |
241| `awaySummaryEnabled` | 数分間ターミナルから離れた後に戻ったときに、1 行のセッション要約を表示します。`false` に設定するか、`/config` でセッション要約をオフにして無効にします。[`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/docs/ja/env-vars)と同じです | `true` |
242| `awsAuthRefresh` | `.aws` ディレクトリを変更するカスタムスクリプト([高度な認証情報構成](/docs/ja/amazon-bedrock#advanced-credential-configuration)を参照) | `aws sso login --profile myprofile` |
243| `awsCredentialExport` | AWS 認証情報を含む JSON を出力するカスタムスクリプト([高度な認証情報構成](/docs/ja/amazon-bedrock#advanced-credential-configuration)を参照) | `/bin/generate_aws_grant.sh` |
244| `axScreenReader` | スクリーンリーダーフレンドリーな出力をレンダリングします:装飾的なボーダーやアニメーションのないフラットテキスト。スクリーンリーダーモードは常にクラシックレンダラーを使用するため、`tui` 設定はアクティブな間は効果がありません。[`CLAUDE_AX_SCREEN_READER`](/docs/ja/env-vars)環境変数と [`--ax-screen-reader`](/docs/ja/cli-reference#cli-flags)フラグが優先されます。Claude Code v2.1.181 以降が必要です | `true` |
245| `blockedMarketplaces` | (Managed 設定のみ)マーケットプレイスソースのブロックリスト。マーケットプレイス追加時およびプラグインのインストール、更新、リフレッシュ、自動更新時に適用されるため、ポリシーが設定される前に追加されたマーケットプレイスは使用できません。ブロックされたソースはダウンロード前にチェックされるため、ファイルシステムに触れることはありません。[Managed マーケットプレイス制限](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions)を参照してください | `[{ "source": "github", "repo": "untrusted/plugins" }]` |
246| `browserExternalPageTools` | (Managed 設定のみ)デスクトップアプリの [Browser ペイン](/docs/ja/desktop#browse-external-sites)で外部ページを読み取ったり操作したりするツールを使用するのを防ぐために `"disabled"` に設定します。ユーザーは引き続き外部サイトに自分で移動できます。ローカル開発サーバープレビューは影響を受けません | `"disabled"` |
247| `channelsEnabled` | (Managed 設定のみ)組織に対して[チャネル](/docs/ja/channels)を許可します。Claude.ai Team および Enterprise プランでは、これが未設定または `false` の場合、チャネルはブロックされます。[Anthropic Console](/docs/ja/authentication#claude-console-authentication)アカウントで API キー認証を使用している場合、チャネルはデフォルトで許可されます。ただし、組織が managed 設定をデプロイしている場合は、このキーを `true` に設定する必要があります | `true` |
248| `claudeMd` | (Managed 設定のみ)CLAUDE.md スタイルの命令が組織管理メモリとして注入されます。managed またはポリシー設定で設定されている場合のみ尊重され、ユーザー、プロジェクト、およびローカル設定では無視されます。[組織全体の CLAUDE.md](/docs/ja/memory#deploy-organization-wide-claude-md)を参照してください | `"Always run make lint before committing."` |
249| `claudeMdExcludes` | [メモリ](/docs/ja/memory)を読み込むときにスキップする `CLAUDE.md` ファイルの Glob パターンまたは絶対パス。パターンは絶対ファイルパスに対してマッチします。ユーザー、プロジェクト、およびローカルメモリのみに適用されます。managed ポリシーファイルは除外できません | `["**/vendor/**/CLAUDE.md"]` |
250| `cleanupPeriodDays` | **デフォルト**:`30` 日、最小 `1`。Claude Code はこの期間より古い[セッションファイルおよびその他のアプリケーションデータ](/docs/ja/claude-directory#cleaned-up-automatically)を起動時に削除します。`0` に設定するとバリデーションエラーで拒否されます。また、起動時に[孤立した worktrees](/docs/ja/worktrees#clean-up-worktrees)の自動削除の年齢カットオフも制御します。Claude Code が設定ファイルを読み込めないか解析できない場合、保持クリーンアップスイープを一時停止し、ファイルを修正するまで `/status` に警告を表示します。ただし、[managed 設定](/docs/ja/server-managed-settings)が `cleanupPeriodDays` を提供する場合は、スイープは managed 値で実行されます。v2.1.203 より前では、クリーンアップは 30 日のデフォルトでその状態で実行され、より長い `cleanupPeriodDays` が保持することを意図していたトランスクリプトを削除できました。30 日より新しいファイルは削除されませんでした。トランスクリプト書き込みを完全に無効にするには、[`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/ja/env-vars)環境変数を設定するか、非インタラクティブモード(`-p`)で `--no-session-persistence` フラグまたは `persistSession: false` SDK オプションを使用します。 | `20` |
251| `companyAnnouncements` | 起動時にユーザーに表示するアナウンス。複数のアナウンスが提供される場合、ランダムにサイクルされます。 | `["Welcome to Acme Corp! Review our code guidelines at docs.acme.com"]` |
252| `defaultShell` | **デフォルト**:`"bash"`、または Bash が利用できない場合は Windows で `"powershell"`。入力ボックス `!` コマンドのデフォルトシェル。`"bash"` または `"powershell"` を受け入れます。`"powershell"` を設定すると、インタラクティブ `!` コマンドが Windows 上の PowerShell を通じてルーティングされます。`CLAUDE_CODE_USE_POWERSHELL_TOOL=1` が必要です。[PowerShell ツール](/docs/ja/tools-reference#powershell-tool)を参照してください | `"powershell"` |
253| `deniedMcpServers` | managed-settings.json で設定されている場合、明示的にブロックされた MCP サーバーの拒否リスト。managed サーバーを含むすべてのスコープに適用されます。拒否リストがホワイトリストよりも優先されます。[Managed MCP 構成](/docs/ja/managed-mcp)を参照してください | `[{ "serverName": "filesystem" }]` |
254| `disableAgentView` | [バックグラウンドエージェントとエージェントビュー](/docs/ja/agent-view)をオフにするために `true` に設定します:`claude agents`、`--bg`、`/background`、およびオンデマンドスーパーバイザー。通常は [managed 設定](/docs/ja/permissions#managed-settings)で設定されます。`CLAUDE_CODE_DISABLE_AGENT_VIEW` を `1` に設定するのと同等です | `true` |
255| `disableAllHooks` | すべての [hooks](/docs/ja/hooks) とカスタム [ステータスライン](/docs/ja/statusline)を無効にします | `true` |
256| `disableArtifact` | [Artifact](/docs/ja/artifacts)ツールを無効にするために `true` に設定します。このツールはセッション出力を claude.ai 上のプライベート Web ページとして公開します。`CLAUDE_CODE_DISABLE_ARTIFACT` を `1` に設定するのと同等です | `true` |
257| `disableAutoMode` | [自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)の有効化を防ぐために `"disable"` に設定します。`Shift+Tab` サイクルから `auto` を削除し、起動時に `--permission-mode auto` を拒否します。[managed 設定](/docs/ja/permissions#managed-settings)で最も役立ちます。ユーザーはこれをオーバーライドできません | `"disable"` |
258| `disableBrowserExternalNavigation` | (Managed 設定のみ)デスクトップアプリの [Browser ペイン](/docs/ja/desktop#browse-external-sites)で外部ブラウジングをオフにするために `true` に設定します。ユーザーも Claude も外部サイトに移動できず、localhost 開発サーバープレビューは影響を受けません。値は JSON ブール値 `true` である必要があります。文字列 `"true"` は無視されます | `true` |
259| `disableBundledSkills` | [skills](/docs/ja/skills)とワークフローをオフにするために `true` に設定します。Claude Code に付属しています:バンドルされた skills とワークフローは完全に削除されますが、`/init` などの組み込みスラッシュコマンドは入力可能なままですが、モデルから非表示になります。`/doctor` は組み込みコマンドのように入力可能なままです。[`DISABLE_DOCTOR_COMMAND`](/docs/ja/env-vars)環境変数で非表示にします。プラグイン、`.claude/skills/`、および `.claude/commands/` からの Skills は影響を受けません。`CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` を `1` に設定するのと同等です | `true` |
260| `disableClaudeAiConnectors` | [claude.ai MCP コネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai)を無効にして、自動フェッチまたは接続されないようにします。任意の設定スコープで設定します。任意のソースの `true` が優先されるため、チェックインされたプロジェクト `.claude/settings.json` はリポジトリをクラウドコネクタから除外できますが、プロジェクトレベルの `false` はユーザーまたはポリシーレベルの `true` をオーバーライドできません。`--mcp-config` を通じて明示的に渡されたサーバーは影響を受けません。[個別のコネクタを拒否する](/docs/ja/managed-mcp)には、代わりに [`deniedMcpServers`](/docs/ja/managed-mcp)を使用します。Claude Code v2.1.182 以降が必要です | `true` |
261| `disableDeepLinkRegistration` | Claude Code が起動時にオペレーティングシステムで `claude-cli://` プロトコルハンドラーを登録するのを防ぐために `"disable"` に設定します。[ディープリンク](/docs/ja/deep-links)を使用すると、外部ツールは事前入力されたプロンプトで Claude Code セッションを開くことができます。プロトコルハンドラー登録が制限されているか、別途管理されている環境で役立ちます | `"disable"` |
262| `disabledMcpjsonServers` | `.mcp.json` ファイルから拒否する特定の MCP サーバーのリスト | `["filesystem"]` |
263| `disableRemoteControl` | [リモートコントロール](/docs/ja/remote-control)を無効にします:`claude remote-control`、`--remote-control` フラグ、自動開始、およびセッション内トグルをブロックします。通常は [managed 設定](/docs/ja/permissions#managed-settings)に配置されます。デバイスごとの MDM 強制用ですが、任意のスコープから機能します。Claude Code v2.1.128 以降が必要です | `true` |
264| `disableSideloadFlags` | (Managed 設定のみ)起動時に `--plugin-dir`、`--plugin-url`、`--agents`、および `--mcp-config` CLI フラグを拒否します。ユーザーはこれらを渡して、単一実行で [`strictKnownMarketplaces`](#strictknownmarketplaces)をバイパスできます。また、これらのフラグを内部的に使用して CLI を生成するサーフェスからのフラグも拒否します。現在 [Cowork](/docs/ja/desktop)デスクトップアプリのローカルセッション。すべてのサーバーがインプロセス `type: "sdk"` エントリである `--mcp-config` は引き続き受け入れられるため、Agent SDK と VS Code 拡張機能は機能し続けます。`claude mcp add`、`.mcp.json`、または SDK `setMcpServers()` はブロックされません。[`allowedMcpServers`](/docs/ja/managed-mcp)とペアにしてサーバーごとの MCP 制御を行います。Claude Code v2.1.193 以降が必要です | `true` |
265| `disableSkillShellExecution` | [skills](/docs/ja/skills) およびユーザー、プロジェクト、プラグイン、または追加ディレクトリソースからのカスタムコマンド内の `` !`...` `` および ` ```! ` ブロックのインラインシェル実行を無効にします。コマンドは実行される代わりに `[shell command execution disabled by policy]` に置き換えられます。バンドルされた skills および managed skills は影響を受けません。[managed 設定](/ja/permissions#managed-settings)で最も役立ちます。ユーザーはこれをオーバーライドできません | `true` |
266| `disableWorkflows` | **デフォルト**:`false`。[動的ワークフロー](/docs/ja/workflows#turn-workflows-off)とバンドルされたワークフローコマンドを無効にします。`CLAUDE_CODE_DISABLE_WORKFLOWS` を `1` に設定するのと同等です | `true` |
267| `editorMode` | **デフォルト**:`"normal"`。入力プロンプトのキーバインディングモード:`"normal"` または `"vim"`。`/config` に**エディターモード**として表示されます | `"vim"` |
268| `effortLevel` | [努力レベル](/docs/ja/model-config#adjust-effort-level)をセッション全体で永続化します。`"low"`、`"medium"`、`"high"`、または `"xhigh"` を受け入れます。これらの値のいずれかで `/effort` を実行すると自動的に書き込まれます。`--effort` と [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ja/env-vars)はこれを 1 セッション間オーバーライドします。[努力レベルを調整](/docs/ja/model-config#adjust-effort-level)でサポートされているモデルを参照してください | `"xhigh"` |
269| `enableAllProjectMcpServers` | プロジェクト `.mcp.json` ファイルで定義されたすべての MCP サーバーを自動的に承認します。v2.1.196 以降、`claude mcp list` と `claude mcp get` は [リポジトリにチェックインされていない設定ファイル](/docs/ja/mcp#managing-your-servers)からのみ信頼されていないフォルダでこのキーを尊重します | `true` |
270| `enableArtifact` | このユーザーの [Artifact](/docs/ja/artifacts)ツールを有効または無効にします。未設定の場合、デフォルトはあなたのアカウントの機能の[可用性](/docs/ja/artifacts#availability)に従います。`/config` の **Artifacts** 行がこのキーを書き込みます。managed `disableArtifact` とあなたの組織の [管理者設定](/docs/ja/artifacts#manage-artifacts-for-your-organization)が優先され、キーはプロジェクトおよびローカル設定(`.claude/settings.json`、`.claude/settings.local.json`)では無視されます。リポジトリはこれをコミットできます。Claude Code v2.1.196 以降が必要です | `true` |
271| `enabledMcpjsonServers` | `.mcp.json` ファイルから承認する特定の MCP サーバーのリスト。v2.1.196 以降、`claude mcp list` と `claude mcp get` は [リポジトリにチェックインされていない設定ファイル](/docs/ja/mcp#managing-your-servers)からのみ信頼されていないフォルダでこのキーを尊重します | `["memory", "github"]` |
272| `enforceAvailableModels` | managed 設定で `true` で `availableModels` が空でないリストの場合、デフォルトモデルもホワイトリストに制限されます。利用可能なモデルが最初のホワイトリストエントリにフォールバックします。ただし、モデル Default が解決する場合のみ([組織デフォルト](/docs/ja/model-config#organization-default-model)が適用される場合、それ以外の場合はアカウントタイプのデフォルト)がホワイトリストに含まれていない場合。ホワイトリストされたデフォルトはそのまま保持されます。`availableModels` が未設定または空の場合は効果がありません。[モデル選択を制限](/docs/ja/model-config#restrict-model-selection)を参照してください。Claude Code v2.1.175 以降が必要です | `true` |
273| `env` | すべてのセッションに適用される環境変数。変数を `""` に設定して、シェルエクスポートを空の文字列でオーバーライドします。Claude Code はこれを未設定として扱います。サブプロセスは引き続き空の値を継承します。`NO_COLOR` と `FORCE_COLOR` がここで設定されている場合、サブプロセスのみに到達します。Claude Code 自体のインターフェイスの色を変更するには、`claude` を起動する前にシェルでこれらを設定します。v2.1.195 以降、Claude Code のホスティング環境が設定する ID 変数(`CLAUDE_CODE_REMOTE` や `CLAUDE_CODE_ACCOUNT_UUID` など)は、ここで設定されている場合は無視されます | `{"FOO": "bar"}` |
274| `fallbackModel` | プライマリモデルがオーバーロードされているか利用できない場合に順番に試すフォールバックモデル。Claude Code はチェーン内の次の利用可能なモデルに切り替え、ターンの残りを表示し、通知を表示します。`"default"` はデフォルトモデルに展開されます。チェーンは 3 つのモデルに制限されます。余分なエントリは無視されます。ほとんどの配列設定とは異なり、このキーはスコープ全体でマージされません:これを定義する最高優先度ファイルが全体の値を提供します。[`--fallback-model`](/docs/ja/cli-reference#cli-flags)フラグはこれを 1 セッション間オーバーライドします。[フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains)を参照してください | `["claude-sonnet-5", "claude-haiku-4-5"]` |
275| `fastMode` | セッションで利用可能な場合、[高速モード](/docs/ja/fast-mode)をオンにします。`/fast` でトグルすると、ユーザー設定で `true` がここに書き込まれ、高速モードをオフにするときはキーが削除されます | `true` |
276| `fastModePerSessionOptIn` | `true` の場合、高速モードはセッション全体で永続化されません。各セッションは高速モードがオフで開始され、ユーザーが `/fast` で有効にする必要があります。ユーザーの高速モード設定は引き続き保存されます。[セッションごとのオプトインを要求](/docs/ja/fast-mode#require-per-session-opt-in)を参照してください | `true` |
277| `feedbackSurveyRate` | [セッション品質調査](/docs/ja/data-usage#session-quality-surveys)が適格な場合に表示される確率(0~1)。完全に抑制するには `0` に設定するか、`env` で [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](/docs/ja/env-vars)を設定します。Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry を使用する場合に役立ちます。デフォルトのサンプルレートは適用されません | `0.05` |
278| `fileCheckpointingEnabled` | **デフォルト**:`true`。各編集の前にファイルをスナップショットして、[`/rewind`](/docs/ja/checkpointing)でそれらを復元できるようにします。`/config` に\*\*コードを巻き戻す(チェックポイント)\*\*として表示されます。環境変数で無効にするには、`env` で [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](/docs/ja/env-vars)を設定します | `false` |
279| `fileSuggestion` | `@` ファイルオートコンプリート用のカスタムスクリプトを構成します。[ファイル提案設定](#file-suggestion-settings)を参照してください | `{"type": "command", "command": "~/.claude/file-suggestion.sh"}` |
280| `footerLinksRegexes` | ターン出力に正規表現がマッチするときにフッターにクリック可能なバッジをレンダリングします。各エントリには `pattern`、名前付きキャプチャグループから `{name}` プレースホルダーが入力される URL テンプレート、およびオプションの `label` があります。ユーザー、`--settings` フラグ、および managed 設定からのみ読み込まれます。[フッターリンクバッジ](#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/ja/claude-apps-gateway)を参照してください。managed 設定で設定されている場合、`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` で認証されたセッションは起動時にブロックされます。環境認証情報は必須のログイン方法を満たすことができないため。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry などのサードパーティプロバイダーセッションはブロックされません:これらはクラウドプロバイダーではなく Anthropic に対して認証されます | `claudeai` |
282| `forceLoginGatewayUrl` | `/login` クラウドゲートウェイ画面でゲートウェイ URL を事前入力してロックします。このキーまたは `forceLoginMethod: "gateway"` のいずれかがその画面を表示します。両方を設定して URL が入力されるようにします。managed ポリシーティアでのみ尊重されます。ユーザーおよびプロジェクト設定では無視されます。[Claude apps gateway](/docs/ja/claude-apps-gateway#set-the-gateway-url)を参照してください | `"https://claude-gateway.example.com"` |
283| `forceLoginOrgUUID` | ログインが特定の Anthropic 組織に属することを要求します。単一の UUID 文字列を受け入れます。これはログイン中にその組織を自動的に事前選択するか、リストされた組織のいずれかが受け入れられる UUID の配列を受け入れます。事前選択なし。managed 設定で設定されている場合、認証されたアカウントがリストされた組織に属していない場合、ログインは失敗します。`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` で認証されたセッションは起動時にブロックされます。これらのセッションでは組織メンバーシップを検証できないため。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry などのサードパーティプロバイダーセッションはブロックされません:クラウド IAM を使用して、どのクラウドアカウントを使用できるかを制限します。空配列は失敗して閉じられ、ログインを設定ミスメッセージでブロックします | `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"` または `["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"]` |
284| `forceRemoteSettingsRefresh` | (Managed 設定のみ)リモート managed 設定がサーバーから新しく取得されるまで CLI スタートアップをブロックします。フェッチが失敗した場合、キャッシュされた設定または設定なしで続行するのではなく、CLI は終了します。設定されていない場合、スタートアップはリモート設定を待たずに続行します。[fail-closed 強制](/docs/ja/server-managed-settings#enforce-fail-closed-startup)を参照してください | `true` |
285| `gcpAuthRefresh` | GCP Application Default Credentials が期限切れになったか読み込めない場合にリフレッシュするカスタムスクリプト。[高度な認証情報構成](/docs/ja/google-vertex-ai#advanced-credential-configuration)を参照してください | `gcloud auth application-default login` |
286| `hooks` | ライフサイクルイベントで実行するカスタムコマンドを構成します。形式については [hooks ドキュメント](/docs/ja/hooks)を参照してください | [hooks](/docs/ja/hooks)を参照 |
287| `httpHookAllowedEnvVars` | HTTP hooks がヘッダーに補間できる環境変数名のホワイトリスト。設定されている場合、各 hook の有効な `allowedEnvVars` はこのリストとの交差です。未定義 = 制限なし。配列はすべての設定ソース全体でマージされます。[Hook 構成](#hook-configuration)を参照してください | `["MY_TOKEN", "HOOK_SECRET"]` |
288| `includeGitInstructions` | **デフォルト**:`true`。Claude のシステムプロンプトに組み込みコミットおよび PR ワークフロー命令と git ステータススナップショットを含めます。たとえば、独自の git ワークフロースキルを使用する場合は、これらの命令を削除するために `false` に設定します。`CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` 環境変数が設定されている場合、この設定よりも優先されます | `false` |
289| `inputNeededNotifEnabled` | **デフォルト**:`false`。[リモートコントロール](/docs/ja/remote-control)が接続されている場合、権限プロンプトまたは質問があなたの入力を待っているときにスマートフォンにプッシュ通知を送信します。`/config` に**アクションが必要なときにプッシュ**として表示されます。[モバイルプッシュ通知](/docs/ja/remote-control#mobile-push-notifications)を参照してください。Claude Code v2.1.119 以降が必要です | `true` |
290| `language` | Claude の優先応答言語を構成します(例:`"japanese"`、`"spanish"`、`"french"`)。Claude はデフォルトでこの言語で応答します。また、[音声ディクテーション](/docs/ja/voice-dictation#change-the-dictation-language)言語も設定します。v2.1.176 以降、設定されていない場合、セッションタイトルは会話の言語と一致します | `"japanese"` |
291| `minimumVersion` | バックグラウンド自動更新と `claude update` が特定のバージョン以下にインストールするのを防止するフロア。`"latest"` チャネルから `"stable"` に `/config` を通じて切り替えると、現在のバージョンに留まるか、ダウングレードを許可するかを求めるプロンプトが表示されます。留まることを選択すると、この値が設定されます。また、[managed 設定](/docs/ja/permissions#managed-settings)で組織全体の最小値をピンするのに役立ちます。ハードフロアについては、`requiredMinimumVersion` を参照してください | `"2.1.100"` |
292| `model` | Claude Code に使用するデフォルトモデルをオーバーライドします。`--model` と [`ANTHROPIC_MODEL`](/docs/ja/model-config#environment-variables)はこれを 1 セッション間オーバーライドします | `"claude-sonnet-5"` |
293| `modelOverrides` | Anthropic モデル ID を Amazon Bedrock 推論プロファイル ARN などのプロバイダー固有のモデル ID にマップします。各モデルピッカーエントリは、プロバイダー API を呼び出すときにマップされた値を使用します。[バージョンごとにモデル ID をオーバーライド](/docs/ja/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/ja/env-vars)でリフレッシュ間隔を設定します。[動的ヘッダー](/docs/ja/monitoring-usage#dynamic-headers)を参照してください | `/bin/generate_otel_headers.sh` |
295| `outputStyle` | システムプロンプトを調整するための出力スタイルを構成します。[出力スタイルドキュメント](/docs/ja/output-styles)を参照してください | `"Explanatory"` |
296| `parentSettingsBehavior` | (Managed 設定のみ)**デフォルト**:`"first-wins"`。Agent SDK または IDE 拡張機能などの埋め込みホストプロセスによってプログラム的に提供される managed 設定が、管理者デプロイ済みの managed ティアも存在する場合に適用されるかどうかを制御します。`"first-wins"`:親提供の設定は削除され、管理者ティアのみが適用されます。`"merge"`:親提供の設定は管理者ティアの下で適用され、ポリシーを厳しくできるが緩くすることはできないようにフィルタリングされます。管理者ティアがデプロイされていない場合は効果がありません。Claude Code v2.1.133 以降が必要です | `"merge"` |
297| `permissions` | 権限の構造については、以下の表を参照してください。 | |
298| `plansDirectory` | **デフォルト**:`~/.claude/plans`。プランファイルが保存される場所をカスタマイズします。パスはプロジェクトルートに相対的です。 | `"./plans"` |
299| `pluginSuggestionMarketplaces` | (Managed 設定のみ)プラグインが文脈的なインストール提案として表示される可能性があるマーケットプレイス名。提案は各プラグインのマーケットプレイスエントリの `relevance` 宣言から来ます。名前は、マーケットプレイスがマシンに登録されており、その登録されたソースが managed 設定でも宣言されている場合にのみ有効になります。その名前の `extraKnownMarketplaces` エントリとして、または `strictKnownMarketplaces` のエントリとして。異なるソースから登録されたマーケットプレイスはホワイトリストされた名前の下で無視されます。公式マーケットプレイスはソース要件から除外されます:その名前をホワイトリストするだけで十分です。その名前は公式 Anthropic ソースからのみ登録できるため。 | `["acme-corp-plugins"]` |
300| `pluginTrustMessage` | (Managed 設定のみ)インストール前に表示されるプラグイン信頼警告に追加されるカスタムメッセージ。これを使用して、組織固有のコンテキストを追加します。たとえば、内部マーケットプレイスからのプラグインが検証されていることを確認します。 | `"All plugins from our marketplace are approved by IT"` |
301| `policyHelper` | 起動時に managed 設定を動的に計算する管理者デプロイ済みの実行可能ファイル。MDM またはシステム `managed-settings.json` ファイルからのみ尊重されます。[ポリシーヘルパーで managed 設定を計算](#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` に**通知**として表示されます。[ターミナルベルまたは通知を取得](/docs/ja/terminal-config#get-a-terminal-bell-or-notification)を参照してください | `"terminal_bell"` |
303| `prefersReducedMotion` | アクセシビリティのために UI アニメーション(スピナー、シマー、フラッシュエフェクト)を削減または無効にします | `true` |
304| `prUrlTemplate` | フッターおよびツール結果サマリーに表示される PR バッジの URL テンプレート。`gh` レポートされた PR URL から `{host}`、`{owner}`、`{repo}`、`{number}`、および `{url}` を置き換えます。PR リンクを `github.com` の代わりに内部コードレビューツールにポイントするために使用します。Claude の散文の `#123` オートリンクには影響しません | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |
305| `remoteControlAtStartup` | 各インタラクティブセッションの開始時に [リモートコントロール](/docs/ja/remote-control)を自動的に接続します。`/remote-control` を待つ代わりに。`true` に設定して常に自動接続するか、`false` に設定して自動接続しないか、組織のデフォルトに従うために未設定のままにします。`/config` に**すべてのセッションでリモートコントロールを有効にする**として表示されます。[すべてのセッションでリモートコントロールを有効にする](/docs/ja/remote-control#enable-remote-control-for-all-sessions)を参照してください | `false` |
306| `requiredMaximumVersion` | Managed 設定のみ。起動を許可される最大 Claude Code バージョン。実行中のバージョンがより新しい場合、Claude Code は起動時に終了し、ユーザーに組織の承認された方法を通じて承認されたバージョンをインストールするよう指示します。`claude install <version>` も機能する可能性があります。バックグラウンド自動更新と `claude update` は上限を超えるバージョンをスキップするため、範囲内のインストールは範囲内のままです。`claude update`、`claude install`、および `claude doctor` は上限を超えて機能し続けるため、ユーザーは回復できます。この設定より前のバージョンはそれを無視します | `"2.1.150"` |
307| `requiredMinimumVersion` | Managed 設定のみ。起動に必要な最小 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 が応答するかどうか。コマンド出力をコンテキストに追加するが応答なしで `false` に設定します。[`!` プレフィックス付きシェルモード](/docs/ja/interactive-mode#shell-mode-with-prefix)を参照してください。Claude Code v2.1.186 以降が必要です | `false` |
310| `showClearContextOnPlanAccept` | **デフォルト**:`false`。プラン受け入れ画面に「コンテキストをクリア」オプションを表示します。`true` に設定してオプションを復元します | `true` |
311| `showThinkingSummaries` | **デフォルト**:`false`。[拡張思考](/docs/ja/model-config#extended-thinking)サマリーをインタラクティブセッションに表示します。未設定または `false` の場合、思考ブロックは API によって編集され、折りたたまれたスタブとして表示されます。編集は表示内容のみを変更し、モデルが生成するものは変更しません:思考支出を削減するには、[予算を低下させるか思考を無効にする](/docs/ja/model-config#extended-thinking)代わりに。この設定は非インタラクティブモード(`-p`)、Agent SDK、または VS Code などの IDE 拡張機能には影響しません | `true` |
312| `showTurnDuration` | **デフォルト**:`true`。レスポンス後のターン期間メッセージを表示します(例:「Cooked for 1m 6s」)。`/config` に**ターン期間を表示**として表示されます | `false` |
313| `skillListingBudgetFraction` | **デフォルト**:`0.01`。[スキルリスティング](/docs/ja/skills#skill-descriptions-are-cut-short)Claude が各ターンで見るモデルのコンテキストウィンドウ用に予約されたフラクション。リスティングが予算を超える場合、最も使用頻度の低いスキルの説明は、Claude が引き続き呼び出すことができるが理由を見ることができないように、ベアネームに折りたたまれます。より多くの説明を表示するために上げるか、より多くのスキルを収めるために下げます。`/doctor` は現在の切り詰めカウントと影響を受けるスキルを表示します | `0.02` |
314| `skillListingMaxDescChars` | **デフォルト**:`1536`。[スキルリスティング](/docs/ja/skills#skill-descriptions-are-cut-short)Claude が各ターンで見る `description` と `when_to_use` テキストの結合されたスキルごとの文字上限。この長さより長いテキストは切り詰められます。長い説明を保持するために上げるか、より多くのスキルを [`skillListingBudgetFraction`](#available-settings)の下に収めるために下げます | `2048` |
315| `skillOverrides` | スキル名でキー付けされたスキルごとの可視性オーバーライド。値は `"on"`、`"name-only"`、`"user-invocable-only"`、または `"off"` です。スキルの SKILL.md を編集することなく、スキルを非表示または折りたたむことができます。プラグインスキルには適用されません。これらは `/plugin` を通じて管理されます。`/skills` メニューはこれらを `.claude/settings.local.json` に書き込みます。[設定からスキルの可視性をオーバーライド](/docs/ja/skills#override-skill-visibility-from-settings)を参照してください。Claude Code v2.1.129 以降が必要です | `{"legacy-context": "name-only", "deploy": "off"}` |
316| `skipWebFetchPreflight` | [WebFetch ドメイン安全チェック](/docs/ja/data-usage#webfetch-domain-safety-check)をスキップします。このチェックは、フェッチ前に各リクエストされたホスト名を `api.anthropic.com` に送信します。Amazon Bedrock、Google Cloud の Agent Platform、または制限的な出力を持つ Microsoft Foundry デプロイメントなど、Anthropic へのトラフィックをブロックする環境で `true` に設定します。スキップされた場合、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` | [Desktop](/docs/ja/desktop#pre-configure-ssh-connections-for-your-team)環境ドロップダウンに表示する SSH 接続。各エントリには `id`、`name`、および `sshHost` が必要です。`sshPort`、`sshIdentityFile`、および `startDirectory` はオプションです。managed 設定で設定されている場合、接続はユーザーに対して読み取り専用です。managed およびユーザー設定からのみ読み込まれます | `[{"id": "dev-vm", "name": "Dev VM", "sshHost": "user@dev.example.com"}]` |
321| `statusLine` | コンテキストを表示するカスタムステータスラインを構成します。[`statusLine` ドキュメント](/docs/ja/statusline)を参照してください | `{"type": "command", "command": "~/.claude/statusline.sh"}` |
322| `strictKnownMarketplaces` | (Managed 設定のみ)プラグインマーケットプレイスソースのホワイトリスト。未定義 = 制限なし、空配列 = ロックダウン。マーケットプレイス追加時およびプラグインのインストール、更新、リフレッシュ、自動更新時に適用されるため、ポリシーが設定される前に追加されたマーケットプレイスは使用できません。[Managed マーケットプレイス制限](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions)を参照してください | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |
323| `strictPluginOnlyCustomization` | (Managed 設定のみ)ユーザーおよびプロジェクトソースからの skills、agents、hooks、および MCP サーバーをブロックして、プラグインまたは managed 設定からのみ取得できるようにします。`true` は 4 つすべてをロックします。配列は名前付きのものだけをロックします。[`strictPluginOnlyCustomization`](#strictpluginonlycustomization)を参照してください | `["skills", "hooks"]` |
324| `syntaxHighlightingDisabled` | diff、コードブロック、ファイルプレビューの構文強調表示を無効にします | `true` |
325| `teammateMode` | **デフォルト**:`in-process`。[エージェントチーム](/docs/ja/agent-teams)チームメイトの表示方法:`in-process`、`auto`(tmux または iTerm2 で分割ペインを選択、それ以外の場合はインプロセス)、`tmux`(tmux または iTerm2 を使用して分割ペインを選択、ターミナルから検出)、または }`iterm2`(iTerm2 ネイティブ分割ペイン。v2.1.186 で追加された `it2` CLI 経由)。デフォルトは v2.1.179 で `auto` から変更されました。`--teammate-mode` はこれを 1 セッション間オーバーライドします。[表示モードを選択](/docs/ja/agent-teams#choose-a-display-mode)を参照してください | `"auto"` |
326| `terminalProgressBarEnabled` | **デフォルト**:`true`。サポートされているターミナルでターミナル進行状況バーを表示します:ConEmu、Ghostty 1.2.0 以降、および iTerm2 3.6.6 以降。`/config` に**ターミナル進行状況バー**として表示されます | `false` |
327| `theme` | **デフォルト**:`"dark"`。インターフェイスのカラーテーマ:`"auto"`、`"dark"`、`"light"`、`"dark-daltonized"`、`"light-daltonized"`、`"dark-ansi"`、`"light-ansi"`、または `"custom:<slug>"` または `"custom:<plugin-name>:<slug>"` などのカスタムテーマリファレンス。[カスタムテーマを作成](/docs/ja/terminal-config#create-a-custom-theme)を参照してください。`/config` に**テーマ**として表示されます | `"dark"` |
328| `tui` | ターミナル UI レンダラー。フリッカーのない[alt-screen レンダラー](/docs/ja/fullscreen)を備えた仮想スクロールバック用に `"fullscreen"` を使用します。クラシックメインスクリーンレンダラー用に `"default"` を使用します。`/tui` で設定します。[`CLAUDE_CODE_NO_FLICKER`](/docs/ja/env-vars)環境変数を設定することもできます。[エージェントビュー](/docs/ja/agent-view)から開かれたバックグラウンドセッションは、この設定に関係なく常にフルスクリーンレンダラーを使用します | `"fullscreen"` |
329| `ultracode` | セッションの [ultracode](/docs/ja/workflows#let-claude-decide-with-ultracode)をオンにします。セッションのみで `settings.json` から読み込まれません。`/effort ultracode`、`--settings`、または Agent SDK 制御リクエストを通じて設定します。ultracode をオンで開始するには、`claude --effort ultracode` で起動します。Claude Code v2.1.203 以降が必要です | `true` |
330| `useAutoModeDuringPlan` | **デフォルト**:`true`。プラン モードが自動モードが利用可能な場合に自動モードセマンティクスを使用するかどうか。共有プロジェクト設定から読み込まれません。`/config` に「プラン中に自動モードを使用」として表示されます | `false` |
331| `verbose` | **デフォルト**:`false`。切り詰められたサマリーの代わりに完全なツール出力を表示します。`/config` に**詳細出力**として表示されます。`--verbose` フラグはこれを 1 セッション間オーバーライドします | `true` |
332| `viewMode` | 起動時のデフォルトトランスクリプトビューモード:`"default"`、`"verbose"`、または `"focus"`。設定されている場合、スティッキー `/focus` 選択をオーバーライドします。`--verbose` フラグはこれを 1 セッション間オーバーライドします | `"verbose"` |
333| `vimInsertModeRemaps` | }[vim エディターモード](/docs/ja/interactive-mode#vim-editor-mode)で 2 キーの INSERT モードシーケンスを Escape にマップします。各キーは正確に 2 つの印字可能文字で、順序で入力され、`"<Esc>"` は唯一のサポートされているターゲットです。他のエントリは無視されます。ユーザー、`--settings` フラグ、および managed 設定からのみ読み込まれるため、リポジトリのチェックイン設定はキーストロークを再マップできません。`editorMode` が `"vim"` でない限り効果がありません。[INSERT モードキーシーケンスを再マップ](/docs/ja/interactive-mode#remap-insert-mode-key-sequences)を参照してください。Claude Code v2.1.208 以降が必要です | `{"jj": "<Esc>"}` |
334| `voice` | [音声ディクテーション](/docs/ja/voice-dictation)設定:`enabled` はディクテーションをオンにし、`mode` は `"hold"` または `"tap"` を選択し、`autoSubmit` はホールドモードでキーリリース時にプロンプトを送信します。`/voice` を実行すると自動的に書き込まれます。Claude.ai アカウントが必要です | `{ "enabled": true, "mode": "tap" }` |
335| `voiceEnabled` | `voice.enabled` のレガシーエイリアス。`voice` オブジェクトを優先します | `true` |
336| `wheelScrollAccelerationEnabled` | **デフォルト**:`true`。[フルスクリーンレンダリング](/docs/ja/fullscreen#mouse-wheel-scrolling)で、高速スクロール中にマウスホイールスクロール速度を加速します。ホイールノッチごとに一定のスクロール速度を使用するには `false` に設定します。Claude Code v2.1.174 以降が必要です | `false` |
337| `workflowKeywordTriggerEnabled` | **デフォルト**:`true`。プロンプト内の単語 `ultracode` が[動的ワークフロー](/docs/ja/workflows#ask-for-a-workflow-in-your-prompt)をトリガーするかどうか。単語を入力してトリガーしないようにするには `false` に設定します。ultracode 努力設定、`/workflows`、および保存されたワークフローコマンドは影響を受けません。`/config` に**ワークフローキーワードトリガー**として表示されます。v2.1.157 で追加されました。v2.1.160 より前は、トリガーキーワードは `workflow` でした | `false` |
338| `wslInheritsWindowsSettings` | (Windows managed 設定のみ)`true` の場合、WSL 上の Claude Code は `/etc/claude-code` に加えて Windows ポリシーチェーンから managed 設定を読み込み、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>
343 495
344これらの設定は `settings.json` ではなく `~/.claude.json` に保存されます。これらを `settings.json` に追加すると、スキーマ検証エラーがトリガーされます。496v2.1.211 より前では、Claude Code は開始ディレクトリにファイルを保持していました。以前のバージョンが残したファイルをルートファイルと並行して読み込みます。両方が同じキーを設定する場合、ルートの値が適用され、両方のファイルからの権限ルールが適用されます。Agent SDK の [`resolveSettings()`](/docs/ja/agent-sdk/typescript#resolvesettings) ヘルパーは常に開始ディレクトリからファイルを読み込みます。
345 497
346<Note>498Claude Code は共有 `.claude/settings.json` をセッションの[プライマリ作業ディレクトリ](/docs/ja/permissions#working-directories)から読み込むため、リポジトリルートにコミットされたファイルを使用するには、そこから Claude Code を開始してください。[`/cd`](/docs/ja/permissions#move-the-session-to-another-directory) でセッションを移動した後、Claude Code は代わりに新しいディレクトリから両方のプロジェクトファイルを読み込み、同じルールでローカルファイルを配置します。移動したディレクトリから読み込むには Claude Code v2.1.246 以降が必要です。
347 v2.1.119 より前のバージョンでは、`theme`、`verbose`、`editorMode`、`autoCompactEnabled`、および `preferredNotifChannel` も `settings.json` ではなくここに保存されます。
348</Note>
349 499
350| キー | 説明 | 例 |500<span id="managed-settings-delivery" />
351| :--------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- |
352| `autoConnectIde` | **デフォルト**:`false`。Claude Code が外部ターミナルから起動するときに、実行中の IDE に自動的に接続します。VS Code または JetBrains ターミナルの外で実行する場合、`/config` に\*\*IDE に自動接続(外部ターミナル)\*\*として表示されます。[`CLAUDE_CODE_AUTO_CONNECT_IDE`](/docs/ja/env-vars)環境変数が設定されている場合、これをオーバーライドします | `true` |
353| `autoInstallIdeExtension` | **デフォルト**:`true`。VS Code ターミナルから実行するときに Claude Code IDE 拡張機能を自動的にインストールします。VS Code または JetBrains ターミナル内で実行する場合、`/config` に**IDE 拡張機能を自動インストール**として表示されます。[`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/docs/ja/env-vars)環境変数を設定することもできます | `false` |
354| `externalEditorContext` | **デフォルト**:`false`。`Ctrl+G` で外部エディターを開くときに Claude の前の応答を `#` コメント付きコンテキストとして先頭に追加します。`/config` に**外部エディターに最後の応答を表示**として表示されます | `true` |
355| `permissionExplainerEnabled` | **デフォルト**:`true`。Bash または PowerShell 権限プロンプトで `Ctrl+E` を押すときに、モデル生成の[コマンドの説明](/docs/ja/permissions#permission-system)を表示します。ショートカットをオフにするには `false` に設定します | `false` |
356| `teammateDefaultModel` | [エージェントチーム](/docs/ja/agent-teams)チームメイトのデフォルトモデル。spawn プロンプトが指定しない場合。`"sonnet"` などのモデルエイリアスに設定するか、リーダーの現在の `/model` 選択を継承するために `null` に設定します。`/config` に**デフォルトチームメイトモデル**として表示されます | `"sonnet"` |
357| `workflowSizeGuideline` | **デフォルト**:`unrestricted`。ガイドラインを送信しません。[エージェント数 Claude が目指す](/docs/ja/workflows#set-a-size-guideline)動的ワークフローで書き込みます。Claude Code は値を Claude にアドバイスとして送信し、強制されたキャップではありません。`unrestricted`、`small`、`medium`、または `large` を受け入れます。`/config` に**動的ワークフローサイズ**として表示されます。`/config workflowSizeGuideline=small` で直接設定することもできます。Claude Code v2.1.202 以降が必要です。ガイドラインのエージェント数は、[`Large workflow` 警告](/docs/ja/workflows#cost)のデフォルト閾値も置き換えます。その動作は Claude Code v2.1.203 以降が必要です | `"small"` |
358
359<h3 id="worktree-settings">
360 Worktree 設定
361</h3>
362 501
363`--worktree` が git worktrees を作成および管理する方法を構成します。502<span id="precedence-within-the-managed-tier" />
364 503
365| キー | 説明 | 例 |504<span id="parent-settings-from-embedding-hosts" />
366| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |
367| `worktree.baseRef` | 新しい worktrees がブランチする ref。`"fresh"`(デフォルト)は `origin/<default-branch>` からブランチして、リモートと一致するクリーンツリーを取得します。`"head"` は現在のローカル `HEAD` からブランチするため、プッシュされていないコミットとフィーチャーブランチの状態が worktree に存在します。`--worktree`、`EnterWorktree` ツール、および subagent 分離に適用されます | `"head"` |
368| `worktree.symlinkDirectories` | メインリポジトリから各 worktree にシンボリックリンクするディレクトリ。ディスク上の大規模なディレクトリの重複を避けるため。デフォルトではディレクトリはシンボリックリンクされません | `["node_modules", ".cache"]` |
369| `worktree.sparsePaths` | git sparse-checkout を通じて各 worktree でチェックアウトするディレクトリ。リストされたパスのみがディスク上に書き込まれます。大規模なモノレポではより高速です | `["packages/my-app", "shared/utils"]` |
370| `worktree.bgIsolation` | [バックグラウンドセッション](/docs/ja/agent-view#how-file-edits-are-isolated)の分離モード。`"worktree"`(デフォルト)は `EnterWorktree` が呼び出されるまでメインチェックアウトで `Edit`/`Write` をブロックします。git リポジトリの外では、失敗する [`WorktreeCreate` hook](/docs/ja/worktrees#non-git-version-control)がブロックを解放して、セッションが作業ディレクトリを所定の位置で編集できるようにします。Claude Code v2.1.203 以降が必要です。`"none"` はバックグラウンドジョブがワーキングコピーを直接編集できるようにします。Claude Code v2.1.143 以降が必要です | `"none"` |
371 505
372gitignored ファイル(`.env` など)を新しい worktrees にコピーするには、設定の代わりにプロジェクトルートの [`.worktreeinclude` ファイル](/docs/ja/worktrees#copy-gitignored-files-into-worktrees)を使用します。506<span id="enforce-settings-for-an-organization" />
373 507
374<h3 id="permission-settings">508<span id="settings-your-organization-manages" />
375 権限設定
376</h3>
377 509
378| キー | 説明 | 例 |510<h3 id="check-what-your-organization-enforces">
379| :---------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------- |511 組織が強制する内容を確認する
380| `allow` | ツール使用を許可する権限ルールの配列。ツール名 glob はリテラル `mcp__<server>__` プレフィックスの後のツール位置でのみサポートされます。たとえば `mcp__github__get_*`。サーバーセグメントは glob フリーである必要があります。パターンマッチングの詳細については、以下の[権限ルール構文](#permission-rule-syntax)を参照してください | `[ "Bash(git diff *)" ]` |
381| `ask` | ツール使用時に確認を求める権限ルールの配列。[権限ルール構文](#permission-rule-syntax)を参照してください | `[ "Bash(git push *)" ]` |
382| `deny` | ツール使用を拒否する権限ルールの配列。これを使用して、機密ファイルを Claude Code アクセスから除外します。ツール名は glob パターンを受け入れます:`"*"` はすべてのツールを拒否し、`"mcp__*"` はすべての MCP ツールを拒否します。[権限ルール構文](#permission-rule-syntax)と [Bash 権限制限](/docs/ja/permissions#tool-specific-permission-rules)を参照してください | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |
383| `additionalDirectories` | Claude がアクセスできる追加の[作業ディレクトリ](/docs/ja/permissions#working-directories)。ほとんどの `.claude/` 構成は[これらのディレクトリから検出されません](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration) | `[ "../docs/" ]` |
384| `defaultMode` | Claude Code を開くときのデフォルト[権限モード](/docs/ja/permission-modes)。有効な値:`default`、`acceptEdits`、`plan`、`auto`、`dontAsk`、`bypassPermissions`、および }`manual` は `default` のエイリアス。CLI および VS Code と JetBrains 拡張機能で Manual とラベル付けされたモード。manual エイリアスは Claude Code v2.1.200 以降が必要です。v2.1.142 以降、`auto` はプロジェクトまたはローカル設定(`.claude/settings.json`、`.claude/settings.local.json`)で設定されている場合は無視されるため、リポジトリはそれ自体に自動モードを付与できません。代わりに `~/.claude/settings.json` で設定します。`--permission-mode` CLI フラグは単一セッションのこの設定をオーバーライドします | `"acceptEdits"` |
385| `disableBypassPermissionsMode` | `"disable"` に設定して `bypassPermissions` モードの有効化を防止します。これにより `--dangerously-skip-permissions` フラグが無効になります。通常は [managed 設定](/docs/ja/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>512</h3>
391 513
392権限ルールは `Tool` または `Tool(specifier)` の形式に従います。ルールは順序で評価されます:最初に拒否ルール、次に ask、次に allow。最初に一致するルールが優先されます。[権限ルール評価順序](/docs/ja/permissions#manage-permissions)を参照してください。514組織が Claude Code を管理する場合、いくつかの設定はあなたのために決定され、独自のファイルに入れるものは何もそれらを変更しません。どれを確認するには、`/status` を実行してください。`Setting sources` 行は、あなたに適用される管理ソースの名前を付けます。管理設定はこのマシンで Claude Code が実行される場所に到達します。[開発者が変更できる内容](/docs/ja/managed-settings#what-a-developer-can-change)はローカル管理者権限と Claude Code 以外のツールをカバーしています。
393
394クイック例:
395
396| ルール | 効果 |
397| :----------------------------- | :------------------------- |
398| `Bash` | すべての Bash コマンドに一致 |
399| `Bash(npm run *)` | `npm run` で始まるコマンドに一致 |
400| `Read(./.env)` | `.env` ファイルの読み取りに一致 |
401| `WebFetch(domain:example.com)` | example.com へのフェッチリクエストに一致 |
402
403ワイルドカード動作、Read、Edit、WebFetch、MCP、および Agent ルール用のツール固有パターン、および Bash パターンのセキュリティ制限を含む完全なルール構文リファレンスについては、[権限ルール構文](/docs/ja/permissions#permission-rule-syntax)を参照してください。
404
405<h3 id="sandbox-settings">
406 サンドボックス設定
407</h3>
408 515
409高度なサンドボックス動作を構成します。サンドボックスは bash コマンドをファイルシステムとネットワークから分離します。詳細については [サンドボックス](/docs/ja/sandboxing)を参照してください。516管理設定は[管理設定ページ](/docs/ja/managed-settings#delivery-mechanisms)の配信メカニズムを通じてあなたに到達します。最も一般的には:
410
411| キー | 説明 | 例 |
412| :------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |
413| `enabled` | bash サンドボックスを有効にします(macOS、Linux、WSL2)。デフォルト:false | `true` |
414| `failIfUnavailable` | `sandbox.enabled` が true だがサンドボックスが起動できない場合(依存関係の欠落、サポートされていないプラットフォーム)、起動時にエラーで終了します。false(デフォルト)の場合、警告が表示され、コマンドはサンドボックス化されずに実行されます。managed 設定デプロイメント用で、サンドボックスをハードゲートとして必要とします | `true` |
415| `autoAllowBashIfSandboxed` | サンドボックス化されている場合、bash コマンドを自動承認します。デフォルト:true | `true` |
416| `excludedCommands` | サンドボックスの外で実行する必要があるコマンド | `["docker *"]` |
417| `allowUnsandboxedCommands` | `dangerouslyDisableSandbox` パラメータを通じてコマンドをサンドボックスの外で実行することを許可します。`false` に設定すると、`dangerouslyDisableSandbox` エスケープハッチが完全に無効になり、すべてのコマンドはサンドボックス化されるか `excludedCommands` に含まれる必要があります。厳密なサンドボックスを必要とするエンタープライズポリシーに役立ちます。デフォルト:true | `false` |
418| `filesystem.allowWrite` | サンドボックス化されたコマンドが書き込みできる追加パス。配列はすべての設定スコープ全体でマージされます:ユーザー、プロジェクト、および managed パスが結合され、置き換えられません。`Edit(...)` allow 権限ルールからのパスともマージされます。以下の[パスプレフィックス](#sandbox-path-prefixes)を参照してください。 | `["/tmp/build", "~/.kube"]` |
419| `filesystem.denyWrite` | サンドボックス化されたコマンドが書き込みできないパス。配列はすべての設定スコープ全体でマージされます。`Edit(...)` deny 権限ルールからのパスともマージされます。 | `["/etc", "/usr/local/bin"]` |
420| `filesystem.denyRead` | サンドボックス化されたコマンドが読み取りできないパス。配列はすべての設定スコープ全体でマージされます。`Read(...)` deny 権限ルールからのパスともマージされます。 | `["~/.aws/credentials"]` |
421| `filesystem.allowRead` | `denyRead` 領域内での読み取りを再度許可するパス。`denyRead` よりも優先されます。配列はすべての設定スコープ全体でマージされます。これを使用してワークスペースのみの読み取りアクセスパターンを作成します。 | `["."]` |
422| `filesystem.allowManagedReadPathsOnly` | (Managed 設定のみ)managed 設定からの `filesystem.allowRead` パスのみが尊重されます。`denyRead` はすべてのソースからマージされます。デフォルト:false | `true` |
423| `credentials.files` | サンドボックス化されたコマンドが読み取りできない認証情報ファイルまたはディレクトリ。`filesystem.denyRead` と同じ読み取りブロックを適用します。個別のキーは認証情報パスを `credentials.envVars` と一緒にグループ化し、一般的なファイルシステムルールから離します。各エントリは `{ "path": "...", "mode": "deny" }` です。パスは `filesystem.*` 設定と同じ[プレフィックス](#sandbox-path-prefixes)を使用します。配列はすべての設定スコープ全体でマージされます。`deny` のみがサポートされています。Claude Code v2.1.187 以降が必要です。 | `[{ "path": "~/.aws/credentials", "mode": "deny" }]` |
424| `credentials.envVars` | [サンドボックス化されたコマンドから保護](/docs/ja/sandboxing#protect-credentials)する環境変数。各エントリは `name` と `mode` を持ちます。名前は文字またはアンダースコアで始まり、文字、数字、アンダースコアのみを含む必要があります。`deny` は変数をサンドボックス化されたコマンドの環境から削除します。Claude Code v2.1.187 以降が必要です。}`mask` は変数をセッションごとのセンチネル値でサンドボックス内に置き換え、サンドボックスプロキシはそのエントリの `injectHosts` へのアウトバウンドリクエストで実際の値を置き換えます。`network.tlsTerminate` と Claude Code v2.1.199 以降が必要です。`mask` エントリはユーザー、managed、または CLI `--settings` 設定からのみ尊重され、`.claude/settings.json` または `.claude/settings.local.json` からは尊重されません。配列はすべての設定スコープ全体でマージされ、同じ変数が両方のモードで表示される場合、`deny` が優先されます。 | `[{ "name": "GITHUB_TOKEN", "mode": "deny" }]` |
425| `credentials.envVars[].injectHosts` | サンドボックスプロキシが `mask` エントリの実際の値を置き換えるホスト。各ホストは `network.allowedDomains` でもカバーされている必要があります。正確にまたはワイルドカードで。未設定の場合、プロキシは `network.allowedDomains` のすべてのホストへのリクエストで値を置き換えます。`mode` が `deny` の場合は受け入れられますが無視されます。Claude Code v2.1.199 以降が必要です。 | `["api.github.com"]` |
426| `credentials.allowPlaintextInject` | TLS 終了 HTTPS だけでなく、プレーン HTTP リクエストでも `mask` 置換を許可します。プレーン HTTP ではアップストリーム ID が検証されず、認証情報がクリアテキストで移動するため、信頼されたテストネットワーク外ではこれをオフのままにしてください。ユーザー、managed、または CLI `--settings` 設定からのみ尊重され、`.claude/settings.json` または `.claude/settings.local.json` からは尊重されません。デフォルト:false。Claude Code v2.1.199 以降が必要です。 | `true` |
427| `network.allowUnixSockets` | (macOS のみ)サンドボックスでアクセス可能な Unix ソケットパス。Linux と WSL2 では無視されます。seccomp フィルターは `socket(AF_UNIX, ...)` 呼び出しをブロックできないため、代わりに `allowAllUnixSockets` を使用します。 | `["~/.ssh/agent-socket"]` |
428| `network.allowAllUnixSockets` | サンドボックス内のすべての Unix ソケット接続を許可します。Linux と WSL2 ではこれが Unix ソケットを許可する唯一の方法です。seccomp フィルターをスキップするため、`socket(AF_UNIX, ...)` 呼び出しをブロックします。デフォルト:false | `true` |
429| `network.allowLocalBinding` | localhost ポートへのバインドを許可します(macOS のみ)。デフォルト:false | `true` |
430| `network.allowMachLookup` | サンドボックスが検索できる追加の XPC/Mach サービス名(macOS のみ)。プレフィックスマッチング用に単一の末尾 `*` をサポートします。iOS Simulator または Playwright などの XPC を通じて通信するツールに必要です。 | `["com.apple.coresimulator.*"]` |
431| `network.allowedDomains` | アウトバウンドネットワークトラフィックを許可するドメインの配列。ワイルドカード(例:`*.example.com`)をサポートします。 | `["github.com", "*.npmjs.org"]` |
432| `network.deniedDomains` | アウトバウンドネットワークトラフィックをブロックするドメインの配列。`allowedDomains` と同じワイルドカード構文をサポートします。両方が一致する場合、拒否リストが優先されます。すべての設定ソースからマージされます。`allowManagedDomainsOnly` に関係なく | `["sensitive.cloud.example.com"]` |
433| `network.allowManagedDomainsOnly` | (Managed 設定のみ)managed 設定からの `allowedDomains` および `WebFetch(domain:...)` allow ルールのみが尊重されます。ユーザー、プロジェクト、およびローカル設定からのドメインは無視されます。許可されていないドメインはユーザーにプロンプトを表示せずに自動的にブロックされます。拒否されたドメインはすべてのソースから引き続き尊重されます。デフォルト:false | `true` |
434| `network.httpProxyPort` | 独自のプロキシを使用する場合に使用される HTTP プロキシポート。指定されていない場合、Claude は独自のプロキシを実行します。 | `8080` |
435| `network.socksProxyPort` | 独自のプロキシを使用する場合に使用される SOCKS5 プロキシポート。指定されていない場合、Claude は独自のプロキシを実行します。 | `8081` |
436| `network.tlsTerminate` | 実験的。サンドボックスプロキシ内で TLS を終了して、HTTPS リクエストの内容を読み取ることができるようにします。`mask` [認証情報置換](/docs/ja/sandboxing#protect-credentials)に必要です。セッション用に一時的な認証局を生成するには `{}` に設定するか、独自の CA を使用するには `caCertPath` と `caKeyPath` を設定します。ユーザー、managed、または CLI `--settings` 設定からのみ尊重され、`.claude/settings.json` または `.claude/settings.local.json` からは尊重されません。Claude Code v2.1.199 以降が必要です。 | `{}` |
437| `enableWeakerNestedSandbox` | 非特権 Docker 環境用の弱いサンドボックスを有効にします(Linux と WSL2 のみ)。**セキュリティを低下させます。** デフォルト:false | `true` |
438| `enableWeakerNetworkIsolation` | (macOS のみ)サンドボックス内のシステム TLS 信頼サービス(`com.apple.trustd.agent`)へのアクセスを許可します。`httpProxyPort` を MITM プロキシおよびカスタム CA と共に使用する場合、`gh`、`gcloud`、`terraform` などの Go ベースのツールが TLS 証明書を検証するために必要です。**セキュリティを低下させます**。データ流出の可能性のあるパスを開きます。デフォルト:false | `true` |
439| `allowAppleEvents` | (macOS のみ)サンドボックス化されたコマンドが Apple Events を送信することを許可します。`open`、`osascript`、および URL をブラウザで開くツールに必要です。これ以外の場合は error `-600` で失敗します。**コード実行分離を削除します。** サンドボックス化されたコマンドは、ユーザープロンプトなしで他のアプリケーションをサンドボックス化されていない状態で起動できます。また、Terminal などの実行中のアプリケーションに AppleScript コマンドを送信することもできます。macOS 自動化同意プロンプト(TCC)の対象となります。ユーザー、managed、または CLI 設定からのみ尊重され、プロジェクト設定からは尊重されません。デフォルト:false | `true` |
440| `bwrapPath` | (Managed 設定のみ、Linux/WSL2)bubblewrap(`bwrap`)バイナリへの絶対パス。`PATH` を通じた自動検出をオーバーライドします。[managed 設定](/docs/ja/settings#settings-precedence)からのみ尊重され、ユーザーまたはプロジェクト設定からは尊重されません。managed 環境で `bwrap` が非標準の場所にインストールされている場合に役立ちます。 | `/opt/admin/bwrap` |
441| `socatPath` | (Managed 設定のみ、Linux/WSL2)サンドボックスネットワークプロキシに使用される `socat` バイナリへの絶対パス。`PATH` を通じた自動検出をオーバーライドします。managed 設定からのみ尊重されます。 | `/opt/admin/socat` |
442
443<h4 id="sandbox-path-prefixes">
444 サンドボックスパスプレフィックス
445</h4>
446 517
447`filesystem.allowWrite`、`filesystem.denyWrite`、`filesystem.denyRead`、`filesystem.allowRead`、および `credentials.files` のパスは、これらのプレフィックスをサポートしています:518* [サーバー管理設定](/docs/ja/server-managed-settings)。Claude Code が claude.ai 管理コンソールまたは自己ホスト型[Claude apps gateway](/docs/ja/claude-apps-gateway) から取得します
519* MDM または OS レベルのポリシー、およびシステムディレクトリの `managed-settings.json` ファイル
520* Claude Desktop などの埋め込みホスト。SDK `managedSettings` オプション経由。[埋め込みホストからポリシーを制御する](/docs/ja/managed-settings#parent-settings-from-embedding-hosts)を参照してください
448 521
449| プレフィックス | 意味 | 例 |522Claude Desktop アプリで実行される[Cowork](https://claude.com/docs/cowork/overview) セッションでは、Claude Code は claude.ai 管理コンソールからサーバー管理設定を取得しません。組織の Claude Desktop 構成が `requireCoworkFullVmSandbox` を設定しない限り、デバイスにデプロイされたポリシーを読み込みます。[ポリシーが適用される場所と時期](/docs/ja/managed-settings#where-and-when-a-policy-applies)は Cowork とクラウドセッションをカバーしています。
450| :---------------- | :--------------------------------------------------- | :---------------------------------------------------------------------- |
451| `/` | ファイルシステムルートからの絶対パス | `/tmp/build` は `/tmp/build` のままです |
452| `~/` | ホームディレクトリに相対的 | `~/.kube` は `$HOME/.kube` になります |
453| `./` またはプレフィックスなし | プロジェクト設定ではプロジェクトルートに相対的、またはユーザー設定では `~/.claude` に相対的 | `./output` は `.claude/settings.json` では `<project-root>/output` に解決されます |
454 523
455古い `//path` プレフィックスは絶対パスに対して引き続き機能します。以前に単一スラッシュ `/path` を使用してプロジェクト相対解決を期待していた場合は、`./path` に切り替えてください。この構文は [Read および Edit 権限ルール](/docs/ja/permissions#read-and-edit)と異なります。これは `//path` を絶対パスに、`/path` をプロジェクト相対に使用します。サンドボックスファイルシステムパスは標準的な規則を使用します:`/tmp/build` は絶対パスです。524管理者の場合、[組織向けに Claude Code をセットアップする](/docs/ja/admin-setup)は何を強制するかを選択する手順を説明し、[管理設定をデプロイする](/docs/ja/managed-settings)は配信と、ポリシーが有効であることを確認する方法をカバーしています。
456 525
457**構成例:**526<h2 id="change-a-setting">
527 設定を変更する
528</h2>
458 529
459```json theme={null}530`/config` メニューから、設定ファイルを編集して、または 1 つのセッションのコマンドラインから設定を変更できます。
460{
461 "sandbox": {
462 "enabled": true,
463 "autoAllowBashIfSandboxed": true,
464 "excludedCommands": ["docker *"],
465 "filesystem": {
466 "allowWrite": ["/tmp/build", "~/.kube"],
467 "denyRead": ["~/.aws/credentials"]
468 },
469 "network": {
470 "allowedDomains": ["github.com", "*.npmjs.org", "registry.yarnpkg.com"],
471 "deniedDomains": ["uploads.github.com"],
472 "allowUnixSockets": [
473 "/var/run/docker.sock"
474 ],
475 "allowLocalBinding": true
476 }
477 }
478}
479```
480 531
481**ファイルシステムとネットワーク制限**は、一緒にマージされる 2 つの方法で構成できます:532<span id="system-prompt" />
482 533
483* **`sandbox.filesystem` 設定**(上記):OS レベルのサンドボックス境界でパスを制御します。これらの制限は、Claude のファイルツールだけでなく、すべてのサブプロセスコマンド(例:`kubectl`、`terraform`、`npm`)に適用されます。534Claude Code のシステムプロンプトは公開されていません。Claude に立ったままの命令を与えるには、[`CLAUDE.md` ファイル](/docs/ja/memory)または `--append-system-prompt` フラグを使用してください。
484* **権限ルール**:`Edit` allow/deny ルールを使用して Claude のファイルツールアクセスを制御し、`Read` deny ルールを使用して読み取りをブロックし、`WebFetch` allow/deny ルールを使用してネットワークドメインを制御します。これらのルールからのパスもサンドボックス構成にマージされます。
485 535
486<h3 id="attribution-settings">536<h3 id="use-the-/config-menu">
487 属性設定537 /config メニューを使用する
488</h3>538</h3>
489 539
490Claude Code は git コミットとプルリクエストに属性を追加します。これらは個別に構成されます:540Claude Code 内で `/config` を実行し、**Config** タブを開きます。テーマ、エディターモード、詳細出力などの短いセットの個人的なオプションをリストします。すべての設定キーではありません。オプションを選択して変更します。Claude Code はあなたのために保存します:
491 541
492* コミットはデフォルトで[git トレーラー](https://git-scm.com/docs/git-interpret-trailers)(`Co-Authored-By` など)を使用し、カスタマイズまたは無効にできます542* **ほとんどのオプション**:`~/.claude/settings.json`
493* プルリクエストの説明はプレーンテキストです543* **ヒントを表示などのいくつかのオプション**:`.claude/settings.local.json`
544* **[グローバル構成オプション](/docs/ja/settings-reference#global-config-settings)**:`~/.claude.json`
494 545
495| キー | 説明 |5461 つのオプションをメニューなしで設定するには、`/config verbose=true` などの `key=value` を渡してください。
496| :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------- |
497| `commit` | git コミットの属性(トレーラーを含む)。空の文字列はコミット属性を非表示にします |
498| `pr` | プルリクエストの説明の属性。空の文字列はプルリクエスト属性を非表示にします |
499| `sessionUrl` | web またはリモートコントロールセッションから実行する場合、claude.ai セッションリンクを `Claude-Session` トレーラーとしてコミットに追加し、プルリクエストの説明にリンクとして追加するかどうか。デフォルト:`true`。`false` に設定してリンクを省略します |
500
501**デフォルトコミット属性:**
502
503```text theme={null}
504Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
505```
506
507セッションのアクティブなモデルはトレーラーのモデル名を反映します。
508
509**デフォルトプルリクエスト属性:**
510
511```text theme={null}
512🤖 Generated with [Claude Code](https://claude.com/claude-code)
513```
514
515**例:**
516
517```json theme={null}
518{
519 "attribution": {
520 "commit": "Generated with AI\n\nCo-Authored-By: AI <ai@example.com>",
521 "pr": ""
522 }
523}
524```
525 547
526<Note>548<Note>
527 `attribution` 設定は非推奨の `includeCoAuthoredBy` 設定よりも優先されます。すべての属性を非表示にするには、`commit` と `pr` を空の文字列に設定し、`sessionUrl` を `false` に設定します。549 `/config` はターミナルインターフェースの一部です。[VS Code](/docs/ja/vs-code) チャットパネルと[デスクトップアプリ](/docs/ja/desktop)はそれを開きません。設定ファイルを編集するか、これらのアプリ独自の設定を通じて設定を変更してください。
528</Note>550</Note>
529 551
530<h3 id="file-suggestion-settings">552<h3 id="edit-a-settings-file">
531 ファイル提案設定553 設定ファイルを編集する
532</h3>
533
534`@` ファイルパスオートコンプリート用のカスタムコマンドを構成します。組み込みファイル提案は高速ファイルシステムトラバーサルを使用しますが、大規模なモノレポは事前構築されたファイルインデックスやカスタムツールなどのプロジェクト固有のインデックスから利益を得る可能性があります。
535
536```json theme={null}
537{
538 "fileSuggestion": {
539 "type": "command",
540 "command": "~/.claude/file-suggestion.sh"
541 }
542}
543```
544
545コマンドは [hooks](/docs/ja/hooks)と同じ環境変数(`CLAUDE_PROJECT_DIR` を含む)で実行されます。`query` フィールドを含む JSON を stdin 経由で受け取ります:
546
547```json theme={null}
548{"query": "src/comp"}
549```
550
551stdout にニューラインで区切られたファイルパスを出力します(現在 15 に制限):
552
553```text theme={null}
554src/components/Button.tsx
555src/components/Modal.tsx
556src/components/Form.tsx
557```
558
559**例:**
560
561```bash theme={null}
562#!/bin/bash
563query=$(cat | jq -r '.query')
564# your-repo-file-index をあなた自身のファイル検索コマンドに置き換えます
565your-repo-file-index --query "$query" | head -20
566```
567
568<h3 id="footer-link-badges">
569 フッターリンクバッジ
570</h3>554</h3>
571 555
572`footerLinksRegexes` 設定は、入力ボックスの下のフッターに追加のクリック可能なバッジをレンダリングします。プロジェクト CLI によって出力される ID(レビューツールと問題トラッカーなど)をセッションリンクに変換するために使用します。556エディターで必要なスコープの設定ファイルを開き、キーを追加または変更します。設定ファイルは厳密な JSON です。`//` コメントまたは末尾のコンマは構文エラーであり、Claude Code はファイルを[設定エラー](#fix-a-broken-settings-file)として次の開始時に報告します。たとえば、Claude Code が確認なしに lint とテストコマンドを実行し、`.env` ファイルの読み取りを停止するようにするには、これを `~/.claude/settings.json` に追加してください:
573
574各エントリの `pattern` 正規表現はターン出力に対してマッチされます:ツール結果(ファイルコンテンツとフェッチされたページを含む)および Claude 自身の応答。`url` と `label` の `{name}` プレースホルダーはパターンの名前付きキャプチャグループから入力されます。
575
576次の例は、`PROJ-1234` のような問題キーがターン出力に表示されるたびにバッジをレンダリングします。`(?<key>...)` 名前付きグループはキーをキャプチャし、`{key}` は URL とラベルに置き換えられます:
577 557
578```json ~/.claude/settings.json theme={null}558```json ~/.claude/settings.json theme={null}
579{559{
580 "footerLinksRegexes": [560 "$schema": "https://json.schemastore.org/claude-code-settings.json",
581 {561 "permissions": {
582 "type": "regex",562 "allow": [
583 "pattern": "\\b(?<key>PROJ-\\d+)\\b",563 "Bash(npm run lint)",
584 "url": "https://issues.example.com/browse/{key}",564 "Bash(npm run test *)"
585 "label": "{key}"565 ],
586 }566 "deny": [
567 "Read(./.env)",
568 "Read(./.env.*)"
587 ]569 ]
570 }
588}571}
589```572```
590 573
591これが構成されている場合、`PROJ-1234` がツール結果または Claude の返信に表示されると、`PROJ-1234` チップがフッターに表示され、`https://issues.example.com/browse/PROJ-1234` にリンクされます。574`permissions` の下の各エントリは、ツールとそれが何ができるかを名前付けするルールです。[権限を構成する](/docs/ja/permissions)は構文を説明します。`$schema` 行は Claude Code 設定の[公開 JSON スキーマ](https://json.schemastore.org/claude-code-settings.json)を指し、VS Code、Cursor、および JSON スキーマをサポートする他のエディターでオートコンプリートとインライン検証を提供します。スキーマは最新の CLI リリースより遅れることができるため、最近ドキュメント化されたキーの検証警告は、構成が無効であることを意味しません。
592
593各エントリに以下の制約が適用されます:
594 575
595| 制約 | 動作 |576保存した後、Claude Code 内で `/status` を実行してファイルが読み込まれたことを確認してください。[読み込まれたものを確認する](#check-what-loaded)は `Setting sources` 行が表示するものと、壊れたファイルがどのように報告されるかを説明します。
596| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
597| URL オリジン | キャプチャされた値は URL エンコードされ、構築された URL はテンプレートのリテラルオリジンを共有する必要があります。キャプチャはパスセグメントまたはクエリ値を入力できますが、リンクがポイントする場所を変更することはできません |
598| URL 長 | 2048 文字より長い構築された URL は削除されます |
599| URL スキーム | `https`、`http`、または認識されたエディターまたはワークスペースディープリンクスキーム:`vscode`、`vscode-insiders`、`cursor`、`windsurf`、`zed`、`jetbrains`、`idea`、`slack`、`linear`、`notion`、`figma` である必要があります |
600| ラベル | デフォルトはマッチされたテキストで、28 表示列に切り詰められます |
601| バッジ数 | 最大 5 つのバッジがレンダリングされます。最も古いものは新しいマッチによって置き換えられ、`/clear` はそれらを削除します |
602| 設定スコープ | ユーザー設定、`--settings` フラグ、および managed 設定からのみ読み込まれます。プロジェクト `.claude/settings.json` およびローカル `.claude/settings.local.json` では無視されます |
603 577
604ターンが完了すると、Claude Code はメインスレッドでターン出力に対して各エントリの `pattern` 正規表現をマッチします。そのため、遅い正規表現は UI をブロックしてセッションを凍結するまでブロックします。`(a+)+$` などのネストされた量指定子は、特定の入力に対して指数関数的に長くかかる可能性があるため、各 `pattern` を線形に保ち、`+` または `*` の ネストを避けます。578完全な個人ファイル、チームファイル、および組織ファイルについては、それが設定するすべてのキーのコメント付きで、[設定ファイルの例](/docs/ja/settings-example)を参照してください。
605 579
606フッターバッジは、構成されている場合、[カスタムステータスライン](/docs/ja/statusline)と並んでレンダリングされます。どちらも他方を置き換えません。セッションデータから独自のコンテンツを計算するスクリプト駆動行にはステータスラインを使用し、スクリプトなしで会話から ID をリンクに変換するにはフッターバッジを使用します。580<span id="pass-settings-for-one-session" />
607 581
608<h3 id="hook-configuration">582<h3 id="change-a-setting-for-one-session">
609 Hook 構成583 1 つのセッションの設定を変更する
610</h3>584</h3>
611 585
612これらの設定は、どの hooks が実行を許可されるか、および HTTP hooks がアクセスできるものを制御します。`allowManagedHooksOnly` 設定は [managed 設定](#settings-files)でのみ構成できます。URL と環境変数ホワイトリストは任意の設定レベルで設定でき、ソース全体でマージされます。586値を保存せずに試すには、Claude Code を開始するときに設定します。値はそのセッションに適用され、設定ファイルはそのままです。3 つの方法があります:
613
614**`allowManagedHooksOnly` が `true` の場合の動作:**
615
616* Managed hooks と SDK hooks が読み込まれます
617* managed 設定 `enabledPlugins` で強制的に有効にされたプラグインからの Hooks が読み込まれます。これにより、管理者は組織マーケットプレイスを通じて検証済みの hooks を配布しながら、他のすべてをブロックできます。信頼は完全な `plugin@marketplace` ID によって付与されるため、別のマーケットプレイスからの同じ名前のプラグインはブロックされたままです
618* ユーザー hooks、プロジェクト hooks、およびその他すべてのプラグイン hooks はブロックされます
619 587
620**HTTP hook URL を制限:**588* **`--settings`**:JSON としてキーを渡します。インラインまたはファイルへのパス。Claude Code はそれをユーザー、プロジェクト、およびローカルファイルの上に適用し、管理設定の下に適用します。ユーザー設定ファイルが設定できるキーを設定できます。`Managed` または `Global config` キーを設定することはできません。
589* **そのキーのフラグ**:いくつかのキーには独自のフラグがあります。`model` の `--model` や `effortLevel` と `modelSettings` の `--effort` など。
590* **環境変数**:`model` の `ANTHROPIC_MODEL` など、キーのペアリングされた変数をエクスポートしてから `claude` を実行してください。
621 591
622HTTP hooks がターゲットにできる URL を制限します。マッチングのワイルドカードとして `*` をサポートします。配列が定義されている場合、一致しない URL をターゲットにする HTTP hooks はサイレントにブロックされます。ホスト名マッチングは大文字と小文字を区別せず、末尾の FQDN ドットを無視し、DNS セマンティクスに一致します。592各キーの[設定リファレンス](/docs/ja/settings-reference)のエントリは、その 1 セッションのオーバーライドと、どれが優先されるかをリストします。変更したいキーのエントリを確認してください。
623 593
624```json theme={null}594セッション内で実行するコマンドはほとんどあなたの選択を保存します。`/config` で設定を変更すると、Claude Code はそれを設定ファイルに書き込み、`/model` は値を新しいセッションのデフォルトとして保存します。
625{
626 "allowedHttpHookUrls": ["https://hooks.example.com/*", "http://localhost:*"]
627}
628```
629 595
630**HTTP hook 環境変数を制限:**596`/model` ピッカーで `s` を押すと、Claude Code はモデルを切り替えますが、ユーザーデフォルトとして保存しません。[努力レベルを調整する](/docs/ja/model-config#adjust-effort-level)は、Claude Code が使用しているモデルのデフォルトとして保存する `/effort` ピックと、現在のセッションのみに適用するものを説明します。
631 597
632HTTP hooks がヘッダー値に補間できる環境変数名を制限します。各 hook の有効な `allowedEnvVars` はこの設定との交差です。598たとえば、デフォルトを変更せずに 1 つのセッションで Opus で開始するには:
633 599
634```json theme={null}600```bash theme={null}
635{601claude --settings '{"model": "claude-opus-4-8"}'
636 "httpHookAllowedEnvVars": ["MY_TOKEN", "HOOK_SECRET"]
637}
638```602```
639 603
640<h3 id="compute-managed-settings-with-a-policy-helper">604<h3 id="when-edits-take-effect">
641 ポリシーヘルパーで managed 設定を計算605 編集がいつ有効になるか
642</h3>606</h3>
643 607
644`policyHelper` 設定は、起動時に managed 設定を動的に計算する実行可能ファイルを指しています。管理者は、静的ファイルの代わりに、デバイスの状態、ID、またはリモートサービスからポリシーを導出できます。MDM またはシステム `managed-settings.json` ファイルから構成します。Claude Code は、ユーザー設定、プロジェクト設定、HKCU レジストリハイブ、および [サーバー管理設定](/docs/ja/server-managed-settings)を含む他のスコープに表示される `policyHelper` を無視します。608Claude Code は設定ファイルを監視し、変更時に再読み込みするため、`permissions`、`hooks`、および `apiKeyHelper` などの認証情報ヘルパーへの編集を含む、ほとんどの編集は再起動なしで実行中のセッションに適用されます。再読み込みはユーザー、プロジェクト、ローカル、および管理設定をカバーし、Claude Code は検出した各設定ファイル変更に対して [`ConfigChange` hook](/docs/ja/hooks#configchange) を実行します。MDM または claude.ai コンソールから到達する管理設定ではありません。MDM またはclaude.ai コンソールから到達する管理設定は、スケジュールに従ってセッションに到達します。[配信テーブル](/docs/ja/managed-settings#choose-a-delivery-mechanism)はソースごとにそれを提供します。
645 609
646設定は以下のキーを受け入れます:610Claude Code はセッション開始時に一度だけいくつかのキーを読み込むため、そのうちの 1 つへの編集は実行中のセッションに到達しません。`requiredMinimumVersion` などの管理者側のキーも再起動を待ちます。[ポリシーが適用される場所と時期](/docs/ja/managed-settings#where-and-when-a-policy-applies)の下にリストされています。セッション中に編集する可能性が最も高いもの:
647 611
648| キー | タイプ | 説明 |612* [`model`](/docs/ja/settings-reference#model):セッション中に切り替えるには [`/model`](/docs/ja/model-config#setting-your-model) を使用してください。各モデルには独自のプロンプトキャッシュがあるため、切り替え後の最初のリクエストは会話全体をキャッシュなしで再読み込みします。[モデルを切り替える](/docs/ja/prompt-caching#switching-models)を参照してください
649| ------------------- | ------ | ------------------------------------------------------------- |613* [`effortLevel`](/docs/ja/settings-reference#effortlevel) および [`modelSettings`](/docs/ja/settings-reference#modelsettings):セッション中に努力を変更するには [`/effort`](/docs/ja/model-config#adjust-effort-level) を使用してください
650| `path` | string | ヘルパー実行可能ファイルへの絶対パス |
651| `timeoutMs` | number | ヘルパーが失敗として扱われるまでの待機時間 |
652| `refreshIntervalMs` | number | バックグラウンドでヘルパーを再実行する頻度。`0` に設定して更新を無効にするか、少なくとも `60000` に設定します |
653 614
654ヘルパーは JSON エンベロープを stdout に書き込みます。設定をトップレベルではなく `managedSettings` キーの下に配置します。ベアの設定オブジェクトは `managedSettings` が未定義で解析され、何も適用されないためです:615<span id="verify-active-settings" />
655
656```json theme={null}
657{
658 "managedSettings": {
659 "permissions": { "deny": ["Read(//etc/secrets/**)"] }
660 },
661 "claudeMd": "# Organization context\n...",
662 "appendSystemPrompt": "Always cite the internal style guide."
663}
664```
665 616
666ヘルパーが `managedSettings` を出力すると、そのオブジェクトは実行のためにファイルベースの managed 設定を置き換えます。ヘルパーが起動時にゼロ以外で終了すると、Claude Code はエラーを出力し、起動を拒否します。そのため、停止復旧が必要なヘルパーは独自のキャッシュから提供し、`0` で終了する必要があります。617<span id="check-what-loaded" />
667 618
668<h3 id="settings-precedence">619<h3 id="confirm-what-loaded">
669 設定の優先度620 読み込まれたものを確認する
670</h3>621</h3>
671 622
672設定は優先度の順に適用されます。最高から最低:623Claude Code 内で `/status` を実行して、どの設定ソースがアクティブであるかを確認してください。**Status** タブには、Claude Code が現在のセッション用に読み込んだ各設定ファイルをリストする `Setting sources` 行が含まれています。`User settings` または `Project local settings` など。[管理設定](/docs/ja/admin-setup#decide-how-settings-reach-devices)が有効な場合、管理設定エントリは括弧内にそれらがマシンに到達した方法を示します。
673 624
6741. **Managed 設定**([サーバー管理](/docs/ja/server-managed-settings)、[MDM/OS レベルのポリシー](#configuration-scopes)、または [managed 設定](#settings-files))625行は Claude Code が読み込んだファイルを確認します。各ファイルがどのキーを供給したかは表示されません。Claude Code が拒否したエントリをリストするには、[`claude doctor`](/docs/ja/debug-your-config) を実行してください。プロジェクトまたは管理設定が設定するモデルについては、スタートアップヘッダーがそれを設定したファイルの名前を付けます。`/status` と `/config` は異なるタブで同じダイアログを開き、**Config** タブは `settings.json` コンテンツのビューではありません。
675 * IT がサーバー配信、MDM 構成プロファイル、レジストリポリシー、または managed 設定ファイルを通じて展開するポリシー
676 * コマンドラインの引数を含む他のレベルでオーバーライドできません
677 * managed ティア内では、優先度は:[`policyHelper`](#compute-managed-settings-with-a-policy-helper)出力(構成されている場合は唯一の managed ソースとして使用)> リモート(claude.ai [サーバー管理](/docs/ja/server-managed-settings)または [Claude apps gateway](/docs/ja/claude-apps-gateway)配信)> MDM/OS レベルのポリシー > ファイルベース(`managed-settings.d/*.json` + `managed-settings.json`)> HKCU レジストリ(Windows のみ)です。1 つの managed ソースのみが使用されます。ソースはマージされません。ただし、サンドボックスロックキー `sandbox.network.allowManagedDomainsOnly` と `sandbox.filesystem.allowManagedReadPathsOnly`、それらの関連ホワイトリスト、`allowAllClaudeAiMcps`、およびサンドボックスバイナリパス `sandbox.bwrapPath` と `sandbox.socatPath` は、管理者制御の managed ソースがそれらを設定する場合に尊重されます。ユーザー書き込み可能な HKCU ティアは除外されます。ファイルベースティア内では、ドロップインファイルとベースファイルがマージされます。
678 * Agent SDK または IDE 拡張機能などの埋め込みホストプロセスによってプログラム的に提供される managed 設定。デフォルトではこれは管理者デプロイ済みの managed ティアが存在する場合は無視されます:サーバー管理設定、MDM または OS レベルのポリシー、または managed 設定ファイル。ユーザー書き込み可能な HKCU レジストリフォールバックは管理者デプロイ済みソースとしてカウントされません。管理者は [`parentSettingsBehavior`](#available-settings)を `"merge"` に設定することでオプトインできます。埋め込み側の値はフィルタリングされるため、managed ポリシーを厳しくできますが、緩くすることはできません。
679 626
6802. **コマンドラインの引数**627<h3 id="fix-a-broken-settings-file">
681 * 特定のセッションの一時的なオーバーライド。JSON は `--settings <file-or-json>` を通じて渡され、ファイルベース設定と同じルールを使用して他のレイヤーとマージされます:ここで設定されたキーはローカル、プロジェクト、またはユーザー設定の同じキーをオーバーライドし、キーを省略すると下位レイヤーの値が保持されます628 壊れた設定ファイルを修正する
682 629</h3>
6833. **ローカルプロジェクト設定**(`.claude/settings.local.json`)
684 * 個人的なプロジェクト固有の設定
685 630
6864. **共有プロジェクト設定**(`.claude/settings.json`)631JSON をタイプミスするか、Claude Code が受け入れない値にキーを設定する場合、Claude Code はインタラクティブセッションの開始時にあなたに伝えます。表示される内容は、ファイルのどの程度が影響を受けるかによって異なります:
687 * ソース管理内のチーム共有プロジェクト設定
688 632
6895. **ユーザー設定**(`~/.claude/settings.json`)633* **設定エラー**:ユーザー、プロジェクト、またはローカルファイルに無効な JSON またはスキーマが拒否する値があります。インタラクティブセッションの開始時に Claude Code はダイアログを表示し、Claude の助けでファイルを修正するか、終了するか、壊れた設定なしで続行できます。
690 * 個人的なグローバル設定634* **設定警告**:個別のエントリのみが失敗します。不正な形式の権限ルールまたは不明な hook イベント名など。Claude Code はそれらの値をスキップし、ファイルの残りを有効に保ちます。
635* **管理設定**:Claude Code はファイルの残りを強制し続けます。[管理設定の無効なエントリ](/docs/ja/managed-settings#invalid-entries-in-managed-settings)は、それが削除するものと、修正するまでどのキーがより厳密な値にフォールバックするかを説明します。有効な JSON ではない管理設定ドキュメントについては、[管理設定ドキュメントを解析できませんでした](/docs/ja/errors#managed-settings-document-could-not-be-parsed)を参照してください。
636* **構成エラー**:`~/.claude.json` を解析できません。Claude Code は壊れたファイルを `~/.claude/backups/.claude.json.corrupted.<timestamp>` にコピーし、終了して手動で修正するか、デフォルト構成にリセットするかを尋ねます。`-p` 実行はエラーを出力して終了します。以前の状態を復旧するには、`~/.claude/backups/` の 5 つの最新 `.claude.json.backup.<timestamp>` ファイルの 1 つをコピーして戻してください。Claude Code はファイルを書き込む前に保存します。
691 637
692この階層は、組織のポリシーが常に強制されながら、チームと個人がエクスペリエンスをカスタマイズできることを保証します。同じ優先度は、CLI から Claude Code を実行する場合、[VS Code 拡張機能](/docs/ja/vs-code)から実行する場合、または [JetBrains IDE](/docs/ja/jetbrains)から実行する場合に適用されます。638続行した後、`/status` を実行して影響を受けたファイルを確認し、各エラーの詳細について `claude doctor` を実行してください。
693 639
694たとえば、ユーザー設定が `permissions.defaultMode` を `acceptEdits` に設定しているが、プロジェクトの共有設定がそれを `default` に設定している場合、プロジェクト値が適用されます。以下の例は、配列値の設定(権限ルールなど)がどのように結合されるかについて説明しています。640`-p` 実行はダイアログを表示しません。[管理設定ドキュメントを解析できない](/docs/ja/errors#managed-settings-document-could-not-be-parsed)場合を除き、Claude Code は壊れたファイルまたは値をスキップして残りで続行するため、設定をスキップした `-p` 実行の後、`claude doctor` を実行して削除したものを確認してください。
695 641
696<Note>642<span id="how-scopes-interact" />
697 **配列設定はスコープ全体でマージされます。** 同じ配列値の設定(`sandbox.filesystem.allowWrite` や `permissions.allow` など)が複数のスコープに表示される場合、配列は**連結および重複排除**され、置き換えられません。これは、低優先度のスコープが高優先度のスコープで設定されたエントリをオーバーライドすることなくエントリを追加でき、その逆も同様です。たとえば、managed 設定が `allowWrite` を `["/opt/company-tools"]` に設定し、ユーザーが `["~/.kube"]` を追加する場合、両方のパスが最終構成に含まれます。
698 643
699 2 つの配列設定はこのようにマージされません:644<span id="key-points-about-the-configuration-system" />
700 645
701 * [`fallbackModel`](#available-settings) は位置が意味を持つ順序付きチェーン:これを定義する最高優先度ファイルが全体の値を提供します。646<span id="which-value-claude-code-uses" />
702 * [`availableModels`](#available-settings):[最高優先度の managed ソース](/docs/ja/server-managed-settings#settings-precedence)がこれを定義する場合、そのリストはそのまま適用され、ユーザー、プロジェクト、およびローカルエントリはそれを拡張できません。非 managed スコープ全体では、配列は通常どおりマージされます。[マージ動作](/docs/ja/model-config#merge-behavior)を参照してください。
703</Note>
704 647
705<h3 id="verify-active-settings">648<span id="which-value-wins" />
706 アクティブな設定を確認
707</h3>
708 649
709Claude Code 内で `/status` を実行して、どの設定ソースがアクティブであるかを確認します。メニュー内の **Status** タブには、`Setting sources` 行が含まれており、このセッション用に Claude Code が読み込んだ各レイヤーをリストします。`User settings` または `Project local settings` などのレイヤーが表示される場合、そのソースはそのセッション用に読み込まれています。[managed 設定](/docs/ja/admin-setup#decide-how-settings-reach-devices)が有効な場合、エントリは配信チャネルを括弧内に表示します。たとえば、`Enterprise managed settings (remote)`、`(plist)`、`(HKLM)`、`(HKCU)`、または `(file)` などです。`remote` チャネルは claude.ai サーバー管理設定と [Claude apps gateway](/docs/ja/claude-apps-gateway)配信ポリシーの両方をカバーしています。レイヤーは、そのソースが少なくとも 1 つのキーで読み込まれた場合にのみリストに表示されるため、空のリストは設定ソースが見つからなかったことを意味します。650<h2 id="settings-precedence">
651 設定の優先順位
652</h2>
710 653
711`Setting sources` 行は、どのソースが読み込まれているかを確認します。各個別キーがどのレイヤーから供給されたかは表示されません。同じダイアログの **Config** タブは、テーマや詳細出力などの固定されたトグルセットのエディターであり、`settings.json` コンテンツのビューではありません。654同じキーが複数の場所に表示される場合、Claude Code はそれを設定する最高レベルからの値を使用します。下のスタックはレベルを示します。最高は上。より高いレベルのキーは、その下のどこでも同じキーをオーバーライドします。
712 655
713設定ファイルに無効な JSON やバリデーションに失敗する値などのエラーが含まれている場合、`/status` は影響を受けたファイルをリストします。各エラーの詳細については `/doctor` を実行してください。656<SettingsPrecedence />
714 657
715<h3 id="key-points-about-the-configuration-system">658順序で、最初に最高優先度:
716 構成システムの重要なポイント
717</h3>
718 659
719* **メモリファイル(`CLAUDE.md`)**:Claude が起動時に読み込む命令とコンテキストを含みます6601. **管理設定**:組織がデプロイする設定。`managed-settings.json` ファイル、MDM ポリシー、または claude.ai コンソールからの[サーバー管理設定](/docs/ja/server-managed-settings)。何もあなたが設定するものはそれらをオーバーライドしません。`--settings` フラグで渡すキーは同じ管理キーをオーバーライドしません。`--model` などのフラグは、組織が許可するモデルからのみ選択します。管理 `model` は各セッションが開始するモデルを設定し、`/model` で切り替えることができます。ロックは [`availableModels`](/docs/ja/settings-reference#availablemodels) です。これは `/model`、`--model`、および独自のファイルの `model` キーを制約します。組織が複数の管理ソースを配信する場合、[管理ティア内の優先順位](/docs/ja/managed-settings#precedence-within-the-managed-tier)のルールは Claude Code が各から読み込むものを説明します。
720* **設定ファイル(JSON)**:権限、環境変数、およびツール動作を構成します6612. **コマンドラインの引数**:ターミナルから `claude` を開始するときに渡すフラグ。1 つのセッション。[1 つのセッションの設定を変更する](#change-a-setting-for-one-session)を参照してください。Claude Code は `--settings <file-or-json>` で渡す JSON を他のレベルと同じルールでマージします。ここで設定するキーはローカル、プロジェクト、またはユーザー設定の同じキーを取り、省略するキーは下位レベルの値を保持します。
721* **Skills**:`/skill-name` で呼び出すか、Claude によって自動的に読み込むことができるカスタムプロンプト6623. **プロジェクトローカル設定**(`.claude/settings.local.json`):このプロジェクトの個人設定。
722* **MCP サーバー**:追加のツールと統合で Claude Code を拡張します6634. **共有プロジェクト設定**(`.claude/settings.json`):チームがソース管理にチェックインする設定。
723* **優先度**:高レベルの構成(Managed)が低レベルの構成(User/Project)をオーバーライドします6645. **ユーザー設定**(`~/.claude/settings.json`):すべてのプロジェクトの個人設定。
724* **継承**:設定はマージされ、スカラー値はより高い優先度のスコープからオーバーライドされ、配列は連結されます。例外:[`fallbackModel`](#available-settings) は位置が意味を持つ順序付きチェーン:これを定義する最高優先度ファイルが全体の値を提供します。v2.1.175 以降、`availableModels` は managed またはポリシー値が低優先度エントリを完全に置き換えます
725 665
726<h3 id="system-prompt">666環境変数はこのスタックのレベルではありません。動作にシェル変数と設定キーの両方がある場合、どれが適用されるかはレベルではなくペアごとに決定されます。`ANTHROPIC_MODEL` をシェルでエクスポートすると、任意のファイルの `model` キーに適用されます。`ANTHROPIC_DEFAULT_MODEL` はファイルが `model` を設定しない場合のみ適用されます。[環境変数リファレンス](/docs/ja/env-vars#precedence)は、どのキーがペアを持ち、Claude Code が最初に読み込むものを説明します。設定ファイル内の `env` ブロックは通常のキーであり、上記のレベルに従います。
727 システムプロンプト
728</h3>
729 667
730Claude Code の内部システムプロンプトは公開されていません。カスタム命令を追加するには、`CLAUDE.md` ファイルまたは `--append-system-prompt` フラグを使用します。668いくつかのセキュリティに敏感なキーについて、Claude Code は下位レベルからのより厳密な値を管理値より優先します。[管理設定の優先順位の例外](#exceptions-to-managed-settings-precedence)はそれらをリストします。
731 669
732<h3 id="exclude-sensitive-files">670<h3 id="lists-merge-instead-of-overriding">
733 機密ファイルを除外671 リストはオーバーライドの代わりにマージされます
734</h3>672</h3>
735 673
736API キー、シークレット、環境ファイルなどの機密情報を含むファイルへの Claude Code アクセスを防ぐには、`.claude/settings.json` ファイルの `permissions.deny` 設定を使用します:674同じリストキー(`permissions.allow` など)を複数のファイルで設定する場合、Claude Code はリストを結合するのではなく 1 つを選択するため、各ファイルは別のファイルのエントリを削除することなくエントリを追加できます。4 つのキーがモデルリストまたはモデルごとのエントリを保持し、独自のルールに従います:
737
738```json theme={null}
739{
740 "permissions": {
741 "deny": [
742 "Read(./.env)",
743 "Read(./.env.*)",
744 "Read(./secrets/**)",
745 "Read(./config/credentials.json)",
746 "Read(./build)"
747 ]
748 }
749}
750```
751
752これは非推奨の `ignorePatterns` 構成に置き換わります。これらのパターンに一致するファイルはファイル検出と検索結果から除外され、これらのファイルの読み取り操作は拒否されます。
753
754<h2 id="subagent-configuration">
755 Subagent 構成
756</h2>
757 675
758Claude Code は、ユーザーレベルとプロジェクトレベルの両方で構成できるカスタム AI subagents をサポートしています。これらの subagents は YAML frontmatter を含む Markdown ファイルとして保存されます:676* [`fallbackModel`](/docs/ja/settings-reference#fallbackmodel) は位置が意味を持つ順序付きチェーンです。Claude Code はそれを定義する最高優先度ファイルから全体の値を取ります。
677* [`modelPicker`](/docs/ja/settings-reference#modelpicker) は 1 つの順序付きリストの行とリプレイスフラグを保持するため、Claude Code は 2 つのソースから行をマージしません。管理設定、`--settings`、およびユーザー設定の最高から全体の値を取り、プロジェクトおよびローカル設定のキーを無視します。Claude Code v2.1.242 以降が必要です。
678* [`availableModels`](/docs/ja/settings-reference#availablemodels):Claude Code が適用する管理設定がそれを定義する場合、Claude Code はそのリストをそのまま適用し、ユーザー、プロジェクト、またはローカル設定で追加するエントリを無視します。Claude Code を埋め込むアプリが独自のモデルリストを提供しない限り。[管理設定の優先順位の例外](#exceptions-to-managed-settings-precedence)を参照してください。管理ソース全体でリストはマージされません。[Claude Code が管理ソースを結合する方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)は、どのソースのリストが適用されるかを説明します。非管理スコープ全体で Claude Code は通常どおりリストをマージします。
679* [`modelSettings`](/docs/ja/settings-reference#modelsettings):Claude Code はそれを 1 つのモデルずつ、[`effortLevel`](/docs/ja/settings-reference#effortlevel) と一緒に解決します。`modelSettings` エントリは、どのファイルの値がモデルに適用されるかを述べます。
759 680
760* **ユーザー subagents**:`~/.claude/agents/` - すべてのプロジェクト全体で利用可能681<span id="examples" />
761* **プロジェクト subagents**:`.claude/agents/` - プロジェクト固有で、チームと共有できます
762 682
763Subagent ファイルは、カスタムプロンプトとツール権限を持つ特殊な AI アシスタントを定義します。[subagents ドキュメント](/docs/ja/sub-agents)で subagents の作成と使用について詳しく学びます。683<h3 id="precedence-examples">
764 684 優先順位の例
765<h2 id="plugin-configuration">
766 プラグイン構成
767</h2>
768
769Claude Code は、skills、agents、hooks、および MCP サーバーで機能を拡張できるプラグインシステムをサポートしています。プラグインはマーケットプレイスを通じて配布され、ユーザーレベルとリポジトリレベルの両方で構成できます。
770
771<h3 id="plugin-settings">
772 プラグイン設定
773</h3>685</h3>
774 686
775`settings.json` のプラグイン関連設定:687Claude が作業している間、Claude Code はスピナーの下に 1 行のヒントを表示します。「/config を使用してデフォルト権限モード(Plan Mode を含む)を変更してください」など。[`spinnerTipsEnabled`](/docs/ja/settings-reference#spinnertipsenabled) を `~/.claude/settings.json` で `false` に設定してそれらのヒントをオフにしたいとします。以下の各シナリオはそれらをオンに戻すことができるものであり、それについてできることです。
776
777```json theme={null}
778{
779 "enabledPlugins": {
780 "formatter@acme-tools": true,
781 "deployer@acme-tools": true,
782 "analyzer@security-plugins": false
783 },
784 "extraKnownMarketplaces": {
785 "acme-tools": {
786 "source": {
787 "source": "github",
788 "repo": "acme-corp/claude-plugins"
789 }
790 }
791 }
792}
793```
794 688
795<h4 id="enabledplugins">689<h4 id="team-settings-override-personal-settings">
796 `enabledPlugins`690 チーム設定は個人設定をオーバーライドします
797</h4>691</h4>
798 692
799どのプラグインが有効かを制御します。形式:`"plugin-name@marketplace-name": true/false`。任意のスコープにエントリがないプラグインは、その [`defaultEnabled`](/docs/ja/plugins-reference#default-enablement) 値にフォールバックします。693チームの `.claude/settings.json` はそれを `true` に設定します。Claude Code はプロジェクト値を使用します。共有プロジェクトはユーザーの上に座るため、そのプロジェクトでヒントを見て、他の場所では見ません。
800 694
801**スコープ**:695値を取り戻すことができます。そのプロジェクトの `.claude/settings.local.json` に `"spinnerTipsEnabled": false` を追加してください。プロジェクトローカルは共有プロジェクトの上に座るため、セッションはヒントを表示するのを停止し、チームメイトのセッションは変わりません。
802
803* **ユーザー設定**(`~/.claude/settings.json`):個人的なプラグイン設定
804* **プロジェクト設定**(`.claude/settings.json`):チームと共有されるプロジェクト固有のプラグイン
805* **ローカル設定**(`.claude/settings.local.json`):マシンごとのオーバーライド(Claude Code が作成する場合は gitignored)
806* **Managed 設定**(`managed-settings.json`):すべてのスコープでのインストールをブロックし、マーケットプレイスからプラグインを非表示にする組織全体のポリシーオーバーライド
807
808<Note>
809 プロジェクト設定はユーザー設定よりも優先されるため、`~/.claude/settings.json` でプラグインを `false` に設定しても、プロジェクトの `.claude/settings.json` が有効にするプラグインは無効になりません。プロジェクトで有効になっているプラグインをマシンでオプトアウトするには、代わりに `.claude/settings.local.json` で `false` に設定してください。
810
811 Managed 設定で強制的に有効にされたプラグインは、Managed 設定がローカル設定をオーバーライドするため、この方法では無効にできません。
812
813 外部ソース(GitHub リポジトリや npm パッケージなど)からのプラグインをプロジェクトの `.claude/settings.json` で有効にしても、他のユーザーにはインストールされません。Claude Code v2.1.195 以降、プラグインを読み込むすべてのパスは、実行前に各ユーザーに [プラグインをインストールして信頼する](/docs/ja/discover-plugins#configure-team-marketplaces)よう求めます。
814</Note>
815
816**例**:
817
818```json theme={null}
819{
820 "enabledPlugins": {
821 "code-formatter@team-tools": true,
822 "deployment-tools@team-tools": true,
823 "experimental-features@personal": false
824 }
825}
826```
827 696
828<h4 id="pluginconfigs">697<h4 id="organization-settings-override-everything">
829 `pluginConfigs`698 組織設定はすべてをオーバーライドします
830</h4>699</h4>
831 700
832プラグインの [`userConfig`](/docs/ja/plugins-reference#user-configuration) プロンプトが収集する機密性の低いオプション値を保存します。プラグイン ID でキー付けされます。Claude Code は、プラグインの構成ダイアログに入力すると、このキーをユーザー設定に書き込むため、手動で編集する必要はありません。機密オプションは、macOS Keychain に保存されるか、サポートされているキーチェーンがないプラットフォームでは `~/.claude/.credentials.json` に保存されます。701組織の管理設定はそれを `true` に設定します。ユーザー、プロジェクト、またはローカル設定に入れるものは何もヒントをオフにしません。`--settings` も。管理は最高レベルです。
833
834この例は、`acme-tools` マーケットプレイスからインストールされたプラグインの 1 つのオプションを保存します:
835
836```json theme={null}
837{
838 "pluginConfigs": {
839 "deployer@acme-tools": {
840 "options": {
841 "api_endpoint": "https://api.example.com"
842 }
843 }
844 }
845}
846```
847 702
848`pluginConfigs` はユーザー設定、`--settings` フラグ、および managed 設定からのみ読み込まれます。プロジェクトの `.claude/settings.json` または `.claude/settings.local.json` 内のエントリは無視されます。これらの値はプラグイン hook、MCP、および LSP 構成に置き換えられるため、クローンされたリポジトリはそれらを提供できません。v2.1.207 より前は、プロジェクトおよびローカル設定も読み込まれていました。703値を取り戻すことはできません。`/status` を実行してどの管理ソースが適用されるかを確認し、ポリシーが変更されるべきかどうかを管理者に尋ねてください。
849 704
850<h4 id="extraknownmarketplaces">705<h4 id="the-command-line-overrides-your-files-for-one-session">
851 `extraKnownMarketplaces`706 コマンドラインは 1 つのセッションのファイルをオーバーライドします
852</h4>707</h4>
853 708
854リポジトリで利用可能にする必要がある追加のマーケットプレイスを定義します。通常、リポジトリレベルの設定で使用され、チームメンバーが必要なプラグインソースにアクセスできることを確認します。709`claude --settings '{"spinnerTipsEnabled": true}'` でセッションを開始しました。コマンドラインは管理を除くすべてのファイルの上に座るため、そのセッションはファイルが `false` と言っていてもヒントを表示します。
855
856**リポジトリが `extraKnownMarketplaces` を含む場合**:
857
8581. チームメンバーはフォルダを信頼するときにマーケットプレイスをインストールするよう求められます
8592. チームメンバーはそのマーケットプレイスからプラグインをインストールするよう求められます
8603. ユーザーは不要なマーケットプレイスまたはプラグインをスキップできます(ユーザー設定に保存)
8614. インストールは信頼境界を尊重し、明示的な同意が必要です
862
863**例**:
864
865```json theme={null}
866{
867 "extraKnownMarketplaces": {
868 "acme-tools": {
869 "source": {
870 "source": "github",
871 "repo": "acme-corp/claude-plugins"
872 }
873 },
874 "security-plugins": {
875 "source": {
876 "source": "git",
877 "url": "https://git.example.com/security/plugins.git"
878 }
879 }
880 }
881}
882```
883
884**マーケットプレイスソースタイプ**:
885
886* `github`:GitHub リポジトリ(`repo` を使用)
887* `git`:任意の git URL(`url` を使用)
888* `directory`:ローカルファイルシステムパス(開発のみ、`path` を使用)
889* `hostPattern`:マーケットプレイスホストに一致する正規表現パターン(`hostPattern` を使用)
890* `settings`:ホストされたリポジトリなしで settings.json に直接宣言されたインラインマーケットプレイス(`name` と `plugins` を使用)
891
892`git` ソースタイプは、自己ホストされた GitLab や Bitbucket を含む任意の git ホスティングサービスで機能します。Claude Code は、そのマシンで `git clone` が使用するのと同じ認証でリポジトリをクローンします:構成された認証情報ヘルパーまたは SSH キー。`GITHUB_TOKEN` などのプロバイダートークンは、それを読み取る認証情報ヘルパーを通じてのみ有効になります。セットアップの詳細については、[プライベートリポジトリ](/docs/ja/plugin-marketplaces#private-repositories)を参照してください。
893 710
894`github` および `git` ソースの場合、`source` オブジェクト内(`repo` または `url` と並行して)に `"skipLfs": true` を設定して、Claude Code がマーケットプレイスリポジトリをクローンまたは更新するときに Git LFS ダウンロードをスキップします。LFS ポインターファイルはポインターのままで、コンテンツをダウンロードしません。リポジトリにプラグインコンテンツに関連しない大規模な LFS オブジェクトが含まれている場合に使用します。Claude Code v2.1.153 以降が必要です。711次のセッションで値を取り戻します。`--settings` は 1 つのセッション続き、ファイルに書き込みません。
895
896各マーケットプレイスエントリは、オプションの `autoUpdate` ブール値も受け入れます。`source` と並行して `"autoUpdate": true` を設定して、Claude Code がそのマーケットプレイスをリフレッシュし、起動時にインストール済みプラグインを更新するようにします。省略した場合、公式 Anthropic マーケットプレイスはデフォルトで `true` に設定され、その他すべてのマーケットプレイスはデフォルトで `false` に設定されます。[自動更新の構成](/docs/ja/discover-plugins#configure-auto-updates)を参照してください。
897
898`source: 'settings'` を使用して、ホストされたマーケットプレイスリポジトリをセットアップせずに、小規模なプラグインセットをインラインで宣言します。ここにリストされているプラグインは、GitHub または npm などの外部ソースを参照する必要があります。各プラグインを `enabledPlugins` で個別に有効にする必要があります。
899
900```json theme={null}
901{
902 "extraKnownMarketplaces": {
903 "team-tools": {
904 "source": {
905 "source": "settings",
906 "name": "team-tools",
907 "plugins": [
908 {
909 "name": "code-formatter",
910 "source": {
911 "source": "github",
912 "repo": "acme-corp/code-formatter"
913 }
914 }
915 ]
916 }
917 }
918 }
919}
920```
921 712
922<h4 id="strictknownmarketplaces">713<h4 id="a-flag-or-environment-variable-sets-the-same-thing">
923 `strictKnownMarketplaces`714 フラグまたは環境変数が同じことを設定します
924</h4>715</h4>
925 716
926**Managed 設定のみ**:ユーザーが追加してプラグインをインストールできるプラグインマーケットプレイスを制御します。この設定は [managed 設定](/docs/ja/settings#settings-files)でのみ構成でき、管理者にマーケットプレイスソースに対する厳密な制御を提供します。717いくつかのキーには、設定値に関係なくキーをオーバーライドするコマンドラインフラグまたは環境変数があります。`ANTHROPIC_MODEL` は [`model`](/docs/ja/settings-reference#model) 設定をオーバーライドし、`--model` はセッションのために両方をオーバーライドします。
927
928**Managed 設定ファイルの場所**:
929
930* **macOS**:`/Library/Application Support/ClaudeCode/managed-settings.json`
931* **Linux と WSL**:`/etc/claude-code/managed-settings.json`
932* **Windows**:`C:\Program Files\ClaudeCode\managed-settings.json`
933
934**主な特性**:
935
936* managed 設定(`managed-settings.json`)でのみ利用可能
937* ユーザーまたはプロジェクト設定でオーバーライドできません(最高優先度)
938* ネットワーク/ファイルシステム操作の前に強制されます(ブロックされたソースは実行されません)
939* `hostPattern` と `pathPattern` を除き、ソース仕様に対して完全一致を使用します。`hostPattern` と `pathPattern` は正規表現マッチングを使用します
940
941**ホワイトリスト動作**:
942
943* `undefined`(デフォルト):制限なし - ユーザーは任意のマーケットプレイスを追加できます
944* 空配列 `[]`:完全ロックダウン - ユーザーは新しいマーケットプレイスを追加できません
945* ソースのリスト:ユーザーは正確に一致するマーケットプレイスのみを追加できます
946
947**サポートされているすべてのソースタイプ**:
948
949ホワイトリストは複数のマーケットプレイスソースタイプをサポートしています。ほとんどのソースは完全一致を使用しますが、`hostPattern` と `pathPattern` はそれぞれマーケットプレイスホストとファイルシステムパスに対して正規表現マッチングを使用します。
950
9511. **GitHub リポジトリ**:
952
953```json theme={null}
954{ "source": "github", "repo": "acme-corp/approved-plugins" }
955{ "source": "github", "repo": "acme-corp/security-tools", "ref": "v2.0" }
956{ "source": "github", "repo": "acme-corp/plugins", "ref": "main", "path": "marketplace" }
957```
958
959フィールド:`repo`(必須)、`ref`(オプション:ブランチまたはタグ)、`path`(オプション:サブディレクトリ)
960
9612. **Git リポジトリ**:
962
963```json theme={null}
964{ "source": "git", "url": "https://gitlab.example.com/tools/plugins.git" }
965{ "source": "git", "url": "https://bitbucket.org/acme-corp/plugins.git", "ref": "production" }
966{ "source": "git", "url": "ssh://git@git.example.com/plugins.git", "ref": "v3.1", "path": "approved" }
967```
968
969フィールド:`url`(必須)、`ref`(オプション:ブランチまたはタグ)、`path`(オプション:サブディレクトリ)
970
9713. **URL ベースのマーケットプレイス**:
972
973```json theme={null}
974{ "source": "url", "url": "https://plugins.example.com/marketplace.json" }
975{ "source": "url", "url": "https://cdn.example.com/marketplace.json", "headers": { "Authorization": "Bearer ${TOKEN}" } }
976```
977
978フィールド:`url`(必須)、`headers`(オプション:認証アクセス用の HTTP ヘッダー)
979
980<Note>
981 URL ベースのマーケットプレイスは `marketplace.json` ファイルのみをダウンロードします。サーバーからプラグインファイルをダウンロードしません。URL ベースのマーケットプレイス内のプラグインは、相対パスではなく外部ソース(GitHub、npm、または git URL)を使用する必要があります。相対パスを持つプラグインの場合は、代わりに Git ベースのマーケットプレイスを使用します。詳細については [トラブルシューティング](/docs/ja/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces)を参照してください。
982</Note>
983
9844. **NPM パッケージ**:
985
986```json theme={null}
987{ "source": "npm", "package": "@acme-corp/claude-plugins" }
988{ "source": "npm", "package": "@acme-corp/approved-marketplace" }
989```
990
991フィールド:`package`(必須、スコープ付きパッケージをサポート)
992
9935. **ファイルパス**:
994
995```json theme={null}
996{ "source": "file", "path": "/usr/local/share/claude/acme-marketplace.json" }
997{ "source": "file", "path": "/opt/acme-corp/plugins/marketplace.json" }
998```
999
1000フィールド:`path`(必須:marketplace.json ファイルへの絶対パス)
1001
10026. **ディレクトリパス**:
1003
1004```json theme={null}
1005{ "source": "directory", "path": "/usr/local/share/claude/acme-plugins" }
1006{ "source": "directory", "path": "/opt/acme-corp/approved-marketplaces" }
1007```
1008
1009フィールド:`path`(必須:`.claude-plugin/marketplace.json` を含むディレクトリへの絶対パス)
1010
10117. **ホストパターンマッチング**:
1012
1013```json theme={null}
1014{ "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }
1015{ "source": "hostPattern", "hostPattern": "^gitlab\\.internal\\.example\\.com$" }
1016```
1017
1018フィールド:`hostPattern`(必須:マーケットプレイスホストに対してマッチする正規表現パターン)
1019
1020各リポジトリを列挙することなく、特定のホストからすべてのマーケットプレイスを許可する場合は、ホストパターンマッチングを使用します。これは、開発者が独自のマーケットプレイスを作成する内部 GitHub Enterprise または GitLab サーバーを持つ組織に役立ちます。
1021
1022ソースタイプ別のホスト抽出:
1023
1024* `github`:常に `github.com` に対してマッチ
1025* `git`:URL からホスト名を抽出(HTTPS と SSH 形式の両方をサポート)
1026* `url`:URL からホスト名を抽出
1027* `npm`、`file`、`directory`:ホストパターンマッチングではサポートされていません
1028
10298. **パスパターンマッチング**:
1030
1031```json theme={null}
1032{ "source": "pathPattern", "pathPattern": "^/opt/approved/" }
1033{ "source": "pathPattern", "pathPattern": ".*" }
1034```
1035
1036フィールド:`pathPattern`(必須:`file` および `directory` ソースの `path` フィールドに対してマッチする正規表現パターン)
1037
1038ネットワークソースの `hostPattern` 制限と並行して、ファイルシステムベースのマーケットプレイスを許可するには、パスパターンマッチングを使用します。すべてのローカルパスを許可するには `".*"` を設定するか、特定のディレクトリに制限するにはより狭いパターンを設定します。
1039
1040**構成例**:
1041
1042例:特定のマーケットプレイスのみを許可:
1043
1044```json theme={null}
1045{
1046 "strictKnownMarketplaces": [
1047 {
1048 "source": "github",
1049 "repo": "acme-corp/approved-plugins"
1050 },
1051 {
1052 "source": "github",
1053 "repo": "acme-corp/security-tools",
1054 "ref": "v2.0"
1055 },
1056 {
1057 "source": "url",
1058 "url": "https://plugins.example.com/marketplace.json"
1059 },
1060 {
1061 "source": "npm",
1062 "package": "@acme-corp/compliance-plugins"
1063 }
1064 ]
1065}
1066```
1067
1068例:すべてのマーケットプレイス追加を無効にする:
1069
1070```json theme={null}
1071{
1072 "strictKnownMarketplaces": []
1073}
1074```
1075
1076例:内部 git サーバーからすべてのマーケットプレイスを許可:
1077
1078```json theme={null}
1079{
1080 "strictKnownMarketplaces": [
1081 {
1082 "source": "hostPattern",
1083 "hostPattern": "^github\\.example\\.com$"
1084 }
1085 ]
1086}
1087```
1088
1089**完全一致要件**:
1090
1091マーケットプレイスソースはユーザーの追加を許可するために正確に一致する必要があります。git ベースのソース(`github` と `git`)の場合、これはすべてのオプションフィールドを含みます:
1092
1093* `repo` または `url` は正確に一致する必要があります
1094* `ref` フィールドは正確に一致する必要があります(または両方が未定義)
1095* `path` フィールドは正確に一致する必要があります(または両方が未定義)
1096 718
1097一致しないソースの例:719値を取り戻すことができるかどうかはキーによって異なります。変数をアンセットするか、フラグをドロップし、[設定リファレンス](/docs/ja/settings-reference)のキーのエントリと[環境変数リファレンス](/docs/ja/env-vars)の変数の行を確認して、Claude Code が使用するものを確認してください。
1098 720
1099```json theme={null}721<span id="keys-ignored-in-a-repository-file" />
1100// これらは異なるソースです:
1101{ "source": "github", "repo": "acme-corp/plugins" }
1102{ "source": "github", "repo": "acme-corp/plugins", "ref": "main" }
1103 722
1104// これらも異なります:723<span id="keys-only-you-or-your-organization-can-set" />
1105{ "source": "github", "repo": "acme-corp/plugins", "path": "marketplace" }
1106{ "source": "github", "repo": "acme-corp/plugins" }
1107```
1108
1109**`extraKnownMarketplaces` との比較**:
1110
1111| 側面 | `strictKnownMarketplaces` | `extraKnownMarketplaces` |
1112| ------------- | -------------------------- | ------------------------- |
1113| **目的** | 組織ポリシーの強制 | チームの利便性 |
1114| **設定ファイル** | `managed-settings.json` のみ | 任意の設定ファイル |
1115| **動作** | 許可されていない追加をブロック | 不足しているマーケットプレイスを自動インストール |
1116| **強制時期** | ネットワーク/ファイルシステム操作の前 | ユーザー信頼プロンプト後 |
1117| **オーバーライド可能** | いいえ(最高優先度) | はい(高優先度設定による) |
1118| **ソース形式** | 直接ソースオブジェクト | ネストされたソースを持つ名前付きマーケットプレイス |
1119| **ユースケース** | コンプライアンス、セキュリティ制限 | オンボーディング、標準化 |
1120 724
1121**形式の違い**:725<span id="common-cases" />
1122 726
1123`strictKnownMarketplaces` は直接ソースオブジェクトを使用します:727<span id="which-value-applies-in-common-situations" />
1124 728
1125```json theme={null}729<h3 id="troubleshoot-a-setting-that-doesn’t-apply">
1126{730 適用されない設定をトラブルシューティングする
1127 "strictKnownMarketplaces": [731</h3>
1128 { "source": "github", "repo": "acme-corp/plugins" }
1129 ]
1130}
1131```
1132 732
1133`extraKnownMarketplaces` は名前付きマーケットプレイスが必要です:733キーを設定し、Claude Code がそのように動作しない場合は、`/status` で読み込まれたファイルを確認してから、以下で症状を見つけてください。[構成をデバッグする](/docs/ja/debug-your-config)はより広いチェックをカバーしています。クリーン構成テストを含みます。
1134 734
1135```json theme={null}735<h4 id="a-value-you-set-is-ignored">
1136{736 設定した値が無視されます
1137 "extraKnownMarketplaces": {737</h4>
1138 "acme-tools": {
1139 "source": { "source": "github", "repo": "acme-corp/plugins" }
1140 }
1141 }
1142}
1143```
1144 738
1145**両方を一緒に使用**:739別のものが同じキーを設定しているか、ファイルがその値を設定できないか、ファイルが読み込まれませんでした:
1146 740
1147`strictKnownMarketplaces` はポリシーゲートです:ユーザーが追加できるものを制御しますが、マーケットプレイスを登録しません。マーケットプレイスを制限して事前登録するには、`managed-settings.json` で両方を設定します:741* **より高いレベルがそれを設定します。** 別の設定ファイル、`--settings` フラグ、または管理ソースがあなたのキーの上にキーを設定します。[スタック](#settings-precedence)はどれを説明します。フラグまたは環境変数もキーをオーバーライドできます。キーごとに決定されます。[設定リファレンス](/docs/ja/settings-reference)のキーのエントリは Claude Code が使用するものを説明し、[`env` エントリ](/docs/ja/settings-reference#env)は管理 `env` 値対シェルエクスポートをカバーしています。
742* **セキュリティキーはその厳密な値を保持します。** いくつかのキーについて Claude Code は任意のファイルからの制限値を優先するため、プロジェクト `true` は [`disableClaudeAiConnectors`](/docs/ja/settings-reference#disableclaudeaiconnectors) でオンのままです。[管理設定の優先順位の例外](#exceptions-to-managed-settings-precedence)を参照してください。
743* **ファイルはその値を設定できません。** [`permissions.defaultMode`](/docs/ja/settings-reference#permissions-defaultmode) 値 `auto` および `bypassPermissions` はプロジェクトまたはローカル設定から有効になりません。代わりにユーザーまたは管理設定で設定するか、1 つのセッションのために `--permission-mode` を渡してください。v2.1.257 より前では、`bypassPermissions` は任意のファイルから有効になりました。
744* **ファイルは壊れています。** 無効な JSON またはスキーマが拒否する値は Claude Code をファイルまたはエントリをスキップさせます。[壊れた設定ファイルを修正する](#fix-a-broken-settings-file)を参照してください。
1148 745
1149```json theme={null}746<h4 id="a-change-you-made-in-claude-code-is-lost-in-new-sessions">
1150{747 Claude Code で行った変更は新しいセッションで失われます
1151 "strictKnownMarketplaces": [748</h4>
1152 { "source": "github", "repo": "acme-corp/plugins" }
1153 ],
1154 "extraKnownMarketplaces": {
1155 "acme-tools": {
1156 "source": { "source": "github", "repo": "acme-corp/plugins" }
1157 }
1158 }
1159}
1160```
1161 749
1162`strictKnownMarketplaces` のみが設定されている場合、ユーザーは `/plugin marketplace add` を通じて許可されたマーケットプレイスを手動で追加できますが、自動的には利用できません。750Claude Code 内から新しいセッションの選択を保存する場合(`/model` でデフォルトモデルなど)、Claude Code はそれをユーザー設定ファイル `~/.claude/settings.json` に書き込みます。そのファイルに書き込むことができない場合(別のツールがそれを生成するか、読み取り専用コピーにリンクするため)、変更は現在のセッションに適用され、次のセッションで消えます。生成するツールでキーを設定するか、ファイルを書き込み可能なものに置き換えてください。
1163 751
1164**重要な注意**:752ファイルに書き込むことができ、変更がまだ続かない場合は、変更が[1 つのセッションのみ](#change-a-setting-for-one-session)であるか、[より高いレベルが同じキーを設定する](#a-value-you-set-is-ignored)かどうかを確認してください。`model` キーについては、[新しいセッションが選択したものとは異なるモデルで開始します](/docs/ja/model-config#a-new-session-starts-on-a-different-model-than-you-picked)はより多くの原因をリストします。
1165 753
1166* 制限はネットワークリクエストまたはファイルシステム操作の前にチェックされます754<h4 id="a-managed-change-hasn’t-reached-you">
1167* ブロックされた場合、ユーザーはソースが managed ポリシーでブロックされていることを示す明確なエラーメッセージを表示します755 管理変更があなたに到達していません
1168* 制限はマーケットプレイスの追加およびプラグインのインストール、更新、リフレッシュ、および自動更新に対して強制されます。ポリシーが設定される前に追加されたマーケットプレイスは、そのソースがホワイトリストと一致しなくなると、プラグインのインストールまたは更新に使用できません756</h4>
1169* Managed 設定は最高優先度を持ち、オーバーライドできません
1170 757
1171ユーザー向けドキュメントについては、[Managed マーケットプレイス制限](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions)を参照してください。758管理ソースは[配信テーブル](/docs/ja/managed-settings#choose-a-delivery-mechanism)のスケジュールでセッションに到達するため、最初にセッションを再起動してください。`/status` がその後、管理者が変更したものとは異なるソースの名前を付ける場合、より高い優先度のソースが適用されます。[Claude Code が管理ソースを結合する方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)は順序を提供します。
1172 759
1173<h4 id="strictpluginonlycustomization">760<h4 id="a-committed-key-doesn’t-reach-teammates">
1174 `strictPluginOnlyCustomization`761 コミットされたキーはチームメイトに到達しません
1175</h4>762</h4>
1176 763
1177**Managed 設定のみ**:skills、agents、hooks、および MCP サーバーをユーザーおよびプロジェクトソースからブロックするため、プラグインまたは managed 設定からのみ取得できます。`strictKnownMarketplaces` と組み合わせて、カスタマイズサプライチェーン全体を制御します:マーケットプレイスホワイトリストはユーザーがインストールできるプラグインを制御し、この設定はプラグインまたは managed 設定から来ていないすべてをブロックします。7642 つのことが `.claude/settings.json` のキーがそれをクローンするすべての人に適用されるのを保持します:
1178
1179値は、すべての 4 つのサーフェスをロックするための `true`、またはロックするサーフェスを名前付けする配列です:
1180 765
1181```json theme={null}766* **Claude Code はリポジトリファイルのキーを無視します。** [設定インデックス](/docs/ja/settings-reference#settings-index)の Scope 列で `User, local, or managed`、`User or managed`、`Managed`、または `Global config` を探してください。これらのキーはコミットされたファイルから適用されません。[`autoContinueAtUsageLimit`](/docs/ja/settings-reference#autocontinueatusagelimit) を除いて。リポジトリファイルはキーを設定し、ユーザー、`--settings`、または管理値は設定しません。Claude Code はそれをオフとして読み込みます。`Global config` キーは `~/.claude.json` からのみ適用されます。
1182{767* **キーは信頼を待ちます。** `permissions.allow` ルール、`permissions.additionalDirectories`、`extraKnownMarketplaces`、およびほとんどの [`env`](/docs/ja/settings-reference#env) 値は、各チームメイトが[フォルダを信頼する](/docs/ja/permissions#project-allow-rules-and-workspace-trust)後にのみ適用されます。それまで彼らはプロンプトを見て、ファイルが宣言するマーケットプレイスからプラグインを取得しません。`deny` および `ask` ルールはすぐに適用されます。
1183 "strictPluginOnlyCustomization": ["skills", "hooks"]
1184}
1185```
1186 768
1187ロックされた各サーフェスについて、Claude Code はユーザーレベルおよびプロジェクトレベルのソースをスキップし、プラグイン提供および managed ソースのみを読み込みます:769<h4 id="permission-rules-combine-differently-than-you-expected">
770 権限ルールは期待と異なる方法で結合されます
771</h4>
1188 772
1189| サーフェス | ロック時にブロック | 引き続き読み込み |773* **権限プロンプトで「はい、今後は聞かないでください」を選択しましたが、同じツールのプロンプトを取得し続けます。** その選択はローカルファイルに `allow` ルールを保存し、ローカルの `allow` ルールはプロジェクトまたは管理ファイルからの `ask` ルールをランク付けしません。[権限ルールがどのように結合されるか](/docs/ja/permissions#settings-precedence)は順序を説明します。VS Code 拡張機能では、承認カードはプロジェクトの共有ファイルを含む宛先ファイルを選択できます。これはすべての人のルールを変更します。CLI では、Claude Code はローカルファイルのみに書き込みます。
1190| :------- | :------------------------------------------- | :-------------------------------------------------------- |774* **組織の allow ルールはあなたのものと並行して適用されます。** それは期待されています。Claude Code は [`permissions.allow`](/docs/ja/settings-reference#permissions-allow) をスコープ全体でマージします。組織が [`allowManagedPermissionRulesOnly`](/docs/ja/settings-reference#allowmanagedpermissionrulesonly) を設定しない限り。
1191| `skills` | `~/.claude/skills/`、`.claude/skills/` | プラグイン skills、バンドルされた skills、managed ポリシーディレクトリ内の skills |
1192| `agents` | `~/.claude/agents/`、`.claude/agents/` | プラグイン agents、組み込み agents、managed ポリシーディレクトリ内の agents |
1193| `hooks` | ユーザー、プロジェクト、およびローカル `settings.json` 内の Hooks | プラグイン hooks、managed 設定内の hooks |
1194| `mcp` | `~/.claude.json` および `.mcp.json` 内のサーバー | プラグイン MCP サーバー、[`managed-mcp.json`](/docs/ja/managed-mcp) サーバー |
1195 775
1196Claude Code バージョンが認識しないサーフェス名は、設定ファイルが失敗するのではなく無視されるため、すべてのクライアントが更新される前に新しいサーフェス名を追加できます。776<span id="security-keys-where-the-stricter-value-applies" />
1197 777
1198<h3 id="manage-plugins">778<h3 id="exceptions-to-managed-settings-precedence">
1199 プラグインの管理779 管理設定の優先順位の例外
1200</h3>780</h3>
1201 781
1202`/plugin` コマンドを使用してプラグインを対話的に管理します:782いくつかのセキュリティに敏感なキーについて、Claude Code は、それ以外の場合は管理設定をオーバーライドできないスコープからの制限値を優先します。このテーブルでキーを見つけて、どの値を優先し、どこから優先するかを確認してください。
1203 783
1204* マーケットプレイスから利用可能なプラグインを参照784| キー | Claude Code が優先する値 | 注 |
1205* プラグインをインストール/アンインストール785| :------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------- |
1206* プラグインを有効/無効にする786| [`disableClaudeAiConnectors`](/docs/ja/settings-reference#disableclaudeaiconnectors) | 任意のスコープからの `true` | 管理ソースが `false` を設定する場合でも優先されます |
1207* プラグインの詳細を表示(提供される skills、agents、hooks)787| [`enableArtifact`](/docs/ja/settings-reference#enableartifact) | 任意のスコープからの `false`、および任意のスコープからの `disableArtifact: true` | 管理ソースが `true` を設定する場合でも優先されます。何も[Artifact ツール](/docs/ja/artifacts#disable-artifacts)をオンに戻しません。Claude Code v2.1.242 以降が必要です |
1208* マーケットプレイスを追加/削除788| [`isolatePeerMachines`](/docs/ja/settings-reference#isolatepeermachines) | 任意のスコープからの `true` | 管理ソースが `false` を設定する場合でも優先されます |
789| [`remoteControlAtStartup`](/docs/ja/settings-reference#remotecontrolatstartup) | `.claude/settings.json` または `.claude/settings.local.json` からの `false` | 管理ソースが `true` を設定する場合でも優先されます。プロジェクトまたはローカル `true` は無視されます |
790| [`crossSessionInbound`](/docs/ja/settings-reference#crosssessioninbound) | `.claude/settings.json` または `.claude/settings.local.json` からのより厳密な値。`accept` \< `hold` \< `refuse` ラダーで | 管理、`--settings`、およびユーザー値より優先されます。プロジェクトまたはローカル値がより厳密でない場合は無視されます |
791| [`useAutoModeDuringPlan`](/docs/ja/settings-reference#useautomodeduringplan) | 任意の管理ソース、`--settings`、`~/.claude/settings.json`、または `.claude/settings.local.json` からの `false` | 勝利した管理ソースが `true` を設定する場合でも優先されます。`.claude/settings.json` の `false` は無視されます |
792| [`syncClaudeAiSkills`](/docs/ja/settings-reference#syncclaudeaiskills) | 任意の管理ソース、`--settings`、`~/.claude/settings.json`、または `.claude/settings.local.json` からの `false` | 勝利した管理ソースが `true` を設定する場合でも優先されます。`.claude/settings.json` の `false` は無視されます |
1209 793
1210[プラグインドキュメント](/docs/ja/plugins)でプラグインシステムについて詳しく学びます。794Claude Code を実行し、[`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ja/env-vars) を設定するアプリも例外です。Claude Code はそのアプリのモデル構成を、すべての管理ソースからの `model`、`fallbackModel`、および `modelOverrides` キーより優先し、管理 `env` ブロック内のモデル選択変数(`ANTHROPIC_MODEL` および `ANTHROPIC_DEFAULT_*_MODEL` ファミリーなど)より優先します。Claude Code は、アプリが独自のものを提供しない限り、管理 [`availableModels`](/docs/ja/settings-reference#availablemodels) 許可リストを有効に保ちます。
1211 795
1212<h2 id="environment-variables">796<h2 id="settings-in-cloud-sessions">
1213 環境変数797 クラウドセッションの設定
1214</h2>798</h2>
1215 799
1216環境変数を使用すると、設定ファイルを編集することなく Claude Code の動作を制御できます。任意の変数は、すべてのセッションに適用するか、チームにロールアウトするために [`settings.json`](#available-settings) の `env` キーで構成することもできます。800クラウドセッション。[Claude Code on the web](/docs/ja/claude-code-on-the-web) または [`claude --cloud`](/docs/ja/claude-code-on-the-web#from-terminal-to-web) から。[クラウド環境](/docs/ja/cloud-environments)で実行します。リポジトリの新しいクローンで、マシンではありません。これはどの設定がそれに到達するかを変更します:
1217
1218完全なリストについては、[環境変数リファレンス](/docs/ja/env-vars)を参照してください。
1219
1220<h2 id="tools-available-to-claude">
1221 Claude が利用できるツール
1222</h2>
1223 801
1224Claude Code は、ファイルの読み取り、編集、検索、コマンド実行、および subagents のオーケストレーション用のツールセットにアクセスできます。ツール名は、権限ルールと hook マッチャーで使用する正確な文字列です。802* **共有プロジェクト設定**(`.claude/settings.json`):読み込まれます。ファイルはクローンの一部であるため。クラウドセッションで適用するために設定をそこにコミットしてください。
803* **ユーザーおよびプロジェクトローカル設定**(`~/.claude/settings.json` および `.claude/settings.local.json`):読み込まれません。両方ともマシンに留まり、ローカルファイルはクローンにありません。
804* **管理設定**:[サーバー管理設定](/docs/ja/server-managed-settings)のみがクラウドセッションに到達します。デバイスの `managed-settings.json` ファイルまたは MDM プロファイルは到達しません。[自己ホスト型環境](/docs/ja/self-hosted-environments)もランナーイメージの管理設定ファイルを読み込みます。[Claude Code が管理ソースを結合する方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)はそのファイルがいつ適用されるかを説明します。
805* **`/config`**:web では、Claude Code セクションを変更する代わりに claude.ai 設定を開きます。クラウドセッションの設定を変更するには、環境で[環境変数](/docs/ja/cloud-environments#set-environment-variables)を設定するか、リポジトリの `.claude/settings.json` にキーをコミットしてください。
1225 806
1226完全なリストと Bash ツール動作の詳細については、[ツールリファレンス](/docs/ja/tools-reference)を参照してください。807[セットアップから何が引き継がれるか](/docs/ja/cloud-environments#what-carries-over-from-your-setup)は残りをリストします。`CLAUDE.md`、skills、MCP サーバー、プラグイン、および認証情報。
1227 808
1228<h2 id="see-also">809<h2 id="what’s-next">
1229 関連項目810 次は何か
1230</h2>811</h2>
1231 812
1232* [権限](/docs/ja/permissions):権限システム、ルール構文、ツール固有パターン、および managed ポリシー813* [すべての設定](/docs/ja/settings-reference):すべてのキー。設定する場所と例
1233* [認証](/docs/ja/authentication):Claude Code へのユーザーアクセスをセットアップ814* [設定ファイルの例](/docs/ja/settings-example):個人ファイル、チームファイル、および組織の管理ファイル
1234* [設定をデバッグする](/docs/ja/debug-your-config):設定、hook、または MCP サーバーが有効にならない理由を診断815* [権限を構成する](/docs/ja/permissions):allow、ask、および deny ルール。Claude Code が確認なしで実行するもの
1235* [インストールとログインのトラブルシューティング](/docs/ja/troubleshoot-install):インストール、認証、およびプラットフォームの問題816* [環境変数](/docs/ja/env-vars):Claude Code が読み込む変数および `env` ブロック
817* [構成をデバッグする](/docs/ja/debug-your-config):設定が適用されない場合
818* [Claude ディレクトリリファレンス](/docs/ja/claude-directory):Claude Code が読み込むすべてのファイル。subagents、MCP サーバー、プラグイン、および `CLAUDE.md` を含む