Anthropic
OpenAI
xAI
Gemini
S
settings-reference.md
2026-09-30 23:00 UTC to 2026-10-01 21:59 UTC
This page contains 338 additions and 245 deletions.
Page
Diff
2026
2026
Jan
Feb
Mar
Apr
May
Jun
Jul
Aug
Sep
Oct
Nov
Dec
すべての設定
Claude Code の settings.json キーの完全なリファレンス:各キーの場所、型とデフォルト値、貼り付け可能な例、およびすべてのキーのインデックス。
export const BackToIndex = ({href = '#all-settings', label = 'Back to index'}) => {
const [show, setShow] = useState(false);
useEffect(() => {
const onScroll = () => setShow(window.scrollY > window.innerHeight);
onScroll();
window.addEventListener('scroll', onScroll, {
passive: true
});
return () => window.removeEventListener('scroll', onScroll);
}, []);
return
<a className={'bti-btn' + (show ? ' bti-show' : '')} href={href} aria-hidden={!show} tabIndex={show ? 0 : -1}>
{label}
;
};
export const ReferenceFilter = ({placeholder, noun, facets, facetOrder, columnHelp, children}) => {
const useLive = init => {
const [v, setV] = useState(init);
const ref = useRef(init);
return [v, ref, x => {
ref.current = x;
setV(x);
}];
};
const cap = s => s.charAt(0).toUpperCase() + s.slice(1);
const plural = s => s.endsWith('y') ? s.slice(0, -1) + 'ies' : s + 's';
const facetNames = facets || ['category', 'topic', 'scope', 'where'];
const orderOf = {};
Object.keys(facetOrder || ({})).forEach(k => {
orderOf[k] = facetOrder[k].map(x => String(x).toLowerCase());
});
const rankIn = (col, v) => {
const list = orderOf[col];
if (!list) return -1;
const i = list.indexOf(String(v).toLowerCase());
return i < 0 ? list.length : i;
};
const cmpValues = col => (a, b) => {
const ra = rankIn(col, a);
const rb = rankIn(col, b);
if (ra !== rb) return ra - rb;
return a < b ? -1 : a > b ? 1 : 0;
};
const help = columnHelp || ({});
const FIRST_COL_HELP = 'Click an entry to open it.';
const optionLabel = (f, c) => c === 'All' ? 'All ' + plural(f.label.toLowerCase()) : c;
const nounText = noun || 'entries';
const placeholderText = placeholder || 'Filter this reference';
const rootRef = useRef(null);
const tablesRef = useRef(null);
const searchRef = useRef(null);
const menuRef = useRef({});
const [q, qRef, setQ] = useLive('');
const [sel, selRef, setSel] = useLive({});
const [sortBy, sortRef, setSortBy] = useLive(null);
const [menuOpen, menuOpenRef, setMenu] = useLive(null);
const [facetList, setFacetList] = useState([]);
const [firstHead, setFirstHead] = useState('');
const [counts, setCounts] = useState({
shown: 0,
total: 0
});
const [disabled, setDisabled] = useState(false);
const menuBtn = name => menuRef.current[name] ? menuRef.current[name].querySelector(':scope > button') : null;
const menuList = name => menuRef.current[name] ? menuRef.current[name].querySelector('[role="listbox"]') : null;
const closeMenu = name => {
setMenu(null);
const btn = menuBtn(name);
if (btn) btn.focus();
};
const focusSelected = name => {
const list = menuList(name);
if (!list) return;
const btn = list.querySelector('button[aria-selected="true"]') || list.querySelector('button');
if (btn) btn.focus();
};
const setFacet = (name, value) => {
setSel(Object.assign({}, selRef.current, {
[name]: value
}));
apply(qRef.current);
closeMenu(name);
};
const sortTables = by => {
(tablesRef.current || []).forEach(tab => {
const t = tab.el;
const idx = tab.heads.indexOf(by);
const body = t.querySelector('tbody');
if (idx < 0 || !body) return;
const rows = [...body.querySelectorAll('tr')];
const keyOf = r => r.children[idx] ? r.children[idx].textContent.trim().toLowerCase() : '';
const cmp = cmpValues(by);
rows.map((r, i) => ({
r,
i: Number(r.dataset.sfIndex !== undefined ? r.dataset.sfIndex : i),
k: keyOf(r)
})).sort((a, b) => cmp(a.k, b.k) || a.i - b.i).forEach(x => body.appendChild(x.r));
[...t.querySelectorAll('thead th')].forEach((h, i) => {
const sortable = tab.heads[i] === tab.heads[0] || facetNames.indexOf(tab.heads[i]) > -1;
if (sortable) h.setAttribute('aria-sort', i === idx ? 'ascending' : 'none'); else h.removeAttribute('aria-sort');
});
});
};
const scan = () => {
const tables = [];
let el = rootRef.current ? rootRef.current.nextElementSibling : null;
while (el) {
if (el.tagName === 'H2' || el.querySelector(':scope > h2')) break;
const found = el.tagName === 'TABLE' ? [el] : [...el.querySelectorAll('table')];
found.forEach(t => {
const headCells = [...t.querySelectorAll('thead th, thead td')];
const heads = headCells.map(h => h.textContent.trim().toLowerCase());
if (heads.length === 0) return;
const facetIdx = {};
heads.forEach((h, i) => {
if (facetNames.indexOf(h) > -1) facetIdx[h] = i;
});
if (!t.dataset.sfDecorated) {
t.dataset.sfDecorated = '1';
headCells.forEach((h, i) => {
const text = i === 0 ? help[heads[0]] || FIRST_COL_HELP : help[heads[i]];
if (text) h.title = text;
});
}
const rows = [...t.querySelectorAll('tbody tr')].map((r, i) => {
if (r.dataset.sfIndex === undefined) r.dataset.sfIndex = String(i);
const cells = r.querySelectorAll('td');
const fv = {};
Object.keys(facetIdx).forEach(h => {
fv[h] = cells[facetIdx[h]] ? cells[facetIdx[h]].textContent.trim() : '';
});
return {
el: r,
text: [...cells].map(c => c.textContent).join(' ').toLowerCase(),
facets: fv,
anchors: [...r.querySelectorAll('a[href^="#"]')].map(a => a.getAttribute('href').slice(1)),
ids: [...r.querySelectorAll('[id]')].map(n => n.id)
};
});
tables.push({
el: t,
box: t.closest('[data-table-wrapper]') || t,
rows,
heads
});
});
el = el.nextElementSibling;
}
tablesRef.current = tables;
if (sortRef.current) sortTables(sortRef.current);
return tables;
};
const apply = query => {
let tables = tablesRef.current || scan();
if (tables.some(t => !t.el.isConnected)) tables = scan();
const needle = query.trim().toLowerCase();
const sel = selRef.current;
const activeFacets = Object.keys(sel).filter(h => sel[h] && sel[h] !== 'All');
const show = (el, on) => {
const want = on ? '' : 'none';
if (el.style.display !== want) el.style.display = want;
};
let total = 0;
let shown = 0;
const visibleTargets = new Set();
tables.forEach(t => {
let tableVisible = 0;
t.rows.forEach(row => {
total += 1;
const catOk = activeFacets.every(h => {
const v = row.facets[h];
return v === sel[h] || v === '' || v === undefined;
});
const match = catOk && (needle === '' || row.text.includes(needle));
show(row.el, match);
if (match) {
tableVisible += 1;
row.anchors.forEach(a => visibleTargets.add(a));
}
});
show(t.box, !(t.rows.length > 0 && tableVisible === 0));
shown += tableVisible;
});
if (shown < total && visibleTargets.size > 0) {
tables.forEach(t => {
t.rows.forEach(row => {
if (row.el.style.display === 'none' && row.ids.some(id => visibleTargets.has(id))) {
show(row.el, true);
show(t.box, true);
shown += 1;
}
});
});
}
setCounts({
shown,
total
});
return total;
};
const deriveFacets = tables => {
const seen = {};
tables.forEach(t => t.rows.forEach(r => {
Object.keys(r.facets).forEach(h => {
if (!seen[h]) seen[h] = [];
if (r.facets[h] && seen[h].indexOf(r.facets[h]) === -1) seen[h].push(r.facets[h]);
});
}));
const list = facetNames.filter(h => seen[h] && seen[h].length > 0).map(h => ({
name: h,
label: cap(h),
values: seen[h].sort(cmpValues(h))
}));
setFacetList(list);
const first = tables[0] ? tables[0].heads[0] : '';
setFirstHead(first);
if (!sortRef.current && first) {
setSortBy(first);
sortTables(first);
}
const init = {};
list.forEach(f => {
init[f.name] = selRef.current[f.name] || 'All';
});
setSel(init);
};
const onChange = value => {
setQ(value);
apply(value);
};
const clearAll = () => {
const next = {};
Object.keys(selRef.current).forEach(k => {
next[k] = 'All';
});
setSel(next);
setQ('');
apply('');
if (searchRef.current) searchRef.current.focus();
};
useEffect(() => {
const tables = scan();
deriveFacets(tables);
const total = apply('');
let retryTimer;
if (total === 0) {
retryTimer = setTimeout(() => {
tablesRef.current = null;
if (apply(qRef.current) > 0) deriveFacets(tablesRef.current); else setDisabled(true);
}, 500);
}
const onKey = e => {
if (e.key === 'Escape' && menuOpenRef.current !== null) closeMenu(menuOpenRef.current);
if (!searchRef.current) return;
if (e.metaKey || e.ctrlKey || e.altKey) return;
const active = document.activeElement;
const tag = active && active.tagName;
const editable = active && active.isContentEditable;
const interactive = tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'SELECT' || tag === 'BUTTON' || tag === 'A' || editable || active && active.getAttribute && active.getAttribute('role');
if (e.key === '/' && !interactive) {
const r = rootRef.current ? rootRef.current.getBoundingClientRect() : null;
if (r && r.bottom > 0 && r.top < (window.innerHeight || 0)) {
e.preventDefault();
setMenu(null);
searchRef.current.focus();
}
}
if (e.key === 'Escape' && menuOpenRef.current === null && active === searchRef.current) {
onChange('');
searchRef.current.blur();
}
};
const onDocClick = e => {
const open = menuOpenRef.current;
if (open !== null && menuRef.current[open] && !menuRef.current[open].contains(e.target)) setMenu(null);
};
window.addEventListener('keydown', onKey);
document.addEventListener('mousedown', onDocClick);
return () => {
if (retryTimer) clearTimeout(retryTimer);
window.removeEventListener('keydown', onKey);
document.removeEventListener('mousedown', onDocClick);
(tablesRef.current || []).forEach(t => {
t.box.style.display = '';
t.rows.forEach(row => {
row.el.style.display = '';
});
});
};
}, []);
useEffect(() => {
if (menuOpen !== null) focusSelected(menuOpen);
}, [menuOpen]);
if (disabled) return null;
const facetActive = Object.keys(sel).some(h => sel[h] && sel[h] !== 'All');
const sortOptions = [firstHead].concat(facetList.map(f => f.name)).filter((h, i, a) => h && a.indexOf(h) === i);
return <>
<div ref={rootRef} className="sf-root" style={{
margin: '16px 0 8px'
}}>
<div style={{
display: 'flex',
gap: '8px',
flexWrap: 'wrap',
alignItems: 'center'
}}>
<div style={{
position: 'relative',
flex: '1 1 260px',
maxWidth: '480px'
}}>
<input ref={searchRef} value={q} onChange={e => onChange(e.target.value)} placeholder={placeholderText} aria-label={placeholderText} style={{
width: '100%',
padding: '8px 56px 8px 12px',
borderRadius: '8px',
border: '1px solid var(--sf-border)',
background: 'var(--sf-bg)',
color: 'var(--sf-text)',
fontSize: '14px',
outline: 'none',
boxSizing: 'border-box'
}} />
{q ? <button type="button" onClick={() => {
onChange('');
if (searchRef.current) searchRef.current.focus();
}} aria-label="Clear text" className="sf-end sf-x">
×
: <span className="sf-end" style={{
fontFamily: 'var(--font-mono, ui-monospace, monospace)',
fontSize: '11px',
color: 'var(--sf-text-4)',
border: '1px solid var(--sf-border)',
borderRadius: '3px',
padding: '0 5px',
pointerEvents: 'none'
}}>
/
}
{facetList.map(f => {
const cur = sel[f.name] || 'All';
const isOpen = menuOpen === f.name;
return <div key={f.name} ref={el => {
menuRef.current[f.name] = el;
}} style={{
position: 'relative'
}}>
<button type="button" onClick={() => setMenu(isOpen ? null : f.name)} onKeyDown={e => {
if (e.key === 'ArrowDown') {
e.preventDefault();
if (!isOpen) setMenu(f.name); else focusSelected(f.name);
}
}} aria-haspopup="listbox" aria-expanded={isOpen} style={{
display: 'flex',
alignItems: 'center',
gap: '8px',
padding: cur !== 'All' ? '8px 30px 8px 12px' : '8px 12px',
borderRadius: '8px',
border: '1px solid ' + (cur !== 'All' ? 'var(--sf-accent)' : 'var(--sf-border)'),
background: 'var(--sf-bg)',
color: cur === 'All' ? 'var(--sf-text-3)' : 'var(--sf-text)',
fontSize: '13.5px',
cursor: 'pointer',
whiteSpace: 'nowrap',
maxWidth: '260px'
}}>
<span style={{
overflow: 'hidden',
textOverflow: 'ellipsis'
}}>
{f.label + ': ' + optionLabel(f, cur)}
<span aria-hidden="true" style={{
fontSize: '9px',
color: 'var(--sf-text-4)',
transform: isOpen ? 'rotate(180deg)' : 'none',
transition: 'transform 120ms'
}}>
▼
{cur !== 'All' && <button type="button" onClick={() => setFacet(f.name, 'All')} aria-label={'Clear ' + f.label + ' filter'} title={'Clear ' + f.label + ' filter'} className="sf-end sf-x">
×
}
{isOpen && <div role="listbox" aria-label={f.label} onKeyDown={e => {
const items = [...e.currentTarget.querySelectorAll('button')];
const idx = items.indexOf(document.activeElement);
if (e.key === 'ArrowDown') {
e.preventDefault();
(items[idx + 1] || items[0]).focus();
} else if (e.key === 'ArrowUp') {
e.preventDefault();
(items[idx - 1] || items[items.length - 1]).focus();
} else if (e.key === 'Home') {
e.preventDefault();
if (items[0]) items[0].focus();
} else if (e.key === 'End') {
e.preventDefault();
if (items[items.length - 1]) items[items.length - 1].focus();
} else if (e.key === 'Tab') {
closeMenu(f.name);
}
}} style={{
position: 'absolute',
top: 'calc(100% + 6px)',
left: 0,
zIndex: 1000,
minWidth: '260px',
maxHeight: '340px',
overflowY: 'auto',
background: 'var(--sf-bg)',
border: '1px solid var(--sf-border)',
borderRadius: '10px',
boxShadow: '0 8px 24px rgba(0,0,0,0.12)',
padding: '5px'
}}>
{['All'].concat(f.values).map(c => {
const selected = cur === c;
return <button key={c} role="option" aria-selected={selected} tabIndex={-1} onClick={() => setFacet(f.name, c)} style={{
display: 'flex',
alignItems: 'center',
gap: '8px',
width: '100%',
textAlign: 'left',
padding: '7px 10px',
borderRadius: '6px',
border: 'none',
background: 'transparent',
color: selected ? 'var(--sf-accent)' : 'var(--sf-text)',
fontWeight: selected ? 600 : 400,
fontSize: '13.5px',
cursor: 'pointer'
}}>
<span aria-hidden="true" style={{
width: '14px',
color: 'var(--sf-accent)',
flexShrink: 0
}}>
{selected ? '✓' : ''}
{optionLabel(f, c)}
;
})}
}
;
})}
{sortOptions.length > 1 && <div role="group" aria-label="Sort by" style={{
display: 'flex',
alignItems: 'center',
gap: '4px',
fontSize: '13px',
color: 'var(--sf-text-3)',
whiteSpace: 'nowrap'
}}>
<span style={{
marginRight: '4px'
}}>Sort by
{sortOptions.map(o => {
const on = sortBy === o;
return <button key={o} type="button" aria-pressed={on} onClick={() => {
setSortBy(o);
sortTables(o);
}} style={{
padding: '6px 10px',
borderRadius: '8px',
border: '1px solid ' + (on ? 'var(--sf-accent)' : 'var(--sf-border)'),
background: 'var(--sf-bg)',
color: on ? 'var(--sf-text)' : 'var(--sf-text-3)',
fontSize: '13px',
cursor: 'pointer'
}}>
{o.charAt(0).toUpperCase() + o.slice(1)}
;
})}
}
<div aria-live="polite" style={{
margin: '8px 0 0',
fontSize: '13px',
color: 'var(--sf-text-3)',
minHeight: '1px'
}}>
{q.trim() === '' && !facetActive ? <>{counts.total} {nounText}</> : counts.shown === 0 ? <>
{q.trim() === '' ? 'No ' + nounText + ' match the selected filters.' : facetActive ? 'No ' + nounText + ' match \u201c' + q + '\u201d with the selected filters.' : 'No ' + nounText + ' match \u201c' + q + '\u201d.'}{' '}
<button type="button" onClick={clearAll} style={{
background: 'none',
border: 'none',
padding: 0,
color: 'var(--sf-accent)',
cursor: 'pointer',
font: 'inherit',
textDecoration: 'underline'
}}>
Clear filters
{children ? <> {children}</> : null}
</> : <>
Showing {counts.shown} of {counts.total} {nounText}
</>}
</>;
};
このリファレンスページでは、Claude Code が設定ファイルから読み込む各キーと、代わりに ~/.claude.json に保持する短いキーグループ を一覧表示しています。ファイルを選択するか、優先順位を確認するには、設定ファイルと優先順位 から始めてください。
設定インデックス
以下のすべてのキーはそのエントリにリンクしています。スコープは、それが入ることができるファイル をリストしています。User は ~/.claude/settings.json、Project は .claude/settings.json、Local は .claude/settings.local.json、Managed は組織がデプロイするもの です。Any file は 4 つすべてを意味し、Global config は ~/.claude.json を意味します。
<ReferenceFilter
noun="settings"
placeholder="Filter settings by key or purpose"
facetOrder={{ scope: ["Any file", "User, local, or managed", "User or managed", "Managed", "Global config"] }}
columnHelp={{
topic: "The section of this page that holds the entry. Use Sort by to group the table by topic.",
scope: "Which settings files can set the key: user (~/.claude/settings.json), project (.claude/settings.json), local (.claude/settings.local.json), or managed (deployed by your organization). Global config keys are in ~/.claude.json instead.",
}}
/>
モデルと応答
Claude Code が使用するモデルと応答方法を選択します。これらの設定が /model コマンドと環境変数とどのように相互作用するかについては、モデル設定 を参照してください。
`advisorModel`
Claude がサーバー側のアドバイザーツール を呼び出すときに回答するモデルを選択します。これを設定解除するとアドバイザーがオフになります。アドバイザーはメインモデル以上の能力を持つ必要があります。受け入れられるペアリングと受け入れられないペアリングを選択した場合の動作については、アドバイザーモデルを選択 を参照してください。
通常、このキーを手動で編集することはありません。/advisor を実行して、現在の選択、アドバイザーができるモデル、およびアドバイザーなし を表示するピッカーを開きます。Claude Code は選択を ~/.claude/settings.json のこのキーに保存します。リモートコントロール クライアントから、またはリモートワーカーに接続されたセッションで選択した場合、その選択はそのセッションのみに適用され、このキーは変更されません。
アカウントが使用クレジット同意 を必要とする場合は、/model fable を実行して最初に同意を受け入れます。これを行うまで、/advisor で Fable を選択しても何も保存されず、Claude Code は最初に /model fable を実行するよう指示します。
スコープ : 任意のファイル
タイプ : 文字列、エイリアス "fable"、"opus"、または "sonnet" のいずれか。これらは Claude Code の現在のデフォルトバージョンのそのモデルファミリーに解決されます。または、"claude-opus-5-5" などの完全なモデル ID
デフォルト : 設定解除されているため、アドバイザーはオフです
セッションごとのオーバーライド : --advisor はこのキーより優先されます。CLAUDE_CODE_DISABLE_ADVISOR_TOOL はアドバイザーをオフにし、このキーはそれをオンに戻すことはできません
{
"advisorModel" : "opus"
}
このキーは、Amazon Bedrock や Claude Platform on AWS など、アドバイザーが利用できない プロバイダーには影響しません。"fable" にはFable アクセス が必要です。
`alwaysThinkingEnabled`
このキーを false に設定して、すべてのセッションで拡張思考 をオフにします。思考はデフォルトでオンなので、true は何も変わりません。ほとんどの人はファイルを編集するのではなく /config を通じてこれを設定します。
Opus 5.5、Sonnet 5.5、Fable モデルなど、常に思考するモデルでは、false は効果がありません。サードパーティプロバイダー では、Claude Code は思考をオフにするのではなく thinking パラメータを省略するため、適応推論モデルは依然として思考する可能性があります。Anthropic API で思考をオフにした場合、Claude Code は、Opus 5 などその組み合わせを受け入れない ことが分かっているモデルに、より高いレベルではなく努力 high を送信します。
スコープ : 任意のファイル
タイプ : ブール値
true: 効果なし。思考は既にオンです
false: Claude Code はすべてのセッションで拡張思考をオフにします
デフォルト : 設定解除されているため、思考はそれをサポートするモデルではオンです
セッションごとのオーバーライド : MAX_THINKING_TOKENS はこのキーより優先されます。0 は false と同じモデルおよびプロバイダーの制限の下で思考をオフにし、正の値は、このキーが false の場合でも思考をオンにします。適応推論モデルでは、数値自体は無視されます
{
"alwaysThinkingEnabled" : false
}
`availableModels`
メインセッション、サブエージェント 、スキル 、およびアドバイザー で選択できるモデルを制限します。管理リストは /model、--model、および開発者自身のファイルの model キーを制限します。リスト外のモデルは選択できません。デフォルトのプレフィックスマッチングでは、これは Default オプション自体には影響しません。enforceAvailableModels とペアにしてください。
スコープ : 任意のファイル 。組織に対して強制するために、管理設定にデプロイします。
タイプ : モデルエイリアスまたは ID の配列
デフォルト : 設定解除されているため、すべてのモデルが利用可能です
この例では、Sonnet と Haiku モデルのみを選択できます:
{
"availableModels" : [ "sonnet" , "haiku" ]
}
"claude-opus-5" などのモデル ID エントリは、Opus 5.5 などそれを拡張する後のバージョンも許可します。これらのバージョンのいずれかをブロックするには、deniedModels を使用します。各モデル ID エントリが名前を付けたバージョンのみを許可するようにするには、availableModelsMatch を使用します。モデル選択を制限 を参照してください。
`availableModelsMatch`
availableModels エントリがモデル ID とどのように一致するかを選択します。デフォルトでは、モデル ID エントリはそれを拡張する後のバージョンも許可するため、"claude-opus-5" は Opus 5.5 を許可します。"exact" では、各モデル ID エントリは名前を付けたバージョンのみを許可するため、そのモデルの新しいバージョンはリストに追加されるまでブロックされたままです。Claude Code v2.1.283 以降が必要です。
スコープ : 管理 。Claude Code はユーザー、プロジェクト、ローカル設定および --settings のキーを無視し、警告を表示します
タイプ : 文字列、以下のいずれか:
"prefix": モデル ID エントリはそのバージョンと、別のセグメントで拡張するモデル ID を許可します
"exact": モデル ID エントリは名前を付けたバージョンのみを許可します。日付付き ID を含むため、"claude-opus-5" は Opus 5 を許可しますが claude-opus-5-5 は許可しません。"opus" などのファミリーエイリアスは依然としてファミリー全体を許可し、best、opusplan、および default エントリは無視されます
デフォルト : "prefix"
この例は Opus 5 と Sonnet 5 を許可し、どちらの後のリリースも許可しません:
{
"availableModels" : [ "claude-opus-5" , "claude-sonnet-5" ] ,
"availableModelsMatch" : "exact"
}
"exact" では、リストが少なくとも 1 つのモデルまたはファミリーを名前付けするときはいつでも、Default オプションもリストされたモデルに制限されます。特定のモデルまたはバージョンをブロック を参照してください。
`deniedModels`
availableModels 許可リストの有無にかかわらず、特定のモデルをブロックし、そのリストがそれらを許可する場合でもブロックします。Claude Code はブロックされたモデルを /model ピッカーから非表示にし、availableModels が強制される場所ではどこでもモデルを選択できません。Default オプションのセッションは、特定のモデルまたはバージョンをブロック で説明されているように、ブロックされたモデルも実行しません。Claude Code v2.1.283 以降が必要です。
スコープ : 管理 。Claude Code はユーザー、プロジェクト、ローカル設定および --settings のキーを無視し、警告を表示します
タイプ : モデルエイリアスまたは ID の配列
"opus" などのファミリーエイリアスはそのファミリーのすべてのモデルをブロックします
"claude-opus-5-5" などのモデル ID は、日付付きおよびプロバイダー固有の ID を含むすべてのスペルでそのバージョンをブロックします
"claude-opus-5" などのマイナーバージョンなしのモデル ID は、Opus 5.5 などの後のマイナーバージョンもブロックします。Opus 5 のみをブロックするには "claude-opus-5-0" を記述します
best、opusplan、および default エントリは無視されます
デフォルト : 設定解除されているため、モデルはブロックされません
この例は Opus と Sonnet モデルを許可し、Opus 5.5 をブロックします:
{
"availableModels" : [ "opus" , "sonnet" ] ,
"deniedModels" : [ "claude-opus-5-5" ]
}
特定のモデルまたはバージョンをブロック を参照してください。
`effortLevel`
保存していないモデルのデフォルト努力レベル を設定します。低いレベルは単純なタスクではより高速で安価であり、高いレベルは複雑な問題でより深く推論します。
マシン上のインタラクティブセッションで /effort low、medium、high、または xhigh を実行すると、Claude Code はレベルをファイルを編集するのではなく modelSettings の下のアクティブなモデルに保存します。v2.1.251 より前では、/effort はこのキーを書き込みました。
同じ設定ファイル内で、Claude Code はこのキーではなくモデルの保存されたレベルを使用します。modelSettings はクロスファイルの優先順位を述べています。
リモートワーカーに接続されたセッション、-p 実行、および Agent SDK では、/effort はそのセッションのみに適用されます。努力レベルを調整 はそのセッションのみに適用されるインタラクティブな選択肢もリストします。/effort が出力するメッセージは、どちらが起こったかを示します。
スコープ : 任意のファイル
タイプ : 文字列、以下のいずれか:
"low": 最小限の推論。短く、スコープが限定され、レイテンシに敏感で、インテリジェンスに敏感ではないタスク用
"medium": コスト敏感な作業のトークン使用量を削減します。インテリジェンスをいくらか取引できます
"high": トークン使用量とインテリジェンスのバランスを取ります
"xhigh": より高いトークン支出でより深い推論
デフォルト : 設定解除されています
セッションごとのオーバーライド : --effort はこのキーより優先されます。CLAUDE_CODE_EFFORT_LEVEL は両方より優先されます
{
"effortLevel" : "xhigh"
}
ユーザー設定ファイル ~/.claude/settings.json では、このキーは /effort が保存する前の古い形式です。モデルごとにレベルを保存し、以前に適用された場所に適用され続けます。Opus 5、Fable 5.1、および以前のモデルで。Opus 5.5 およびそれ以降にリリースされたモデルはそれを無視し、modelSettings の下でレベルを保存するまで独自のデフォルトで開始します。これは /effort が書き込みます。プロジェクト、ローカル、管理設定、および --settings では、このキーはすべてのモデルに適用されます。
`enforceAvailableModels`
/model ピッカーにはDefault オプションがあり、default モデル設定 はそれが解決するモデルを説明します。availableModels 許可リストは名前を付けることができるモデルを制限しますが、デフォルトプレフィックスマッチング では、アカウントタイプのデフォルトを再マップしないため、Default はリスト外のモデルに解決できます。このキーはそのギャップを閉じます。Claude Code v2.1.175 以降が必要です。
組織が管理設定をデプロイすると、Claude Code はこのキーを管理ソースからのみ読み取り、他のファイルでは無視します。
スコープ : 任意のファイル
タイプ : ブール値
true: Default が availableModels 外のモデルに解決される場合、Claude Code はそれをリスト内の最初の利用可能なモデルに解決します
false: このキーはDefault の解決方法を変更しません
デフォルト : false
この例は、名前付き選択を Sonnet と Haiku モデルに制限し、Default を利用可能なそれらの最初のものに解決します:
{
"availableModels" : [ "sonnet" , "haiku" ] ,
"enforceAvailableModels" : true
}
このキーは availableModels が設定解除されているか空の場合は効果がありません。Default モデルの許可リストを強制 を参照してください。Claude Code v2.1.175 以降が必要です。
`fallbackModel`
プライマリモデルがオーバーロードされているか利用できない場合に、Claude Code が順番に試すバックアップモデルに名前を付けます。Claude Code はターンの残りの間、チェーン内の次の利用可能なモデルに切り替え、通知を表示します。チェーンがない場合、Claude Code は同じモデルを再試行してからサーバーのエラーを表示し、再試行するか自分でモデルを切り替えます。
切り替えは、フォールバックモデルでコールドプロンプトキャッシュ を使用した 1 ターンを意味します。次のメッセージはプライマリモデルを最初に再度試します。
スコープ : 任意のファイル
タイプ : モデルエイリアスまたは ID の配列。"default" はデフォルトモデルに展開されます
デフォルト : 設定解除されているため、失敗したリクエストは別のモデルで再試行されません
セッションごとのオーバーライド : --fallback-model はこのキーより優先されます
この例は、プライマリモデルが失敗したときに最初に Sonnet 5 を試し、次に Haiku 4.5 を試します:
{
"fallbackModel" : [ "claude-sonnet-5" , "claude-haiku-4-5" ]
}
ほとんどの配列設定とは異なり、このキーは設定ファイル全体でマージされません。最も優先度の高いファイルがそれを定義すると、チェーン全体が供給されます。プロジェクトファイルが ["claude-sonnet-5"] を設定し、ユーザーファイルが ["claude-haiku-4-5"] を設定する場合、チェーンは ["claude-sonnet-5"] のみです。Claude Code はリストから最大 3 つの異なる許可されたモデルを保持し、残りを無視します。フォールバックモデルチェーン を参照してください。
`fastMode`
利用可能なセッションで高速モード をオンにします。高速反復やライブデバッグなどのインタラクティブな作業用で、トークンあたりのコストが高い速度が必要な場合。通常、このキーを手動で編集することはありません。/fast を実行すると fastMode: true が ~/.claude/settings.json に書き込まれ、再度実行すると高速モードをオフにするキーが削除されます。高速モードは Opus 5.5、Opus 5、および Opus 4.8 でのみ実行されます。別のモデルからオンにするとあなたを Opus に切り替え、サポートされていないモデルに切り替えるとオフになります。高速モードがオンの間にモデルを切り替え を参照してください。
スコープ : 任意のファイル
タイプ : ブール値
true: Claude Code は利用可能なセッションで高速モードをオンにします
false: 高速モードはオフのままです
デフォルト : 設定解除されているため、高速モードはオフです
セッションごとのオーバーライド : CLAUDE_CODE_DISABLE_FAST_MODE は 1 つのセッションで高速モードをオフにし、このキーはそれをオンに戻すことはできません
{
"fastMode" : true
}
`fastModePerSessionOptIn`
通常、/fast を実行すると fastMode がユーザー設定に保存されるため、高速モードは後のすべてのセッションの開始時にオンになります。このキーを true に設定して、それを停止します。保存された fastMode: true はセッション開始時に高速モードをオンにしなくなり、各ユーザーは必要な各セッションで /fast を実行する必要があります。Claude Code は fastMode キーをファイルに残すため、このキーをオフにすると古い動作が復元されます。
Team または Enterprise プランのオーナーは、サーバー管理設定 を通じて組織全体にデプロイできます。管理設定がキーを設定すると、/fast on はインタラクティブターミナルセッション外で拒否され、組織が高速モードを無効にしたことを報告します。これは非インタラクティブモード 、VS Code 拡張機能 、およびクラウドセッション をカバーします。
スコープ : 任意のファイル
タイプ : ブール値
true: 保存された fastMode: true はセッション開始時に高速モードをオンにしなくなるため、各ユーザーは必要な各セッションで /fast を実行します。--settings で渡された fastMode: true は、管理設定がこのキーを設定しない限り、そのセッションでもカウントされます
false: 保存された fastMode: true は後のすべてのセッションの開始時に高速モードをオンにします
デフォルト : false
{
"fastModePerSessionOptIn" : true
}
セッションごとのオプトインを必須にする を参照してください。
`language`
Claude がデフォルトで英語以外の言語で応答するようにします。応答の固定リストはありません。Claude Code は値を Claude に逐語的に、常にその言語で応答するという指示として渡すため、Claude が読むことができる言語名は機能します。Claude Code は値をチェックしないため、スペルが間違った名前はエラーを生成するのではなく、書かれたとおりに Claude に到達します。同じ値は音声ディクテーション の言語を設定します。これはサポートされているディクテーション言語 の固定リストを持ち、自動生成されたセッションタイトルも設定します。
スコープ : 任意のファイル
タイプ : 文字列、"japanese"、"spanish"、"french" などの言語名。Claude Code はそれを検証しません
デフォルト : 設定解除されています。セッションタイトルは会話の言語と一致します
{
"language" : "japanese"
}
`maxEffortLevel`
セッションが使用できる努力レベル をキャップし、低いレベルを利用可能なままにします。より高いレベルはキャップで実行されます。/effort、/model ピッカー、--effort、CLAUDE_CODE_EFFORT_LEVEL 、スキルまたはサブエージェントの effort frontmatter、またはモデル自体のデフォルトから。Claude Code はリクエストの前にキャップ自体を適用するため、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry を含むすべてのプロバイダーで保持されます。Claude Code v2.1.267 以降が必要です。
スコープ : 任意のファイル 。組織に対して強制するために、管理設定にデプロイします。複数のスコープがキャップを設定する場合、最も低いものが適用されるため、1 つのスコープで設定されたキャップを別のスコープから上げることはできません
タイプ : 文字列、"low"、"medium"、"high"、"xhigh"、または "max" のいずれか。"max" 値はキャップを設定しません
デフォルト : 設定解除されているため、キャップは適用されません
モデルごとのキャップ : モデルの modelSettings エントリに maxEffortLevel を追加します。そのエントリは、ユーザー設定や 1 つの管理ソース など、両方を設定する設定ソース内でのみこのキーを置き換えます。そこで "max" を設定して、そのソースのキャップからモデルを除外します。Claude Code は他のソースからのキャップを依然として適用します
この例はすべてのモデルを medium でキャップし、Sonnet 4.6 を除外します:
{
"maxEffortLevel" : "medium" ,
"modelSettings" : {
"claude-sonnet-4-6" : {
"maxEffortLevel" : "max"
}
}
}
組織がモデルの努力制限 も設定する場合、2 つのキャップの低い方が適用されます。
`model`
すべての新しいセッションが使用するモデルを設定するため、毎回 /model で 1 つを選択する必要はありません。ここで設定してもセッション中に切り替えることは止まりません。管理者が組織デフォルトモデル を設定してユーザー選択をオーバーライドした場合、ユーザー、プロジェクト、またはローカル設定でこのキーを設定しても、そのモデルを取得します。
スコープ : 任意のファイル
タイプ : 文字列、モデルエイリアスまたは完全なモデル ID
デフォルト : 設定解除されているため、Claude Code はアカウントのデフォルトモデルを使用します
セッションごとのオーバーライド : --model は ANTHROPIC_MODEL より優先され、両方は 1 つのセッションでこのキーより優先されます。管理 model を含む。availableModels リストは依然として選択に適用されます
{
"model" : "claude-sonnet-5"
}
ここの値は ANTHROPIC_DEFAULT_MODEL をランク付けし、Claude Code は他に何もモデルを選択しない場合にのみ使用します。
`modelOverrides`
Anthropic モデル ID をプロバイダー固有のモデル ID (Amazon Bedrock 推論プロファイル ARN など)にマップします。各モデルピッカーエントリは、プロバイダー API を呼び出すときにマップされた値を使用します。管理者はAmazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry でこれを使用して、各モデルバージョンを特定の推論プロファイル、バージョン名、またはガバナンス、コスト配分、または地域ルーティングのためのデプロイメントにルーティングします。
スコープ : 任意のファイル
タイプ : モデル ID をプロバイダーモデル ID にマップするオブジェクト
デフォルト : 設定解除されています
この例は、Opus 4.6 のすべての呼び出しを名前付き Bedrock 推論プロファイルにルーティングします:
{
"modelOverrides" : {
"claude-opus-4-6" : "arn:aws:bedrock:us-east-1:123456789012:inference-profile/example"
}
}
モデル ID をバージョンごとにオーバーライド を参照してください。
`modelPicker`
/model ピッカーが提供するモデルを、書き込む順序で、選択するラベルの下にリストします。ピッカーは組織が実行するモデルをリストします。組み込みラインアップの後または代わりに。各行の model は逐語的に取得されるため、--model が受け入れるもの、opus などのエイリアス、Anthropic モデル ID、または Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または LLM ゲートウェイのプロバイダー形式 ID を受け入れます。Claude Code v2.1.242 以降が必要です。
スコープ : ユーザーまたは管理 。Claude Code は管理設定、--settings、およびユーザー設定からキーを読み取り、プロジェクトおよびローカル設定では無視するため、クローンするリポジトリはピッカーを再ラベルできません。これら 3 つの最も高いものがキーを設定すると、ラインアップ全体が供給され、Claude Code は 2 つのソースからラインアップをマージしません。
タイプ : options 配列と行とオプションの replaceBuiltInOptions ブール値を持つオブジェクト
デフォルト : 設定解除されているため、ピッカーは組み込みラインアップを表示します
この例は、組み込みラインアップの後に 2 つの Bedrock デプロイメントを追加し、チームが認識する名前の下に:
{
"modelPicker" : {
"options" : [
{ "model" : "us.anthropic.claude-opus-4-8" , "label" : "Opus (production)" } ,
{
"model" : "us.anthropic.claude-sonnet-4-6" ,
"label" : "Sonnet (production)" ,
"description" : "Day-to-day work"
}
]
}
}
`modelPicker` のフィールド
キーは 2 つのフィールドを取ります。1 つは行自体用で、もう 1 つは組み込みラインアップを置き換えるか追加するかです。
フィールド
タイプ
動作
options
必須の model とオプションの label、description、および behavesAs を持つ行の配列
ピッカーが表示する行。この順序で。グレーアウトされた行は下部に移動します。label がない場合、Claude Code は既知のモデルの組み込み名でタイトルを付けるか、モデル ID でタイトルを付けます。description がない場合は、一般的な 2 行目を書き込みます
replaceBuiltInOptions
ブール値、デフォルト false
これらの行のみ、Default 、およびセッションが既に使用しているモデルの行を表示するには true に設定します。これらの行を組み込みラインアップの後に追加するには、設定解除のままにします
options のエントリは、その model の横にオプションの behavesAs 文字列を持つこともできます。これには v2.1.257 以降が必要です。Claude Code バージョンが既に知っている claude-opus-4-8 などのモデルの ID に設定します。model が バージョンより新しいエントリで。Claude Code はそれ以降、既知のモデルの機能と努力デフォルトをエントリに適用し、そのモデルを不明として扱いません。エントリのラベルと Claude Code がリクエストで送信するモデル ID は変わりません。
replaceBuiltInOptions がオンの場合、Claude Code はすべての他の行を非表示にします。組み込みラインアップ、availableModels エントリ用に追加する行、ゲートウェイディスカバリー が見つけたモデル、および ANTHROPIC_CUSTOM_MODEL_OPTION 。オフの場合、Claude Code は組み込みラインアップが既にカバーするリストされたモデルをスキップします。ラベルはピッカーが表示するものを変更し、Claude Code が実行するモデルではありません。
availableModels 許可リストはこれらの行に依然として適用されます。リストされたモデルを許可リストに追加する前に、マージ動作 を読んでください。特定のモデル ID はそのファミリーのワイルドカード エントリを絞ります。Claude Code はピッカーを表示する前に各行をセッションに対してチェックします:
削除 : Claude Code が提供できない行。廃止されたモデルや組織がアクセスできないモデルなど
グレーアウト : まだ選択できない行。理由を示して表示されます
行が生き残らない : Claude Code は通常どおり許可リストでフィルタリングされた組み込みラインアップを保持します
Claude Code は解析できない行を削除し、残りを保持します。壊れた設定ファイルを修正 を参照してください。
`modelPricing`
組織が支払うレートでリスト価格の代わりに支出を報告します。組織が契約レートを持っている場合に設定するため、開発者が見るドル数字は請求書と一致します。Claude Code は /usage、ステータスライン 、Agent SDK の total_cost_usd、--max-budget-usd 制限、およびOpenTelemetry コストメトリックとイベントのレートを適用します。レートを供給します。Claude Code は契約またはClaude Console から読み取りません。Claude Code v2.1.242 以降が必要です。
スコープ : 管理 。サーバー管理設定、MDM ポリシー、managed-settings.json ファイル、またはポリシーヘルパー を通じてキーをデプロイします。Claude Code はユーザー、プロジェクト、ローカル設定、--settings、および Windows のユーザー書き込み可能なHKCU レジストリ では無視します。サーバー管理設定では、各セッションはそのセッションの設定フェッチ が設定を確認するまでリスト価格でコストを報告します。Claude Code を埋め込み、CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST を設定するホストアプリケーションは、SDK managedSettings オプションを通じて独自のテーブルを供給でき、Claude Code はマネージドソースがキーを設定しない場合にのみ使用し、Claude Code v2.1.246 以降でのみ使用します。
タイプ : オプションの multiplier とオプションの overrides マップを持つオブジェクト
デフォルト : 設定解除されているため、Claude Code はリスト価格を報告します。ホストアプリケーションがテーブルを供給しない限り
multiplier のみを設定して定額割引またはマークアップ、overrides のみをモデルごとのレート、または両方を設定します。
この例は Sonnet 4.6 の契約レートを設定し、すべての数字を 15% 削減します。Sonnet 行を含む:
{
"modelPricing" : {
"multiplier" : 0.85,
"overrides" : {
"claude-sonnet-4-6" : {
"input" : 2.4,
"output" : 12,
"cacheRead" : 0.24,
"cacheWrite" : 3
}
}
}
}
1 より上、最大 10 までマークアップするには multiplier を設定します。マークアップには Claude Code v2.1.271 以降が必要です。以前のバージョンは警告付きで 1 より上の multiplier を無視し、設定の残りを保持します。
手順を含む、レートが有効であることを確認する方法については、契約レートで支出を報告 を参照してください。
`modelPricing` のフィールド
フィールド
タイプ
動作
multiplier
0 より大きく最大 10 の数値
Claude Code が計算するすべてのコストをスケーリングします。overrides 行がカバーするかどうかに関わらず。1 未満は割引、1 より上はマークアップです
overrides
モデル ID をそれぞれ 0 から 10000 の input、output、cacheRead、および cacheWrite を持つレートオブジェクトにマップします
そのモデルの USD-per-million-token レート。すべて 4 つが必要です。cacheWrite は 5 分と 1 時間のキャッシュ書き込みの両方をカバーします。どのモデルが行に適用されるか を参照してください
Claude Code はレートを書き込んだとおりに使用し、高速モード割増料金またはUS のみの推論レート を追加しません。multiplier も設定する場合、Claude Code はそれを行のレートの上に適用します。Claude Code は解析できないレートを持つ行、または解析できない multiplier を削除し、残りを保持します。壊れた設定ファイルを修正 を参照してください。
どのモデルが `modelPricing` 行に適用されるか
Claude Code は行のキーから行が適用されるモデルを決定します:
組み込みモデルの ID : Claude Code 自体がモデルの独自の ID (例: claude-sonnet-4-6) またはその Bedrock、Agent Platform、または Foundry ID であるかどうかに関わらず、組み込みモデルに使用するキー。Claude Code はそのモデルのすべての日付スナップショット ID とプロバイダー固有の ID に行を適用します。
その他のキー : 組み込みモデルの ID ではないキー。ゲートウェイモデルエイリアスなど。Claude Code はそのキーのみに行を適用します。モデル ID がキーの 1 つと正確に一致し、組み込みモデルの ID でキーされた行の下にも該当する場合、Claude Code は正確な一致を使用します。
Bedrock アプリケーション推論プロファイル : Claude Code がプロファイルを modelOverrides マップまたは bedrock:GetInferenceProfile ルックアップ を通じてルーティングするモデルに解決した後、Claude Code はそのモデルの行をプロファイルに適用します。
`modelSettings`
使用する各モデルの努力レベル を保存します。Claude Code v2.1.251 以降が必要です。
マシン上のインタラクティブセッションで、/effort または /model ピッカーの努力スライダーで low、medium、high、または xhigh をデフォルトとして保存すると、Claude Code はそれを使用しているモデルの下にここにそのレベルを書き込むため、このキーを自分で編集することはめったにありません。VS Code 拡張機能のモデルピッカー でこれらのレベルのいずれかを選択すると、Claude Code は同じ方法でここに保存します。effortLevel エントリは /effort がそのセッションのみに適用されるセッションをリストします。
レベルを変更または削除するには、キーを手動で編集します。
このモデルの effortLevel ここは同じ設定ファイルの最上位 effortLevel より優先されます。ファイル全体で、Claude Code は各モデルを個別に解決します。そのモデルの effortLevel またはそのモデルに適用される 最上位 effortLevel のいずれかを設定する最も優先度の高い設定ファイル が決定するため、管理設定の effortLevel はユーザー設定で保存されたレベルをランク付けします。努力レベルを調整 は、--effort 起動など、保存されたレベルをオーバーライドできるその他のものをリストします。
1 つのモデルの努力をキャップするのではなく、そのモデルのエントリに maxEffortLevel フィールドを追加します。フィールドには Claude Code v2.1.267 以降が必要です。
スコープ : 任意のファイル
タイプ : モデル名を effortLevel フィールド (1 つの "low"、"medium"、"high"、または "xhigh")、maxEffortLevel フィールド、またはその両方を持つオブジェクトにマップするオブジェクト
デフォルト : 設定解除されています
Claude Code は各エントリを claude-opus-5-5 などのモデルの正規名の下に書き込み、そのモデルのエイリアス、日付サフィックス、[1m]、および認識されたプロバイダー固有の ID を同じエントリと一致させます。
この例は Opus 5.5 を high に保ちながら、他のモデルは独自の保存またはデフォルトレベルを使用します:
{
"modelSettings" : {
"claude-opus-5-5" : {
"effortLevel" : "high"
}
}
}
/effort auto を実行して、使用しているモデルの保存されたレベルをクリアします。Claude Code は他のエントリと最上位の effortLevel をそのままにします。
`outputStyle`
出力スタイル を名前で選択します。出力スタイルは、Claude の役割、トーン、出力形式を変更する保存された指示のセットです。組み込みの Explanatory および Learning スタイルや自分で書いたものなど。
セッション中にこのキーを変更すると、Claude は次のメッセージから新しいスタイルを使用します。そのメッセージがプロンプトキャッシュでコストするものについては、出力スタイルを変更 を参照してください。v2.1.251 より前では、編集は /clear を実行した後またはセッションを開始した後にのみ適用されました。
スコープ : 任意のファイル
タイプ : 文字列。組み込み またはカスタム 出力スタイルの名前
デフォルト : 設定解除されているため、Claude Code はデフォルトスタイルを使用します
この例は、タスク間に教育的な洞察を追加する組み込みの Explanatory スタイルを選択します:
{
"outputStyle" : "Explanatory"
}
`promptCacheTtl`
プロンプトキャッシュ がメイン会話を保持する期間を選択します。このキーはインタラクティブ、-p、および Agent SDK ターンに適用されます。Claude Code がインラインで実行するヘルパーと一緒に。1 時間のライフタイムはより長い休憩全体でキャッシュを温かく保ち、API は各キャッシュ書き込みを 5 分のライフタイムより高いレートで請求します 。Claude Code v2.1.242 以降が必要です。
この例はメイン会話を 1 時間のライフタイムに保ち、サブエージェントを 5 分のままにします:
{
"promptCacheTtl" : "1h" ,
"subagentPromptCacheTtl" : "5m"
}
各ライフタイムのコストについては、キャッシュライフタイム を参照してください。
`showThinkingSummaries`
インタラクティブセッションで Claude の拡張思考 の概要を参照してください。Ctrl+O で思考を展開するときに完全な概要が必要な場合に設定します。設定解除または false の場合、Anthropic API は思考ブロックを編集し、Claude Code は折りたたまれたスタブを表示します。サードパーティプロバイダーは編集しません。
スコープ : 任意のファイル
タイプ : ブール値
true: Ctrl+O で思考を展開するときに完全な思考概要が表示されます
false: Anthropic API は思考ブロックを編集し、Claude Code は折りたたまれたスタブを表示します
デフォルト : false
{
"showThinkingSummaries" : true
}
編集は、モデルが生成するものではなく、表示するものだけを変更します。思考支出を削減するには、代わりに予算を低下させるか思考を無効にします 。
`subagentPromptCacheTtl`
プロンプトキャッシュ がメイン会話外で Claude Code が行うリクエストを保持する期間を選択します。このキーはサブエージェント 、ワークフロー 、および Claude Code 独自のバックグラウンドおよびヘルパーリクエスト (圧縮やセッションタイトルなど)に適用されます。1 時間のライフタイムはより長い休憩全体でキャッシュを温かく保ち、API は各キャッシュ書き込みを 5 分のライフタイムより高いレートで請求します 。Claude Code v2.1.242 以降が必要です。
この例はサブエージェントとメイン会話外の他のリクエストに 1 時間のライフタイムを与えます:
{
"subagentPromptCacheTtl" : "1h"
}
このキーは promptCacheTtl がカバーしないリクエストをカバーするため、Claude Code が行うすべてのリクエストのライフタイムを選択するには両方を設定します。サブエージェントのキャッシュがメイン会話のキャッシュとどのように異なるかについては、サブエージェントとキャッシュ を参照してください。
`switchModelsOnFlag`
安全分類器がリクエストにフラグを立てた 場合に何が起こるかを選択します。フォールバックモデルに切り替えて続行するか、切り替えるかプロンプトを編集するかを選択できるように一時停止します。
スコープ : 任意のファイル 。/config にメッセージがフラグされたときにモデルを切り替え として表示されます。
タイプ : ブール値
true: Claude Code はフォールバックモデルに切り替えて続行します
false: インタラクティブセッションで Claude Code は一時停止して、切り替えるかプロンプトを編集するかを選択できます。ダイアログが表示できない場所 (-p 実行など)では、フラグされたリクエストはエラーで終了します
デフォルト : true。自動的に切り替え
{
"switchModelsOnFlag" : false
}
切り替える前に確認 を参照してください。
`ultracode`
セッションをultracode でオンで開始します。オンの場合、Claude は、あなたが尋ねるのを待つのではなく、各実質的なタスクのワークフローを計画します。Claude は動的ワークフロー が有効になっており、モデルが xhigh 努力をサポートする場合にのみワークフローを計画します。キーはセッションの努力レベルを変更しません。ultracode はセッションが使用するレベルで実行されます。Claude Code はこのキーを読み取りますが、決して書き込みません。/effort ultracode は現在のセッションのみで ultracode をオンにします。
スコープ : 任意のファイル
タイプ : ブール値
true: 動的ワークフローが有効になっており、モデルが xhigh をサポートする場合、セッションは ultracode でオンで開始されます
false: セッションは ultracode でオフで開始されます
デフォルト : 設定解除されているため、ultracode はオフです
セッションごとのオーバーライド : /effort ultracode はこのキーなしで 1 つのセッションで ultracode をオンにし、/effort ultracode off はこのキーが true の場合、1 つのセッションでそれをオフにします。--effort ultracode フラグも 1 つのセッションでそれをオンにし、xhigh 努力で、Claude Code v2.1.203 以降が必要です
{
"ultracode" : true
}
セッションの努力レベルは effortLevel 、modelSettings 、および他の努力ソース から来ます。maxEffortLevel などの努力キャップ はそのレベルを低下させますが、ultracode をオフにしません。これと /effort ultracode off フォームには Claude Code v2.1.284 以降が必要です。v2.1.284 より前では、ultracode: true はセッションを xhigh 努力で実行し、xhigh より下の努力キャップは ultracode をオフに保ちました。Agent SDK apply_flag_settings コントロールリクエストもキーを受け入れます。
権限設定
Claude が何を確認なしで実行できるか、セッションがどの権限モードで開始するか、自動モードの分類器が何を許可するかを決定します。ルール構文と権限モデルについては、権限を設定する を参照してください。
`allowManagedPermissionRulesOnly`
管理設定を権限ルールの唯一の設定ソースにします。Claude Code はユーザー、プロジェクト、ローカル、および --settings ファイル内の allow、ask、deny ルールを無視し、--allowedTools を無視し、権限プロンプトで常に許可する選択肢を非表示にし、新しいルールの保存を停止します。
埋め込みホストからの親設定 が適用される場合、Claude Code はそれらを管理層の一部として扱います。それらの deny および ask ルールを保持し、それらの allow ルールと additionalDirectories を削除します。また、Read および Edit ルールで ! で始まるパターンを除きます。ホストは ! ルールで管理ルールからパスを除外することはできません。allowManagedPermissionRulesOnly を設定しているかどうかに関わらず。
--disallowedTools ルールと現在のセッションの deny および ask ルールは、Claude Code が設定をセッション中に再度読み込んだ後を含めて、引き続き適用されます。これらは制限のみを行うため、管理ルールが付与するものを拡大することはできません。v2.1.257 より前では、Claude Code は最初の設定再度読み込み時にそれらのコマンドラインおよびセッションルールを削除していました。
--disallowedTools またはセッションルール内の ! パターンが除外できるものについては、Read および Edit ルール を参照してください。
スコープ : Managed
タイプ : ブール値
true: 管理設定が権限ルールの唯一の設定ソースになります
false: Claude Code は管理ルールに加えて、ユーザー、プロジェクト、ローカル、および --settings ファイルから権限ルールを適用します
デフォルト : 未設定。Claude Code はユーザー、プロジェクト、ローカル設定、および --settings から権限ルールを管理ルールに加えて適用します
{
"allowManagedPermissionRulesOnly" : true
}
このキーは MCP サーバーの許可リストをロックダウンしません。そのためには、allowManagedMcpServersOnly を設定してください。管理のみの設定 を参照してください。
`autoMode`
自動モード 分類器がブロックおよび許可するものに独自のルールを追加します。これを使用して、分類器に組織が信頼するリポジトリ、バケット、ドメインを伝え、日常的な内部操作のブロックを停止させます。分類器には組み込みの許可および拒否ルール が付属しています。リテラル文字列 "$defaults" を配列に含めて、それらの組み込みルールをその位置に保持し、その周りに独自のルールを追加します。省略すると、それらを独自のルールに置き換えます。
この例は、"$defaults" を通じて組み込みの soft_deny ルールを保持し、terraform apply をブロックするルールを 1 つ追加します。
{
"autoMode" : {
"soft_deny" : [ "$defaults" , "Never run terraform apply" ]
}
}
これらのファイルの複数が同じ配列を設定する場合、Claude Code はエントリを連結します。ルール形式と各配列の適用方法については、自動モードを設定する を参照してください。
`autoMode.classifyAllShell`
自動モードがアクティブな間、すべての Bash および PowerShell コマンドを自動モード分類器に通します。デフォルトでは、自動モードは任意のコードを実行できる許可ルールのみを一時停止します。Bash(*) やワイルドカードルール、および Bash(python *) などのインタープリタまたはシェルラッパープレフィックス。Bash(npm test) などの他の許可ルールと一致するコマンドは分類器をスキップし、コマンドごとの許可ドメイン を持たない限り、ルールのプレフィックスが予期しなかった破壊的な引数が見えないまま通過する可能性があります。このキーを設定すると、セッションのすべてのシェル許可ルールが一時停止され、分類器がすべてのコマンドを確認します。Claude Code v2.1.193 以降が必要です。
スコープ : User or managed 。autoMode が読み取られる場所で読み取られます。
タイプ : ブール値
true: 自動モードがアクティブな間、Claude Code はすべての Bash および PowerShell コマンドを分類器に通し、シェル許可ルールを一時停止します。自動モード外では、ルールは引き続き適用されます
false: 自動モードは Bash(*) および Bash(python *) などの任意のコードを実行できる許可ルールのみを一時停止します。他の許可ルールと一致するコマンドは分類器をスキップし、コマンドごとの許可ドメイン を持たない限り、他のすべてのシェルコマンドはそれを通します
デフォルト : false
{
"autoMode" : {
"classifyAllShell" : true
}
}
すべてのシェルコマンドを分類器にルーティングする を参照してください。Claude Code v2.1.193 以降が必要です。
`disableAutoMode`
自動モード を Shift+Tab サイクルから削除します。--permission-mode auto、設定ファイル、または組み込みデフォルトから自動モードで開始 する可能性があるセッションは、代わりに default で開始します。管理者は管理設定で設定して、組織内の開発者が自動モードを使用するのを防ぎます。
スコープ : Any file 。管理設定 で最も有用です。ユーザーはそれをオーバーライドできません。permissions の下で permissions.disableAutoMode として受け入れられます。
タイプ : 文字列 "disable"
デフォルト : 未設定
{
"disableAutoMode" : "disable"
}
`permissions`
Claude が確認なしで使用できるツール、常にプロンプトを表示するツール、ブロックされるツールを制御し、セッションが開始する権限モード を設定します。以下のすべての permissions.* キーはこのオブジェクトの下にネストされます。
スコープ : Any file
タイプ : allow、ask、deny、additionalDirectories、blockReadsOutsideWorkingDirectories、defaultMode、disableBypassPermissionsMode、disableAutoMode を含むオブジェクト
デフォルト : 未設定
この例は npm run コマンドを確認なしで承認し、git push の前にプロンプトを表示し、.env の読み取りをブロックし、セッションを acceptEdits で開始します。
{
"permissions" : {
"allow" : [ "Bash(npm run *)" ] ,
"ask" : [ "Bash(git push *)" ] ,
"deny" : [ "Read(./.env)" ] ,
"defaultMode" : "acceptEdits"
}
}
3 つのルール配列は 1 つの構文を共有します。permissions.allow の下の権限ルール構文 を参照してください。異なるファイルからの権限ルールがどのように結合されるかについては、スコープ全体での権限ルールのマージ方法 を参照してください。一般的に設定キーがどのように結合されるかについては、設定ガイドの設定の優先順位 を参照してください。
`useAutoModeDuringPlan`
Claude Code がプランモード中にシェルコマンドを確認するために自動モード分類器を使用するかどうかを選択します。デフォルトの true では、自動モードが利用可能で、プロンプトが表示されない場合、分類器は計画中に各コマンドを確認します。ただし、重要パスの削除 を除きます。false に設定して、組み込みの読み取り専用セット外のすべてのコマンドに対して権限プロンプトを取得します。/config にプラン中に自動モードを使用 として表示されます。
スコープ : User, local, or managed 。リポジトリはそれをオフにすることはできません。
タイプ : ブール値
true: 未設定と同じです。自動モードが利用可能な場合、分類器はプランニング中に各シェルコマンドを確認し、プロンプトを表示しません。ただし、重要パスの削除 を除きます。これらのファイルのいずれかで false でもそれをオフにします
false: 組み込みの読み取り専用セット外のすべてのコマンドに対して権限プロンプトを取得します
デフォルト : true
{
"useAutoModeDuringPlan" : false
}
`permissions.allow`
Claude Code が確認なしで承認するツール使用をリストします。MCP ルールでは、* はツール名内の mcp__<server>__ プレフィックスの後にのみ表示できます(例:mcp__github__get_*)。サーバー名には表示できません。
スコープ : Any file
タイプ : 権限ルール文字列の配列
デフォルト : 未設定
セッションごとのオーバーライド : --allowedTools は 1 つのセッションに許可ルールを追加し、任意の設定ファイルからの拒否ルールは、それが名前を付けるツールをブロックします
この例は git diff を承認し、Claude Code が確認なしに .zshrc を読み取ることを許可します。
{
"permissions" : {
"allow" : [ "Bash(git diff *)" , "Read(~/.zshrc)" ]
}
}
Claude Code はプロジェクトの .claude/settings.json から allow ルールを適用するのは、そのフォルダのワークスペース信頼ダイアログ を受け入れた後のみです。
権限ルール構文
権限ルールは Tool または Tool(specifier) の形式に従います。Claude Code は deny ルールを最初に評価し、次に ask、次に allow を評価し、最初のマッチが各ルールの具体性に関係なく決定します。権限ルール評価順序 を参照してください。
各行は 1 つのルール形状とそれが一致するものを示します。
ルール
一致するもの
Bash
すべての Bash コマンド
Bash(npm run *)
npm run で始まるコマンド
Read(./.env)
.env ファイルの読み取り
WebFetch(domain:example.com)
example.com へのフェッチリクエスト
ワイルドカード動作、Read、Edit、WebFetch、MCP、Agent ルールのツール固有パターン、および Bash パターンのセキュリティ制限を含む完全なルール構文については、権限ルール構文 を参照してください。
`permissions.ask`
acceptEdits または bypassPermissions などの権限モードで確認を求めるツール使用をリストします。dontAsk モードでは、Claude Code は一致するツール使用をプロンプトする代わりに拒否します。
スコープ : Any file
タイプ : 権限ルール文字列の配列
デフォルト : 未設定
{
"permissions" : {
"ask" : [ "Bash(git push *)" ]
}
}
`permissions.deny`
Claude Code がブロックするツール使用をリストします。API キー、シークレット、または環境値を保持するファイルに使用します。Claude Code は一致するファイルをファイル検出と検索結果から除外し、それらの読み取りを拒否し、一致するパスのEdit および Write ツール をブロックします。Read および Edit 拒否ルールは Claude の組み込みファイルツール、Claude Code が Bash で認識するファイルコマンド(cat、head、tail、sed、tee など)、および > file および < file などの Bash リダイレクション のターゲットに適用されます。ファイルを名前で読み取らないコマンド(grep -r pattern . など)または任意のサブプロセスには適用されません。OS レベルの強制については、サンドボックスを有効にする を参照してください。
スコープ : Any file
タイプ : 権限ルール文字列の配列
デフォルト : 未設定
セッションごとのオーバーライド : --disallowedTools はこのキーと並行して 1 つのセッションに拒否ルールを追加します
この例は .env ファイル、secrets ディレクトリ、認証情報ファイルの読み取りを拒否し、curl コマンドをブロックします。
{
"permissions" : {
"deny" : [
"Read(./.env)" ,
"Read(./.env.*)" ,
"Read(./secrets/**)" ,
"Read(./config/credentials.json)" ,
"Bash(curl *)"
]
}
}
ツール名はグロブパターンを受け入れるため、"*" はすべてのツールを拒否し、"mcp__*" はすべての MCP ツールを拒否します。Claude Code は、他のツールがまだ Claude で利用可能である限り、EndConversation ツールの拒否ルールを無視します。Bash 拒否ルールは Claude が書いたコマンドと一致するため、Bash(curl *) は /usr/bin/curl または sh -c 'curl …' を停止しません。Bash ルールが一致しないもの を参照してください。このキーは非推奨の ignorePatterns 設定に置き換わります。
`permissions.additionalDirectories`
Claude に開始したディレクトリ外のディレクトリへのファイルアクセスを付与し、追加の作業ディレクトリ として使用します。ほとんどの .claude/ 設定は、これらのディレクトリから検出されません 。
スコープ : Any file
タイプ : ディレクトリパスの配列
デフォルト : 未設定
セッションごとのオーバーライド : --add-dir および /add-dir はこのキーと並行して 1 つのセッションにディレクトリを追加します
{
"permissions" : {
"additionalDirectories" : [ "../docs/" ]
}
}
allow ルールと同様に、プロジェクトの .claude/settings.json のエントリは、そのフォルダのワークスペース信頼ダイアログ を受け入れた後にのみ有効になります。
`permissions.blockReadsOutsideWorkingDirectories`
Claude のファイルツールがセッションの作業ディレクトリ 外のパスを読み取るのを拒否します。bypassPermissions を含むすべての権限モード。Claude Code は Read、Grep、Glob、LSP 呼び出しをそれらのパスで拒否し、Claude に /add-dir でディレクトリを追加するよう求めるよう指示します。Claude Code 自体が必要とするファイル(~/.claude/ の下のスキル、プラグイン、ルール、エージェント、コマンド、CLAUDE.md メモリファイルなど)は読み取り可能なままです。Claude Code v2.1.257 以降が必要です。
Claude Code はシェルコマンドを同じ方法で拒否しません。
シェルパーサーが追跡できない Bash コマンド(複数回ディレクトリを変更するか、サブシェルを実行するなど)は、自動モードおよび bypassPermissions モードでもプロンプトを表示します。プロンプトは、コマンドが作業ディレクトリ外のパスを名前で指定しない場合でも表示されます。このプロンプトは、コマンドがサンドボックス で実行され、サンドボックスがブロックを強制する場合には適用されません。
Claude Code は、作業ディレクトリ外の最初の読み取り前の自動モードのプロンプト でそのような読み取りをブロックすることを選択した場合、ここに true を書き込みます。
スコープ : Any file 。任意のファイルが true を設定する場合、ブロックが適用されるため、リポジトリはプロジェクトのブロックをオンにできますが、設定したブロックを解除することはできません。
タイプ : ブール値
true: Claude のファイルツールは作業ディレクトリ外の読み取りを拒否します
false: 未設定と同じです。ブロックは別のファイルが true を設定する場合でも適用されます
デフォルト : 未設定。作業ディレクトリ外の読み取りは権限モード に従います
{
"permissions" : {
"blockReadsOutsideWorkingDirectories" : true
}
}
--add-dir、/add-dir、またはユーザーまたは管理設定の additionalDirectories で追加するディレクトリは、ブロックの作業ディレクトリとしてカウントされます。リポジトリ設定でのみ追加されるディレクトリはカウントされません。.claude/settings.json のディレクトリ、および git がファイルを追跡されていないとして報告する場合を除き、.claude/settings.local.json のディレクトリ。ディレクトリが git リポジトリではない場合、またはファイルを git が追跡する場合、Claude Code は .claude/settings.local.json をリポジトリ提供設定として扱うため、代わりにユーザー設定にディレクトリを配置してください。
autoMemoryDirectory がプロジェクトの .claude/settings.json から、またはリポジトリ提供として扱われる .claude/settings.local.json から来る場合、Claude Code はそのディレクトリから自動メモリ を読み込まず、そこに保存しません。
ブロックを解除するには、それを設定するすべての設定ファイルからキーを削除し、新しいセッションを開始します。
ブロック下のサンドボックス化されたコマンド
サンドボックス がオンの場合、ブロックはサンドボックス化されたコマンドにも適用されます。Claude Code はホームディレクトリおよびユーザーファイルを保持する他のルート(/Users、/home、/root、/Volumes、/mnt、/media、/run/media、/srv)への読み取りアクセスを拒否します。その後、作業ディレクトリ、worktrees Claude Code がセッション中に作成するもの、セッション一時ディレクトリ、およびコマンドが必要とする ~/.claude の部分(スキルやプラグインなど)を再度開きます。ブロックが有効な間、リポジトリ設定からの allowRead および allowWrite エントリはカウントされません。
セッションの作業ディレクトリがリンク済み git worktree である場合(Claude Code がセッション中に入力したものを含む)、リポジトリの共通 .git ディレクトリはサンドボックス化されたコマンドに対して読み取り可能および書き込み可能なままなので、git はそこで機能し続けます。
これらの場合、ブロックはサンドボックス化されたコマンドに到達しませんが、Claude のファイルツールは引き続きそれを強制します。
ブロック下で、Claude Code はサンドボックス化されたコマンドにグローバル git 設定ファイルを再度開くため、git はアイデンティティと設定を保持します。
~/.gitconfig
$XDG_CONFIG_HOME/git の下の config、ignore、attributes ファイル。デフォルトは ~/.config/git
グローバル git 設定が [include]、[includeIf]、core.excludesFile、core.attributesFile を通じて名前を付けるファイル
Claude Code は各ファイルを個別に判断します。ファイルがサンドボックス化されたコマンドが直接または symlink を通じて書き込める場所にある場合、Claude Code はそれが名前を付けるファイルを再度開きません。
Linux および WSL2 では、symlink である設定ファイルは独自のパスで読み取り不可のままにすることができ、git はそれなしで実行されます。~/.git-credentials および $XDG_CONFIG_HOME/git/credentials はブロックされたままです。
再度開いたファイルがシークレット(http.extraHeader トークンなど)を保持する場合、そのパスを sandbox.filesystem.denyRead に追加します。ファイルをカバーする denyRead エントリは常にこの再度開きより優先されます。
`permissions.defaultMode`
新しいセッションが開始する権限モード を設定します。未設定のままにすると、セッションはプランとサーフェスの組み込みデフォルト で開始します。
スコープ : Any file 。auto および bypassPermissions はプロジェクトまたはローカル設定から有効にならないため、代わりに ~/.claude/settings.json で設定してください。v2.1.257 より前では、bypassPermissions は任意のファイルから有効になりました。VS Code 拡張機能が開始する会話の場合、Claude Code はユーザー、管理、および --settings 値のみを読み取ります。
タイプ : 文字列。次のいずれか:
"default": Claude Code は確認なしで読み取りのみを実行します
"acceptEdits": Claude Code は確認なしでファイル編集と mkdir および mv などの一般的なファイルシステムコマンドも実行します
"plan": Claude Code は読み取りと計画を行いますが、承認されるまで編集をブロックします
"auto": Claude Code はすべてを実行し、バックグラウンド安全チェックを行います
"dontAsk": Claude Code はプロンプトを表示するすべての呼び出しを自動的に拒否します。読み取り、承認が不要な他のアクション、事前承認されたツールは引き続き実行されます
"bypassPermissions": Claude Code はすべてを確認なしで実行します
"manual": Claude Code v2.1.200 以降の "default" のエイリアス
デフォルト : 未設定
セッションごとのオーバーライド : --permission-mode およびその同等の --dangerously-skip-permissions(bypassPermissions の場合)は 1 つのセッションのこのキーより優先されます
{
"permissions" : {
"defaultMode" : "acceptEdits"
}
}
権限ルールはすべてのモードの上に層状化されます。deny ルールは bypassPermissions を含むすべてのモードでブロックします。権限モード を参照してください。manual は CLI および VS Code 拡張機能で Manual というラベルが付いた権限モードに名前を付けます。エイリアスには Claude Code v2.1.200 以降が必要です。クラウドセッションでは、Claude Code はこのキーから acceptEdits、plan、default、auto のみを尊重します。VS Code 拡張機能が開始する会話の場合、開始権限モードの拡張機能が読み取る設定 を参照してください。
`permissions.disableBypassPermissionsMode`
誰もが bypassPermissions モードに入るのを防ぎます。Claude Code は --dangerously-skip-permissions フラグを拒否し、エージェント定義 の permissionMode: bypassPermissions を無視するため、サブエージェントは親セッションの権限モードで実行されます。
スコープ : Any file 。通常、管理設定 で設定して、組織のポリシーを強制します。
タイプ : 文字列 "disable"
デフォルト : 未設定
セッションごとのオーバーライド : このキーは --dangerously-skip-permissions より優先されます。キーが設定されている間、Claude Code はそれを拒否します
{
"permissions" : {
"disableBypassPermissionsMode" : "disable"
}
}
v2.1.223 より前では、Claude Code はバイパスが無効になっていても frontmatter 権限モードを適用していました。
`skipAutoPermissionPrompt`
Claude Code が最初に自動モード自体に入るときに表示する自動モード を説明する 1 回限りの通知をスキップします。例えば、独自の設定またはモードセレクターを通じて、組み込みデフォルトがセッションをそれで開始するのではなく。Claude Code はその通知を 1 回表示してから、それが表示されたことを記録するため、このキーは通知がまだ表示されていない場所でのみ重要です。
スコープ : User or managed 。リポジトリはそれを設定することはできません。
タイプ : ブール値
true: Claude Code は通知をスキップします
false: 未設定と同じです。これらのファイルのいずれかが true を設定しない限り、通知が表示されます
デフォルト : 未設定。通知が 1 回表示されます
{
"skipAutoPermissionPrompt" : true
}
`skipDangerousModePermissionPrompt`
Claude Code が bypassPermissions モードに入る前に表示する確認ダイアログをスキップします。--dangerously-skip-permissions または defaultMode: "bypassPermissions" からかどうか。Claude Code は、そのダイアログを 1 回受け入れたときに、ユーザー設定にここに true を書き込みます。
スコープ : User, local, or managed 。信頼されていないリポジトリはダイアログをスキップすることはできません。
タイプ : ブール値
true: Claude Code は bypassPermissions モードに入る前に確認ダイアログをスキップします
false: 未設定と同じです。これらのファイルのいずれかが true を設定しない限り、ダイアログが表示されます
デフォルト : 未設定。ダイアログが表示されます
{
"skipDangerousModePermissionPrompt" : true
}
サンドボックス設定
Claude が実行するコマンドをファイルシステム、ネットワーク、認証情報から分離します。サンドボックスの仕組みとプラットフォーム要件については、サンドボックス を参照してください。
`sandbox`
サンドボックス を使用して、Claude が実行する Bash コマンドをファイルシステムとネットワークから分離します。enabled でサンドボックスをオンにしてから、filesystem、network、credentials サブオブジェクトを使用して、サンドボックス化されたコマンドが何にアクセスできるかを制限または拡大します。サンドボックスは macOS、Linux、WSL2 で実行されます。
Scope : Any file
Type : enabled、failIfUnavailable、autoAllowBashIfSandboxed、excludedCommands、allowUnsandboxedCommands、enableWeakerNestedSandbox、enableWeakerNetworkIsolation、allowAppleEvents、bwrapPath、socatPath、ignoreViolations、ripgrep を含むオブジェクト、および filesystem、network、credentials オブジェクト
Default : 未設定。Claude Code はサンドボックスなしでコマンドを実行します
これはサンドボックスをオンにし、サンドボックス化されたコマンドの権限プロンプトをスキップし、docker をサンドボックスの外で実行し、2 つの追加の書き込みパスを開き、AWS 認証情報ファイルを非表示にし、GitHub と npm を事前に許可します:
{
"sandbox" : {
"enabled" : true,
"autoAllowBashIfSandboxed" : true,
"excludedCommands" : [ "docker *" ] ,
"filesystem" : {
"allowWrite" : [ "/tmp/build" , "~/.kube" ] ,
"denyRead" : [ "~/.aws/credentials" ]
} ,
"network" : {
"allowedDomains" : [ "github.com" , "*.npmjs.org" ]
}
}
}
Claude Code はブール値キーの値を、それを設定する最も優先度の高い設定スコープから取得するため、管理対象の enabled または failIfUnavailable は開発者が設定したものをオーバーライドします。配列キーはセッションが読み込むすべての設定スコープ全体でマージされるため、開発者はエントリを追加できます。ポリシーの拡大を開発者に防止させる については、管理対象のみのロックを参照してください。組織に対してサンドボックスを必須にするには、管理設定でサンドボックスを強制する を参照してください。
`sandbox.enabled`
Bash コマンドのサンドボックス をオンにします。/sandbox パネルでモードを選択すると、Claude Code はこのキーを現在のプロジェクトの .claude/settings.local.json に書き込みます。~/.claude/settings.json に設定して、すべてのプロジェクトをサンドボックス化します。
Scope : Any file
Type : ブール値
true: Claude Code は Bash コマンドをサンドボックス化します
false: Bash コマンドはサンドボックスなしで実行されます
Default : false
{
"sandbox" : {
"enabled" : true
}
}
Linux と WSL2 では、サンドボックスは bubblewrap と socat が必要です。Linux と WSL2 をセットアップする を参照してください。サンドボックスが起動できない場合、Claude Code は警告を表示し、failIfUnavailable も設定しない限り、コマンドはサンドボックスなしで実行されます。
`sandbox.failIfUnavailable`
sandbox.enabled が true であるにもかかわらずサンドボックスが起動できない場合(依存関係が不足しているか、プラットフォームがサポートされていない場合)、Claude Code がスタートアップ時にエラーで終了するようにします。これがない場合、Claude Code は警告を表示し、コマンドはサンドボックスなしで実行されます。組織がサンドボックスを厳密な要件として必要とする場合は、管理設定で使用します。
Scope : Any file
Type : ブール値
true: sandbox.enabled が true であるにもかかわらずサンドボックスが起動できない場合、Claude Code はスタートアップ時にエラーで終了します
false: Claude Code は警告を表示し、コマンドはサンドボックスなしで実行されます
Default : false
これにより、すべての管理対象マシンがコマンドをサンドボックス化するか、起動を拒否します:
{
"sandbox" : {
"enabled" : true,
"failIfUnavailable" : true
}
}
管理設定でサンドボックスを強制する を参照してください。
`sandbox.autoAllowBashIfSandboxed`
Claude Code がサンドボックス化された Bash コマンドを権限プロンプトなしで実行できるようにします。サンドボックスで実行できないコマンドは通常の権限フローを通過し、deny ルールと Bash(git push *) などのコンテンツスコープ付き ask ルールは引き続き適用されます。ベアの Bash ask ルールはサンドボックス化されたコマンドではスキップされます。これを false に設定して、サンドボックス化されたコマンドも通常の権限フローを通すようにします。これは /sandbox Mode タブが通常権限モードと呼ぶものです。
Scope : Any file
Type : ブール値
true: Claude Code はサンドボックス化された Bash コマンドを権限プロンプトなしで実行します。deny ルールとコンテンツスコープ付き ask ルールの対象です。CLAUDE_CODE_SUBPROCESS_ENV_SCRUB は自動許可をオフにします
false: サンドボックス化されたコマンドは通常の権限フローを通過するため、許可ルールと権限モードが決定します。/sandbox Mode タブはこれを通常権限モードと呼びます
Default : true
これはサンドボックスをオンに保ち、サンドボックス化されたコマンドを通常の権限フローを通します:
{
"sandbox" : {
"enabled" : true,
"autoAllowBashIfSandboxed" : false
}
}
サンドボックスモード を参照して、自動許可モードが何をプロンプトするか、およびプランモードでどのように動作するかを確認してください。
`sandbox.excludedCommands`
Claude Code がサンドボックスの外で実行するコマンド(サンドボックスで動作しないツールなど)に名前を付けます。各エントリは、Bash(...) 権限ルール の内容と同じ構文を使用します:正確なコマンド、docker * などのプレフィックス、またはワイルドカードパターン。
エントリは、Bash 呼び出しのすべてのコマンドをカバーする場合にのみ、Bash 呼び出しをサンドボックスから外します。一部の呼び出し形式はそれでもサンドボックス化されたままです。docker * エントリだけでは、npm ci && docker build . をサンドボックスから外しません。
Scope : Any file
Type : コマンドパターンの配列
Default : 未設定。コマンドは除外されません
{
"sandbox" : {
"excludedCommands" : [ "docker *" ]
}
}
Claude Code は、以下の形状の 1 つを持つ場合、Bash 呼び出しをサンドボックス化したままにします:
sudo、eval、または xargs で始まるコマンド
cd、pushd、または popd(呼び出しのどこにでも出現)
コマンド置換、サブシェル、または if や for などの制御フロー ブロック
docker build . > build.log など、ファイル記述子を複製するもの以外のリダイレクト(2>&1 など)
変数から来るコマンド名
たとえば、cd build && docker compose up は docker * エントリの下でサンドボックス化されたままであり、cd エントリを追加してもそれは変わりません。
除外されたコマンドは通常の権限フローを通過します。除外は便宜的なものであり、セキュリティ境界ではありません。ツールが特定の場所にのみ書き込む必要がある場合は、filesystem.allowWrite を優先してください。Claude Code はセッションが読み込むすべての設定スコープ全体でエントリをマージし、このリストに対する管理対象のみのロックはないため、管理対象リストを狭く保ちます。
`sandbox.allowUnsandboxedCommands`
Claude がサンドボックスによってブロックされた後、dangerouslyDisableSandbox パラメータを使用してコマンドをサンドボックスの外で再試行できるようにします。これを false に設定して、Claude Code がそのパラメータを完全に無視し、Claude が実行するすべてのコマンドがサンドボックス化されるか、excludedCommands に表示されるようにします。/sandbox Overrides タブはその状態を厳密なサンドボックスモード として表示します。厳密なサンドボックスを必要とするポリシーの場合は、管理設定で false を使用します。
Scope : Any file
Type : ブール値
true: Claude がサンドボックスによってブロックされた後、dangerouslyDisableSandbox パラメータを使用してコマンドをサンドボックスの外で再試行できます
false: Claude Code はそのパラメータを無視するため、Claude が実行するすべてのコマンドはサンドボックス化されるか、excludedCommands に表示されます
Default : true
これにより、管理設定がカバーするすべてのユーザーに対して厳密なサンドボックスモードが強制されます:
{
"sandbox" : {
"enabled" : true,
"allowUnsandboxedCommands" : false
}
}
サンドボックスなしの再試行は通常の権限フローを通過し、マニュアルモードではプロンプトが表示されます。サンドボックスなしの再試行エスケープハッチ を参照してください。
! シェルモードプロンプト で自分で入力するコマンドがサンドボックス化されるときを確認するには、厳密なサンドボックスモード を参照してください。
`sandbox.filesystem`
サンドボックス化されたコマンドが読み取りおよび書き込みできるパスを制御します。デフォルトでは、作業ディレクトリ、ユーザーごとの一時ディレクトリ、--add-dir、/add-dir、または permissions.additionalDirectories で追加したディレクトリに書き込むことができ、認証情報ファイルを含むファイルシステムの残りの部分を読み取ることができます。4 つのパスリストで制限または拡大するか、disabled でファイルシステムレイヤーをオフにします。ファイルシステム分離 のデフォルト境界を参照してください。
Scope : Any file
Type : allowWrite、denyWrite、denyRead、allowRead 配列を含むオブジェクト、および allowManagedReadPathsOnly と disabled ブール値
Default : 未設定。デフォルトの読み取りおよび書き込み境界が適用されます
これにより、サンドボックス化されたコマンドはビルドディレクトリと kubeconfig に書き込むことができ、AWS 認証情報ファイルを非表示にします:
{
"sandbox" : {
"filesystem" : {
"allowWrite" : [ "/tmp/build" , "~/.kube" ] ,
"denyRead" : [ "~/.aws/credentials" ]
}
}
}
Claude Code はこれらのリストを OS サンドボックス境界で強制するため、kubectl、terraform、npm などのサンドボックス化されたコマンドが開始するすべてのサブプロセスに適用されます。Claude Code は権限ルール を同じリストに追加します:Edit 許可および拒否ルールを allowWrite および denyWrite に、Read 拒否ルールを denyRead に、WebFetch(domain:...) 許可および拒否ルールをnetwork ドメインリストに追加します。
管理対象のみのロックが設定されていない限り、Claude Code はセッションが読み込む設定ファイル全体ですべてのリストをマージします。allowManagedReadPathsOnly は allowRead を管理設定からのエントリに制限し、allowManagedDomainsOnly は許可されたドメインに対して同じことを行います。
サンドボックスを設定する は、--setting-sources で除外するソースをカバーしています。セッション中にリストを編集すると、Claude Code は実行中のセッションに変更を適用 します。
サンドボックスパスプレフィックス
allowWrite、denyWrite、denyRead、allowRead、および credentials.files のパスはプレフィックスで解決されます:
プレフィックス
意味
例
/
ファイルシステムルートからの絶対パス
/tmp/build は /tmp/build のままです
~/
ホームディレクトリに相対
~/.kube は $HOME/.kube になります
./ またはプレフィックスなし
プロジェクト設定ではプロジェクトルートに相対、ユーザー設定では ~/.claude に相対
.claude/settings.json の ./output は <project-root>/output に解決されます
絶対パスの //path プレフィックスも機能します。プロジェクト相対解決を期待して単一スラッシュ /path を使用する場合は、./path に切り替えます。この構文は、//path を絶対パスに、/path をプロジェクト相対に使用するRead および Edit 権限ルール とは異なります。サンドボックスファイルシステムパスは標準規則を使用するため、/tmp/build は絶対パスです。
Claude Code はディレクトリパスから末尾のスラッシュを削除するため、~/.aws と ~/.aws/ は同じディレクトリと一致します。v2.1.224 より前では、Claude Code は末尾のスラッシュをサンドボックスに渡し、Claude は denyRead または denyWrite エントリで書き込まれたパスの下のパスを読み取りまたは書き込みできました。
Claude Code は末尾の /** も削除するため、~/build/** と ~/build は同じディレクトリをカバーします。* などのワイルドカードが機能するかどうかは、エントリがどのリストにあるか、およびプラットフォームに依存します:
allowWrite および denyWrite : macOS ではワイルドカードが機能します。Linux と WSL2 では、サンドボックスは具体的なパスをマウントするため、Claude Code は末尾の /** を削除した後に *、?、または [ を含むエントリをスキップし、そのエントリは効果がありません。Claude Code は Edit 権限ルールからパスを追加するため、同じ制限が適用され、/sandbox の Config タブはワイルドカードを含む Edit および Read 権限ルールについて警告します。
denyRead および allowRead : ワイルドカードはすべてのプラットフォームで機能します。Linux と WSL2 では、Claude Code は読み取りエントリを、それが一致する具体的なパスに展開します。これは書き込みリストでは行いません。
`sandbox.filesystem.allowWrite`
作業ディレクトリ、ユーザーごとの一時ディレクトリ、--add-dir、/add-dir、または permissions.additionalDirectories で追加したディレクトリを超えて、サンドボックス化されたコマンドが書き込むことができるパスを追加します。kubectl やビルドツールなどのサブプロセスがプロジェクト外に書き込む必要がある場合に使用します。
これにより、ビルドは /tmp/build の下に書き込むことができ、kubectl は kubeconfig を更新できます:
{
"sandbox" : {
"filesystem" : {
"allowWrite" : [ "/tmp/build" , "~/.kube" ]
}
}
}
Claude Code は allowWrite エントリと Edit(...) 許可権限ルールからのパスをセッションが読み込むすべての設定スコープ全体でマージし、permissions.blockReadsOutsideWorkingDirectories がオンの間、リポジトリ設定からのものを除外します。allowWrite エントリは保護されたパス を解除できません。
`sandbox.filesystem.denyWrite`
サンドボックス化されたコマンドが特定のパスへの書き込みをブロックします。これには、別の方法で書き込み可能なディレクトリ内のパスが含まれます。
これにより、サンドボックス化されたコマンドがシステム設定を変更したり、バイナリをインストールしたりするのを防ぎます:
{
"sandbox" : {
"filesystem" : {
"denyWrite" : [ "/etc" , "/usr/local/bin" ]
}
}
}
Claude Code はセッションが読み込むすべての設定スコープ全体でエントリをマージし、Edit(...) 拒否権限ルールからのパスを追加します。
`sandbox.filesystem.denyRead`
サンドボックス化されたコマンドが特定のパス(デフォルトの読み取りポリシーが公開する認証情報ファイルなど)の読み取りをブロックします。認証情報ファイルを保護し、サンドボックスプロキシを通じて使用可能に保つには、代わりに sandbox.credentials を参照してください。
{
"sandbox" : {
"filesystem" : {
"denyRead" : [ "~/.aws/credentials" ]
}
}
}
Claude Code はセッションが読み込むすべての設定スコープ全体でエントリをマージし、Read(...) 拒否権限ルールからのパスを追加します。filesystem.disabled が true の場合、Claude Code はこれらのエントリを強制しません。
`sandbox.filesystem.allowRead`
denyRead がブロックする領域内の特定のパスの読み取りを再度開き、ワークスペースのみの読み取りアクセスを構築します。正確またはワイルドカード denyRead エントリは、より広い allowRead 内でブロックされたままです。重複テーブル が示すとおりです。ワイルドカード denyRead エントリ(~/**/.env など)がディレクトリと一致する場合、Claude Code はその内容の読み取りもブロックします。v2.1.236 より前の macOS では、Claude Code はワイルドカード denyRead エントリが一致したパスを、より広い allowRead エントリがカバーしている場所で再度開き、一致したディレクトリの内容を読み取り可能なままにしました。
これにより、プロジェクト自体を除くホームディレクトリの読み取りがブロックされます:
{
"sandbox" : {
"filesystem" : {
"denyRead" : [ "~/" ] ,
"allowRead" : [ "." ]
}
}
}
Claude Code は . エントリをプロジェクト設定ではプロジェクトルートに、ユーザー設定では ~/.claude に解決します。Claude Code はセッションが読み込むすべての設定ファイル全体でエントリをマージします。allowManagedReadPathsOnly が設定されていない限り、permissions.blockReadsOutsideWorkingDirectories がオンの間、リポジトリ設定からのエントリを除外します。
`sandbox.filesystem.allowManagedReadPathsOnly`
管理設定から来る allowRead エントリのみを尊重するため、開発者は組織がブロックしたパスへの読み取りアクセスを再度開くことができません。Claude Code は引き続きセッションが読み込むすべての設定スコープから denyRead エントリをマージします。
Scope : Managed
Type : ブール値
true: Claude Code は管理設定からの allowRead エントリのみを尊重します
false: allowRead エントリはセッションが読み込むすべての設定スコープからマージされます
Default : false
これにより、ホームディレクトリの読み取りがブロックされ、~/work が再度開かれ、開発者が他のものを再度開くのが停止されます:
{
"sandbox" : {
"filesystem" : {
"denyRead" : [ "~/" ] ,
"allowRead" : [ "~/work" ] ,
"allowManagedReadPathsOnly" : true
}
}
}
ポリシーの拡大を開発者に防止させる を参照してください。
`sandbox.filesystem.disabled`
ネットワーク分離を保持しながらファイルシステム分離をスキップします。サンドボックス化されたコマンドはホストファイルシステムへの無制限の読み取りおよび書き込みアクセスを取得し、それらのネットワーク出力は network.allowedDomains に限定されたままです。コマンドが何を書き込むかではなく、どこに接続するかを制御するためにサンドボックスを使用する場合に使用します。Claude Code v2.1.216 以降が必要です。
Scope : User or managed 。管理設定が sandbox.filesystem をまったく設定する場合、または "mode": "deny" を持つ sandbox.credentials.files エントリをリストする場合、管理設定のみがそれを設定できます。
Type : ブール値
true: Claude Code はファイルシステム分離をスキップし、ネットワーク分離を保持します
false: ファイルシステム分離は有効なままです
Default : false。ファイルシステム分離は有効なままです
これにより、ファイルシステムが開かれ、ネットワーク出力が GitHub と npm に限定されます:
{
"sandbox" : {
"enabled" : true,
"filesystem" : {
"disabled" : true
} ,
"network" : {
"allowedDomains" : [ "github.com" , "*.npmjs.org" ]
}
}
}
レイヤーがオフの場合、Claude Code は denyRead または credentials.files deny エントリを強制しませんが、credentials.envVars エントリと適用された mask エントリは引き続き機能します。autoAllowBashIfSandboxed は引き続き true にデフォルト設定されるため、プロンプトを続けるには false に設定します。ファイルシステム分離を無効にする を参照して、それを設定できるソースの完全なリストと、分離がオフの場合に何が変わるかを確認してください。Claude Code v2.1.216 以降が必要です。
`sandbox.ignoreViolations`
コマンドがプローブして拒否されることが予想されるパスのサンドボックス違反レポートを沈黙させます(例えば、スタートアップ時に /etc/hosts をチェックするツール)。これらの拒否は違反として表示されず、Claude が見るものにも表示されません。サンドボックスはアクセスをブロックしたままです。レポートのみが抑制されます。キーはコマンドに対して一致するサブストリング(* はすべてのコマンドに一致)で、値はそのコマンドで無視する違反のサブストリング(ファイルシステムパスなど)です。
Scope : Any file
Type : コマンドサブストリングを違反サブストリングの配列にマップするオブジェクト(通常はパス)
Default : 未設定。すべての違反が報告されます
{
"sandbox" : {
"ignoreViolations" : {
"*" : [ "/etc/hosts" ]
}
}
}
`sandbox.enableWeakerNestedSandbox`
Linux サンドボックスを非特権 Docker コンテナ内で実行します。bubblewrap は新しい /proc をマウントできません。代わりに、内部サンドボックスはコンテナの既存の /proc をバインドマウントします。これにより、新しいマウントが非表示にするプロセス情報が公開されます。これはセキュリティを低下させます。外部コンテナが既に必要な分離を提供する場合にのみ使用します。
Scope : Any file
Type : ブール値
true: 内部サンドボックスは新しい /proc をマウントする代わりに、コンテナの既存の /proc をバインドマウントします
false: サンドボックスは新しい /proc をマウントします。これは非特権 Docker コンテナでは機能しません
Default : false
{
"sandbox" : {
"enabled" : true,
"enableWeakerNestedSandbox" : true
}
}
Linux と WSL2 のみ。Bubblewrap がコンテナ内で起動に失敗する を参照してください。
`sandbox.enableWeakerNetworkIsolation`
macOS でサンドボックス化されたコマンドがシステム TLS トラストサービス com.apple.trustd.agent に到達できるようにします。gh、gcloud、terraform などの Go ベースのツールは、network.httpProxyPort を MITM プロキシとカスタム CA で使用する場合、TLS 証明書を検証するために必要です。これはトラストサービスを通じた潜在的なデータ流出パスを開くことでセキュリティを低下させます。
Scope : Any file
Type : ブール値
true: macOS でサンドボックス化されたコマンドは com.apple.trustd.agent に到達できます
false: macOS でサンドボックス化されたコマンドはシステム TLS トラストサービスに到達できません
Default : false
{
"sandbox" : {
"enabled" : true,
"enableWeakerNetworkIsolation" : true
}
}
MITM プロキシを使用しない場合は、代わりに失敗するツールを excludedCommands にリストします。Go ベースの CLI が macOS で TLS 検証に失敗する を参照してください。
`sandbox.allowAppleEvents`
macOS でサンドボックス化されたコマンドが Apple Events を送信できるようにします。open、osascript、およびブラウザで URL を開くツールはこれが必要です。これがないと、エラー -600 で失敗します。これはコード実行分離を削除します。サンドボックス化されたコマンドはユーザープロンプトなしで他のアプリケーションを非サンドボックス化で起動でき、Terminal などの実行中のアプリケーションに AppleScript コマンドを送信できます。これはアプリごとの macOS オートメーション同意プロンプト(TCC)の対象です。
Scope : User or managed
Type : ブール値
true: macOS でサンドボックス化されたコマンドは Apple Events を送信できます
false: macOS でサンドボックス化されたコマンドは Apple Events を送信できないため、open と osascript はエラー -600 で失敗します
Default : false
{
"sandbox" : {
"enabled" : true,
"allowAppleEvents" : true
}
}
分離を保持しながら 1 つのそのようなツールを実行するには、代わりに excludedCommands に追加します。macOS の Apple Events を参照してください。
`sandbox.ripgrep`
Claude Code が使用するものの代わりに、独自の ripgrep バイナリをサンドボックスに指定します。たとえば、プラットフォームが異なる方法で構築された rg が必要な場合です。
Scope : User or managed
Type : ripgrep バイナリへのパスである command を含むオブジェクト、および前置する引数の配列である optional args
Default : 未設定。サンドボックスは Claude Code と同じ ripgrep バイナリを使用します。USE_BUILTIN_RIPGREP を 0 に設定しない限り、これはバンドルされたバイナリです
{
"sandbox" : {
"ripgrep" : {
"command" : "/usr/local/bin/rg"
}
}
}
`sandbox.bwrapPath`
PATH の外にインストールされた bubblewrap バイナリ(エアギャップホスト上のベンダー版など)をサンドボックスに指定します。Claude Code はスタートアップ依存関係チェックと、サンドボックス化された各コマンドをラップするときの両方でパスを使用します。
Scope : Managed 。Claude Code はユーザー、プロジェクト、またはローカルファイルがサンドボックスを別のバイナリに指定できないように、管理設定からのみ読み取ります。
Type : 文字列。絶対パス。Claude Code は相対パスを削除し、PATH ルックアップにフォールバックします
Default : 未設定。Claude Code は PATH で bwrap を見つけます
{
"sandbox" : {
"enabled" : true,
"bwrapPath" : "/opt/admin/bwrap"
}
}
Linux と WSL2 のみ。
`sandbox.socatPath`
PATH の外にインストールされた socat バイナリをサンドボックスネットワークプロキシに指定します。
Scope : Managed
Type : 文字列。絶対パス。Claude Code は相対パスを削除し、PATH ルックアップにフォールバックします
Default : 未設定。Claude Code は PATH で socat を見つけます
{
"sandbox" : {
"enabled" : true,
"socatPath" : "/opt/admin/socat"
}
}
Linux と WSL2 のみ。
`sandbox.credentials`
サンドボックス化されたコマンドから保護する 認証情報ファイルと環境変数を宣言します。各エントリはファイル path または変数 name と mode に名前を付けます:deny はサンドボックス内の認証情報を非表示にし、mask はサンドボックス化されたコマンドにプレースホルダーを表示します。サンドボックスプロキシ は送信リクエストで実際の値を置き換えます。Claude Code はリストしたエントリのみを保護します。組み込みの認証情報拒否リストはありません。
Scope : Any file 。Claude Code は mask エントリ、allowPlaintextInject、awsPairs、sigv4 をユーザー設定、管理設定、--settings フラグからのみ尊重します。
Type : files、envVars、allowPlaintextInject、awsPairs、sigv4 を含むオブジェクト
Default : 未設定。認証情報は保護されません
これにより、AWS 認証情報ファイルが非表示になり、GITHUB_TOKEN がサンドボックス化されたコマンドから削除されます:
{
"sandbox" : {
"credentials" : {
"files" : [ { "path" : "~/.aws/credentials" , "mode" : "deny" } ] ,
"envVars" : [ { "name" : "GITHUB_TOKEN" , "mode" : "deny" } ]
}
}
}
deny ファイル保護はファイルシステムレイヤーの一部であるため、ファイルシステム分離を無効にする 場合は適用されません。環境変数保護は引き続き適用されます。
管理設定の無効な認証情報エントリ
管理対象の sandbox.credentials エントリが検証に失敗した場合、Claude Code は可能な限り認証情報を保護し続けます:
files または envVars のエントリで、有効な path または name と mask または deny の mode を持つもの(キャプチャグループがない extract パターンなど)は、警告とともに mode: "deny" に低下されるため、認証情報はマスクされず、エントリを修正するまでブロックされたままです。低下した files エントリは、明示的な deny エントリのように filesystem.disabled をピンします。警告は、管理設定がファイルシステム分離をオフにする場合、その読み取りブロックが強制されないことを記します。
不明な mode または無効な path または name を持つエントリは削除されます。
各ケースは警告します。エントリが低下または削除されるかどうかに関わらず、残りの有効なエントリは引き続き強制され、完全に無効な credentials 値は削除されますが、sandbox の残りは引き続き適用されます。
v2.1.191 以降に適用されます。v2.1.221 より前では、すべての無効なエントリが削除されました。フィールドごとの処理を持つ他の管理キーについては、管理設定の無効なエントリ を参照してください。
`sandbox.credentials.files`
認証情報ファイルまたはディレクトリをサンドボックス化されたコマンドから保護します。"mode": "deny" の場合、Claude Code はサンドボックス内のパスの読み取りをブロックします。これは sandbox.filesystem.denyRead と同じ読み取りブロックです。"mode": "mask" の場合、Linux と WSL2 でサンドボックス化されたコマンドはファイルのセンチネルコピーを読み取り、サンドボックスプロキシはそのエントリの injectHosts への送信リクエストで実際の値を置き換えます。macOS ではファイルはサンドボックス内で読み取り不可です。"mode": "mask" には Claude Code v2.1.221 以降が必要です。
Scope : Any file 。Claude Code はプロジェクト .claude/settings.json とローカル .claude/settings.local.json から mask エントリを削除します。
Type : オブジェクトの配列。各オブジェクトは path と "deny" または "mask" の mode、および optional ファイルのマスクフィールド を含みます
Default : 未設定。認証情報ファイルは保護されません
これにより、AWS 認証情報ファイルが非表示になり、gh ホストファイルがマスクされ、api.github.com へのリクエストでのみ実際の値が置き換えられます:
{
"sandbox" : {
"credentials" : {
"files" : [
{ "path" : "~/.aws/credentials" , "mode" : "deny" } ,
{ "path" : "~/.config/gh/hosts.yml" , "mode" : "mask" , "injectHosts" : [ "api.github.com" ] }
]
}
}
}
パスは sandbox.filesystem.* 設定と同じプレフィックス を使用し、Claude Code はセッションが読み込むすべての設定スコープから配列をマージします。認証情報を保護する は、--setting-sources で除外するソースから何が引き続き適用されるかをカバーしています。mask エントリには Claude Code v2.1.221 以降が必要です。
mask 置換はサンドボックスプロキシを通じてのみ実行されるため、sandbox.network.tlsTerminate 、または プレーン HTTP テストネットワークの場合は allowPlaintextInject を設定します。mask は単一ファイルに適用されるため、各認証情報ファイルを個別にリストします。Claude Code は deny エントリの mask フィールドを受け入れますが、無視します。認証情報ファイルをマスクする は、どの設定ソースが尊重されるか、およびエントリが deny にフォールバックするときをカバーしています。
ファイルのマスクフィールド
mask エントリはこれらの optional フィールドを受け入れます。extract または decode がない場合、Claude Code はファイル全体の内容を 1 つのセンチネルで置き換えます。ファイルシステム分離がオンの macOS では、Claude Code は extract または decode が実行される前に mask エントリを deny として適用します。認証情報ファイルをマスクする を参照してください。
フィールド
型
何をするか
extract
文字列。少なくとも 1 つのキャプチャグループを持つ正規表現
各一致のグループ 1 でキャプチャされたテキストのみをマスクするため、ファイルの残りは解析可能なままです。decode も設定されている場合、Claude Code は各キャプチャを置き換える前に、可能な JWT として確認します。v2.1.221 以降が必要です
onExtractNoMatch
"warn"、"deny"、または "error"。デフォルト "warn"
extract または decode がマスクするものを見つけられない場合に何が起こるか。warn はファイルをサンドボックス内で読み取り可能なままにし、deny は読み取り不可にし、error は設定を修正するまでサンドボックスセットアップを停止します。Claude Code は、読み取りブロックが強制されない場合、deny を error として扱います。ファイルシステム分離を無効にする か、sandbox.filesystem.allowRead エントリがパスを再度開く場合です。v2.1.221 以降が必要です。decode ケースには v2.1.224 以降が必要です
decode
文字列 "jwt"
ファイル内の JSON Web Token(JWT)を見つけます。組み込みパターンまたは設定されている場合は extract を使用して、各候補を検証し、構造的に有効な偽のトークンで置き換えます。サンドボックス内のコードがトークンをデコードし続けるようにします。候補が検証されない場合、onExtractNoMatch が結果を管理します。v2.1.224 以降が必要です
maskClaims
文字列の配列。少なくとも 1 つのクレーム名。decode が必要
各検証済み JWT 内の名前付きトップレベルペイロードクレームのみをマスクし、変更されたペイロードの周りにトークンを再構築します。他のクレームは読み取り可能なままです。名前付きクレームが一致しない場合、onExtractNoMatch が結果を管理します。v2.1.224 以降が必要です
maskDuplicates
ブール値。デフォルト false
各マスクされた値の逐語的なコピーをファイル内の他の場所でも置き換えます。例えば、コメントに貼り付けられたシークレット。Claude Code は生のサブストリングと一致するため、長く、高エントロピーのシークレット用に予約します。extract または decode が設定されている場合にのみ参照されます。v2.1.221 以降が必要です
injectHosts
文字列の配列。各ホストは sandbox.network.allowedDomains も認めます
サンドボックスプロキシが実際の値を置き換えるホストを絞ります。未設定の場合、プロキシは sandbox.network.allowedDomains のすべてのホストへのリクエストで置き換えます。v2.1.221 以降が必要です
これにより、gh ホストファイル内の oauth_token 値のみがマスクされ、ファイル内のそれぞれの他のコピーが置き換えられ、パターンが何も一致しない場合はファイルが読み取り不可になり、実際のトークンは api.github.com へのリクエストでのみ置き換えられます:
{
"sandbox" : {
"credentials" : {
"files" : [
{
"path" : "~/.config/gh/hosts.yml" ,
"mode" : "mask" ,
"extract" : "oauth_token:\\s*(\\S+)" ,
"maskDuplicates" : true,
"onExtractNoMatch" : "deny" ,
"injectHosts" : [ "api.github.com" ]
}
]
}
}
}
`sandbox.credentials.envVars`
環境変数をサンドボックス化されたコマンドから保護します。"mode": "deny" の場合、Claude Code はサンドボックス化されたコマンドの環境から変数を削除します。"mode": "mask" の場合、サンドボックス化されたコマンドはセッションごとのセンチネル値を見て、サンドボックスプロキシはそのエントリの injectHosts への送信リクエストで実際の値を置き換えます。gh や npm などのツールは実際の認証情報を保持することなく認証を続けます。"mode": "mask" には Claude Code v2.1.199 以降が必要です。
Scope : Any file 。Claude Code はプロジェクト .claude/settings.json とローカル .claude/settings.local.json から mask エントリを削除します。
Type : オブジェクトの配列。各オブジェクトは name と "deny" または "mask" の mode、および optional 環境変数のマスクフィールド を含みます
Default : 未設定。環境変数は保護されません
これにより、NPM_TOKEN がサンドボックス化されたコマンドから削除され、GITHUB_TOKEN がマスクされ、実際の値は api.github.com へのリクエストでのみ置き換えられます:
{
"sandbox" : {
"credentials" : {
"envVars" : [
{ "name" : "NPM_TOKEN" , "mode" : "deny" } ,
{ "name" : "GITHUB_TOKEN" , "mode" : "mask" , "injectHosts" : [ "api.github.com" ] }
]
}
}
}
name は文字または下線で始まり、文字、数字、下線のみを含む必要があります。Claude Code はセッションが読み込むすべての設定スコープから配列をマージし、同じ変数が両方のモードで表示される場合は deny を適用します。認証情報を保護する は、--setting-sources で除外するソースから何が引き続き適用されるかをカバーしています。mask エントリには Claude Code v2.1.199 以降が必要です。
mask 置換はサンドボックスプロキシを通じてのみ実行されるため、sandbox.network.tlsTerminate 、または プレーン HTTP テストネットワークの場合は allowPlaintextInject を設定します。環境変数をマスクする を参照してください。Claude Code は deny エントリの mask フィールドを受け入れますが、無視します。
環境変数のマスクフィールド
mask エントリはこれらの optional フィールドを受け入れます。extract または decode がない場合、Claude Code は全体の値を 1 つのセンチネルで置き換えます。extract と decode は同じエントリで組み合わせることはできません。
フィールド
型
何をするか
extract
文字列。少なくとも 1 つのキャプチャグループを持つ正規表現
各一致のグループ 1 でキャプチャされたテキストのみをマスクします。例えば、DATABASE_URL 接続文字列内のパスワード。値の残りは解析可能なままです。v2.1.224 以降が必要です
onExtractNoMatch
"warn"、"deny"、または "error"。デフォルト "warn"。decode を持つエントリでは、"warn" のみが受け入れられます
extract が何も一致しない場合に何が起こるか。warn は変数をマスクなしで渡し、deny はサンドボックス内でそれをアンセットし、error は設定を修正するまでサンドボックスセットアップを停止します。v2.1.224 以降が必要です
decode
文字列 "jwt"
全体の値が JWT であることを検証し、構造的に有効な偽のトークンで置き換えます。サンドボックス内のコードがトークンをデコードし続けるようにします。プロキシは出力時に全体の実際のトークンを置き換えます。検証されない値は警告とともにマスクなしで渡されます。v2.1.224 以降が必要です
maskClaims
文字列の配列。少なくとも 1 つのクレーム名。decode が必要
デコードされた JWT 内の名前付きトップレベルペイロードクレームのみをマスクし、変更されたペイロードの周りにトークンを再構築します。他のクレームは読み取り可能なままです。名前付きクレームが一致しない場合、変数は警告とともにマスクなしで渡されます。v2.1.224 以降が必要です
injectHosts
文字列の配列。各ホストは sandbox.network.allowedDomains も認めます
サンドボックスプロキシが実際の値を置き換えるホストを絞ります。未設定の場合、プロキシは sandbox.network.allowedDomains のすべてのホストへのリクエストで置き換えます。IPv6 宛先を裸の圧縮アドレスとして書き込みます。例えば、"::1"。括弧形式ではなく。injectHosts の IPv6 宛先 を参照してください。v2.1.199 以降が必要です
これにより、DATABASE_URL 内のパスワードのみがマスクされ、パターンが何も一致しない場合は変数がアンセットされ、SERVICE_JWT の JWT がマスクされます。api_key を除くすべてのクレームは読み取り可能なままです:
{
"sandbox" : {
"credentials" : {
"envVars" : [
{
"name" : "DATABASE_URL" ,
"mode" : "mask" ,
"extract" : "://[^:]+:([^@]+)@" ,
"onExtractNoMatch" : "deny"
} ,
{
"name" : "SERVICE_JWT" ,
"mode" : "mask" ,
"decode" : "jwt" ,
"maskClaims" : [ "api_key" ]
}
]
}
}
}
`sandbox.credentials.allowPlaintextInject`
TLS 終了 HTTPS だけでなく、プレーン HTTP リクエストでも mask 置換を許可します。プレーン HTTP では、アップストリーム ID は検証されず、認証情報はクリアテキストで移動するため、信頼できるテストネットワーク外ではこれをオフのままにします。Claude Code v2.1.199 以降が必要です。
Scope : User or managed
Type : ブール値
true: Claude Code はプレーン HTTP リクエストと TLS 終了 HTTPS の両方で mask 置換を許可します
false: Claude Code は TLS 終了 HTTPS でのみ mask 置換を許可します
Default : false
{
"sandbox" : {
"credentials" : {
"allowPlaintextInject" : true
}
}
}
Claude Code v2.1.199 以降が必要です。
`sandbox.credentials.awsPairs`
マスクされた環境変数をグループ化して、認証情報が非標準の名前の変数に存在する場合、SigV4 再署名 用に 1 つの AWS 認証情報を形成します。Claude Code は、従来の AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_SESSION_TOKEN トリオを全体の値をマスクする場合、自動的にリンクするため、他の名前の場合にのみこのキーが必要です。Claude Code v2.1.224 以降が必要です。
Scope : User or managed
Type : オブジェクトの配列。各オブジェクトは accessKeyIdVar、secretAccessKeyVar、および optional sessionTokenVar を含み、sandbox.credentials.envVars エントリに名前を付けます
Default : 未設定。従来のトリオのみがペアになります
これにより、3 つのカスタム名の変数が 1 つの AWS 認証情報にリンクされ、再署名されます:
{
"sandbox" : {
"credentials" : {
"awsPairs" : [
{
"accessKeyIdVar" : "MY_KEY_ID" ,
"secretAccessKeyVar" : "MY_SECRET_KEY" ,
"sessionTokenVar" : "MY_SESSION_TOKEN"
}
]
}
}
}
各名前付き変数は sandbox.credentials.envVars の全体値 mask エントリである必要があり、extract または decode なしで、すべてのペアで 1 つのスロットのみを埋めることができます。
`sandbox.credentials.sigv4`
サンドボックスプロキシが 再署名できない AWS リクエスト形式で何をするかを選択します:streaming は aws-chunked ストリーミングアップロード、presigned は事前署名 URL、sigv4a は SigV4A 非対称署名です。これは、マスクされたペアのプレースホルダーアクセスキー ID で署名されたリクエストにのみ適用されます。Claude Code v2.1.224 以降が必要です。
Scope : User or managed
Type : streaming、presigned、sigv4a を含むオブジェクト。各オブジェクトは以下のいずれかです:
"deny": プロキシはリクエストを失敗させます
"passthrough": プロキシはマスクされたプレースホルダーで署名されたリクエストを転送するため、ツールは AWS 自体の拒否を受け取ります
Default : 未設定。すべての形式は "deny" です
これにより、ストリーミングアップロードはプロキシで失敗する代わりに転送されます:
{
"sandbox" : {
"credentials" : {
"sigv4" : {
"streaming" : "passthrough"
}
}
}
}
deny の場合、プロキシはリクエストを失敗させます。passthrough の場合、プロキシはマスクされたプレースホルダーから計算された署名でリクエストを転送するため、AWS はそれを拒否し、呼び出しツールはプロキシエラーの代わりに AWS 自体の応答を受け取ります。
`sandbox.network`
サンドボックス化されたコマンドが到達できるホスト、ポート、ソケットを制御します。サンドボックスは送信トラフィックをプロキシを通じてルーティングし、これらのリストを強制します。ネットワーク分離 を参照して、プロキシがどのように決定するか、およびいつプロンプトするかを確認してください。
Scope : Any file 。strictAllowlist、allowManagedDomainsOnly、tlsTerminate は、それらのエントリが言うように、より少ないソースから読み取られます。
Type : 以下のサブキーを含むオブジェクト
Default : 未設定。ドメインは事前に許可されず、サンドボックスは各新しいホストについてプロンプトします
これにより、GitHub と npm が事前に許可され、uploads.github.com がブロックされ、コマンドが localhost にバインドできます:
{
"sandbox" : {
"network" : {
"allowedDomains" : [ "github.com" , "*.npmjs.org" ] ,
"deniedDomains" : [ "uploads.github.com" ] ,
"allowLocalBinding" : true
}
}
}
Claude Code は配列サブキーを設定スコープ全体でマージし、重複を排除するため、プロジェクトはドメインをユーザーリストに追加できます。WebFetch(domain:...) 許可および拒否権限ルール は同じ許可および拒否リストをフィードします。
`sandbox.network.allowUnixSockets`
macOS でサンドボックス化されたコマンドが接続できる Unix ソケットパスをリストします。Claude Code は Linux と WSL2 でこのリストを無視します。seccomp フィルタはソケットパスを検査できません。代わりに allowAllUnixSockets を使用します。
Scope : Any file
Type : 文字列の配列。各ソケットパス
Default : 未設定。macOS サンドボックスはすべての Unix ソケットをブロックします
{
"sandbox" : {
"network" : {
"allowUnixSockets" : [ "~/.ssh/agent-socket" ]
}
}
}
ソケットパスは広いアクセスを許可できます。たとえば、/var/run/docker.sock を許可すると、サンドボックス化されたコマンドが Docker デーモンを制御できます。セキュリティ制限 を参照してください。
`sandbox.network.allowAllUnixSockets`
サンドボックス化されたコマンドがすべての Unix ソケットに接続できるようにします。Linux と WSL2 では、サンドボックスの seccomp フィルタ は socket(AF_UNIX, ...) 呼び出しをブロックするため、これは Unix ソケットを許可する唯一の方法です。フィルタが不足している場合(/sandbox がその Dependencies タブで報告する場合)、サンドボックスは Unix ソケット呼び出しをブロックしません。Linux と WSL2 をセットアップする を参照して、フィルタがどこから来るかを確認してください。
Scope : Any file
Type : ブール値
true: サンドボックス化されたコマンドはすべての Unix ソケットに接続できます
false: サンドボックスは Unix ソケット接続をブロックします:macOS では allowUnixSockets のパスを除き、Linux と WSL2 ではフィルタが存在する場合は seccomp フィルタを通じて
Default : false
{
"sandbox" : {
"network" : {
"allowAllUnixSockets" : true
}
}
}
WSL2 では、true は cmd.exe や powershell.exe などの Windows バイナリを起動する相互運用ソケットも再度開きます。
`sandbox.network.allowLocalBinding`
macOS でサンドボックス化されたコマンドが localhost ポートにバインドできるようにします。例えば、開発サーバーを起動するためです。
Scope : Any file
Type : ブール値
true: macOS でサンドボックス化されたコマンドは localhost ポートにバインドできます
false: macOS でサンドボックス化されたコマンドは localhost ポートにバインドできません
Default : false
{
"sandbox" : {
"network" : {
"allowLocalBinding" : true
}
}
}
`sandbox.network.allowMachLookup`
macOS サンドボックスが検索できる追加の XPC および Mach サービス名をリストします。iOS Simulator や Playwright などの XPC を通じて通信するツールは、ここにサービスをリストする必要があります。
Scope : Any file
Type : 文字列の配列。各サービス名。単一の末尾 * はプレフィックスと一致し、"*" だけはすべてのサービスと一致します
Default : 未設定
これにより、com.apple.coresimulator. プレフィックスの下のすべてのサービスが許可されます:
{
"sandbox" : {
"network" : {
"allowMachLookup" : [ "com.apple.coresimulator.*" ]
}
}
}
`sandbox.network.allowedDomains`
サンドボックス化されたコマンドからの送信トラフィック用にドメインを事前に許可するため、サンドボックスはそれらについてプロンプトしません。*.example.com などのワイルドカードはサブドメインと一致し、optional :port サフィックスはエントリを 1 つのポートに制限します。ポートなしのエントリはすべてのポートと一致します。
Scope : Any file 。allowManagedDomainsOnly が設定されている場合、管理設定のみ。
Type : 文字列の配列。各ドメイン、ワイルドカードパターン、または IP リテラル。optional :port サフィックス付き
Default : 未設定。サンドボックスは新しいホストに初めて到達するときにプロンプトします
これにより、GitHub がすべてのポートで事前に許可され、すべての npm サブドメイン、および 1 つの API ホストがポート 443 でのみ許可されます:
{
"sandbox" : {
"network" : {
"allowedDomains" : [ "github.com" , "*.npmjs.org" , "api.example.com:443" ]
}
}
}
IPv6 リテラルを括弧で囲んで書き込みます。optional ポート付き:"[::1]" はすべてのポートを許可し、"[::1]:443" は 1 つのポートを許可します。括弧形式には Claude Code v2.1.229 以降が必要です。ドメインリストの IPv6 アドレス を参照してください。
`sandbox.network.deniedDomains`
allowedDomains と同じワイルドカード、ポート、IPv6 構文を使用して、サンドボックス化されたコマンドからの送信トラフィック用にドメインをブロックします。拒否されたドメインは、allowedDomains エントリも一致する場合でもブロックされたままです。
Scope : Any file
Type : 文字列の配列。各ドメイン、ワイルドカードパターン、または IP リテラル。optional :port サフィックス付き
Default : 未設定
{
"sandbox" : {
"network" : {
"deniedDomains" : [ "sensitive.cloud.example.com" ]
}
}
}
Claude Code はセッションが読み込むすべての設定ソースからこのリストをマージします。allowManagedDomainsOnly が設定されている場合でも、開発者は常に拒否リストを厳しくできます。IPv6 リテラルについては、ドメインリストの IPv6 アドレス を参照してください。
完全修飾ドメイン名をマークする末尾ドット(example.com. など)で書き込まれたエントリは、example.com と同じ接続をブロックします。
`sandbox.network.strictAllowlist`
許可リスト外のホストへのアクセスをプロンプトする代わりにブロックします。許可リストは allowedDomains と WebFetch(domain:...) 許可ルールからのドメイン、または allowManagedDomainsOnly が設定されている場合は管理設定エントリのみです。Claude Code v2.1.219 以降が必要です。
Scope : User or managed 。リポジトリはそれをオンまたはオフにできません。
Type : ブール値
true: Claude Code は許可リスト外のホストへのサンドボックス化されたコマンドアクセスを拒否します
false: 別の信頼できる設定ファイルが true を設定しない限り、Claude Code は許可リスト外のホストを権限モードの代わりに決定します:自動モードではコマンドのコマンドごとの許可ドメイン に対してホストをチェックし、dontAsk モードではブロックし、bypassPermissions モードおよび バイパスが利用可能なインタラクティブターミナルプランモードセッションでは許可し、それ以外の場合は尋ねます
Default : false
{
"sandbox" : {
"network" : {
"strictAllowlist" : true
}
}
}
Claude Code はサンドボックス化されたコマンドのみに対してこれを強制します。WebFetch などのインプロセスツールは引き続き権限ルール に従います。尊重されるソースのいずれかが true に設定する場合、それはオンのままです。ネットワーク分離 を参照してください。Claude Code v2.1.219 以降が必要です。
`sandbox.network.allowManagedDomainsOnly`
ネットワーク許可リストを管理設定が定義するものにロックします。Claude Code は管理設定からの allowedDomains と WebFetch(domain:...) 許可ルールのみを尊重し、ユーザー、プロジェクト、ローカル、--settings 設定からのドメインを無視し、許可されていないドメインをプロンプトする代わりに自動的にブロックします。
Scope : Managed
Type : ブール値
true: Claude Code は管理設定からの allowedDomains と WebFetch(domain:...) 許可ルールのみを尊重し、許可されていないドメインをブロックする代わりにプロンプトします
false: ユーザー、プロジェクト、ローカル、--settings 設定からのドメインが許可リストにマージされます
Default : false
これにより、許可リストが GitHub と npm にロックされ、開発者が追加するドメインが無視されます:
{
"sandbox" : {
"network" : {
"allowManagedDomainsOnly" : true,
"allowedDomains" : [ "github.com" , "*.npmjs.org" ]
}
}
}
拒否されたドメインはセッションが読み込むすべてのソースからマージされます。ポリシーの拡大を開発者に防止させる を参照してください。
`sandbox.network.httpProxyPort`
Claude Code が実行するものの代わりに、独自の HTTP プロキシをサンドボックスに指定します。組織はこれを行って、HTTPS トラフィックを検査し、独自のフィルタリングルールを適用するか、すべてのリクエストをログします。未設定の場合、Claude Code は HTTP トラフィック用に独自のプロキシを起動します。
Scope : Any file
Type : 数値。ローカル TCP ポート
Default : 未設定。Claude Code は独自のプロキシを実行します
{
"sandbox" : {
"network" : {
"httpProxyPort" : 8080
}
}
}
プロキシが SOCKS トラフィックも実行する場合は、socksProxyPort も設定します。2 つのうち 1 つだけが設定されている場合、Claude Code は他のプロトコル用に独自のプロキシを実行します。カスタムプロキシ設定 を参照してください。
`sandbox.network.socksProxyPort`
Claude Code が実行するものの代わりに、独自の SOCKS5 プロキシをサンドボックスに指定します。未設定の場合、Claude Code は SOCKS トラフィック用に独自のプロキシを起動します。
Scope : Any file
Type : 数値。ローカル TCP ポート
Default : 未設定。Claude Code は独自のプロキシを実行します
{
"sandbox" : {
"network" : {
"socksProxyPort" : 8081
}
}
}
カスタムプロキシ設定 を参照してください。
`sandbox.network.tlsTerminate`
サンドボックスプロキシが TLS を終了して、HTTPS リクエストの内容を読み取ることができるようにします。これは実験的であり、mask 認証情報置換 はそれを必要とします。{} を設定してセッション用に一時的な認証局を生成するか、caCertPath と caKeyPath を設定して独自のものを使用します。
Scope : User or managed 。リポジトリはそれをオンにするか、認証局を提供できません。
Type : optional caCertPath と caKeyPath 文字列を含むオブジェクト。各ファイルパス
Default : 未設定。プロキシは TLS を終了または検査しません
{
"sandbox" : {
"network" : {
"tlsTerminate" : { }
}
}
}
複数の尊重されるソースがそれを設定する場合、Claude Code は最も優先度の高いソースからの値を使用します:管理設定、次に --settings フラグ、次にユーザー設定。Claude Code v2.1.199 以降が必要です。
メモリとコンテキスト
Claude Code がコンテキストに読み込む内容、コンパクト化の方法、メモリと計画の保存場所を制御します。コンテキストの管理 とメモリ を参照してください。
`autoCompactEnabled`
コンテキストが制限に近づいたときに Claude Code が会話を自動的にコンパクト化 するようにします。/config に自動コンパクト化 として表示され、そこで切り替えるとこのキーがユーザー設定に書き込まれます。
スコープ : 任意のファイル
タイプ : ブール値
true: コンテキストが制限に近づいたときに Claude Code が会話を自動的にコンパクト化します
false: Claude Code は自動的にコンパクト化しません
デフォルト : true
セッションごとのオーバーライド : DISABLE_AUTO_COMPACT は 1 つのセッションの自動コンパクト化をオフにします。2 つのうちどちらかがオフにすると、もう一方はオンに戻すことができません
{
"autoCompactEnabled" : false
}
手動の /compact コマンドは自動コンパクト化がオフの間も機能し続けます。
`autoCompactWindow`
Claude Code が自動的にコンパクト化 する前にコンテキストウィンドウがどの程度満杯になるかを設定します。
{
"autoCompactWindow" : 500000
}
/autocompact コマンドで設定します。このコマンドはこのキーをユーザー設定に書き込みます。自動コンパクト化ウィンドウを設定 では、コマンド、フラグ、変数、設定がどのように相互作用するかについて説明しています。
`autoMemoryDirectory`
自動メモリ をプロジェクトごとのデフォルトではなく、選択したディレクトリに保存します。
スコープ : 任意のファイル
タイプ : 文字列。絶対パスまたは ~/ で始まるディレクトリパス
デフォルト : 未設定。Claude Code は ~/.claude/projects/<project>/memory/ を使用します
{
"autoMemoryDirectory" : "~/my-memory-dir"
}
プロジェクトまたはローカル設定から、Claude Code はこのキーをフックと同じワークスペーストラストルール の下で尊重します。クローンされたリポジトリはこれらのファイルを提供できるためです。
`autoMemoryEnabled`
自動メモリ をオンまたはオフにします。false の場合、Claude は自動メモリディレクトリから読み取ったり書き込んだりしません。セッション中に /memory で切り替えることもできます。これはこのキーをユーザー設定に書き込みます。
スコープ : 任意のファイル
タイプ : ブール値
true: 未設定と同じです。--bare、セーフモード、CLAUDE_CODE_DISABLE_AUTO_MEMORY など、セッションでこのキーより優先される何かがオフにしない限り、自動メモリはオンのままです
false: Claude は自動メモリディレクトリから読み取ったり書き込んだりしません
デフォルト : true
セッションごとのオーバーライド : CLAUDE_CODE_DISABLE_AUTO_MEMORY は 1 つのセッションでこのキーより優先されます。どちらの方向でも優先されます
{
"autoMemoryEnabled" : false
}
`bashOutputMaxChars`
成功した Bash または PowerShell コマンドの出力 Claude が受け取るインライン の文字数を設定します。出力が制限を超える場合、Claude Code はそれをファイルに保存し、Claude は短いプレビューとファイルのパスを受け取ります。詳細なビルドまたは完全なテストスイートログなどのコマンド出力がデフォルトを定期的に超過し、Claude がファイルを開かずに読み取ることを希望する場合は、制限を引き上げます。Claude Code v2.1.261 以降が必要です。
スコープ : 任意のファイル
タイプ : 文字数。正の整数。Claude Code はこの値を 4000 から 128000 の範囲に制限します
デフォルト : 未設定。Claude は最大 30,000 文字をインラインで受け取ります
{
"bashOutputMaxChars" : 100000
}
このキーを設定すると、Claude Code はBASH_MAX_OUTPUT_LENGTH 環境変数を無視します。
`claudeMd`
CLAUDE.md スタイルの指示を別のファイルをデプロイせずに組織管理メモリとして挿入します。Claude Code はテキストをユーザーおよびプロジェクト CLAUDE.md ファイルの前に管理メモリエントリとして読み込みます。
スコープ : 管理
タイプ : 文字列。CLAUDE.md ファイルのテキスト。ファイルのように記述します。Markdown を含め、改行は \n として記述します
デフォルト : 未設定
この例は 2 つのルールを短い Markdown リストとしてデプロイします。
{
"claudeMd" : "# Engineering rules\n\n- Always run make lint before committing.\n- Never push directly to main."
}
組織全体の CLAUDE.md をデプロイ を参照してください。
`claudeMdExcludes`
Claude Code がメモリ を読み込むときに特定の CLAUDE.md ファイルをスキップします。大規模なモノレポでは、これを使用して、作業に関連のない他のチームの CLAUDE.md ファイルをスキップします。大規模コードベースガイド の関連のない CLAUDE.md ファイルを除外するセクションでそのケースについて説明しています。パターンは絶対ファイルパスと照合されます。
スコープ : 任意のファイル
タイプ : 文字列の配列。各要素はグロブパターンまたは絶対パス
デフォルト : 未設定。Claude Code は見つかったすべての CLAUDE.md を読み込みます
{
"claudeMdExcludes" : [ "**/vendor/**/CLAUDE.md" ]
}
除外はユーザー、プロジェクト、ローカルメモリファイルにのみ適用されます。管理ポリシー CLAUDE.md ファイルは除外できません。
`env`
すべてのセッションと Claude Code がそこから開始するサブプロセスの環境変数を設定します。環境変数リファレンス の任意の変数をここに配置できます。これは 1 つをすべてのセッションに適用するか、チーム全体にロールアウトする方法です。プロジェクトおよびローカル設定はそれらの一部を設定できません 。
スコープ : 任意のファイル
タイプ : 変数名を文字列値にマップするオブジェクト
デフォルト : 未設定
この例は自動コンパクト化をオフにし、API リクエストをプロキシ経由でルーティングします。
{
"env" : {
"DISABLE_AUTO_COMPACT" : "1" ,
"ANTHROPIC_BASE_URL" : "https://proxy.example.com"
}
}
`env` 値がシェルとどのように相互作用するか
ここの値はシェルでエクスポートされた同じ変数を上書きします。複数の設定ファイルが変数を設定する場合、最も優先度の高い ものが適用されます。Claude Code が env で無視する変数 はプロジェクトおよびローカル設定の例外をリストします。
Claude Desktop アプリまたは自己ホスト環境 ランナーがセッションを開始する場合、それが構築する起動環境が代わりに優先されます。Claude Code は、起動環境がすでに設定している変数について、設定ファイルからの env 値を無視します。デバッグログ は無視された各変数の名前を付けます。
シェルエクスポートをキャンセルするには、変数を "" に設定します。Claude Code は空の値をプロバイダー選択の未設定として扱い、サブプロセスは空の値を継承します。
NO_COLOR と FORCE_COLOR をここで設定すると、サブプロセスにのみ到達します。Claude Code 自体のインターフェースカラーを変更するには、claude を起動する前にシェルで設定します。
ここの値は設定ファイルのプレーンテキストであり、Claude Code が開始するすべてのサブプロセスに到達します。ローテーションする OTLP ベアラートークンの場合はotelHeadersHelper を使用します。API 認証情報の場合はapiKeyHelper を使用します。
Claude Code が `env` 値を適用するタイミング
ユーザー設定、--settings、管理設定から: 起動時、および実行中のセッションでマージされた env を変更する保存された変更がある場合。
プロジェクトおよびローカル設定から: ワークスペースを信頼した後、または -p モード(信頼ダイアログを表示しない)での起動時、およびマージされた env を変更する保存された変更がある場合。
Claude Code がモデル選択、タイムアウトと制限、機能トグルなどの安全として分類する変数: プロジェクトおよびローカル設定が設定できない変数 を除き、すべての設定ファイルから起動時。
v2.1.246 以降で/cd でセッションを移動した後: 新しいディレクトリのプロジェクトおよびローカル env 値。前のディレクトリの上に。
Claude Code が `env` で無視する変数
プロジェクトおよびローカル設定は、チェックアウトされたリポジトリが制御すべきではない変数を設定できません。代わりにシェル、ユーザー設定、または管理設定で設定します。Claude Code は各変数をドロップし、claude --debug で確認できる警告をログに記録します。これらには以下が含まれます。
Claude Code が独自のファイルを保存または書き込む場所を選択する変数: CLAUDE_CONFIG_DIR、CLAUDE_CODE_TMPDIR、および HOME、TMPDIR、TMP、TEMP、XDG_* ファミリーなどのオペレーティングシステムディレクトリ変数。
セッションコンテンツをエクスポートする変数: OTEL_LOG_RAW_API_BODIES および詳細なベータトレーシングペア ENABLE_BETA_TRACING_DETAILED と BETA_TRACING_ENDPOINT。
OpenTelemetry エクスポーター 変数。テレメトリをオンにする、どこに送信するかを選択する、またはどのコンテンツをキャプチャするかを選択します。
CLAUDE_CODE_ENABLE_TELEMETRY。拡張テレメトリベータペア CLAUDE_CODE_ENHANCED_TELEMETRY_BETA と ENABLE_ENHANCED_TELEMETRY_BETA
エクスポーターセレクター OTEL_LOGS_EXPORTER、OTEL_METRICS_EXPORTER、OTEL_TRACES_EXPORTER
コンテンツ変数 OTEL_LOG_USER_PROMPTS、OTEL_LOG_ASSISTANT_RESPONSES、OTEL_LOG_TOOL_CONTENT、OTEL_LOG_TOOL_DETAILS
OTEL_EXPORTER_OTLP_* 変数。名前が _ENDPOINT、_HEADERS、_PROTOCOL、_CERTIFICATE、_CLIENT_KEY、_INSECURE で終わります。汎用およびシグナルごとの形式。OTEL_EXPORTER_OTLP_ENDPOINT と OTEL_EXPORTER_OTLP_METRICS_HEADERS など
OTEL_EXPORTER_PROMETHEUS_HOST と OTEL_EXPORTER_PROMETHEUS_PORT
これらの値のみがプロジェクトおよびローカル設定から適用されます。何かをオフにするため: 3 つのエクスポーターセレクターの場合は none。OTEL_LOG_USER_PROMPTS、OTEL_LOG_TOOL_CONTENT、OTEL_LOG_TOOL_DETAILS の場合は 0 などのオフ値。そのような値はユーザー設定で同じ変数をオーバーライドしますが、環境で Claude Code を起動するもの、--settings ファイル、または管理設定は設定しません。
プロジェクトまたはローカル設定ファイルがこのグループの変数を設定する場合、ローカルインタラクティブセッションは起動時に通知を表示します。/status または claude doctor を実行して、Claude Code が無視したものと、テレメトリをオフにしたものを確認します。両方とも名前をリストします。値は決してリストしません。-p を使用した非インタラクティブ実行または Agent SDK セッションは通知を表示しないため、アップグレード後にコレクターがデータを受け取り続けるかどうかを確認します。受け取らない場合は、ユーザー設定、管理設定、ジョブの環境、または --settings で渡すファイルで変数を設定します。
プロジェクトおよびローカル設定でこのグループを無視するには Claude Code v2.1.282 以降が必要です。
Claude Code の起動またはシンク方法を変更する変数。CLAUDE_CODE_PROCESS_WRAPPER、CLAUDE_CODE_SYNC_SKILLS、CLAUDE_CODE_SYNC_PLUGINS、CLAUDE_CODE_PLUGIN_CACHE_DIR、CLAUDE_CODE_PLUGIN_SEED_DIR など。
v2.1.251 より前は、プロジェクトおよびローカル設定は HOME と XDG_CONFIG_HOME を除き、このリストが名前を付けるファイルの保存または書き込み場所を選択する変数、またはセッションコンテンツをエクスポートする変数を設定できました。
Claude Code のホスティング環境が所有する CLAUDE_CODE_REMOTE や CLAUDE_CODE_ACCOUNT_UUID などのアイデンティティ変数は、すべてのファイルから無視されます。
CLAUDE_CODE_MESSAGING_SOCKET と CLAUDE_CODE_MESSAGING_TOKEN 。Claude Code 自体がエクスポートするものは、すべてのファイルから無視されます。ソケット変数を無視するには Claude Code v2.1.224 以降が必要で、トークンを無視するには v2.1.228 以降が必要です。
CLAUDE_CODE_PROJECT_DIR_NAME 。Claude Code は起動環境からのみ読み取ります。すべてのファイルから無視されます。v2.1.234 以降が必要です。
CLAUDE_CODE_RESTRICTED 。Claude Code は起動環境からのみ読み取ります。すべてのファイルから無視されます。
CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY 。Claude Code は起動環境からのみ読み取ります。すべてのファイルから無視されます。この変数には Claude Code v2.1.283 以降が必要です。
CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT と CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT 。Claude Code は起動環境からのみ読み取ります。すべてのファイルから無視されます。
`fileCheckpointingEnabled`
各編集の前にファイルをスナップショットして、/rewind がそれらを復元できるようにします。/config に**コードを巻き戻す(チェックポイント)**として表示され、そこで切り替えるとこのキーがユーザー設定に書き込まれます。
スコープ : 任意のファイル
タイプ : ブール値
true: Claude Code は各編集の前にファイルをスナップショットして、/rewind がそれらを復元できるようにします
false: Claude Code はファイルをスナップショットしないため、/rewind はそれらを復元できません
デフォルト : true
セッションごとのオーバーライド : CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING は 1 つのセッションのチェックポイント作成をオフにします。2 つのうちどちらかがオフにすると、もう一方はオンに戻すことができません
{
"fileCheckpointingEnabled" : false
}
-p 実行または Agent SDK セッションでは、Claude Code はこのキーを無視します。SDK は enableFileCheckpointing オプションでチェックポイント作成をオンにし、ベアの -p 実行には CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING=true が必要です。Agent SDK でのファイルチェックポイント作成 を参照してください。
`plansDirectory`
Claude Code が計画モード で書き込む計画ファイルを保存する場所を選択します。Claude Code はパスをプロジェクトルートを基準に解決し、パスがそれの外側に解決される場合はデフォルトを保持します。
スコープ : 任意のファイル
タイプ : 文字列。プロジェクトルートを基準とした相対パス
デフォルト : 未設定。Claude Code は ~/.claude/plans を使用します
{
"plansDirectory" : "./plans"
}
`skillListingBudgetFraction`
各ターンで、Claude はスキルのリスト とその説明を見ます。Claude Code はそのリスティングをコンテキストウィンドウのシェアで上限に設定します。リスティングが上限を超える場合、Claude Code はすべてのスキルの名前を保持しますが、最も使用されていないスキルの説明をドロップします。Claude はそれらのスキルを呼び出すことはできますが、独自に選択する可能性は低くなります。このキーを引き上げて、ターンごとにより多くのコンテキストを消費する代わりに、より多くの説明を表示させます。
スコープ : 任意のファイル
タイプ : 数値。0 より大きく、最大 1 の分数
デフォルト : 0.01。コンテキストウィンドウの 1% を予約します
{
"skillListingBudgetFraction" : 0.02
}
リスティングがどの程度のコンテキストを使用し、どのスキルが最も貢献しているかを確認するには、/doctor を実行します。
`skillListingMaxDescChars`
各ターンで、Claude はスキルのリスト を見ます。これは各スキルの description と when_to_use テキストを表示します。このキーは Claude Code がスキルごとに表示するそのテキストの文字数を上限に設定します。より長いテキストは上限で切り詰められます。
スコープ : 任意のファイル
タイプ : 文字数。正の整数
デフォルト : 1536
{
"skillListingMaxDescChars" : 2048
}
ターンごとにより多くのコンテキストを消費する代わりに、長い説明を完全に保つために引き上げます。skillListingBudgetFraction の下により多くのスキルを適合させるために引き下げます。
`taskOutputMaxChars`
v2.1.276 を通じて、このキーをバックグラウンドタスク の出力の文字数に設定しました。Claude が TaskOutput ツールでタスクを読み取るときにインラインで受け取ります。
インターフェースとターミナル
Claude Code がターミナルでどのように見え、動作するかを変更します。テーマ、エディタモード、ステータスライン、スピナー、セッション内の通知、アクセシビリティなどです。ターミナル設定 を参照してください。
`askUserQuestionTimeout`
回答されていないAskUserQuestion ダイアログがアイドル時間の経過後に自動的に続行し、既に選択していたオプションを送信するようにします。席を離れて Claude に続行させたい場合に設定します。デフォルトでは、質問は回答されるまで待機します。Claude Code v2.1.200 以降が必要です。
{
"askUserQuestionTimeout" : "5m"
}
/config に質問の自動続行タイムアウト として表示され、このキーをユーザー設定に書き込みます。マネージド設定または --settings フラグがキーを設定している場合、Claude Code は行を非表示にします。Claude Code v2.1.200 以降が必要です。
`autoContinueAtUsageLimit`
claude.ai の使用制限がセッションを停止した後、開いているセッションで待機し、リセット後にタスクを自動的に続行します。自動続行をオフにする を参照してください。Claude Code v2.1.234 以降が必要です。
スコープ : ユーザーまたはマネージド 。ユーザー設定、--settings、およびマネージド設定からのみ読み取ります。これらのいずれもキーを設定しない場合、プロジェクトまたはローカル設定ファイルがキーを設定すると、機能は無視されるのではなくオフになります。
タイプ : ブール値
true: claude.ai の使用制限がセッションを停止した後、Claude Code は開いているセッションで待機し、リセット後にタスクを自動的に続行します
false: Claude Code は独自に待機を開始しません。使用制限オプションメニューから自分で待機を開始 できます
デフォルト : true
{
"autoContinueAtUsageLimit" : false
}
/config に使用制限で自動的に続行 として表示され、このキーをユーザー設定に書き込みます。マネージド設定または --settings フラグがキーを設定している場合、Claude Code は行を非表示にします。
フルスクリーンレンダリング で会話の下部に新しい出力を追従します。オフにすると、Claude が作業を続ける間、スクロールした場所に留まります。権限プロンプトは引き続き表示されます。
スコープ : 任意のファイル
タイプ : ブール値
true: 会話は新しい出力の下部に追従します
false: Claude が作業を続ける間、スクロールした場所に留まります。権限プロンプトはトランスクリプトの下に表示されます
デフォルト : true
{
"autoScrollEnabled" : false
}
/config にフルスクリーンレンダリングがオンの場合自動スクロール として表示され、このキーをユーザー設定に書き込みます。
`axScreenReader`
スクリーンリーダーフレンドリーな出力をレンダリングします。装飾的なボーダーやアニメーションのないフラットテキストです。スクリーンリーダーモードはクラシックレンダラーを使用するため、アクティブな間は tui 設定は効果がありません。接続されたバックグラウンドセッション は引き続きフルスクリーンでレンダリングされます。
スコープ : 任意のファイル
タイプ : ブール値
true: Claude Code は装飾的なボーダーやアニメーションのないフラットテキストをレンダリングし、クラシックレンダラーを使用します
false: Claude Code は通常通りレンダリングします
デフォルト : 未設定、スクリーンリーダーモードはオフです
セッションごとのオーバーライド : --ax-screen-reader は CLAUDE_AX_SCREEN_READER より優先され、両方ともこのキーより優先されます
{
"axScreenReader" : true
}
`bashEditDiffEnabled`
Bash コマンドの実行中に Git リポジトリで変更されたファイルを Claude Code が記録するかどうかを選択します。記録する場合、コマンド後にターミナルでそれらの diff が表示され、PostToolUse Bash フック は変更されたファイルのリストを受け取ります。
リストされたファイルは常にコマンドが変更したものとは限りません。コマンドの実行中に別のプログラムまたは別の Bash 呼び出しが行った変更もそこに表示される可能性があります。
キーを true に設定して、すべての権限モードで記録します。Claude Code v2.1.269 以降が必要です。
スコープ : ユーザーまたはマネージド 。true はユーザー設定、--settings で渡された JSON、またはマネージド設定 からのみカウントされるため、リポジトリの .claude/settings.json または .claude/settings.local.json の true は記録をオンにできません。リポジトリファイルの false はより高い優先度 のファイルが true を設定しない限り、引き続きオフになります。
タイプ : ブール値
デフォルト : 未設定、Claude Code は自動モードと bypassPermissions モードで Claude が Bash を通じてファイルを編集するように指示する場合に変更を記録します
セッションごとのオーバーライド : CLAUDE_CODE_BASH_EDIT_DIFF はこのキーより優先されます
{
"bashEditDiffEnabled" : true
}
`companyAnnouncements`
スタートアップ時に組織のアナウンスメントをユーザーに表示します。複数をリストする場合、Claude Code は各セッションでランダムに 1 つを選択します。ユーザーの最初の起動時には最初のエントリが表示されます。
スコープ : 任意のファイル
タイプ : 文字列の配列
デフォルト : 未設定、アナウンスメントは表示されません
{
"companyAnnouncements" : [
"Welcome to Acme Corp! Review our code guidelines at docs.example.com"
]
}
`defaultShell`
入力ボックスで! プレフィックス で入力したシェルコマンド、Claude Code が直接実行してセッションに追加するコマンドを実行するかどうかを選択します。Bash または PowerShell。
"powershell" はPowerShell ツール がオンの場合のみ機能します。このツールは Git Bash のない Windows ではデフォルトでオンであり、Git Bash を使用する Windows では claude.ai および Console アカウント用にオンです。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry セッション、および macOS、Linux、WSL では、CLAUDE_CODE_USE_POWERSHELL_TOOL=1 を設定してツールをオンにします。そのツールをオフにするには、その変数を 0 に設定します。
スコープ : 任意のファイル
タイプ : 文字列、以下のいずれか:
"bash": Claude Code は ! コマンドを Bash で実行します
"powershell": Claude Code は ! コマンドを PowerShell で実行します
デフォルト : "bash"、または Bash が利用できない Windows では "powershell"
{
"defaultShell" : "powershell"
}
指定したシェルが利用できない場合、Claude Code は他方を使用します。"powershell" は PowerShell ツールがオフの場合 Bash にフォールバックし、"bash" は Bash がインストールされていない場合 PowerShell にフォールバックします。
`dialogExpiry`
Claude Code がリモートクライアントに転送 するダイアログ(Remote Control または SDK ホストなど)および保留中のクロスセッションメッセージ の承認ダイアログの期限を設定します。Claude Code v2.1.236 以降では、同じ期限が誰もターミナルにいない可能性があるセッションの途中のFable 使用クレジット同意プロンプト を制限します。期限前に回答が到着しない場合、Claude Code はダイアログをキャンセルし、デフォルトのアクションなしで続行します。Claude Code v2.1.224 以降が必要です。
{
"dialogExpiry" : "10m"
}
権限プロンプトとAskUserQuestion 質問は独自のフローを使用し、この期限の対象ではありません。Claude Code v2.1.232 以降では /config にダイアログの有効期限 として表示され、このキーをユーザー設定に書き込みます。行には Claude Code v2.1.232 以降が必要であり、マネージド設定または --settings フラグがキーを設定している場合、Claude Code は行を非表示にします。
`editorMode`
入力プロンプトのキーバインディングモードを選択します。
スコープ : 任意のファイル
タイプ : 文字列、以下のいずれか:
"normal": プロンプト入力の標準キーバインディング
"vim": NORMAL、INSERT、VISUAL モードを備えた vim スタイルの編集
デフォルト : "normal"
{
"editorMode" : "vim"
}
/config にエディタモード として表示され、このキーをユーザー設定に書き込みます。
`emojiCompletionEnabled`
プロンプト入力で : とショートコードを入力するときに絵文字の提案を表示し、:heart: などの完成したショートコードを絵文字に置き換えます。false に設定して両方をオフにします。
スコープ : 任意のファイル
タイプ : ブール値
true: Claude Code は : の後に絵文字の提案を表示し、完成したショートコードを絵文字に置き換えます
false: Claude Code は絵文字を提案せず、ショートコードを置き換えません
デフォルト : true
{
"emojiCompletionEnabled" : false
}
絵文字ショートコード を参照してください。Claude Code v2.1.217 以降が必要です。
`fileSuggestion`
組み込みのファイル提案の代わりに、@ ファイルパスオートコンプリートを提供する独自のコマンドを実行します。組み込み提案は高速ファイルシステムトラバーサルを使用します。大規模なモノレポは事前構築されたファイルインデックスなどのプロジェクト固有のインデックスでより良い結果が得られる場合があります。
スコープ : 任意のファイル 。ステータスラインとファイル提案ゲート の下では、Claude Code はコマンドをオフにするか、マネージド値のみを実行し、警告なしにあなたのコマンドをスキップします。
タイプ : type(常に "command")と command(実行するシェルコマンド)を持つオブジェクト
デフォルト : 未設定、Claude Code は組み込みのファイル提案を使用します
{
"fileSuggestion" : {
"type" : "command" ,
"command" : "~/.claude/file-suggestion.sh"
}
}
これを保存した後、プロンプトで @ に続けてパスの一部を入力します。提案はコマンドの出力から取得されます。
Claude Code はフック と同じ環境変数(CLAUDE_PROJECT_DIR を含む)でコマンドを実行し、5 秒後に待機を停止します。コマンドは stdin で query フィールドを持つ JSON を受け取ります。これまでに入力したものを保持します:
{ "query" : "src/comp" }
stdout にニューラインで区切られたファイルパスを出力します。Claude Code は最大 15 個を表示します:
src/components/Button.tsx
src/components/Modal.tsx
src/components/Form.tsx
次のスクリプトはクエリを読み取り、リポジトリファイルインデックスに渡します:
query=$(cat | jq -r '.query' )
your-repo-file-index --query "$query" | head -20
ターン出力(ツール結果(ファイルコンテンツと取得されたページを含む)および Claude 自身の応答)に正規表現がマッチするときに、入力ボックスの下のフッターに追加のクリック可能なバッジをレンダリングします。プロジェクト CLI によって出力される ID(レビューツールおよび問題トラッカーなど)をセッションリンクに変換するために使用します。
スコープ : ユーザーまたはマネージド
タイプ : オブジェクトの配列。各オブジェクトは type を "regex" に設定し、pattern 正規表現、url テンプレート、およびオプションの label を持ちます。url および label の {name} プレースホルダーは pattern の名前付きキャプチャグループから入力されます
デフォルト : 未設定、バッジはレンダリングされません
この例は PROJ-1234 などの問題キーにマッチし、キャプチャされたキーから各リンクを構築します:
{
"footerLinksRegexes" : [
{
"type" : "regex" ,
"pattern" : "\\b(?<key>PROJ-\\d+)\\b" ,
"url" : "https://issues.example.com/browse/{key}" ,
"label" : "{key}"
}
]
}
これが設定されている場合、PROJ-1234 がツール結果または Claude の応答に表示されると、PROJ-1234 バッジがフッターに表示され、https://issues.example.com/browse/PROJ-1234 にリンクします。
バッジの制約
各エントリの URL、ラベル、およびバッジ数は次のように制限されます:
制約
動作
URL オリジン
キャプチャされた値は URL エンコードされ、構築された URL はテンプレートのリテラルオリジンを共有する必要があります。キャプチャはパスセグメントまたはクエリ値を入力できますが、リンクが指す場所を変更することはできません
URL 長
2048 文字より長い構築された URL は削除されます
URL スキーム
https、http、または認識されたエディタまたはワークスペースディープリンクスキーム: vscode、vscode-insiders、cursor、windsurf、zed、jetbrains、idea、slack、linear、notion、figma である必要があります
ラベル
マッチしたテキストにデフォルト設定され、28 表示列に切り詰められます
バッジ数
最大 5 個のバッジがレンダリングされます。最も古いものは新しいマッチに置き換えられ、/clear はそれらを削除します
ターンが完了すると、Claude Code はメインスレッドでターン出力に対して各エントリの pattern 正規表現をマッチングするため、遅い正規表現は完了するまで UI をブロックします。(a+)+$ などのネストされた量指定子は特定の入力に対して指数関数的に長くかかり、セッションをフリーズさせる可能性があるため、各 pattern を線形に保ち、+ または * のネストを避けてください。
フッターバッジはカスタムステータスライン が設定されている場合と並んでレンダリングされます。どちらも他方を置き換えません。セッションデータから独自のコンテンツを計算するスクリプト駆動行にはステータスラインを使用し、会話から ID をリンクに変換するにはフッターバッジを使用します。
`keybindingFlavor`
v2.1.238 から v2.1.260 では、"readline" に設定すると Ctrl+W は前の単語だけでなく前の空白文字に戻って削除されました。
スコープ : 任意のファイル
タイプ : 文字列、"classic" または "readline"
デフォルト : 未設定
`maxProseWidth`
Claude の応答の散文の幅を制限して、行が広いターミナルで読みやすく保ちます。段落、見出し、リスト、およびブロック引用はこの多くの列内でラップされ、テーブルとコードブロックはターミナルの全幅を保ちます。Claude Code v2.1.282 以降が必要です。
スコープ : 任意のファイル
タイプ : ターミナル列の数、整数、最小 40。Claude Code は他の値を無視します
デフォルト : 未設定、散文はターミナルエッジでラップされます
{
"maxProseWidth" : 80
}
`prefersReducedMotion`
スピナー、シマー、フラッシュエフェクトなどのインターフェースアニメーションを削減またはオフにします。/config にモーションを削減 として表示されます。
スコープ : 任意のファイル
タイプ : ブール値
true: Claude Code はスピナー、シマー、フラッシュエフェクトなどのインターフェースアニメーションを削減またはオフにします
false: 未設定と同じです。Claude Code はアニメーションを表示します
デフォルト : false
{
"prefersReducedMotion" : true
}
`promptSuggestionEnabled`
プロンプト提案 を表示または非表示にします。プロンプト入力に表示される灰色の予測です。false に設定するか、/config でプロンプト提案 をオフにして非表示にします。
{
"promptSuggestionEnabled" : false
}
プロンプト提案には、テレメトリがオンの claude.ai または Console アカウントが必要です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または DISABLE_TELEMETRY によるテレメトリがオフの場合、このキーは効果がなく、CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=1 のみがそれらをオンにします。
`respectGitignore`
@ ファイルピッカーが .gitignore パターンにマッチするファイルを除外するかどうかを制御します。/config にファイルピッカーで .gitignore を尊重 として表示されます。
スコープ : 任意のファイル 。設定ファイルがそれを設定しない場合、Claude Code は ~/.claude.json の respectGitignore にフォールバックします。これは /config トグルが書き込みます。
タイプ : ブール値
true: @ ファイルピッカーは .gitignore パターンにマッチするファイルを除外します
false: @ ファイルピッカーは .gitignore パターンにマッチするファイルを含めます
デフォルト : true
{
"respectGitignore" : false
}
`respondToBashCommands`
入力ボックスで! プレフィックス でシェルコマンドを実行した後、Claude が応答するかどうかを選択します。デフォルトでは、Claude Code はコマンドの出力を会話に追加し、Claude がそれに応答します。このキーを false に設定して、応答なしでコンテキストに出力を追加し、複数のコマンドを実行して一緒に質問できるようにします。
スコープ : 任意のファイル
タイプ : ブール値
true: Claude Code はコマンドの出力を会話に追加し、Claude がそれに応答します
false: Claude Code は応答なしでコンテキストに出力を追加します
デフォルト : true
{
"respondToBashCommands" : false
}
! プレフィックスでシェルモード を参照してください。
`showClearContextOnPlanAccept`
Claude がプランモード でプランを完了すると、承認メニューが表示されます。計画は多くのコンテキストを使用できるため、このキーはそのメニューに最初のオプションはい、コンテキストをクリアして… を追加します。これはプランを承認し、会話コンテキストをクリアし、プランだけから実装を開始します。ラベルの残りはセッションが続く権限モードに名前を付け、計画がコンテキストをどの程度使用したかを示します。
スコープ : 任意のファイル
タイプ : ブール値
true: プラン承認メニューは最初のオプションはい、コンテキストをクリアして… を取得します。これはプランを承認し、会話コンテキストをクリアします
false: プラン承認メニューはクリアコンテキストオプションを表示しません
デフォルト : false
{
"showClearContextOnPlanAccept" : true
}
`showTurnDuration`
各応答後のターン期間メッセージを表示または非表示にします。例えば「Cooked for 1m 6s · done 6:05 PM」。「done」の後の時計はターンが完了した時刻を示します。timeFormat と timeZone はその形式とゾーンを制御します。/config にターン期間を表示 として表示されます。
スコープ : 任意のファイル 。古いバージョンの ~/.claude.json の値は、設定ファイルがそれを設定しない場合に適用されます。
タイプ : ブール値
true: 各応答後にターン期間メッセージが表示されます
false: Claude Code はターン期間メッセージを非表示にします
デフォルト : true
{
"showTurnDuration" : false
}
`spellcheck`
入力時にプロンプト入力でスペルミスのある単語に下線を引きます。インストールするスペルチェッカーを使用します。Claude Code はプロンプト入力ボックスのテキストのみをチェックします。入力時にスペルをチェック は aspell、hunspell、または ispell のインストールとチェッカーがカバーするものについて説明しています。Claude Code v2.1.235 以降が必要です。
スコープ : ユーザーまたはマネージド 。それを設定する最高層のブロックが全体として適用されます。
タイプ : enabled(ブール値)、checker("aspell"、"hunspell"、"ispell"、または "auto")、language(文字列、チェッカーの辞書名として渡される)、および color(文字列、ターミナルカラー名、#rrggbb、rgb(r,g,b)、ansi256(n)、または ansi:<name>)を持つオブジェクト
デフォルト : 未設定、スペルチェックはオフです。checker はデフォルトで "auto"、PATH で見つかった最初の 3 つです。language はデフォルトでチェッカー自身の辞書です。color はデフォルトでテーマのエラーカラーです
{
"spellcheck" : { "enabled" : true, "language" : "en_GB" }
}
`spinnerTipsEnabled`
Claude が作業している間、スピナーラインは「Plan Mode を使用して複雑なリクエストに備えてから変更を加えます。Shift+Tab を 2 回押して有効にします」などの Claude Code 機能に関する短いヒントをローテーションします。このキーを false に設定して非表示にします。/config にヒントを表示 として表示されます。
スコープ : 任意のファイル
タイプ : ブール値
true: Claude が作業している間、スピナーにヒントが表示されます
false: Claude Code はスピナーヒントを非表示にします
デフォルト : true
{
"spinnerTipsEnabled" : false
}
`spinnerTipsOverride`
Claude Code が Claude の作業中に表示するスピナーヒント に独自のヒントを追加するか、組み込みヒントを置き換えます。Claude Code はあなたのヒントを組み込みのものと同じローテーションに入れます。
spinnerTipsEnabled を false に設定すると、Claude Code はすべてのヒント(あなたのものを含む)を非表示にします。
スコープ : 任意のファイル 。Claude Code はヒントオブジェクト、tipsFile、label、および excludeDefault をユーザー設定、--settings フラグ、およびマネージド設定から尊重します。プロジェクトおよびローカル設定からは、プレーン文字列ヒントのみを読み取ります。
タイプ : tips、tipsFile、label、および excludeDefault フィールドを持つオブジェクト。各フィールドはオプションです
デフォルト : 未設定、Claude Code は組み込みヒントのみを表示します
ヒントオブジェクト、tipsFile、label、およびスコープ行のルール(プロジェクトおよびローカル設定がプレーン文字列のみを提供)には Claude Code v2.1.247 以降が必要です。
各 tips エントリはプレーン文字列またはこれらのフィールドを持つオブジェクトです:
フィールド
必須
説明
id
はい
最大 64 文字、数字、.、_、または -。Claude Code はヒントの表示履歴をキーにするため、ヒントのクールダウンはリストの並べ替えを生き残ります。同じ id を持つ 2 つのエントリのうち、Claude Code は最初のものを使用します
text
はい
ヒント、最大 500 文字の 1 行。Claude Code は ANSI エスケープと制御文字を削除し、空白を折りたたみます
cooldownSessions
いいえ
Claude Code がヒントを再度表示する前に待機するセッション数、0 から 1000、デフォルト 0
priority
いいえ
同じ期間表示されていないヒント間の順序、より高い最初、-10 から 10、デフォルト 0
Claude Code はプレーン文字列をこれらのデフォルトを持つヒントとして読み取り、位置ベースの id を読み取るため、リストを並べ替えるとその表示履歴がリセットされます。ヒントに id を付けて、編集全体で履歴を保持します。
Claude Code は tips と tipsFile 全体で最大 200 個のヒントを読み取り、設定ファイルを拒否する代わりに、デバッグ警告で無効なエントリを削除します。
残りのフィールドを使用して、ヒントファイルに名前を付け、プレフィックスを設定し、組み込みヒントを非表示にします:
tipsFile: ローカル JSON ファイルへの絶対パスまたは ~/ パス。同じエントリの配列、またはオブジェクト(tips 配列を持つ)を保持します。最大 256 KB。Claude Code はプロセスごとに 1 回ファイルを読み取るため、次の起動時に編集が読み込まれます。サーバー管理設定 を通じて設定することはできません。インライン tips をそこに展開するか、オンディスク managed-settings.json にパスを展開します。
label: Claude Code がユーザー、--settings、およびマネージド設定からのヒントの前に表示するプレフィックス。最大 40 文字。デフォルトは Tip、組み込みヒントと同じプレフィックスであり、プロジェクトおよびローカル設定からのヒントは常にそれを使用します。
excludeDefault: true に設定して、組み込みヒントを非表示にし、あなたのヒントのみを表示します。Claude Code がヒントを読み込めない場合(例えば tipsFile が存在しないか、すべてのエントリが無効な場合)、空のスピナーの代わりに組み込みローテーションを保持します。
複数の設定ファイルがキーを設定する場合、Claude Code はすべてのファイルからヒントを表示し、マネージド設定、--settings フラグ、およびユーザー設定のうち、各 tipsFile、label、および excludeDefault を設定する最高優先度のものから取得します。
この例(ユーザー設定)は、プレーン文字列ヒントとオブジェクトヒントを Acme tip プレフィックスの下のローテーションに追加します:
{
"spinnerTipsOverride" : {
"label" : "Acme tip" ,
"tips" : [
"Run /review before opening a PR" ,
{
"id" : "gateway-errors" ,
"text" : "Seeing 5xx errors? Check the gateway status page first" ,
"cooldownSessions" : 5,
"priority" : 2
}
]
}
}
例の各フィールドは Claude Code がヒントを表示する方法の 1 つを変更します:
label: Claude Code は両方のヒントを Tip: ... の代わりに Acme tip: ... として表示します。
プレーン文字列: Claude Code はデフォルトを付与するため、次のセッションで再度表示される可能性があります。
id: Claude Code は 2 番目のヒントの表示履歴を gateway-errors にキーにするため、そのクールダウンはヒントを追加または並べ替えた後も適用されます。
cooldownSessions: Claude Code が gateway-errors ヒントを表示した後、そのヒントを 5 セッション後まで再度表示しません。
priority: gateway-errors ヒントと別のヒントが同じ期間表示されていない場合(例えば、どちらも表示されていない場合)、Claude Code は gateway-errors を最初に表示します。プレーン文字列はデフォルト優先度 0 を持ちます。
Claude が作業している間、Claude Code はあなたのプレフィックス(例えば Acme tip: Run /review before opening a PR)でスピナーにあなたのヒントを表示します。
`spinnerVerbs`
ターンが進行中の間、スピナーは「Accomplishing」、「Architecting」、または「Baking」などのローテーション動詞を表示します。このキーを使用して、そのローテーションに独自の動詞を追加するか、組み込みリストを置き換えます。
スコープ : 任意のファイル
タイプ : verbs 文字列の配列と mode を持つオブジェクト。以下のいずれか:
"append": Claude Code は組み込みセットに動詞を追加します
"replace": Claude Code はあなたの動詞のみを表示します
デフォルト : 未設定、Claude Code は組み込み動詞を使用します
この例は 2 つの動詞を組み込みセットに追加します:
{
"spinnerVerbs" : {
"mode" : "append" ,
"verbs" : [ "Pondering" , "Crafting" ]
}
}
"replace" モードで空の verbs 配列の場合、Claude Code は組み込み動詞を保持します。
`statusLine`
ステータスライン をプロンプトの下にレンダリングする独自のコマンドを実行します。モデル、コスト、git ブランチなどのコンテキストを含みます。オプションのフィールドは間隔を調整し、定期的な再実行を追加し、スクリプトが vim.mode 自体をレンダリングする場合は組み込みの vim モードインジケーターを非表示にします。
スコープ : 任意のファイル 。allowManagedHooksOnly がオンの場合、または disableAllHooks がマネージド設定の外で設定されている場合、マネージド設定値のみが実行されます。
タイプ : type を "command" に設定し、command 文字列を持つオブジェクト。オプションで padding を文字数として、refreshInterval を秒数として(最小 1)、hideVimModeIndicator をブール値として
デフォルト : 未設定、ステータスラインなし
この例はモデル名とコンテキスト使用量を出力し、2 文字の水平間隔を追加します:
{
"statusLine" : {
"type" : "command" ,
"command" : "jq -r '\" [ \\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'" ,
"padding" : 2
}
}
例にはjq がインストールされている必要があり、シェルで実行されます。PowerShell および Git Bash の同等物については、Windows 設定 を参照してください。完全なセットアップについては、ステータスラインを手動で設定 を参照してください。
`subagentStatusLine`
Claude がサブエージェント を実行する場合、Claude Code はプロンプトの下のタスク表示にそれらをリストします。サブエージェントごとに 1 行。name · description · token count を表示します。このキーを使用すると、独自のコマンドを実行してそれらの行を書き直すことができます。例えば、各サブエージェントのコンテキスト使用量をパーセンテージとして表示します。各リフレッシュで、Claude Code は表示されている行を 1 つの JSON オブジェクトとして stdin に送信します。tasks 配列は各サブエージェントの id、name、status、model、tokenCount などを含みます。書き直した各 id の行を {"id", "content"} 行として置き換えます。書き直さない行はデフォルトレンダリングを保持します。
{
"subagentStatusLine" : {
"type" : "command" ,
"command" : "jq -c '.tasks[] | {id, content: \" \\(.name): \\(.tokenCount) tokens\"}'"
}
}
サブエージェントステータスライン を参照してください。
`syntaxHighlightingDisabled`
Claude Code は組み込みハイライターを使用して、ターミナルに表示される diff、コードブロック、ファイルプレビューで言語別にコードを色付けします。プラグインまたは言語サーバーは関与しません。このキーを true に設定して、代わりにプレーンテキストとして表示します。例えば、色がターミナルテーマと競合する場合やスクリーンリーダーを遅くする場合。
スコープ : 任意のファイル
タイプ : ブール値
true: Claude Code は diff、コードブロック、ファイルプレビューの構文ハイライトをオフにします
false: Claude Code は構文をハイライトします
デフォルト : false
{
"syntaxHighlightingDisabled" : true
}
`terminalProgressBarEnabled`
一部のターミナルは、それらで実行されているプログラムのタブまたはタスクバーに進捗インジケーターを表示できます。Claude が作業している間、Claude Code はターミナルに進行中の状態を報告するため、別のタブまたはウィンドウからセッションがまだビジーかどうかを確認できます。バックグラウンドサブエージェント または動的ワークフロー がまだ実行されている間、インジケーターはターンの終了後も表示されたままになり、セッションがアイドル状態になるとクリアされます。
Claude Code はインジケーターをサポートするターミナルでのみ報告します。ConEmu、Ghostty 1.2.0 以降、および iTerm2 3.6.6 以降。このキーを false に設定して、Claude Code がそれを報告するのを停止します。/config にターミナル進捗バー として表示されます。
スコープ : 任意のファイル 。古いバージョンの ~/.claude.json の値は、設定ファイルがそれを設定しない場合に適用されます。
タイプ : ブール値
true: サポートするターミナルでターミナル進捗バーが表示されます
false: Claude Code はターミナル進捗バーを非表示にします
デフォルト : true
{
"terminalProgressBarEnabled" : false
}
`terminalTitleFromRename`
Claude Code はターミナルタブのタイトルを設定します。デフォルトでは、会話から生成されたタイトルを使用し、/rename または --name でセッションに名前を付ける と、タブはその名前を代わりに表示します。このキーを false に設定して、セッションに名前を付けた後も、生成されたタイトルをタブに保持します。名前自体は引き続き適用されるため、/resume <name> とセッションピッカーはそれを見つけます。
スコープ : 任意のファイル
タイプ : ブール値
true: ターミナルタブのタイトルは設定したセッション名を表示します
false: タブは会話から生成された Claude Code のタイトルを保持します
デフォルト : true
{
"terminalTitleFromRename" : false
}
Claude Code がターミナルタイトルを更新するのを完全に停止するには、代わりに CLAUDE_CODE_DISABLE_TERMINAL_TITLE を 1 に設定します。
`theme`
インターフェースのカラーテーマを選択します。/config にテーマ として表示されます。
スコープ : 任意のファイル 。古いバージョンの ~/.claude.json の値は、設定ファイルがそれを設定しない場合に適用されます。
タイプ : 文字列、以下のいずれか:
"auto": ターミナルの明るいまたは暗い背景に一致します
"dark": ダークテーマ
"light": ライトテーマ
"dark-daltonized": 色覚異常フレンドリーな色を持つダークテーマ
"light-daltonized": 色覚異常フレンドリーな色を持つライトテーマ
"dark-ansi": ターミナルの ANSI カラーパレットのみを使用するダークテーマ
"light-ansi": ターミナルの ANSI カラーパレットのみを使用するライトテーマ
"custom:<slug>" または "custom:<plugin-name>:<slug>": ~/.claude/themes/ またはプラグインからのカスタムテーマ
デフォルト : "dark"
{
"theme" : "light-daltonized"
}
カスタムテーマを作成 を参照してください。
Claude Code がインターフェースに表示する時刻の書き方を選択します。例えば、各ターン期間メッセージの終わりの done 6:05 PM とトランスクリプトビューアー のタイムスタンプ。プリセットを選択するには、/config を実行して時間形式 を設定します。Claude Code v2.1.257 以降が必要です。
スコープ : 任意のファイル
タイプ : 文字列、以下のいずれか:
"auto": 未設定と同じです。各時刻は組み込み形式を保持し、ターン期間メッセージではロケールに従います
"12-hour": 12 時間制
"24-hour": 24 時間制
"24-hour-utc": UTC での 24 時間制。分の後に Z が付きます。例えば 18:05Z。Claude Code はこのプリセットの timeZone を無視します
"%H:%M" などの strftime パターン: Claude Code はパターンで各時刻を書きます。% を含む値はパターンであり、プリセット外の他の値は "auto" としてカウントされます
デフォルト : "auto"
{
"timeFormat" : "24-hour"
}
/config はプリセットのみを提供するため、strftime パターンを使用するには、キーを設定ファイルに追加します。この例は各時刻を 2 桁の 24 時間制として表示します:
{
"timeFormat" : "%H:%M"
}
ターン期間メッセージとトランスクリプトビューアーは 18:05 などの時刻を表示します。トランスクリプトビューアーでは、パターンはタイムスタンプ全体であるため、日付をそこに含める場合は日付ディレクティブを追加します。この例は時計の前に日付を配置します:
{
"timeFormat" : "%Y-%m-%d %H:%M"
}
同じサーフェスは 2026-09-01 18:05 などの時刻を表示します。
`timeZone`
インターフェースの時刻をシステムの時刻以外のタイムゾーンで表示します。IANA タイムゾーン名 ("UTC" または "Europe/Dublin" など)に設定します。timeFormat が制御する時刻はこのゾーンで表示されます。timeFormat が "24-hour-utc" の場合、時刻は UTC のままであり、Claude Code はこのキーを無視します。/config にはこのキーの行がないため、設定ファイルで設定します。Claude Code v2.1.257 以降が必要です。
スコープ : 任意のファイル
タイプ : 文字列、IANA タイムゾーン名。Claude Code が名前を認識しない場合、システムタイムゾーンを使用します
デフォルト : 未設定、時刻はシステムタイムゾーンで表示されます
{
"timeZone" : "Europe/Dublin"
}
`tui`
ターミナル UI レンダラーを選択します。ちらつきのないalt-screen レンダラー を仮想スクロールバックで使用するには "fullscreen" を使用するか、クラシックメインスクリーンレンダラーには "default" を使用します。/tui fullscreen または /tui default を実行すると、このキーが書き込まれます。
スコープ : 任意のファイル
タイプ : 文字列、以下のいずれか:
"default": クラシックメインスクリーンレンダラー
"fullscreen": 仮想スクロールバック付きのちらつきのない alt-screen レンダラー
デフォルト : 未設定、Claude Code はレンダラーを自動的に選択 します
セッションごとのオーバーライド : CLAUDE_CODE_NO_FLICKER と CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN はこのキーより優先されます。CLAUDE_CODE_NO_FLICKER=1 はフルスクリーンをオンにし、CLAUDE_CODE_NO_FLICKER=0 または CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 はオフにします。両方が設定されている場合、Claude Code はオフにします
{
"tui" : "fullscreen"
}
tmux -CC の下または Windows への SSH 経由では、Claude Code は CLAUDE_CODE_NO_FLICKER=1 を設定しない限りクラシックレンダラーを保持します。エージェントビュー から開かれたバックグラウンドセッションは、この設定に関係なく常にフルスクリーンレンダラーを使用します。
`verbose`
デフォルトでは、トランスクリプトは各ツール呼び出しを短い要約に折りたたみます。例えば、Claude が実行したコマンドと出力の行数。詳細を表示したい場合は Ctrl+O を押してトランスクリプト全体を展開ビューに切り替えます。このキーを true に設定して、すべてのツール呼び出しの完全な入力と出力をインラインで表示します。フック、MCP サーバー、または長いシェルコマンドをデバッグする場合に便利です。/config に詳細出力 として表示されます。
スコープ : 任意のファイル 。古いバージョンの ~/.claude.json の値は、設定ファイルがそれを設定しない場合に適用されます。
タイプ : ブール値
true: 完全なツール出力が表示されます
false: ツール出力の切り詰められた要約が表示されます
デフォルト : false
セッションごとのオーバーライド : --verbose はこのキーより優先されます
{
"verbose" : true
}
viewMode 値またはスティッキー /focus 選択はこのキーを毎セッション上書きします。
`viewMode`
Claude Code が開始するトランスクリプトビューを設定します。"default"、"verbose"、または "focus"。設定されている場合、スティッキー /focus 選択と verbose 設定の両方を上書きします。
スコープ : 任意のファイル
タイプ : 文字列、以下のいずれか:
"default": 切り詰められたツール出力を持つ通常のトランスクリプト
"verbose": 完全なツール出力を持つトランスクリプト
"focus": 最後のプロンプトのみ、ツール呼び出しの 1 行の要約(編集 diffstats を含む)、および最終応答。フォーカスビューはフルスクリーンレンダラー が必要です
デフォルト : 未設定、verbose 設定と最後の /focus 選択が適用されます
セッションごとのオーバーライド : --verbose はこのキーより優先されます
{
"viewMode" : "focus"
}
`vimInsertModeRemaps`
vim エディタモード で 2 キーの INSERT モードシーケンスを Escape にマップします。各キーは正確に 2 つの印字可能文字で、順序で入力され、"<Esc>" は唯一のサポートされているターゲットです。Claude Code は他のエントリを無視します。Claude Code v2.1.208 以降が必要です。
スコープ : ユーザーまたはマネージド 。リポジトリはキーストロークを再マップできません。
タイプ : 2 文字シーケンスを "<Esc>" にマップするオブジェクト
デフォルト : 未設定
{
"vimInsertModeRemaps" : {
"jj" : "<Esc>"
}
}
editorMode が "vim" でない限り効果がありません。INSERT モードキーシーケンスを再マップ を参照してください。Claude Code v2.1.208 以降が必要です。
`voice`
音声ディクテーション をオンにし、ディクテーションキーの動作を選択します。Claude Code は /voice を実行するとこのオブジェクトを書き込みます。
スコープ : 任意のファイル
タイプ : enabled をブール値として、autoSubmit をホールドモードのみに適用するブール値として、mode を以下のいずれかとして持つオブジェクト:
"hold": ディクテーションキーを話している間押し続け、停止するために離します
"tap": キーを 1 回タップして記録を開始し、もう一度タップして送信します
デフォルト : 未設定、ディクテーションはオフです。enabled が true で mode が未設定の場合、Claude Code は "hold" を使用します
この例はディクテーションをオンにし、キーを 1 回タップして記録を開始し、もう一度タップして送信するようにします:
{
"voice" : {
"enabled" : true,
"mode" : "tap"
}
}
autoSubmit はホールドモードでキーを離すときにプロンプトを送信します。音声ディクテーションには claude.ai アカウントが必要です。
`voiceEnabled`
voice オブジェクトより前の単一ブール値形式で音声ディクテーションをオンにします。両方が設定されている場合、voice.enabled が適用されます。
スコープ : 任意のファイル
タイプ : ブール値
true: claude.ai アカウントでログインしており、組織のポリシーが音声を許可している場合、音声ディクテーションはオンです。voice.enabled が設定されていない限り
false: 音声ディクテーションはオフです。voice.enabled が設定されていない限り
デフォルト : 未設定
{
"voiceEnabled" : true
}
フルスクリーンレンダリング での高速スクロール中にマウスホイールスクロール速度を加速します。ホイールノッチごとに一定のスクロール速度を使用するには false に設定します。
スコープ : 任意のファイル
タイプ : ブール値
true: Claude Code は高速スクロール中にマウスホイールスクロール速度を加速します
false: Claude Code はホイールノッチごとに一定の速度でスクロールします
デフォルト : true
{
"wheelScrollAccelerationEnabled" : false
}
Git とアトリビューション
Claude Code がコミットとプルリクエストに追加するアトリビューションを制御し、git との連携方法を設定します。
`attribution`
Claude Code が git コミットとプルリクエストに追加するアトリビューションをカスタマイズします。コミットはデフォルトで Co-Authored-By などの git トレーラー を取得します。プルリクエストの説明はプレーンテキストを取得します。以下のサブキーを使用して各部分を個別に設定します。
スコープ : Any file
タイプ : commit と pr 文字列および sessionUrl ブール値を含むオブジェクト、または全てのアトリビューションを非表示にする false。false 値には Claude Code v2.1.281 以降が必要です。それより前のバージョンはこれを拒否し、それを含むユーザー、プロジェクト、またはローカル設定ファイル全体をスキップします
デフォルト : 未設定。Claude Code は各サブキーの下に表示される標準アトリビューションを使用します
全てのアトリビューションを非表示にするには、attribution を false に設定します。それより前のバージョンも読み込む設定ファイルでは、commit と pr を空の文字列に設定し、sessionUrl を false に設定してください。
この例はコミットアトリビューションを置き換え、プルリクエストアトリビューションを削除し、セッションリンクを削除します。
{
"attribution" : {
"commit" : "Generated with AI\n\nCo-Authored-By: AI <ai@example.com>" ,
"pr" : "" ,
"sessionUrl" : false
}
}
commit または pr を設定すると、Claude Code は非推奨の includeCoAuthoredBy 設定を無視し、設定しなかった方のデフォルトテキストを使用します。
Claude Code は、CLAUDE.md または memory ルールなど、アトリビューションに関するカスタマー独自の命令が、managed settings で設定されている場合を除き、これらのコミットおよび PR 行より優先されることを Claude に伝えます。
`includeCoAuthoredBy`
このキーを置き換える attribution を代わりに使用してください。これにより、コミットトレーラー、プルリクエストテキスト、セッションリンクを個別に変更または非表示にできます。Claude Code は attribution より前の設定ファイルからの includeCoAuthoredBy: false を引き続き尊重しますが、attribution.commit または attribution.pr を設定すると無視します。
スコープ : Any file
タイプ : ブール値
true: 未設定と同じ。Claude Code はコミットトレーラーとプルリクエストアトリビューションテキストを追加します
false: Claude Code はコミットトレーラーとプルリクエストアトリビューションテキストの両方を省略します。ただし、attribution が commit または pr を設定する場合は、attribution ルールが適用されます
デフォルト : true
{
"includeCoAuthoredBy" : false
}
全てのアトリビューションを非表示にするには、attribution を参照してください。
`includeGitInstructions`
Claude Code は git 関連の 2 つの部分をコンテキストとして Claude に提供します。Bash ツールの説明にあるコミットとプルリクエストの書き方に関する組み込み命令と、リポジトリの git ステータススナップショット(現在のブランチ、メインブランチ、git status 出力、最近のコミット)です。Claude Code はコンバーセーション開始時にスナップショットを読み込みます。
このキーを false に設定して両方を除外します。例えば、独自の git ワークフロースキルを使用する場合などです。
スコープ : Any file
タイプ : ブール値
true: Claude Code は組み込みのコミットおよびプルリクエストワークフロー命令と git ステータススナップショットを含めます。クラウドセッションはスナップショットを含めません
false: Claude Code は両方を除外します
デフォルト : true
セッションごとのオーバーライド : CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS はこのキーより優先されます(1 セッション)
{
"includeGitInstructions" : false
}
`prUrlTemplate`
Claude Code がレンダリングする PR リンク(フッターバッジとツール結果サマリー内)を github.com の代わりに内部コードレビューツールに指定します。Claude Code は PR URL から {host}、{owner}、{repo}、{number}、{url} を置き換えます。両方のサーフェス上の GitLab マージリクエスト リンクは GitLab URL を保持します。
スコープ : Any file
タイプ : 文字列。5 つのプレースホルダーのいずれかを使用する URL テンプレート
デフォルト : 未設定
{
"prUrlTemplate" : "https://reviews.example.com/{owner}/{repo}/pull/{number}"
}
Claude Code はそれ自体がレンダリングするリンクにのみテンプレートを適用します。Claude がメッセージに書き込む PR 番号(#123 など)は Claude が書き込んだままです。/pull/<number> の形状を持たない URL は変更されません。
`attribution.commit`
Claude Code が git コミットに追加するアトリビューションテキスト(トレーラーを含む)を設定します。コミットアトリビューションを非表示にするには、空の文字列に設定します。
スコープ : Any file
タイプ : 文字列
デフォルト : 未設定。Claude Code は Co-Authored-By: <name> <noreply@anthropic.com> を追加します。名前はコミットが作成されるときに使用されているモデル(Claude Sonnet 5 など)です。subagent がコミットを作成する場合、トレーラーは subagent のモデルに名前を付けます。
Claude Code がモデルを Claude モデルとして認識しているが、その正確なバージョンを確認できない場合、Claude のみを書き込みます。
モデル ID をカスタム ANTHROPIC_BASE_URL を通じて提供されるサードパーティモデルなど、Claude モデルと一致させることができない場合、Claude Code を書き込みます。
この例はデフォルトトレーラーをカスタム行とカスタム Co-Authored-By トレーラーに置き換えます。
{
"attribution" : {
"commit" : "Generated with AI\n\nCo-Authored-By: AI <ai@example.com>"
}
}
`attribution.pr`
Claude Code がプルリクエストの説明に追加するアトリビューションテキストを設定します。プルリクエストアトリビューションを非表示にするには、空の文字列に設定します。
スコープ : Any file
タイプ : 文字列
デフォルト : 未設定。Claude Code は 🤖 Generated with [Claude Code](https://claude.com/claude-code) を追加します
{
"attribution" : {
"pr" : ""
}
}
`attribution.sessionUrl`
Claude Code が クラウド または Remote Control セッションからコミットするか、プルリクエストを開くときに claude.ai セッションリンクを追加するかどうかを選択します。Claude Code はコミット上に Claude-Session トレーラーとしてリンクを追加し、プルリクエストの説明にリンクとして追加します。リンクを省略するには false に設定します。
スコープ : Any file
タイプ : ブール値
true: Claude Code はクラウドまたは Remote Control セッションからコミットするか、プルリクエストを開くときに claude.ai セッションリンクを追加します
false: Claude Code はリンクを省略します
デフォルト : true
{
"attribution" : {
"sessionUrl" : false
}
}
フック と自動化
フックを登録し、実行するフックを制限し、ワークフローを制御します。フックイベントとペイロードについては、フックリファレンス を参照してください。
`allowedHttpHookUrls`
HTTP フック がターゲットできる URL を制限します。このキーを定義すると、Claude Code は HTTP フックを実行するのはその URL がパターンの 1 つと一致する場合のみで、残りはブロックして実行しません。空の配列はすべての HTTP フックをブロックします。
スコープ : Any file 。配列は設定ファイル全体でマージされます。
型 : URL パターンの配列。ワイルドカード として * を使用
デフォルト : 未設定。任意の URL が許可されます
この例は https://hooks.example.com/ 下のすべての URL と任意の http://localhost URL を許可します:
{
"allowedHttpHookUrls" : [ "https://hooks.example.com/*" , "http://localhost:*" ]
}
ホスト名マッチングは大文字と小文字を区別せず、完全修飾ドメイン名を示す末尾のドット付きの hooks.example.com. を hooks.example.com と同じように扱います。これは DNS の扱い方と同じです。許可リストはすべてのソースからのフック(管理設定を含む)に適用されます。
`allowManagedHooksOnly`
フック実行を組織がデプロイするフックに制限します。
スコープ : Managed
型 : ブール値
デフォルト : 未設定。すべての設定スコープとプラグインからのフックが実行されます
{
"allowManagedHooksOnly" : true
}
`allowManagedHooksOnly` 下で実行されるもの
これを true に設定すると、Claude Code はどのフックとフック類似コマンドをロードするかを変更します:
このキーが設定されている間、/goal コマンドは実行できません。これはフックに依存しているためです。
`disableAllHooks`
フック 、カスタム ステータスライン 、カスタム ファイル提案 コマンドをオフにします。これらを設定から削除せずに一時的にオフにするために使用します。
スコープ : Any file 。管理設定のみが管理フックを無効にできます。
型 : ブール値
true: Claude Code はフック、カスタムステータスライン、カスタムファイル提案コマンドをオフにします
false: フック、ステータスライン、ファイル提案コマンドが実行されます
デフォルト : 未設定。フックが実行されます
{
"disableAllHooks" : true
}
到達範囲はキーを持つファイルによって異なります:
管理設定内 : Claude Code はすべての設定済みフック(管理フックを含む)を無効にし、Agent SDK がプロセス内で登録するフックは実行し続けます
他の設定ファイル内 : Claude Code はユーザー、プロジェクト、ローカル、プラグインフックを無効にします。管理フック、Agent SDK フック、管理 enabledPlugins で強制有効にされたプラグインからのフックは実行し続けます
管理設定がこのキーを設定している場合に Agent SDK フックを実行し続けるには、Claude Code v2.1.242 以降が必要です。
フックが無効な間、/goal コマンドは実行できず、/hooks メニューはフックの代わりに通知を表示します。
ステータスラインとファイル提案ゲート
Claude Code は statusLine、fileSuggestion、subagentStatusLine について、この順序で 2 つの決定を行います:
完全にオフ : 管理設定が disableAllHooks を設定している場合、またはフォルダが設定ファイル内のフックと同じ ワークスペーストラストルール の下で信頼されていない場合
管理設定に絞られます : allowManagedHooksOnly が設定されている場合、設定優先度 が適用された後に管理設定外で disableAllHooks が true である場合、または --safe-mode で Claude Code を起動した場合
絞られた場合 : Claude Code はデプロイされた管理値があれば実行します。そうでない場合は警告なしに値をスキップします: ステータスラインは無効になり、@ オートコンプリートは組み込みファイル提案にフォールバックします。
`disableWorkflows`
動的ワークフロー と、管理設定を通じた組織など、設定が到達するすべてのユーザーのためのバンドルワークフローコマンドをオフにします。自分自身のためだけにワークフローをオンまたはオフにするには、代わりに enableWorkflows を使用してください。これは /config の Dynamic workflows トグルが書き込みます。
スコープ : Any file
型 : ブール値
true: Claude Code は動的ワークフローと、設定が到達するすべてのユーザーのためのバンドルワークフローコマンドをオフにします
false: 未設定と同じです。ワークフローがオンかどうかは enableWorkflows とプランのデフォルトに従います
デフォルト : false
セッションごとのオーバーライド : CLAUDE_CODE_DISABLE_WORKFLOWS は 1 つのセッションのワークフローをオフにします。2 つのうちどちらがオフにするかに関わらず、もう一方はオンに戻すことはできません
{
"disableWorkflows" : true
}
`enableWorkflows`
プランのデフォルトが望むものでない場合、自分自身のために 動的ワークフロー をオンまたはオフにします。/config に Dynamic workflows として表示され、このキーをユーザー設定に書き込み、プランのデフォルトに戻すときに再度削除します。管理設定からすべてのユーザーのためにワークフローをオフにするには、代わりに disableWorkflows を使用してください。
スコープ : Any file
型 : ブール値
true: Claude Code は動的ワークフローをオンにします
false: Claude Code は動的ワークフローをオフにします
デフォルト : 未設定。ワークフローはオンです。ただし Pro プランではオフです
セッションごとのオーバーライド : CLAUDE_CODE_DISABLE_WORKFLOWS は 1 つのセッションのワークフローをオフにし、ここで true はそれが設定されている間はワークフローをオンに戻すことはできません
{
"enableWorkflows" : true
}
disableWorkflows と組織のワークフローポリシーも優先されます: enableWorkflows: true はいずれかのソースがワークフローをオフにしている間はワークフローをオンに戻すことはできません。Claude Code は、ユーザー設定以外のソースが enableWorkflows を設定している場合、または disableWorkflows を true に設定している場合、/config 行を非表示にします。
`hooks`
Claude Code のライフサイクルの特定の時点(ツール呼び出しの前やセッション開始時など)で、フック として独自のコマンド、プロンプト、エージェント、HTTP リクエスト、または MCP ツールを実行します。フックリファレンス はすべてのイベント、ペイロード、終了コードをリストします。各イベントはマッチャーグループのリストにマップされ、各グループはマッチャーが適用されるときに実行するハンドラーをリストします。
スコープ : Any file 。フックはファイル全体でマージされ、管理設定からのフックは他のファイルから削除できません。
型 : フックイベント でキー付けされたオブジェクト。各値は "command"、"prompt"、"agent"、"http"、または "mcp_tool" の type を持つ { "matcher", "hooks" } グループの配列
デフォルト : 未設定。フックは実行されません
この例はすべての Bash ツール呼び出しの前にスクリプトを実行します:
{
"hooks" : {
"PreToolUse" : [
{
"matcher" : "Bash" ,
"hooks" : [
{ "type" : "command" , "command" : "~/.claude/hooks/check-bash.sh" }
]
}
]
}
}
すべてのイベント、マッチャーパターン、ハンドラーフィールドについては、フックリファレンス を参照してください。フックをオフにするには、disableAllHooks を参照してください。フックを組織がデプロイするものに制限するには、allowManagedHooksOnly を参照してください。
`httpHookAllowedEnvVars`
HTTP フック は環境変数の値をリクエストヘッダーに入れることができます。例えば Authorization: Bearer $HOOK_TOKEN ヘッダーですが、フックが独自の allowedEnvVars でリストしている変数のみです。このキーはすべての HTTP フックのそのリストに外側の制限を設定します: フックは変数を使用できるのは、独自の allowedEnvVars とこのキーの両方がそれを名前付けしている場合のみです。フックの定義がそれを要求している場合でも、フックが読むべきではないシークレットを読むのを防ぐために使用します。
スコープ : Any file 。配列は設定ファイル全体でマージされます。
型 : 環境変数名の配列
デフォルト : 未設定。各フック独自の allowedEnvVars リストが適用されます
この例はヘッダー補間を MY_TOKEN と HOOK_SECRET に制限します:
{
"httpHookAllowedEnvVars" : [ "MY_TOKEN" , "HOOK_SECRET" ]
}
許可リストはすべてのソースからのフック(管理設定を含む)に適用されます。
`workflowKeywordTriggerEnabled`
プロンプトでキーワード ultracode を入力することが 動的ワークフロー をトリガーするかどうかを選択します。false に設定して、トリガーなしで単語を入力します。
スコープ : Any file 。/config に Ultracode keyword trigger として表示されます。
型 : ブール値
true: プロンプトで ultracode を入力すると動的ワークフローがトリガーされます
false: トリガーなしで単語を入力できます
デフォルト : true
{
"workflowKeywordTriggerEnabled" : false
}
ultracode 努力設定、/workflows、保存されたワークフローコマンドは影響を受けません。
`workflowSizeGuideline`
動的ワークフローが書き込む エージェント数 Claude が目指す を設定します。Claude Code は値を Claude に助言として送信します。強制的な上限ではありません: "small" は 5 未満のエージェントを要求し、"medium" は 10 未満、"large" は 50 未満です。ワークフローが費やすものを制限したい場合は "small" を選択します。Claude Code v2.1.219 以降が必要です。
スコープ : Any file 。そこの値は /config の Dynamic workflow size 選択肢より優先されます。Claude Code は ~/.claude.json に保存します。設定ファイルがキーを設定している間、Claude Code はその行を非表示にします。
型 : 文字列。以下のいずれか:
"unrestricted": ガイドラインなし。Claude はワークフローをタスクにサイズします
"small": Claude は 5 未満のエージェントを目指します
"medium": Claude は 10 未満のエージェントを目指します
"large": Claude は 50 未満のエージェントを目指します
デフォルト : "medium"、または Pro プランで Claude Code v2.1.271 以降にサインインしている場合は "small"
{
"workflowSizeGuideline" : "small"
}
Claude Code v2.1.219 以降が必要です。v2.1.202 から v2.1.218 では、代わりに /config でガイドラインを設定します。
プラグインとスキル
プラグインを有効にし、マーケットプレイスを登録し、組織が許可するプラグインソースを制限し、どのスキルを読み込むかを制御します。プラグインのインストールとビルドについては、プラグイン を参照してください。
`disableBundledSkills`
Claude Code に含まれるスキル とワークフローをオフにします。Claude Code はバンドルされたスキルとワークフローを完全に削除し、/init などの組み込みコマンドは入力可能なままですがモデルから非表示になります。
Scope : Any file
Type : Boolean
true: Claude Code はバンドルされたスキルとワークフローを削除し、/init などの組み込みコマンドをモデルから非表示にします
false: バンドルされたスキルが読み込まれます
Default : 未設定の場合、バンドルされたスキルが読み込まれます
Per-session overrides : CLAUDE_CODE_DISABLE_BUNDLED_SKILLS を 1 に設定すると、1 つのセッションでバンドルされたスキルがオフになります。2 つのうちどちらかがそれらをオフにすると、もう一方はそれらをオンに戻すことができません
{
"disableBundledSkills" : true
}
プラグインからのスキル、.claude/skills/、および .claude/commands/ からのスキルは影響を受けません。/doctor は組み込みコマンドと同様に入力可能なままです。非表示にするには、代わりに DISABLE_DOCTOR_COMMAND を設定してください。
`disableSkillShellExecution`
スキル およびユーザー、プロジェクト、プラグイン、または追加ディレクトリソースからのカスタムコマンドの !`...` および ```! ブロック内のインラインシェル実行をオフにします。Claude Code は各コマンドを実行する代わりに [shell command execution disabled by policy] に置き換えます。
Scope : Any file 。マネージド設定の true は他の場所の false でオーバーライドできません。
Type : Boolean
true: Claude Code は各インラインシェルコマンドを実行する代わりに [shell command execution disabled by policy] に置き換えます
false: インラインシェルが実行されます
Default : 未設定の場合、インラインシェルが実行されます
{
"disableSkillShellExecution" : true
}
バンドルされたスキルおよびマネージド設定を通じてデプロイされたスキルは影響を受けません。
`skillOverrides`
スキル の SKILL.md を編集せずに非表示にしたり折りたたんだりします。Claude Code は各スキルの名前の下の値をスキルリストと / オートコンプリートに適用します。
Scope : Any file 。/skills メニューは .claude/settings.local.json に書き込みます。
Type : スキル名を次のいずれかにマッピングするオブジェクト:
"on": Claude はスキルを認識し、/name を入力できます
"name-only": Claude はスキルを説明なしで名前で認識します
"user-invocable-only": Claude はスキルを認識しませんが、/name を入力することはできます
"off": Claude はスキルを認識せず、/name はオートコンプリートから非表示になります
Default : 未設定の場合、すべてのスキルが "on" です
この例は legacy-context を Claude に名前のみで表示し、deploy を Claude と / オートコンプリートから非表示にします:
{
"skillOverrides" : {
"legacy-context" : "name-only" ,
"deploy" : "off"
}
}
オーバーライドはプラグインスキルには適用されません。プラグインスキルは /plugin で管理します。
マネージド設定および --settings で渡されたファイルでは、checkup(/doctor の場合など)のようなバンドルされたスキルのエイリアスのキーも、スキルに適用されます。エイリアスキーがスキル自体の名前のキーとどのように組み合わされるか を参照してください。
`syncClaudeAiSkills`
claude.ai アカウントで有効になっているスキル のダウンロードをオフにします。Claude Code は、claude.ai アカウントでサインインするターミナルセッション (対話型および非対話型)および Cowork とクラウドセッションで、それらを ~/.claude/skills/synced/ にダウンロードします。false に設定して、そのダウンロードを停止し、既に同期されたスキルの読み込みを停止します。Claude Code は false のみを受け入れます。true は未設定と同じで、それ以外の場所でオンになっていない場合、同期をオンにしません。
Scope : User, local, or managed 、および --settings で渡されたファイル。リポジトリはそれをオフにすることはできません。
Type : Boolean
false: Claude Code は同期されたスキルのダウンロードを停止し、~/.claude/skills/synced/ にあるスキルの読み込みを停止します。ユーザーまたはマネージド設定では、それらを ~/.claude/skills/.trash/ に移動します
true: 未設定と同じです
Default : 未設定の場合、claude.ai アカウントでサインインしたセッションはスキルを同期します
この例は、マシンがどのセッションでもアカウントのスキルをダウンロードするのを防ぎます:
{
"syncClaudeAiSkills" : false
}
`syncClaudeAiPlugins`
claude.ai アカウントで有効になっているプラグイン のダウンロードをオフにします。Claude Code は、claude.ai アカウントでサインインするターミナルセッションの開始時、および Cowork セッションで、それらを ~/.claude/plugins/synced/ にダウンロードし、各プラグインを <name>@synced として読み込みます。false に設定して、そのダウンロードを停止し、既に同期されたプラグインの読み込みを停止します。Claude Code は false のみを受け入れます。true は未設定と同じで、それ以外の場所でオンになっていない場合、同期をオンにしません。Claude Code v2.1.273 以降が必要です。
Scope : User, local, or managed 、および --settings で渡されたファイル。リポジトリはそれをオフにすることはできません。
Type : Boolean
false: Claude Code は同期されたプラグインのダウンロードを停止し、~/.claude/plugins/synced/ にあるプラグインの読み込みを停止します。ユーザーまたはマネージド設定では、それらを ~/.claude/plugins/.trash/ に移動します
true: 未設定と同じです
Default : 未設定の場合、claude.ai アカウントでサインインしたセッションはプラグインを同期します
すべてのプラグインではなく、1 つの同期されたプラグインをオフにするには、enabledPlugins で "<name>@synced": false を設定します。
この例は、マシンがどのセッションでもアカウントのプラグインをダウンロードするのを防ぎます:
{
"syncClaudeAiPlugins" : false
}
`allowedChannelPlugins`
チャネル プラグインが組織内のセッションにメッセージをプッシュできるかを選択します。設定すると、Claude Code はデフォルトの Anthropic 許可リストの代わりにリストを使用します。各エントリはプラグインとそれが由来するマーケットプレイスに名前を付けます。
Scope : Managed
Type : marketplace および plugin 文字列を持つオブジェクトの配列。エントリは代わりに "telegram@claude-plugins-official" などの "plugin@marketplace" 文字列である可能性があり、Claude Code はそれを同等のオブジェクトとして扱います。文字列形式には Claude Code v2.1.267 以降が必要です。以前のバージョンは、1 つを含む場合、全体の allowedChannelPlugins 値を拒否します
Default : 未設定の場合、Claude Code はデフォルトの Anthropic 許可リストを使用します
この例はチャネルをオンにし、公式 Anthropic マーケットプレイスからの Telegram プラグインのみを許可します:
{
"channelsEnabled" : true,
"allowedChannelPlugins" : [
{ "marketplace" : "claude-plugins-official" , "plugin" : "telegram" }
]
}
空の配列はすべてのチャネルプラグインをブロックします。
このキーは、チャネルが channelsEnabled ゲートをアカウントに渡した後に有効になります。Team および Enterprise プラン、およびマネージド設定を持つ Console アカウントでは、channelsEnabled: true を意味します。チャネルプラグインの実行を制限する を参照してください。
`blockedMarketplaces`
組織のプラグインマーケットプレイスソースをブロックします。Claude Code はマーケットプレイスの追加時およびプラグインのインストール、更新、リフレッシュ、自動更新時にブロックリストをチェックするため、ポリシーを設定する前に誰かが追加したマーケットプレイスは、プラグインをフェッチするために使用することはできません。ブロックされたソースはダウンロード前にチェックされるため、ファイルシステムに触れることはありません。
claude.ai 管理コンソール でこのキーを設定する場合、claude.ai は、制限の仕組み で説明されているように、組織内の誰かが claude.ai から git リポジトリからマーケットプレイスを追加するときにも適用します。
この例は、1 つの GitHub リポジトリをマーケットプレイスソースとしてブロックします:
{
"blockedMarketplaces" : [
{ "source" : "github" , "repo" : "untrusted/plugins" }
]
}
GitHub エントリは、オーナーワイルドカード形式 "owner/*" を使用して、その GitHub オーナーの下のすべてのリポジトリをブロックできます。これには Claude Code v2.1.223 以降が必要です。{ "source": "skills-dir" } を追加して、Claude Code が ~/.claude/skills/ から @skills-dir プラグイン を読み込むのを停止し、マーケットプレイスを制限しません。マネージドマーケットプレイス制限 を参照してください。
`channelsEnabled`
組織のチャネル を許可します。claude.ai Team および Enterprise プランでは、Claude Code はこれを true に設定するまでチャネルをブロックします。API キーで認証する Anthropic Console アカウントの場合、チャネルはデフォルトで許可されます。組織がマネージド設定をデプロイする場合、Claude Code はこのキーを true に設定するまで、これらのアカウントのチャネルもブロックします。
Scope : Managed
Type : Boolean
true: Claude Code は組織のチャネルを許可します
false: 未設定と同じです。チャネルがブロックされるかどうかはプランによって異なります(Default を参照)
Default : 未設定。チャネルは Team および Enterprise プランおよびマネージド設定を持つ Console アカウントでブロックされ、Pro および Max プランおよびマネージド設定のない Console アカウントで許可されます
{
"channelsEnabled" : true
}
有効になったら、どのプラグインがチャネルとして登録できるかを制限するには、allowedChannelPlugins を設定します。エンタープライズコントロール を参照してください。
`disableCommandPluginSources`
command プラグインソース をブロックします。これはユーザーのマシンでマーケットプレイス宣言コマンドを実行してプラグインをインストールします。true に設定すると、Claude Code はコマンドを実行せず、コマンドソースプラグインをインストールまたは更新せず、既にインストールされているプラグインの読み込みを停止します。false に設定して明示的に許可します。コマンドソースをブロックするときはいつでも、true に設定するか allowManagedHooksOnly の下で未設定のままにするかに関わらず、マーケットプレイス headersHelper コマンド もブロックします。ただし、マネージド設定自体が宣言するマーケットプレイスは除きます。Claude Code v2.1.229 以降が必要で、headersHelper ブロックには v2.1.238 以降が必要です。
Scope : Managed
Type : Boolean
true: Claude Code はマーケットプレイス宣言コマンドを実行せず、コマンドソースプラグインをインストールまたは更新せず、既にインストールされているプラグインの読み込みを停止します
false: Claude Code はコマンドソースプラグインを明示的に許可します
Default : 未設定の場合、Claude Code は allowManagedHooksOnly に従います。フック実行をマネージド設定に制限する組織はコマンドソースも無効になります
{
"disableCommandPluginSources" : true
}
Claude Code v2.1.229 以降が必要です。
`pluginSuggestionMarketplaces`
スピナーチップおよび /plugin Discover タブの上部にピン留めされた、コンテキスト内インストール提案として表示できるプラグインのマーケットプレイスに名前を付けます。組み込みのファーストパーティフロントエンド設計チップは影響を受けません。提案は各プラグインのマーケットプレイスエントリの relevance 宣言から来ます。
Scope : Managed
Type : マーケットプレイス名の配列
Default : 未設定の場合、マーケットプレイス宣言提案は表示されません
{
"pluginSuggestionMarketplaces" : [ "acme-corp-plugins" ]
}
名前は、マーケットプレイスがマシンに登録され、その登録されたソースが同じマネージド設定でも宣言されている場合にのみ有効になります。その名前の extraKnownMarketplaces エントリとして、または strictKnownMarketplaces のエントリとして。Claude Code は、許可リストされた名前の下で別のソースから登録されたマーケットプレイスを無視します。公式マーケットプレイスはソース要件から除外されます。その名前を許可リストするだけで十分です。その名前は公式 Anthropic ソースからのみ登録できるためです。コンテキストでプラグインを提案する を参照してください。
`pluginTrustMessage`
インストール前に Claude Code が表示するプラグイン信頼警告に、組織独自のテキストを追加します。たとえば、内部マーケットプレイスからのプラグインが検証されていることを確認します。
Scope : Managed
Type : 文字列
Default : 未設定の場合、Claude Code は標準警告のみを表示します
{
"pluginTrustMessage" : "All plugins from our marketplace are approved by IT"
}
`strictKnownMarketplaces`
組織内のユーザーがプラグインを追加およびインストールできるプラグインマーケットプレイスソースを制限します。Claude Code はマーケットプレイスの追加時およびプラグインのインストール、更新、リフレッシュ、自動更新時に許可リストを実施します。ネットワークまたはファイルシステム操作の前に実施されるため、ポリシーを設定する前に誰かが追加したマーケットプレイスは、そのソースが一致しなくなると使用できません。ブロックされたユーザーはマネージドポリシーに名前を付けるエラーを表示します。
claude.ai 管理コンソール でこのキーを設定する場合、claude.ai は、制限の仕組み で説明されているように、組織内の誰かが claude.ai から git リポジトリからマーケットプレイスを追加するときにも適用します。
Scope : Managed
Type : マーケットプレイスソースオブジェクトの配列。許可されたソースタイプ を参照してください
Default : 未設定の場合、ユーザーは任意のマーケットプレイスを追加できます。空の配列は、公式 Anthropic マーケットプレイスを含むすべてのマーケットプレイスソースをブロックする完全なロックダウンです
この例は、2 つの GitHub リポジトリを許可します。1 つは v2.0 ref にピン留めされ、1 つはホストされた marketplace.json URL です:
{
"strictKnownMarketplaces" : [
{ "source" : "github" , "repo" : "acme-corp/approved-plugins" } ,
{ "source" : "github" , "repo" : "acme-corp/security-tools" , "ref" : "v2.0" } ,
{ "source" : "url" , "url" : "https://plugins.example.com/marketplace.json" }
]
}
このキーを allowedMarketplaces として書くこともできます。マーケットプレイスキーエイリアス は、Claude Code がエイリアスをどのように扱うか、およびどのバージョンがそれを受け入れるかを説明しています。このキーはポリシーゲートです。ユーザーが追加できるものを制御しますが、何も登録しません。制限と事前登録を 1 つのファイルで行うには、extraKnownMarketplaces と組み合わせる を参照してください。ユーザー向けビューについては、マネージドマーケットプレイス制限 を参照してください。
許可されたソースタイプ
以下の各エントリは、ソースタイプごとに 1 つの許可リストエントリと、それが受け入れるフィールドを示しています。ほとんどのタイプは正確に一致します。hostPattern と pathPattern は正規表現で一致し、github エントリはオーナーワイルドカード を使用できます。
Source
Example entry
Fields
github
{ "source": "github", "repo": "acme-corp/plugins", "ref": "main", "path": "marketplace" }
repo 必須; ref はブランチまたはタグ; path はサブディレクトリ
git
{ "source": "git", "url": "https://gitlab.example.com/tools/plugins.git", "ref": "production" }
url 必須; ref と path は github と同じ
url
{ "source": "url", "url": "https://plugins.example.com/marketplace.json", "headers": { "Authorization": "Bearer ${TOKEN}" } }
url 必須; headers は認証アクセス用の HTTP ヘッダーを追加します
file
{ "source": "file", "path": "/opt/acme-corp/plugins/marketplace.json" }
path 必須、marketplace.json ファイルへの絶対パス
directory
{ "source": "directory", "path": "/opt/acme-corp/approved-marketplaces" }
path 必須、.claude-plugin/marketplace.json を含むディレクトリへの絶対パス
hostPattern
{ "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }
hostPattern 必須、マーケットプレイスホストに対して一致する正規表現
pathPattern
{ "source": "pathPattern", "pathPattern": "^/opt/approved/" }
pathPattern 必須、file および directory ソースの path に対して一致する正規表現
skills-dir
{ "source": "skills-dir" }
フィールドなし。~/.claude/skills/ プラグインスキャンをオプトバックインします
3 つのソースタイプはテーブルを超えたルールを持ちます:
url : URL マーケットプレイスは marketplace.json ファイルのみをダウンロードし、Claude Code はそのサーバーから相対パスでプラグインファイルをフェッチしないため、そのプラグインは相対パス以外のプラグインソース (同じホストにある可能性があるアーカイブ URL など)を使用する必要があります。相対パスを持つプラグインの場合は、代わりに Git ベースのマーケットプレイスを使用してください。相対パスを持つプラグインが URL ベースのマーケットプレイスで失敗する を参照してください。
hostPattern : 各リポジトリをリストせずに、内部 GitHub Enterprise または GitLab サーバー上のすべてのマーケットプレイスを許可するために使用します。Claude Code は github ソースを github.com に対して一致させ、url ソースからホスト名を取得し、git URL の形式に応じて git ソースから取得します:
https:// や ssh:// などのスキーム付き URL: URL のホスト名。
スキームなしの SSH アドレス、git の user@host:path 形式(git@git.example.com:tools/plugins.git など): @ と : の間のホスト。これは git が接続するホストです。
スキームなしの他の形式: ホストなし、したがって strictKnownMarketplaces hostPattern エントリは一致しません。blockedMarketplaces hostPattern の場合、Claude Code はより広い形式のセットからホストを取得するため、ブロックリストエントリはそのような形式と一致する可能性があります。v2.1.234 より前では、strictKnownMarketplaces hostPattern も git が SSH アドレスとして扱わない一部の形式と一致していました。
file および directory ソースはホストを持たず、hostPattern エントリと一致しません。
pathPattern : ネットワークソースの hostPattern エントリと共にファイルシステムマーケットプレイスを許可するために使用します。".*" はすべてのローカルパスを許可します。"^/opt/approved/" などのより狭いパターンはディレクトリに制限します。
空の配列でも、許可リストは Claude Code が @skills-dir プラグイン を ~/.claude/skills/ から読み込むのを停止します。それらの読み込みを続けるには、{ "source": "skills-dir" } エントリを追加してください。このエントリはこのキーと blockedMarketplaces の外では意味がありません。
オーナーワイルドカード
その repo 値が "<owner>/*" である github エントリは、その GitHub オーナーの下のすべてのリポジトリと一致します。オーナーワイルドカードには Claude Code v2.1.223 以降が必要で、strictKnownMarketplaces および blockedMarketplaces でのみ機能します。extraKnownMarketplaces や /plugin marketplace add などの他の場所で github ソースが表示される場合、repo 値は単一のリポジトリに名前を付ける必要があります。v2.1.223 より前では、Claude Code はエントリを文字通り比較したため、許可リストエントリはリポジトリと一致せず、ブロックリストエントリは何もブロックしませんでした。単一リポジトリエントリはすべてのバージョンで実施されます。
このエントリは acme-corp 組織内のマーケットプレイスリポジトリを許可します:
{
"strictKnownMarketplaces" : [
{ "source" : "github" , "repo" : "acme-corp/*" }
]
}
リポジトリ名の位置全体のみがワイルドカードである可能性があります。Claude Code は *、*/plugins、または acme-corp/tools-* などのエントリを無効として無視するため、リポジトリと一致しません。
マッチングルールは 2 つの設定間で異なります:
Rule
strictKnownMarketplaces
blockedMarketplaces
マッチングソーススペリング
owner/repo 形式のみ。同じリポジトリをクローンする git URL は一致しません
github.com リポジトリに解決する git URL を含む任意のスペリング
オーナーケース
正確なエントリマッチングのように大文字と小文字を区別します
大文字と小文字を区別しません
ref
正確なエントリルールに従います: ref を持つエントリはその正確な ref を持つソースのみと一致し、1 つを持たないエントリは ref を指定しないソースのみと一致します
ref を持たないエントリは、一致するリポジトリのすべての ref をブロックします
path
正確なエントリルールより緩い: path を持つエントリはその正確な値を必要とし、1 つを持たないエントリはリポジトリ内のすべてのパスと一致します
path を持たないエントリは、一致するリポジトリのすべてのパスをブロックします
正確なマッチング
オーナーワイルドカード github エントリと正規表現でマッチングされた hostPattern および pathPattern エントリを除くすべてのソースタイプについて、Claude Code はユーザーの追加をエントリと正確に一致する場合にのみ許可します。Git ベースのソース github および git の場合、正確なマッチングはオプションフィールドを含みます:
repo または url は正確に一致する必要があります
ref フィールドは正確に一致する必要があります。または両方が未定義である必要があります
path フィールドは正確に一致する必要があります。または両方が未定義である必要があります
たとえば、Claude Code は以下の各ペアを 2 つの異なるソースとして扱います:
{ "source": "github", "repo": "acme-corp/plugins" } および { "source": "github", "repo": "acme-corp/plugins", "ref": "main" }
{ "source": "github", "repo": "acme-corp/plugins", "path": "marketplace" } および { "source": "github", "repo": "acme-corp/plugins" }
公式マーケットプレイスのみを許可する
公式 Anthropic マーケットプレイスのみを許可するには、そのリポジトリをリストします:
{
"strictKnownMarketplaces" : [
{ "source" : "github" , "repo" : "anthropics/claude-plugins-official" }
]
}
このエントリを使用すると、Claude Code は既に登録されている公式マーケットプレイスを利用可能に保ち、新しいマシンでは、最初に対話的に Claude Code を起動するときにマーケットプレイスを自動的に登録します。自動登録は最も一般的に以下を見逃します:
マシンの最初の対話的セッションの前に実行される非対話型環境。
Claude Code が VS Code 拡張機能を通じてのみ実行されたマシン。
Claude Code が既に対話的ターミナルセッションを実行したマシン。マーケットプレイスをブロックするポリシー(空の配列ロックダウンなど)の下。Claude Code はブロックされた試行を記録し、ポリシーが変更された後は再試行しません。
これらのマシンでは、同じ managed-settings.json の extraKnownMarketplaces にマーケットプレイスを追加して Claude Code が自動的に登録するか、claude plugin marketplace add anthropics/claude-plugins-official を実行してください。
2 つのキーは異なるジョブを実行します。この表はそれらを比較しています:
Aspect
strictKnownMarketplaces
extraKnownMarketplaces
Purpose
組織ポリシー実施
チーム便宜
Settings file
マネージド設定のみ
任意の設定ファイル
Behavior
許可リストされていない追加をブロック
不足しているマーケットプレイスを登録
When enforced
ネットワークおよびファイルシステム操作の前
ユーザーまたはマネージド設定から直ちに。リポジトリのファイルのワークスペース信頼ダイアログの後
Can be overridden
いいえ、最高優先度
はい、より高い優先度の設定による
Source format
直接ソースオブジェクト
ネストされた source オブジェクトを持つ名前付きマーケットプレイス
すべてのユーザーのマーケットプレイスを制限および事前登録するには、managed-settings.json で両方を設定します:
{
"strictKnownMarketplaces" : [
{ "source" : "github" , "repo" : "acme-corp/plugins" }
] ,
"extraKnownMarketplaces" : {
"acme-tools" : {
"source" : { "source" : "github" , "repo" : "acme-corp/plugins" }
}
}
}
strictKnownMarketplaces のみが設定されている場合、ユーザーは /plugin marketplace add で許可されたマーケットプレイスを自分で追加できます。公式 Anthropic マーケットプレイスは Claude Code が自動的に登録する唯一のマーケットプレイスであり、許可リストがそれを許可する場合のみです。公式マーケットプレイスのみを許可する は、それが見逃すマシンをリストしています。
`strictPluginOnlyCustomization`
ユーザーおよびプロジェクトソースからスキル、エージェント、フック、および MCP サーバーをブロックして、プラグインまたはマネージド設定からのみ来るようにします。strictKnownMarketplaces と組み合わせて、完全なカスタマイズサプライチェーンを制御します。マーケットプレイス許可リストはユーザーがインストールできるプラグインを制御します。
Scope : Managed
Type : すべての 4 種類のカスタマイズをロックするには true、またはロックする種類に名前を付ける配列("skills"、"agents"、"hooks"、"mcp" から)
Default : 未設定の場合、何もロックされません
この例はスキルとフックをロックし、エージェントと MCP サーバーをロック解除したままにします:
{
"strictPluginOnlyCustomization" : [ "skills" , "hooks" ]
}
以下の 4 つのサブキーエントリは、各サーフェスがブロックするものと何が読み込まれるかをリストしています。Claude Code は認識しないサーフェス名を無視するため、すべてのクライアントが更新される前に新しいサーフェス名を追加できます。
`strictPluginOnlyCustomization.skills`
skills サーフェスをロックします。Claude Code は ~/.claude/skills/ および .claude/skills/ からのスキル、~/.claude/commands/ および .claude/commands/ からのカスタムコマンド、--add-dir ディレクトリの下のスキル、および claude.ai アカウントから同期されたスキルの読み込みを停止し、プラグインスキル、バンドルされたスキル、およびマネージドポリシーディレクトリ内のスキルの読み込みを続けます。
{
"strictPluginOnlyCustomization" : [ "skills" ]
}
`strictPluginOnlyCustomization.agents`
agents サーフェスをロックします。Claude Code は ~/.claude/agents/ および .claude/agents/ からのエージェントの読み込みを停止し、プラグインエージェント、組み込みエージェント、およびマネージドポリシーディレクトリ内のエージェントの読み込みを続けます。
{
"strictPluginOnlyCustomization" : [ "agents" ]
}
`strictPluginOnlyCustomization.hooks`
hooks サーフェスをロックします。Claude Code はユーザー、プロジェクト、およびローカル settings.json からのフックの実行を停止し、プラグインフックおよびマネージド設定内のフックの実行を続けます。
{
"strictPluginOnlyCustomization" : [ "hooks" ]
}
`strictPluginOnlyCustomization.mcp`
mcp サーフェスをロックします。Claude Code は ~/.claude.json および .mcp.json からの MCP サーバーの読み込みを停止し、プラグイン MCP サーバー、managed-mcp.json サーバー、および managedMcpServers からのサーバーの読み込みを続けます。
{
"strictPluginOnlyCustomization" : [ "mcp" ]
}
`enabledPlugins`
個別のプラグイン をオンまたはオフにします。plugin-name@marketplace-name でキー付けされます。どのスコープでもエントリを持たないプラグインは、その defaultEnabled 値にフォールバックします。/plugin または claude plugin enable でプラグインを有効または無効にすると、Claude Code はこのキーを書き込みます。
Scope : Any file
Type : plugin-name@marketplace-name を Boolean にマッピングするオブジェクト
Default : 未設定の場合、各プラグインはその defaultEnabled 値に従います
この例は team-tools マーケットプレイスから 2 つのプラグインを有効にし、personal から 1 つを無効にします:
{
"enabledPlugins" : {
"code-formatter@team-tools" : true,
"deployment-tools@team-tools" : true,
"experimental-features@personal" : false
}
}
各スコープは異なる目的を果たします:
User settings : 個人的なプラグイン設定
Project settings : リポジトリ内のすべてのユーザーと共有されるプラグイン
Local settings : マシンごとのオーバーライド。Claude Code がそこに設定を保存するときに gitignored
Managed settings : 組織全体のポリシー。ここで false に設定されたプラグインはすべてのスコープでインストールがブロックされ、マーケットプレイスから非表示になります
プロジェクト設定はユーザー設定より優先されるため、~/.claude/settings.json でプラグインを false に設定しても、プロジェクトの .claude/settings.json が有効にするプラグインは無効になりません。マシン上でプロジェクト有効プラグインをオプトアウトするには、代わりに .claude/settings.local.json で false に設定してください。マネージド設定で強制的に有効にされたプラグインは、マネージド設定がローカル設定をオーバーライドするため、この方法では無効にできません。
外部ソース(GitHub リポジトリや npm パッケージなど)からのプラグインをプロジェクトの .claude/settings.json で有効にしても、他のユーザーにはインストールされません。プラグインを読み込むすべてのパスで、Claude Code はプラグインがインストールされていないと報告します。各ユーザーが それ自体をインストール するまで。
追加のプラグインマーケットプレイスを名前で登録して、リポジトリを開く人、またはマネージド設定が到達するすべての人が、自分で追加することなくマーケットプレイスを取得できるようにします。Claude Code は、既に知らないマーケットプレイスを登録します。enabledPlugins がそれから名前を付けるプラグインがインストールされるかどうかは、プラグインのソースとどのファイルがそれを有効にするかに依存します。そのエントリにはルールがあります。
Scope : Any file 。Claude Code はリポジトリの .claude/settings.json または .claude/settings.local.json のエントリを、そのフォルダーのワークスペース信頼ダイアログを受け入れた後にのみ受け入れます。信頼していないフォルダー(-p 実行を含む)では、メッセージなしで無視します。
Type : マーケットプレイス名を source オブジェクトとオプションの autoUpdate Boolean を持つオブジェクトにマッピングするオブジェクト
Default : 未設定
この例は GitHub マーケットプレイスと自己ホストされた git URL からのマーケットプレイスを登録します:
{
"extraKnownMarketplaces" : {
"acme-tools" : {
"source" : {
"source" : "github" ,
"repo" : "acme-corp/claude-plugins"
}
} ,
"security-plugins" : {
"source" : {
"source" : "git" ,
"url" : "https://git.example.com/security/plugins.git"
}
}
}
}
フォルダーを信頼する前に実行されるもの は信頼ゲートとリポジトリが提供できる他のコンテンツを比較します。このキーを additionalMarketplaces として書くこともできます。マーケットプレイスキーエイリアス を参照してください。
source と共に "autoUpdate": true を設定して、Claude Code がスタートアップ後にバックグラウンドでそのマーケットプレイスをリフレッシュし、インストールされたプラグインを更新するようにします。省略すると、claude-plugins-official およびほとんどの他の公式 Anthropic マーケットプレイスはデフォルトで true、サードパーティマーケットプレイスはデフォルトで false です。自動更新を構成する を参照してください。
複数の設定ファイルが同じ名前の下でマーケットプレイスエントリを定義する場合、Claude Code は最高優先度ファイル からのエントリ全体を使用します。そのエントリは低優先度エントリを置き換え、そのフィールドを継承しないため、再定義は 1 つのファイルの source.headers 認証情報を別のファイルが制御する URL と組み合わせることはできません。v2.1.228 より前では、Claude Code は同じ名前のエントリをフィールドごとにマージしたため、より高い優先度ファイルのエントリは、設定しなかったフィールド(別のファイルの headers を含む)を継承できました。
マーケットプレイスソースタイプ
source オブジェクトは次のいずれかの形式を取ります:
github : GitHub リポジトリ、repo を使用
git : 任意の git URL、url を使用
url : marketplace.json ファイルへの直接 URL、url とオプションの headers および headersHelper を使用して認証アクセスします。headersHelper は値が短命すぎてリストできないヘッダーを出力するコマンドに名前を付け、Claude Code v2.1.238 以降が必要です
file : marketplace.json ファイルへのローカルパス、path を使用
directory : ローカルファイルシステムパス、path を使用。開発用、または組織が各マシンにデプロイするマーケットプレイス に使用します。
settings : ホストされたリポジトリなしで設定ファイルに直接宣言されたインラインマーケットプレイス、name および plugins を使用
git ソースタイプは、自己ホストされた GitLab や Bitbucket を含む任意の git ホスティングサービスで機能します。Claude Code はそのマシンで git clone が使用するのと同じ認証でリポジトリをクローンします。設定された認証ヘルパーまたは SSH キー。GITHUB_TOKEN などのプロバイダートークンは、それを読む認証ヘルパーを通じてのみ有効になります。セットアップの詳細については、プライベートリポジトリ を参照してください。
github および git ソースの場合、Claude Code はマーケットプレイスリポジトリをクローンして追加または更新するときに Git LFS コンテンツをダウンロードしません。LFS トラッキングファイルはポインターファイルとしてチェックアウトされ、追加または更新出力はいくつかのレポートを報告します。
source オブジェクト内の skipLfs フィールドは受け入れられ、効果がありません。v2.1.274 より前では、Claude Code は "skipLfs": true を設定しない限り LFS コンテンツをダウンロードしました。
URL ソースの場合、headers の認証情報が期限切れになり、コマンドが新しい認証情報を生成する必要がある場合は、source オブジェクト内に headersHelper を設定します。Claude Code v2.1.238 以降が必要です。コマンドが出力する必要があるもの、および Claude Code がそれを実行する場所については、headersHelper コマンドを書く を参照してください。Claude Code が headersHelper コマンドをスキップするか、その出力をドロップする場合については、Claude Code が headersHelper コマンドをスキップするか、その出力をドロップする場合 を参照してください。https:// マーケットプレイス URL に headersHelper を設定すると、Claude Code は 2 つのポイントでコマンドを実行し、1 回の実行の出力を最大 60 秒間再利用します:
そのマーケットプレイスの marketplace.json の各フェッチの前(後続のリフレッシュを含む)。Claude Code はそのフェッチで出力されたヘッダーを送信します。
マーケットプレイス URL のオリジン上の各プラグインアーカイブダウンロードの前。つまり、同じスキーム、ホスト、ポート。Claude Code はそのダウンロードで出力を送信し、他のダウンロードはヘッダーを取得しません。
Claude Code は、--add-dir で追加するディレクトリの .claude/settings.json または .claude/settings.local.json に設定された headersHelper を無視します。url ソースおよびインラインプラグインエントリの両方で、そのファイルに設定された固定 headers のみを送信します。ユーザーが headersHelper コマンドを受け入れる方法 は他の設定ファイルをカバーしています。
settings ソースにリストされたプラグインは、GitHub や npm などの外部ソースを参照する必要があり、name はマーケットプレイスキーと一致する必要があります。各プラグインを enabledPlugins で個別に有効にする必要があります。この例は 1 つのプラグインをインラインで宣言します:
{
"extraKnownMarketplaces" : {
"team-tools" : {
"source" : {
"source" : "settings" ,
"name" : "team-tools" ,
"plugins" : [
{
"name" : "code-formatter" ,
"source" : {
"source" : "github" ,
"repo" : "acme-corp/code-formatter"
}
}
]
}
}
}
}
独自の source が archive である source: 'settings' の下のプラグインエントリは、アーカイブダウンロード用に headers を設定できます。headers に入れる値が短命の場合(レジストリがリクエストで作成するトークンなど)、代わりに headersHelper コマンドを設定します。エントリは両方を設定できます。両方のフィールドには Claude Code v2.1.238 以降が必要です。
Claude Code はエントリの headers と、コマンドが出力するもの、そのプラグインのアーカイブダウンロードで送信し、他のダウンロードでは送信しません。Claude Code はユーザーが そのプラグイン 1 つをインストールまたは更新する 場合にのみコマンドを実行します。3 つのさらなるルールはエントリを保持するファイルに依存します:
strict : マーケットプレイスの marketplace.json のエントリとは異なり、設定ファイルのエントリはマニフェストフィールドをインラインする必要がないため、"strict": false は必要ありません。厳密モード を参照してください。
Folder trust : プロジェクトの .claude/settings.json または .claude/settings.local.json のエントリの場合、Claude Code はユーザーが そのフォルダーも信頼した 場合にのみコマンドを実行します。
Header filter : Claude Code は、リポジトリがこれらのファイルを提供できるため、プロジェクトの .claude/settings.json または .claude/settings.local.json のエントリから リクエストルーティングおよびクライアント ID ヘッダー名 をドロップします。Claude Code はカタログエントリおよび --add-dir ディレクトリの設定のエントリに同じフィルターを適用し、ユーザー設定、--settings ファイル、またはマネージド設定のエントリにはフィルターを適用しません。
マーケットプレイスキーエイリアス
Claude Code v2.1.232 以降では、extraKnownMarketplaces を additionalMarketplaces として、strictKnownMarketplaces を allowedMarketplaces として書くことができます。Claude Code は各エイリアスを次のように扱います:
以前のバージョンはエイリアスを無視するため、マネージド設定ファイルなど、古いバージョンも読む設定ファイルで正規のスペリングを保持してください。
正規キーを受け入れる任意の設定ファイルで、Claude Code はエイリアスを正規キーと同じように読みます。
Claude Code はファイルを更新するときに additionalMarketplaces を extraKnownMarketplaces に書き直す可能性があります。
1 つのファイルで両方のスペリングを設定する場合、Claude Code は正規値を使用し、エイリアスを無視します。
`pluginConfigs`
プラグインの userConfig 設定ダイアログに与える非機密の回答を、プラグイン ID でキー付けして保存します。Claude Code は、ダイアログに入力するときにこのキーをユーザー設定に書き込むため、手動で編集する必要はありません。Claude Code は機密オプションを macOS Keychain に保存し、Keychain が書き込みを拒否する場合は ~/.claude/.credentials.json にフォールバックします。サポートされているキーチェーンのないプラットフォームでは、~/.claude/.credentials.json に保存します。
Scope : User or managed
Type : プラグイン ID を options フィールドを持つオブジェクトにマッピングするオブジェクト。各オプション名を文字列、数値、Boolean、または文字列の配列にマッピングし、オプションの mcpServers フィールドは同じ形状でサーバーごとのユーザー設定値を保持します
Default : 未設定
この例は acme-tools からの deployer プラグインの api_endpoint オプションを保存します:
{
"pluginConfigs" : {
"deployer@acme-tools" : {
"options" : {
"api_endpoint" : "https://api.example.com"
}
}
}
}
組み込みプラグインは @builtin サフィックス付きの同じキーの下にオプションを保存します。たとえば、Claude Code が AGENTS.md ファイルを読むかどうかを制御する Project instructions 設定は pluginConfigs["agents-md@builtin"].options.instructionFiles です。
Claude Code はプロジェクトおよびローカルエントリを無視します。これらの値をプラグインフック、MCP、および LSP 設定に置き換えるため、クローンされたリポジトリはそれらを提供できません。v2.1.207 より前では、プロジェクトおよびローカル設定も読まれていました。
`prependPlugins`
マネージドプラグインのリストで、その mods がユーザーがインストールするすべての mod の前に実行されます。リストされた順序で実行されます。マネージド設定でこのキーを設定する場合、リストに sec-default@builtin を名前付けして、組み込みガードを保持します。マネージド設定では、Claude Code はプラグインが組織のものとしてカウントされないプラグインの ID をスキップします。組織の mod をインストールして順序を設定する を参照してください。これらの条件と 2 つの順序付けキーがどのように機能するかについて。
Scope : User or managed 。Claude Code はマネージド設定からキーを読みます。マネージド設定のないマシン上でのみ、Team または Enterprise プランでサインインしていないユーザーのユーザー設定からキーを読みます。プロジェクトおよびローカル設定、および --settings ファイルのキーを無視します。
Type : plugin-name@marketplace-name 文字列の配列
Default : 未設定
{
"extraKnownMarketplaces" : {
"acme-tools" : {
"source" : { "source" : "directory" , "path" : "/opt/acme/claude-plugins" }
}
} ,
"enabledPlugins" : { "acme-guard@acme-tools" : true } ,
"prependPlugins" : [ "acme-guard@acme-tools" , "sec-default@builtin" ]
}
`appendPlugins`
マネージドプラグインのリストで、その mods がユーザーがインストールするすべての mod の後に実行されます。リストされた順序で実行されます。prependPlugins と appendPlugins の両方にリストされている ID は、前置されます。マネージド設定では、Claude Code はプラグインが 組織のものとしてカウント されないプラグインの ID をスキップします。
Scope : User or managed 。Claude Code はマネージド設定からキーを読みます。マネージド設定のないマシン上でのみ、Team または Enterprise プランでサインインしていないユーザーのユーザー設定からキーを読みます。プロジェクトおよびローカル設定、および --settings ファイルのキーを無視します。
Type : plugin-name@marketplace-name 文字列の配列
Default : 未設定
{
"extraKnownMarketplaces" : {
"acme-tools" : {
"source" : { "source" : "directory" , "path" : "/opt/acme/claude-plugins" }
}
} ,
"enabledPlugins" : { "acme-audit@acme-tools" : true } ,
"appendPlugins" : [ "acme-audit@acme-tools" ]
}
MCP
Claude Code が接続する MCP サーバーと、組織が許可する MCP サーバーを制御します。MCP で外部ツールに接続する と管理対象 MCP 設定 を参照してください。
`allowAllClaudeAiMcps`
Claude Code が自身で取得するclaude.ai コネクタ を、デプロイされた managed-mcp.json と一緒に読み込みます。このキーがない場合、managed-mcp.json は MCP サーバーを排他的に制御し、これらのコネクタを抑制します。
スコープ : Managed 。ユーザーは排他的制御によって抑制されたコネクタを再度有効にすることはできません。
タイプ : ブール値
true: Claude Code は、デプロイされた managed-mcp.json と一緒に claude.ai コネクタを読み込みます
false: デプロイされた managed-mcp.json は MCP サーバーを排他的に制御し、Claude Code が自身で取得するclaude.ai コネクタ を抑制します
デフォルト : false。デプロイされた managed-mcp.json は Claude Code が自身で取得する claude.ai コネクタを抑制します
{
"allowAllClaudeAiMcps" : true
}
allowedMcpServers とdeniedMcpServers は、このキーが読み込むコネクタにも適用されます。managed-mcp.json を持つホスト(自己ホスト型ランナーなど)のクラウドセッション に配信されるコネクタは、抑制されたままです。管理対象セットと一緒に claude.ai コネクタを許可する を参照してください。
`allowClaudeInChromeWithManagedMcp`
デプロイされた managed-mcp.json と一緒に、組み込みのClaude in Chrome サーバーを実行できるようにします。このキーがない場合、デプロイされた managed-mcp.json はターミナルセッションで Claude in Chrome をブロックします。Claude Code v2.1.282 以降が必要です。
スコープ : Managed 。デバイス自身の管理設定からのみ。MDM でデプロイされた plist または HKLM レジストリキー、またはシステム managed-settings.json ファイル。Claude Code はサーバー管理設定、ユーザー書き込み可能な HKCU レジストリ、およびユーザーまたはプロジェクト設定では無視します。
タイプ : ブール値
true: 組み込みの Claude in Chrome サーバーは、デプロイされた managed-mcp.json と一緒に実行できます
false: デプロイされた managed-mcp.json はターミナルセッションで Claude in Chrome をブロックします
デフォルト : false。デプロイされた managed-mcp.json はターミナルセッションで Claude in Chrome をブロックします
{
"allowClaudeInChromeWithManagedMcp" : true
}
claude-in-chrome のdeniedMcpServers エントリは、このキーがオンの場合でもサーバーをブロックします。管理対象セットと一緒に Claude in Chrome を許可する を参照してください。
`allowedMcpServers`
ユーザーが追加できる MCP サーバーをホワイトリストに登録します。Claude Code は、プラグインサーバー、--mcp-config で渡されたサーバー、claude.ai からのサーバーを含め、どこで定義されていても、エントリに一致しないサーバーをブロックします。
Claude in Chrome、実行中のVS Code またはJetBrains IDE に Claude Code が接続する ide サーバー、CLI 自体が設定するサーバーなどの組み込みサーバーは、ホワイトリストから除外され、デニーリストは引き続きこれらに適用されます。Claude Code v2.1.268 以降では、Claude Tag セッションの Slack ツールもホワイトリストから除外され、デニーリストは引き続きこれらに適用されます。インプロセス type: "sdk" サーバーは両方のリストから除外されます。セッションを開始したアプリ がこれらを登録します。
組織が配信するサーバーもホワイトリストから除外され、デニーリストは引き続きこれらに適用されます。この除外は、すべてのmanagedMcpServers エントリと、${VAR} 展開を使用しない値を持つmanaged-mcp.json エントリをカバーします。完全なチェック順序については、サーバーの評価方法 を参照してください。v2.1.259 より前では、managed-mcp.json からのサーバーも一致する必要がありました。
スコープ : Any file 。allowManagedMcpServersOnly が設定されていない限り、すべてのファイルからのエントリが 1 つのホワイトリストにマージされます。管理設定にデプロイして、これを強制します。
タイプ : オブジェクトの配列。各オブジェクトは正確に 1 つのキーを持ちます。serverName は、文字、数字、ハイフン、アンダースコアに限定された文字列です。serverCommand は、コマンドとその引数を正確に一致させた配列です。または serverUrl は、* ワイルドカードを含む URL パターンです
デフォルト : 未設定。すべてのサーバーが許可されます。空の配列は、ユーザーが追加するすべてのサーバーをブロックします
この例は、リストされた npx コマンドが開始する stdio サーバーのみを許可します。
{
"allowedMcpServers" : [
{ "serverCommand" : [ "npx" , "-y" , "@modelcontextprotocol/server-filesystem" ] }
]
}
deniedMcpServers エントリが優先されるため、両方のリストにあるサーバーはブロックされます。リストに serverCommand エントリが含まれると、stdio サーバーは serverCommand エントリと一致する必要があり、serverUrl エントリが含まれると、リモートサーバーは serverUrl エントリと一致する必要があります。serverName の一致は、その種類のサーバーをもはや許可しません。ホワイトリストとデニーリストを使用したポリシーベースの制御 を参照してください。
`allowManagedMcpServersOnly`
管理対象ホワイトリストのみを適用対象にします。Claude Code は、ユーザー、プロジェクト、ローカル設定の allowedMcpServers を無視し、管理設定からのみ allowedMcpServers を読み込みます。deniedMcpServers は引き続きすべての設定スコープからマージされるため、ユーザーは自分自身のためにサーバーをブロックできます。管理者は、ユーザー自身の設定が管理対象ホワイトリストが許可するものを拡大できないようにするために、これを設定します。
スコープ : Managed
タイプ : ブール値
true: Claude Code は管理設定からのみ allowedMcpServers を読み込み、ユーザー、プロジェクト、ローカル設定のホワイトリストを無視します
false: すべての設定スコープのホワイトリストがマージされます
デフォルト : false。すべての設定スコープのホワイトリストがマージされます
この例は、ホワイトリストを管理設定にロックし、github という名前のサーバーのみを許可します。
{
"allowManagedMcpServersOnly" : true,
"allowedMcpServers" : [
{ "serverName" : "github" }
]
}
ユーザーは引き続き独自の MCP サーバーを追加できます。管理対象ホワイトリストと一致するサーバーのみが読み込まれます。ホワイトリストを管理設定のみに制限する を参照してください。
`deniedMcpServers`
特定の MCP サーバーをブロックします。Claude Code は、プラグインサーバー、--mcp-config で渡されたサーバー、managed-mcp.json からのサーバー、managedMcpServers からのサーバー、および自身で取得する claude.ai コネクタを含め、どこで定義されていても、一致するサーバーの読み込みを拒否します。インプロセス type: "sdk" サーバーは除外されます。セッションを開始したアプリがこれらを登録します。
スコープ : Any file 。すべてのファイルからのエントリが 1 つのデニーリストにマージされ、allowManagedMcpServersOnly はこれを変更しません。管理設定にデプロイして、これを強制します。
タイプ : オブジェクトの配列。各オブジェクトは正確に 1 つのキーを持ちます。serverName は文字列です。"claude.ai Slack" などの claude.ai コネクタの表示名が機能します。serverCommand は、コマンドとその引数を正確に一致させた配列です。または serverUrl は、* ワイルドカードを含む URL パターンです
デフォルト : 未設定。サーバーはブロックされません。空の配列も何もブロックしません
{
"deniedMcpServers" : [
{ "serverName" : "filesystem" }
]
}
デニーリストはallowedMcpServers より優先されるため、両方のリストにあるサーバーはブロックされます。ホワイトリストとデニーリストを使用したポリシーベースの制御 を参照してください。
`disableClaudeAiConnectors`
Claude Code が自身で取得する claude.ai MCP コネクタ をオフにして、取得も接続もしません。任意の設定ファイルで true が適用されます。チェックインされたプロジェクト .claude/settings.json はリポジトリをこれらのコネクタから除外できますが、プロジェクトレベルの false はユーザーレベルまたは管理レベルの true をオーバーライドできません。
スコープ : Any file
タイプ : ブール値
true: Claude Code はこれらのコネクタを取得も接続もしません
false: 未設定と同じです。別の設定ファイルまたは ENABLE_CLAUDEAI_MCP_SERVERS がこれらをオフにしない限り、Claude Code はコネクタを取得します
デフォルト : false。Claude Code はコネクタを取得します
セッションごとのオーバーライド : ENABLE_CLAUDEAI_MCP_SERVERS を false に設定すると、1 つのセッションのコネクタがオフになります。2 つのうちどちらがオフにしても、もう一方はオンに戻すことはできません
{
"disableClaudeAiConnectors" : true
}
--mcp-config で明示的に渡すサーバーは影響を受けません。すべてのコネクタをブロックする代わりに個別のコネクタをブロックするには、deniedMcpServers を使用します。claude.ai コネクタを無効にする を参照してください。
`disabledMcpjsonServers`
プロジェクトの .mcp.json ファイルで定義された特定のサーバーを拒否して、Claude Code がこれらに接続したり、承認を求めたりしないようにします。任意の設定ファイルでの拒否が適用されます。リポジトリにチェックインされたプロジェクト .claude/settings.json を含みます。
スコープ : Any file
タイプ : 文字列の配列。.mcp.json に表示されるサーバー名
デフォルト : 未設定
{
"disabledMcpjsonServers" : [ "filesystem" ]
}
Claude Code は、承認ダイアログでサーバーを拒否すると、このキーを .claude/settings.local.json に書き込みます。claude mcp get <name> は、拒否されたサーバーを ✘ Rejected (see disabledMcpjsonServers in settings) として表示します。拒否はenabledMcpjsonServers とenableAllProjectMcpServers より優先されます。
`enableAllProjectMcpServers`
プロジェクト .mcp.json ファイルで定義されたすべての MCP サーバーをプロンプトなしで承認します。Claude Code は、承認ダイアログですべてのサーバーを承認することを選択すると、このキーを .claude/settings.local.json に書き込みます。
スコープ : Any file 。信頼ダイアログを受け入れていないフォルダでは、Claude Code はユーザー設定、管理設定、--settings からこれを尊重し、共有プロジェクトファイルではセッション内と claude mcp list および claude mcp get で無視します。プロジェクトサーバーの承認とワークスペースの信頼 は、追跡されていない .claude/settings.local.json がいつカウントされるかを説明しています。
タイプ : ブール値
true: Claude Code はプロジェクト .mcp.json ファイルで定義されたすべての MCP サーバーをプロンプトなしで承認します
false: Claude Code は各サーバーの承認を求めます。信頼されたフォルダでは、優先度の高いファイルの false は優先度の低いファイルの true をオーバーライドします。信頼していないフォルダでは、尊重されるファイルの true で十分です
デフォルト : 未設定。Claude Code は各サーバーの承認を求めます
{
"enableAllProjectMcpServers" : true
}
disabledMcpjsonServers エントリはサーバーを拒否します。
`enabledMcpjsonServers`
プロジェクト .mcp.json ファイルで定義された特定のサーバーを承認して、Claude Code が質問なしにこれらに接続します。Claude Code は、承認ダイアログでサーバーを承認すると、このキーを .claude/settings.local.json に書き込みます。
スコープ : Any file 。信頼ダイアログを受け入れていないフォルダでは、Claude Code はユーザー設定、管理設定、--settings からこれを尊重し、共有プロジェクトファイルではセッション内と claude mcp list および claude mcp get で無視します。プロジェクトサーバーの承認とワークスペースの信頼 は、追跡されていない .claude/settings.local.json がいつカウントされるかを説明しています。
タイプ : 文字列の配列。.mcp.json に表示されるサーバー名
デフォルト : 未設定
この例は、プロジェクトの .mcp.json から memory および github サーバーを承認します。
{
"enabledMcpjsonServers" : [ "memory" , "github" ]
}
disabledMcpjsonServers エントリはサーバーを拒否します。
`managedMcpServers`
管理設定からすべてのユーザーにリモート MCP サーバーを提供します。ユーザーは自分たちが追加したサーバーを保持し、提供されたサーバーを編集または削除することはできません。Claude Code v2.1.259 以降が必要です。
スコープ : Managed 。Claude Code はユーザー、プロジェクト、ローカル設定でキーを警告とともにドロップし、Claude Desktop アプリのコードタブでサードパーティデプロイメント上で、またはアプリの Cowork セッションで読み込みません。Claude Desktop はこれらのセッションの MCP サーバーを供給してロックします。
タイプ : サーバー名でキー付けされたオブジェクト。各エントリは http または sse サーバーの .mcp.json 形状を持ちます。必須の https:// url と、オプションで headers、oauth、その他の HTTP および SSE オプション。Claude Code は検証に失敗したエントリをドロップし、エントリに含まれる内容 は条件をリストします
デフォルト : 未設定。管理設定はサーバーを提供しません
この例は、search という名前の 1 つの HTTP サーバーを提供します。
{
"managedMcpServers" : {
"search" : {
"type" : "http" ,
"url" : "https://search.example.com/mcp"
}
}
}
優先度、提供されたサーバーが managed-mcp.json および許可リストと拒否リストとどのように組み合わされるか、およびユーザーが何を見るかについては、管理設定を通じてサーバーを提供する を参照してください。
エージェント、セッション、ワークツリー
デフォルトエージェントを設定し、チームメイトとクロスセッションメッセージングを制御し、ワークツリーを設定します。サブエージェント とワークツリー を参照してください。
`agent`
メインスレッドを名前付きサブエージェント として実行し、Claude Code がそのサブエージェントのシステムプロンプト、ツール制限、およびモデルをセッションに適用するようにします。同じキーは claude agents からディスパッチするセッションのデフォルトエージェントも設定します。
スコープ : 任意のファイル
タイプ : 文字列、組み込みまたはカスタムエージェントの名前
デフォルト : 未設定。メインスレッドは Claude Code のデフォルトエージェントとして実行されます
セッションごとのオーバーライド : --agent はこのキーより優先され、1 つのセッションに適用されます
{
"agent" : "code-reviewer"
}
プラグイン独自の settings.json もこのキーを提供できます。プラグインでデフォルト設定を配布する を参照してください。
`crossSessionInbound`
このセッションが他の Claude Code セッションから到着するメッセージ に対して何を行うかを選択します。値が適用されない場合、Claude Code は 2 つのセッションの権限モードクラスからメッセージごとに決定します。Claude Code v2.1.224 以降が必要です。
スコープ : 任意のファイル 。プロジェクトまたはローカル値は、管理設定、--settings フラグ、またはユーザー設定が提供する値より厳密な場合にのみ適用されます。
タイプ : 文字列、以下のいずれか:
"accept": Claude Code はメッセージを Claude に配信します
"hold": Claude Code はメッセージの通知を表示しますが、配信しません
"refuse": Claude Code はメッセージを破棄します
デフォルト : 未設定。Claude Code はメッセージごとに決定します
{
"crossSessionInbound" : "hold"
}
Claude Code は管理設定を最初に読み込み、次に --settings フラグ、その後ユーザー設定を読み込み、最初に見つかった値を適用します。refuse は hold より厳密で、hold は accept より厳密です。信頼できるソースのいずれもが値を設定しない場合、プロジェクトまたはローカルの hold または refuse は依然として適用され、メッセージごとのデフォルトを置き換えます。クロスセッションメッセージングを使用するセッションでは、このキーは /config に他のセッションからのメッセージ として表示され、ユーザー設定に書き込まれます。この行には Claude Code v2.1.232 以降が必要で、--settings フラグまたは管理設定がキーを設定している間、Claude Code はそれを非表示にします。
Claude Code は、認識しない値を設定すると警告 します。その値がユーザー、プロジェクト、ローカル、または --settings ファイルに存在する間、Claude Code は受信メッセージを保留します。優先度が高いソースが accept を設定している場合でも、です。別のソースが設定する refuse は依然として適用されます。値を修正または削除して保留をクリアします。
認識しない値が管理設定 にある場合、Claude Code は代わりに管理者が修正するまで refuse として扱います。v2.1.248 より前では、Claude Code は警告なしに認識しない値を無視していました。
`disableAgentView`
バックグラウンドエージェントとエージェントビュー をオフにします:claude agents、--bg、/background、およびオンデマンドスーパーバイザー。管理設定 で設定して、組織に対して強制します。
スコープ : 任意のファイル
タイプ : ブール値
true: Claude Code は claude agents、--bg、/background、およびオンデマンドスーパーバイザーをオフにします
false: エージェントビューが利用可能です
デフォルト : 未設定。エージェントビューが利用可能です
セッションごとのオーバーライド : CLAUDE_CODE_DISABLE_AGENT_VIEW は 1 つのセッションのエージェントビューをオフにします。2 つのいずれかがそれをオフにすると、もう一方はそれをオンに戻すことはできません
{
"disableAgentView" : true
}
`isolatePeerMachines`
Claude の SendMessage がこのマシンを超えたセッションの 1 つに到達する前に、明示的な承認を要求します。クロスマシンメッセージの承認を要求する を参照してください。承認プロンプトは bypassPermissions モード でも表示されます。
スコープ : 任意のファイル 。任意のスコープからの true が適用されるため、チェックインされたプロジェクトファイルは要件をオンにできますがオフにはできません。
タイプ : ブール値
true: Claude Code は Claude の SendMessage がこのマシンを超えたセッションの 1 つに到達する前に承認を求めます
false: クロスマシンメッセージはプロンプトを表示しません
デフォルト : 未設定。クロスマシンメッセージはプロンプトを表示しません
{
"isolatePeerMachines" : true
}
クロスマシン SendMessage 承認には Claude Code v2.1.224 以降が必要です。
`processWrapper`
macOS と Linux では、Claude Code が開始するバックグラウンドプロセス の前に企業ランチャーコマンドを配置します。Claude Code はランチャーを独自のコマンドラインを追加して実行するため、ランチャーは Claude Code に exec する必要があります。企業ランチャーの背後で Claude Code を実行する を参照してランチャーコントラクトを確認してください。Claude Code v2.1.210 以降が必要です。
{
"processWrapper" : "/opt/corp/launcher --profile claude"
}
Claude Code は Windows でランチャーを無視し、すべてのプロセスをラップされずに開始します。Claude Code v2.1.210 以降が必要です。
`teammateMode`
Claude Code がエージェントチーム チームメイトを表示する場所を選択します:メインターミナルペイン内、またはターミナルがサポートしている場合は分割ペイン内。表示モードを選択する を参照してください。
スコープ : 任意のファイル 。Claude Code は古いバージョンによって ~/.claude.json に残された値も読み込みます。
タイプ : 文字列、以下のいずれか:
"in-process": チームメイトはメインターミナルペイン内で実行されます
"auto": tmux 内で実行している場合、または PATH に it2 がある iTerm2 内で実行している場合、または tmux がインストールされている場合は分割ペイン。それ以外の場合はインプロセス
"tmux": ターミナルから検出された tmux または iTerm2 を使用して分割ペイン
"iterm2": it2 CLI を通じた iTerm2 ネイティブ分割ペイン
デフォルト : "in-process"
セッションごとのオーバーライド : --teammate-mode はこのキーより優先され、1 つのセッションに適用されます
{
"teammateMode" : "auto"
}
`worktree`
Claude Code が --worktree、EnterWorktree ツール、および分離されたサブエージェントとバックグラウンドセッションのgit ワークツリー を作成および管理する方法を設定します。
スコープ : 任意のファイル
タイプ : baseRef、symlinkDirectories、sparsePaths、および bgIsolation を含むオブジェクト
デフォルト : 未設定
この例は、現在の HEAD から新しいワークツリーをブランチし、各ワークツリーに node_modules をシンボリックリンクします:
{
"worktree" : {
"baseRef" : "head" ,
"symlinkDirectories" : [ "node_modules" ]
}
}
.env のような gitignore されたファイルを新しいワークツリーにコピーするには、設定の代わりに.worktreeinclude ファイル をプロジェクトルートに追加します。
`worktree.baseRef`
新しいワークツリーがブランチする ref を選択します。"fresh" は origin/<default-branch> からブランチして、リモートと一致するクリーンツリーを取得します。"head" は現在のローカル HEAD からブランチするため、プッシュされていないコミットとフィーチャーブランチの状態がワークツリーに存在します。
スコープ : 任意のファイル
タイプ : 文字列、以下のいずれか:
"fresh": 新しいワークツリーは origin/<default-branch> からブランチします
"head": 新しいワークツリーは現在のローカル HEAD からブランチします(プッシュされていないコミットを含む)
デフォルト : "fresh"
{
"worktree" : {
"baseRef" : "head"
}
}
リンクされたワークツリー内では、"head" はメインチェックアウトの HEAD ではなく、そのワークツリーの HEAD に解決されます。
`worktree.symlinkDirectories`
メインリポジトリからディレクトリをワークツリーにシンボリックリンクして、ディスク上の大きなディレクトリを複製しないようにします。
スコープ : 任意のファイル
タイプ : 文字列の配列、リポジトリルートに相対的なディレクトリパス
デフォルト : 未設定。Claude Code はディレクトリをシンボリックリンクしません
この例は、メインリポジトリから node_modules と .cache をすべての新しいワークツリーにシンボリックリンクします:
{
"worktree" : {
"symlinkDirectories" : [ "node_modules" , ".cache" ]
}
}
`worktree.sparsePaths`
git sparse-checkout を通じて各ワークツリーにリストされたディレクトリのみをチェックアウトします。Claude Code はそれらのディレクトリとルートレベルのファイルのみをディスクに書き込みます。これは大規模なモノレポでより高速です。必要なディレクトリのみをチェックアウトする を参照してください。
スコープ : 任意のファイル
タイプ : 文字列の配列、リポジトリルートに相対的なディレクトリパス
デフォルト : 未設定。各ワークツリーはツリー全体をチェックアウトします
この例は、各ワークツリーで packages/my-app と shared/utils のみをチェックアウトします(ルートレベルのファイルを含む):
{
"worktree" : {
"sparsePaths" : [ "packages/my-app" , "shared/utils" ]
}
}
スパースワークツリーが存在する間、git はリポジトリの共有 .git/config で extensions.worktreeConfig を有効にします。
`worktree.bgIsolation`
バックグラウンドセッション がファイル編集を分離する方法を選択します。"worktree" では、Claude Code はセッションが EnterWorktree を呼び出すまでメインチェックアウトで Edit と Write をブロックします。"none" では、バックグラウンドジョブはワーキングコピーを直接編集します。git ワークツリーが実用的でないリポジトリの場合は "none" を設定します。
スコープ : 任意のファイル
タイプ : 文字列、以下のいずれか:
"worktree": Claude Code はセッションが EnterWorktree を呼び出すまでメインチェックアウトで Edit と Write をブロックします
"none": バックグラウンドジョブはワーキングコピーを直接編集します
デフォルト : "worktree"
{
"worktree" : {
"bgIsolation" : "none"
}
}
git リポジトリの外では、失敗するWorktreeCreate フック がブロックを解放し、セッションがワーキングディレクトリをその場で編集できるようにします。そのリリースには Claude Code v2.1.203 以降が必要です。
リモート、デスクトップ、および通知
Remote Control、クラウド環境、デスクトップアプリ、および Claude Code が必要な場合に送信する通知を設定します。Remote Control を参照してください。
`agentPushNotifEnabled`
Claude が価値があると判断した場合(たとえば、長いタスクが完了した場合など)に、電話にプッシュ通知を送信することを許可します。Claude Code はこの選択をアカウントに同期し、Remote Control が接続されている間にプッシュが到着します。/config では Push when Claude decides として表示されます。
Scope : Any file 。Claude Code は古いバージョンによって ~/.claude.json に残された値も読み取ります。
Type : Boolean
true: Claude は価値があると判断した場合に電話にプッシュ通知を送信できます
false: Claude はそれらの通知を送信しません
Default : false
{
"agentPushNotifEnabled" : true
}
Mobile push notifications を参照してください。
`awaySummaryEnabled`
数分間離れた後にターミナルに戻ったときに、1 行のセッション要約を表示します。false に設定するか、/config で Session recap をオフにして、要約を停止します。
Scope : Any file
Type : Boolean
true: 数分間離れた後に戻ったときに、1 行のセッション要約が表示されます
false: Claude Code は要約を表示しません
Default : 未設定なので、要約はオンです
Per-session overrides : CLAUDE_CODE_ENABLE_AWAY_SUMMARY はこのキーより優先され、どちらの方向でも 1 セッションに適用されます
{
"awaySummaryEnabled" : false
}
Claude Code は非対話モードでは要約を表示しません。
`disableArtifact`
代わりに enableArtifact を使用して、セッション出力を claude.ai 上のプライベート Web ページとして公開する Artifact ツールをオフにします。/config で Artifacts 行をオフにすると、Claude Code はユーザー設定に enableArtifact を書き込み、このキーをクリアします。
Scope : Any file
Type : Boolean
true: Claude Code はファイルが適用されるすべてのセッションに対して Artifact ツールをオフにし、他のファイルはそれをオンに戻しません
false: 無視されます。ツールをオンのままにするには、キーを削除します
Default : 未設定なので、ツールはアカウントの availability に従います
Per-session overrides : CLAUDE_CODE_DISABLE_ARTIFACT を 1 に設定すると、1 つのセッションのツールがオフになります
{
"disableArtifact" : true
}
Disable artifacts はツールをオフにするすべての方法を一覧表示します。
`disableDeepLinkRegistration`
Claude Code が claude-cli:// プロトコルハンドラーをオペレーティングシステムに登録することを停止します。通常、対話セッションの最初のプロンプトを送信した後に登録されます。Deep links により、外部ツールは事前入力されたプロンプトで Claude Code セッションを開くことができます。プロトコルハンドラー登録が制限されているか、別途管理されている環境でこれを設定します。
Scope : Any file
Type : 文字列 "disable"
Default : 未設定なので、Claude Code はハンドラーを登録します
{
"disableDeepLinkRegistration" : "disable"
}
`disableDesktopLocalSessions`
開発者が SSH 経由でリモートマシンで作業する必要があるデプロイメント用に、デスクトップアプリ で実行されるコードセッションをオフにします。Code タブでは、Local 環境は環境ドロップダウンに留まりますが、グレーアウトされて選択できず、組織がオフにしたことを示すツールチップが表示されます。Windows では WSL エントリも同じようにグレーアウトされますが、WSL セッションがマネージドデバイスで実行されるかどうかは 別途管理されます 。新しいセッションは、設定されている場合は最初の SSH 接続 にデフォルト設定され、アプリは同じマシンへの SSH 接続を含む、デバイス上のセッションの開始または再開を拒否します。他のホストへの SSH セッションとクラウドセッションは影響を受けません。デスクトップアプリはこのキーを読み取ります。ターミナル CLI は無視します。Claude Desktop v1.37937.0 以降が必要です。
Scope : Managed
Type : Boolean。JSON Boolean true のみが有効です
true: デスクトップアプリはオンデバイスコードセッションを提供しません。既存のローカルセッションはリストに残りますが、続行できません
false: ローカルセッションは利用可能なままです
Default : 未設定なので、ローカルセッションは利用可能です
{
"disableDesktopLocalSessions" : true
}
デスクトップアプリは他の値を無視し、文字列 "true" や 1 などの Boolean ではない値も警告をログに記録します。sshConfigs とペアにして、ユーザーが機能する接続にアクセスし、sshHostAllowlist とペアにして、到達できるホストを制限します。Local sessions on managed devices を参照してください。
Claude Desktop は、デスクトップ設定から派生したポリシー(たとえば、エグレス許可リスト、ファイルシステムサンドボックス、サードパーティデプロイメント内の MCP 制限など)を使用して Code セッションを提供します。Claude Code は、管理ソース が存在する場合(サーバー管理設定、MDM または OS レベルのポリシー、またはマネージド設定ファイル)、常にそれらの親設定を無視します。サードパーティデプロイメントのように、以前にないデバイスにこのキーをデプロイすると、デスクトップ派生ポリシーが適用されなくなります。Let an embedding host add policy は、親設定がまだマージできる場合をカバーしています。これは、このキーだけでなく、その方法でデプロイするすべてのキーに適用されます。
`disableRemoteControl`
Remote Control をオフにします。Claude Code は claude remote-control、--remote-control フラグ、自動開始、およびセッション内トグルを拒否し、組織のポリシーがそれを無効にしたことを報告します。マネージド設定 に配置して、デバイスごとの MDM 強制を行います。
Scope : Any file
Type : Boolean
true: Claude Code は claude remote-control、--remote-control フラグ、自動開始、およびセッション内トグルを拒否します
false: Remote Control は利用可能なままです
Default : false
{
"disableRemoteControl" : true
}
`enableArtifact`
セッション出力を claude.ai 上のプライベート Web ページとして公開する Artifact ツールをオフにします。/config で Artifacts 行をオフにすると、Claude Code はこのキーをユーザー設定に書き込むため、通常は手動で編集しません。Claude Code v2.1.196 以降が必要です。
Scope : Any file 。すべてのファイルはツールをオフにでき、どのファイルもそれをオンに戻すことはできません。
Type : Boolean
false: Claude Code はファイルが適用されるすべてのセッションに対して Artifact ツールをオフにします
true: キーを未設定のままにするのと同じです。別のファイルからの false、CLAUDE_CODE_DISABLE_ARTIFACT 、または組織の 管理設定 をオーバーライドしないためです
Default : 未設定なので、ツールはアカウントの availability に従います
{
"enableArtifact" : false
}
ユーザー設定以外のソースがツールをオフのままにしている間、Claude Code は /config で Artifacts 行を非表示にします。そこでオンにしても何も変わらないためです。Disable artifacts はツールをオフにするすべての方法を一覧表示します。
権限プロンプトまたは質問が入力を待っているときに、電話にプッシュ通知を取得します。Claude Code はこれらを Remote Control が接続されている間のみ送信します。/config では Push when actions required として表示されます。
Scope : Any file 。Claude Code は古いバージョンによって ~/.claude.json に残された値も読み取ります。
Type : Boolean
true: Remote Control が接続されている間、権限プロンプトまたは質問が入力を待っているときに、電話にプッシュ通知が届きます
false: Claude Code はそのような通知を送信しません
Default : false
{
"inputNeededNotifEnabled" : true
}
Mobile push notifications を参照してください。
`preferredNotifChannel`
タスクが完了したときまたは権限プロンプトが待機しているときに Claude Code が通知する方法を選択します。/config では Local notifications として表示されます。
Scope : Any file 。Claude Code は古いバージョンによって ~/.claude.json に残された値も読み取ります。
Type : 文字列、以下のいずれか:
"auto": Claude Code は iTerm2、Ghostty、Kitty でデスクトップ通知を送信し、Terminal.app でのみ可聴ベルがオフの場合にベルを鳴らし、他の場所では何もしません
"terminal_bell": Claude Code は任意のターミナルでベル文字を鳴らします
"iterm2": Claude Code は iTerm2 デスクトップ通知を送信します
"iterm2_with_bell": Claude Code は iTerm2 デスクトップ通知を送信し、ベルを鳴らします
"kitty": Claude Code は Kitty デスクトップ通知を送信します
"ghostty": Claude Code は Ghostty デスクトップ通知を送信します
"notifications_disabled": Claude Code は通知を送信しません
Default : "auto"
{
"preferredNotifChannel" : "terminal_bell"
}
"auto" では、Claude Code は iTerm2、Ghostty、Kitty でデスクトップ通知を送信します。Terminal.app では、Terminal の可聴ベルをオフにした場合のみベル文字を鳴らし、他のターミナルでは何もしません。任意のターミナルでベル文字を鳴らすには "terminal_bell" を設定します。Get a terminal bell or notification を参照してください。
`remote.defaultEnvironmentId`
claude --cloud などの CLI から作成するクラウドセッション用のデフォルト クラウド環境 を選択します。Claude Code は /remote-env で環境を選択するときに、このキーをユーザー設定に書き込みます。
Scope : Any file 。自己ホスト環境 ID の場合、ユーザーまたはマネージド設定、または --settings フラグのみ。
Type : 文字列、env_... または ccpool_... などの環境 ID
Default : 未設定なので、Claude Code はリストに Anthropic ホスト環境がある場合はそれを使用し、そうでない場合は Remote Control ブリッジ環境 ではないリスト内の最初の環境を使用するか、すべてがブリッジ環境の場合は最初の環境を使用します
Per-session overrides : --environment はこのキーより優先され、作成する 1 つのクラウドセッションに適用されます
{
"remote" : {
"defaultEnvironmentId" : "env_0123abcd"
}
}
env_ で始まる Anthropic ホスト環境 ID は標準設定の優先度に従うため、リポジトリのプロジェクト設定の値がユーザーレベルの選択をオーバーライドします。ccpool_ で始まる 自己ホスト環境 ID は、ユーザー設定、マネージド設定、および --settings フラグからのみ尊重されます。Claude Code はリポジトリのプロジェクトまたはローカル設定のものを無視し、/remote-env は無視した値を表示するため、チェックインされたファイルは選択しなかった自己ホスト環境にセッションをステアリングできません。
`remoteControlAtStartup`
各対話セッションの開始時に Remote Control を自動的に接続します。/remote-control を待つ代わりに。自動接続をオンにするには true に設定し、オフにするには false に設定します。/config では Enable Remote Control for all sessions として表示されます。
Scope : Any file 。Claude Code は古いバージョンによって ~/.claude.json に残された値も読み取ります。
Type : Boolean
true: Claude Code は各対話セッションの開始時に Remote Control を自動的に接続します
false: Claude Code は /remote-control を待ちます
Default : 未設定なので、自動接続デフォルト が適用されます
Per-session overrides : --remote-control はこのキーが false の場合でも 1 つのセッションに対して Remote Control をオンにし、フラグは 1 つのセッションに対してそれをオフにしません
{
"remoteControlAtStartup" : true
}
Claude Code はプロジェクトまたはローカル設定からの true を無視するため、リポジトリはそのチェックアウトの自動接続をオフにできますが、オンにすることはできません。完全なスコープごとの動作については、Enable Remote Control for all sessions および より厳密な値が適用されるセキュリティキー を参照してください。
`sshConfigs`
Desktop 環境ドロップダウンに SSH 接続を追加します。管理者はこれを使用して、共有接続をチームに配布します。マネージド設定で定義した接続はマネージドとして表示されるため、ユーザーはそれらを選択できますが、アプリで編集または削除することはできません。
Scope : User or managed 。デスクトップアプリはこのキーを読み取ります。
Type : オブジェクトの配列。各オブジェクトは必須の id、name、sshHost と、オプションの sshPort および sshIdentityFile を持ちます
Default : 未設定
この例は、user@dev.example.com に接続する Dev VM という名前の 1 つの接続を追加します:
{
"sshConfigs" : [
{
"id" : "dev-vm" ,
"name" : "Dev VM" ,
"sshHost" : "user@dev.example.com"
}
]
}
`sshHostAllowlist`
Desktop SSH セッション が接続できるホストを制限します。デスクトップアプリのみがこのキーを読み取ります。CLI は読み取りません。パターンは大文字と小文字を区別しません。* は任意のホストに一致し、*.example.com は example.com とすべてのサブドメインに一致し、その他は ~/.ssh/config 解決後のホスト名に対する完全一致です。空の配列は SSH セッションをオフにします。
Scope : Managed
Type : ホスト名パターンの配列
Default : 未設定なので、任意のホストが許可されます
この例は、devboxes.example.com とそのサブドメイン、および正確なホスト bastion.example.com を許可します:
{
"sshHostAllowlist" : [ "*.devboxes.example.com" , "bastion.example.com" ]
}
認証とプロバイダー
ヘルパースクリプトを通じて認証情報を提供し、組織の場合はログイン方法または組織を強制します。認証 を参照してください。
`allowedProviders`
マシンが Claude に到達できるサービス(Anthropic API、Amazon Bedrock、LLM ゲートウェイなど)をリストアップします。リストに記載されていないプロバイダー上のセッションは、スタートアップ時、ログイン時、および次に API に接続するときに拒否されるため、セッション中にリストに記載されていないプロバイダーに切り替えることも拒否されます。拒否メッセージ には、プロバイダーを選択したものと続行するためのステップが記載されています。Claude Code v2.1.285 以降が必要です。
スコープ : Managed 。マシン自身の管理者ソースが設定したリスト、MDM ポリシーおよび管理設定ファイルが適用し続けます。サーバー管理設定もリストを配信する場合、セッションは両方のリスト上のプロバイダーのみを使用できるため、サーバー管理リストはマシンが許可するものを狭めることはできますが、広げることはできません。マシンソースの allowedProviders のどれが数えられるかは、Claude Code が管理ソースを組み合わせる方法 に従います。サーバー管理設定のみを通じて配信されたリストは、サーバー管理設定を取得する セッションのみに到達します。
タイプ : 文字列の配列。各要素は以下のいずれか:
デフォルト : 未設定。任意のプロバイダーを使用できます
{
"allowedProviders" : [ "anthropic" , "bedrock" ]
}
各クラウドプロバイダーのエントリは、そのプロバイダー独自のサービス(地域、FIPS、プライベートエンドポイントを含む)を意味します。
Claude Code がプロバイダー名として認識しないエントリは削除され、報告され、リストの残りは強制されます。空のリスト、またはすべてのエントリが認識されないリストの場合、Claude Code はすべてのプロバイダーを拒否し、マシン上で起動しません。
管理 `env` でピンが必要なエンドポイント
ピンは、管理 env ブロックで設定されたエンドポイント変数の値です。セッションがプロバイダーのトラフィックをそのプロバイダー独自のサービス以外の場所に送信する場合、Claude Code はセッションの値がピンと同じ場合にのみそれを許可します。これらのエンドポイントには 1 つが必要です:
"customEndpoint" セッション : ホストを指定する変数(ANTHROPIC_BASE_URL など)
Amazon Bedrock : AWS SDK の AWS_ENDPOINT_URL、AWS_ENDPOINT_URL_BEDROCK、および AWS_ENDPOINT_URL_BEDROCK_RUNTIME 変数が Bedrock 独自のサービス外を指す場合。セッションは "customEndpoint" ではなく "bedrock" の下に留まります
ゲートウェイサインイン URL : セッションは "gateway" の下に留まり、forceLoginGatewayUrl もピンとしてカウントされます
どの env ブロックがピンとしてカウントされるかは、リストが設定されている場所によって異なります:
マシン上の管理者ソースがリストを設定 : マシン独自の管理者ソースの env ブロックのみがカウントされます
サーバー管理設定のみがリストを設定 : これらのサーバー管理設定の env 値もカウントされます
リストは、クラウドプロバイダーの認証情報とテナンシー変数、または HTTPS_PROXY と証明書設定などのネットワークパスを判定しません。管理 env ブロックでフロート用にそれらを設定します。
`apiKeyHelper`
Claude Code がモデルリクエストで送信する認証情報を生成するために独自のコマンドを実行します。Claude Code はコマンドをシステムシェル(macOS と Linux では /bin/sh、Windows では cmd)を通じて実行し、その出力を X-Api-Key ヘッダーと Authorization: Bearer ヘッダーの両方として送信します。ボールトから取得した短期トークンなど、動的または回転する認証情報に使用します。
スコープ : Any file
タイプ : 文字列、シェルコマンドライン
デフォルト : 未設定。Claude Code はヘルパーを実行しません
{
"apiKeyHelper" : "/bin/generate_temp_api_key.sh"
}
Claude Code はこれらの場合に値をキャッシュし、コマンドを再実行します。
キャッシュの有効期限後。デフォルトは 5 分、または CLAUDE_CODE_API_KEY_HELPER_TTL_MS で設定した間隔
Anthropic API へのリクエスト(直接または LLM ゲートウェイ 経由)が 401 または 403 で失敗した場合
Anthropic API へのリクエスト(直接または LLM ゲートウェイ経由)を送信する前に、キャッシュされた出力がヘルパーが生成した後に期限切れになった JWT である場合。Claude Code v2.1.246 以降が必要です。
最後の 2 つのケースは、ヘルパーの出力が Claude Code が送信する認証情報であり、ANTHROPIC_AUTH_TOKEN が設定されていない場合にのみ適用されます。
インタラクティブセッションでは、コマンドがプロジェクトまたはローカル設定から来ている場合、Claude Code はワークスペーストラストプロンプトを受け入れるまでコマンドを実行しません。認証情報管理 を参照してください。
`awsAuthRefresh`
aws sso login などの独自のコマンドを実行して、Claude Code が Amazon Bedrock に対して持つ認証情報が機能しなくなったときに .aws ディレクトリの認証情報をリフレッシュします。Claude Code は最初に現在の認証情報を STS に対してチェックし、そのチェックが失敗した場合にのみコマンドを実行してから、リフレッシュされた .aws ディレクトリを読み取ります。
スコープ : Any file
タイプ : 文字列、シェルコマンドライン
デフォルト : 未設定。Claude Code は AWS 認証情報をリフレッシュしません
{
"awsAuthRefresh" : "aws sso login --profile myprofile"
}
リフレッシュフローが .aws に書き込む場合はこのキーを使用します。代わりに認証情報を出力する場合は awsCredentialExport を使用します。高度な認証情報設定 を参照してください。
`awsCredentialExport`
AWS 認証情報を JSON として出力する独自のコマンドを実行して、Claude Code が .aws ディレクトリに存在しない認証情報で Amazon Bedrock を呼び出すことができるようにします。Claude Code は aws sts 出力形式とフラットな aws configure export-credentials 形式を受け入れ、認証情報を独自の Bedrock クライアントにスコープするため、Claude Code が実行するシェルコマンドは引き続き環境の認証情報を参照します。
スコープ : Any file
タイプ : 文字列、シェルコマンドライン
デフォルト : 未設定。Claude Code は環境の AWS 認証情報チェーンを使用します
{
"awsCredentialExport" : "/bin/generate_aws_grant.sh"
}
awsAuthRefresh とは異なり、Claude Code はこのコマンドが設定されている場合、環境の認証情報を最初にチェックせずに常に実行します。高度な認証情報設定 を参照してください。
`forceLoginMethod`
ユーザーがログインできるアカウントの種類を制限します。"claudeai" を設定して claude.ai アカウントのみを許可するか、"console" を設定して Claude Console アカウントのみを許可するか、"gateway" を設定して クラウドゲートウェイ にユーザーを送信します。管理者は管理設定で設定し、forceLoginOrgUUID と組み合わせて開発者の claude.ai ログインを 1 つの組織内に保つことができます。任意の設定ファイルで "claudeai" または "console" に設定した場合、Claude Code はそのファイルが適用されるセッションで キーレス Console サインイン の提供も停止します。
スコープ : Any file 。Claude Code は "gateway" をマシン上の管理ソース(managed-settings.json、macOS plist または Windows HKLM レジストリ、またはポリシーヘルパー)からのみ受け入れます。ユーザー、プロジェクト、ローカル、HKCU、およびサーバー管理設定では "gateway" を未設定として扱います。これは forceLoginGatewayUrl と同じルールです。
タイプ : 文字列、以下のいずれか:
"claudeai": claude.ai アカウントのみがログインできます
"console": Claude Console アカウントのみがログインできます
"gateway": Claude Code はユーザーをファーストパーティログインの代わりにクラウドゲートウェイに送信します
デフォルト : 未設定。ユーザーはログイン方法を選択します
{
"forceLoginMethod" : "claudeai"
}
すべてのファーストパーティログインパスが制限を適用します。VS Code 拡張機能 、Agent SDK、claude setup-token、および /install-github-app を含みます。ただし、ターミナルのインタラクティブログイン画面(/login または初回実行オンボーディングで到達)は、メソッドを事前選択しますが強制しません。v2.1.212 より前は、ターミナルログインのみが適用されていました。ログインを組織に制限する を参照して、各ログインパス、環境認証情報、およびサードパーティプロバイダーがどのように処理されるかを確認してください。
マシン上の管理ソースが "gateway" を設定する場合、Claude Code は残されたログイン、API キー、または apiKeyHelper 認証情報を使用しません。各メッセージについては 管理者ポリシーがクラウドゲートウェイサインインを必要とします を参照してください。CLAUDE_CODE_USE_BEDROCK または同様の環境変数を通じてクラウドプロバイダーを選択する場合、セッションはゲートウェイサインインを必要としません。v2.1.261 より前は、Claude Code はこれらのマシンで残されたログインを使用していました。
`forceLoginGatewayUrl`
/login クラウドゲートウェイ画面が接続するゲートウェイ URL を設定して、ユーザーがアドレスを入力せずに クラウドゲートウェイ に到達できるようにします。画面には URL フィールドがありません。このキーが設定されている場合、ゲートウェイ URL を表示し、ユーザーが Enter キーを押すと接続します。設定されていない場合、IT 管理者に連絡するよう指示します。
このキーまたは forceLoginMethod: "gateway" のいずれかがマシンをゲートウェイのみにするため、CLAUDE_CODE_USE_* でクラウドプロバイダーを選択するセッションを除き、/login はログイン方法ピッカーなしでクラウドゲートウェイ画面で開きます。残されたファーストパーティログインまたは API キーに何が起こるかについては、管理者ポリシーがクラウドゲートウェイサインインを必要とします を参照してください。画面がエラーを表示する代わりに接続するように、両方のキーを設定します。
スコープ : Managed 。マシン上のソースからのみ読み取ります。managed-settings.json、macOS plist または Windows HKLM レジストリ、またはポリシーヘルパー。Claude Code は HKCU およびサーバー管理設定では無視します。
タイプ : 文字列、スキームを含む完全な URL
デフォルト : 未設定。クラウドゲートウェイ画面は IT 管理者に連絡するよう指示するエラーを表示します
{
"forceLoginGatewayUrl" : "https://claude-gateway.example.com"
}
値が有効な URL でない場合、サインイン画面はそれを報告し、管理設定ファイルの残りは引き続き適用されます。ゲートウェイ URL を設定する を参照してください。
`forceLoginOrgUUID`
管理ソースから、claude.ai アカウントログインが 1 つの Anthropic 組織(単一の UUID として指定)または複数の組織(配列として指定)に属することを要求します。任意の設定ファイルから、Claude Code は単一の UUID を使用して claude.ai または Claude Console ログイン中にその組織を事前選択し、配列の場合は何も事前選択しません。任意の設定ファイルでキーを設定する場合、Claude Code はそのファイルが適用されるセッションで キーレス Console サインイン の提供も停止し、代わりに API キーを作成します。
スコープ : Any file 。管理ソースのみが制限を強制します。他の設定ファイルの単一の UUID は、制限なしにログイン中に組織を事前選択します。
タイプ : 文字列、1 つの UUID、または文字列の配列、複数の UUID
デフォルト : 未設定。任意の組織がログインできます
この例は、1 つを事前選択せずに 2 つの組織のいずれかからのログインを受け入れます。
{
"forceLoginOrgUUID" : [ "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" , "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy" ]
}
管理ソースが空の配列を設定するか、Claude Code が解析できない値を設定する場合、Claude Code はすべてのログインを設定ミスメッセージでブロックします。
ログインを組織に制限する を参照して、Claude Code が Claude Console ログイン、他のログインパス、および環境認証情報をどのように扱うかを確認してください。
`gatewayInternalNetworks`
組織が内部ネットワークに番号を付ける公開 IPv4 ブロックを宣言して、/login が クラウドゲートウェイ をそこで受け入れるようにします。Claude Code v2.1.268 以降が必要です。
このキーがない場合、/login はプライベートアドレス上のゲートウェイのみに接続し、それ以外には接続しません。このキーがある場合、/login はリストされたブロック内のゲートウェイも受け入れます。直接接続のみです。その接続上のマシン自身のアドレスも同じブロック内にある必要があります。
スコープ : Managed 。マシン上のソースからのみ読み取ります。managed-settings.json、macOS plist または Windows HKLM レジストリ、またはポリシーヘルパー。Claude Code は HKCU およびサーバー管理設定では無視します。
タイプ : 文字列の配列、最大 4 つの IPv4 CIDR ブロック、各 /8 から /32、互いに重複しない、およびプライベートスペースと重複しない
デフォルト : 未設定。/login はプライベートアドレス上のゲートウェイのみを受け入れます
{
"gatewayInternalNetworks" : [ "203.0.113.0/24" ]
}
例のドキュメンテーション範囲を独自のブロックに置き換えます。Claude Code はドキュメンテーション範囲、VPN と NAT64 クライアントがローカルで使用する範囲、およびマルチキャストなどのネットワークが番号を付けられていない予約スペースを拒否します。
エントリが無効であるか、値が文字列のリストでない場合、/login は問題を名前で指定し、値を修正するまでマシン上のすべての新しいゲートウェイサインインを拒否します。既存のサインインは機能し続けます。完全なルールと開発者が見るものについては、所有する公開アドレススペース上のゲートウェイを許可する を参照してください。
`gcpAuthRefresh`
Claude Code が Google Cloud Application Default Credentials の有効期限が切れているか読み込めないことを検出したときにリフレッシュするために独自のコマンドを実行して、Google Cloud の Agent Platform リクエストが手動で再認証することなく機能し続けるようにします。
スコープ : Any file
タイプ : 文字列、シェルコマンドライン
デフォルト : 未設定。Claude Code の認証情報エラーは gcloud auth application-default login を自分で実行するよう指示します
{
"gcpAuthRefresh" : "gcloud auth application-default login"
}
高度な認証情報設定 を参照してください。
Claude Code が OpenTelemetry エクスポートで送信するヘッダーを生成するために独自のコマンドを実行します。トークンが回転するバックエンド用です。Claude Code はスタートアップ時と定期的にその後実行し、stdout で文字列ヘッダー値の JSON オブジェクトを期待します。
スコープ : Any file
タイプ : 文字列、実行可能パスまたはシェルコマンドライン
デフォルト : 未設定。Claude Code はヘルパー生成ヘッダーを追加しません
{
"otelHeadersHelper" : "/bin/generate_otel_headers.sh"
}
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS でリフレッシュ間隔を設定します。スクリプト要件と Claude Code が失敗したヘルパーを報告する場所については、動的ヘッダー を参照してください。
アップデートとバージョン管理
アップデートチャネルを選択し、組織の場合はユーザーが実行できるバージョンをピン留めします。Claude Code を更新 を参照してください。
`autoUpdatesChannel`
リリースチャネル をバックグラウンド自動更新と claude update が従うかを選択します。通常約 1 週間前のバージョンで、大きな回帰を含むリリースをスキップする "stable" を設定するか、最新リリースの "latest" を設定します。
スコープ : Any file 。組織全体で 1 つのチャネルを強制するために、管理設定で設定します。
タイプ : 文字列、以下のいずれか:
"latest":更新は最新リリースに従う
"stable":更新は通常約 1 週間前のバージョンに従い、大きな回帰を含むリリースをスキップする
デフォルト : 未設定の場合、Claude Code は "latest" に従う
{
"autoUpdatesChannel" : "stable"
}
Claude Code は /config の Auto-update channel で選択すると、ユーザー設定に "stable" を書き込み、そこで最新に戻すとキーを削除します。claude install stable と claude install latest も、指定したチャネルを保存します。/config で "latest" から "stable" に切り替えると、ダウングレードを許可するか現在のバージョンにとどまるかを尋ねます。とどまることを選択すると、minimumVersion が設定されます。Homebrew インストールはこのキーを無視します:claude-code cask は stable を追跡し、claude-code@latest は latest を追跡し、claude update は brew upgrade に従います。自動更新を完全に無効にするには、env で DISABLE_AUTOUPDATER を設定します。
`minimumVersion`
バックグラウンド自動更新と claude update がこれより下のバージョンをインストールするのを防ぎます。これにより、"stable" チャネルに移動しても、より新しい "latest" ビルドからダウングレードされません。Claude Code は /config でチャネルを切り替えながら現在のバージョンにとどまることを選択すると、このキーを書き込み、"latest" に戻すと削除します。
スコープ : Any file 。ユーザーおよびプロジェクト設定が低下させることができない、組織全体の最小値をピン留めするために、管理設定で設定します。
タイプ : 文字列、"2.1.100" などのバージョン番号。有効なバージョンではない値は無視されます
デフォルト : 未設定の場合、更新はチャネルが提供するすべてのバージョンをインストールできる
この例は stable チャネルに従い、2.1.100 より下のバージョンをインストールするのを拒否します:
{
"autoUpdatesChannel" : "stable" ,
"minimumVersion" : "2.1.100"
}
このキーは更新のみを制約します。Claude Code がバージョン以下で起動するのを拒否させるには、代わりに requiredMinimumVersion を使用します。最小バージョンをピン留めする を参照してください。
`requiredMaximumVersion`
組織が起動を許可する最新の Claude Code バージョンを設定します。実行中のバージョンがより新しい場合、Claude Code は起動時に終了し、ユーザーに組織の承認された方法を通じて承認されたバージョンをインストールするよう指示します。claude install <version> も機能する場合があります。Claude Code v2.1.163 以降が必要です。
スコープ : Managed 。Claude Code は他の場所でキーを無視するときに警告を表示しません。
タイプ : 文字列、"2.1.150" などのバージョン番号。有効なバージョンではない値は無視されます
デフォルト : 未設定の場合、上限は適用されません
{
"requiredMaximumVersion" : "2.1.150"
}
バックグラウンド自動更新と claude update は上限より上のバージョンをスキップするため、範囲内のインストールは範囲内にとどまります。claude update、claude install、および claude doctor は、ユーザーが復旧できるように上限より上で機能し続けます。requiredMinimumVersion とペアにして、範囲を強制します。
`requiredMinimumVersion`
組織が起動を許可する最も古い Claude Code バージョンを設定します。実行中のバージョンがより古い場合、Claude Code は起動時に終了し、ユーザーに組織の承認された方法を通じて更新するよう指示します。チェックは起動時のみ実行されるため、既に実行中のセッションは続行されます。Claude Code v2.1.163 以降が必要です。
スコープ : Managed 。Claude Code は他の場所でキーを無視するときに警告を表示しません。
タイプ : 文字列、"2.1.150" などのバージョン番号。有効なバージョンではない値は無視されます
デフォルト : 未設定の場合、下限は適用されません
{
"requiredMinimumVersion" : "2.1.150"
}
claude update、claude install、および claude doctor は、ユーザーが復旧できるように下限より下で機能し続けます。ダウングレードのみを防ぐ minimumVersion とは異なり、このキーは起動をブロックします。requiredMaximumVersion とペアにして、範囲を強制します。
Claude Code デスクトップアプリ で特定のツールをオフにします。ターミナル CLI はこれらのキーを無視します。ツール自体については、Claude が利用可能なツール を参照してください。
`browserExternalPageTools`
デスクトップアプリのブラウザペイン で、Claude がそのツールを使用して外部ページを読み取ったり、外部ページに対して操作したりするのを停止します。組織内のユーザーは引き続き外部サイトを自分で開くことができ、ローカル開発サーバープレビューは Claude のツールで引き続き機能します。デスクトップアプリはこのキーを読み取ります。ターミナル CLI は無視します。
スコープ : Managed
タイプ : 文字列、"disabled"。デスクトップアプリは"disable"も受け入れます。どちらの場合でも同じです
デフォルト : 未設定。Claude のツールは外部ページで機能します
{
"browserExternalPageTools" : "disabled"
}
その他の値を指定すると Claude のツールはオンのままになり、受け入れられた 2 つの値のいずれでもない空でない文字列は警告をログに記録します。ユーザーと Claude の両方に対して外部サイトをブロックするには、代わりにdisableBrowserExternalNavigation を設定してください。組織の外部ブラウジングを制限する を参照してください。
`disableBrowserExternalNavigation`
デスクトップアプリのブラウザペイン で、ユーザーと Claude の両方に対して外部ブラウジングをオフにします。Localhost 開発サーバープレビューは引き続き機能します。デスクトップアプリはこのキーを読み取ります。ターミナル CLI は無視します。
スコープ : Managed
タイプ : ブール値。JSON ブール値trueのみが有効です
true: デスクトップアプリは、ブラウザペインでユーザーと Claude の両方に対して外部ブラウジングをオフにします。localhost プレビューは引き続き機能します
false: 外部ブラウジングはオンのままです
デフォルト : 未設定。外部ブラウジングはオンです
{
"disableBrowserExternalNavigation" : true
}
デスクトップアプリはその他の値を無視し、文字列"true"や1などのブール値ではない値も警告をログに記録します。外部ブラウジングはオンのままにしておきたいが、Claude のツールを外部ページでオフにしたい場合は、代わりにbrowserExternalPageTools を設定してください。組織の外部ブラウジングを制限する を参照してください。
デスクトップアプリのiOS シミュレータペイン に対する Claude のツールをブロックします。ユーザーはペインの手動使用を継続できます。Claude のアクセスのみが削除され、アプリ内から誰もそれを再度オンにすることはできません。デスクトップアプリはこのキーを読み取ります。ターミナル CLI は無視します。
スコープ : Managed
タイプ : ブール値。JSON ブール値trueのみが有効です
true: デスクトップアプリは iOS シミュレータペインに対する Claude のツールをブロックします
false: Claude のシミュレータツールは、デスクトップアプリ内の各ユーザーの設定トグルに従います
デフォルト : 未設定。Claude のシミュレータツールは、デスクトップアプリ内の各ユーザーの設定トグルに従います
{
"disableMobileSimulatorTools" : true
}
デスクトップアプリはその他の値を無視し、文字列"true"や1などのブール値ではない値も警告をログに記録します。
プライバシーとテレメトリ
Claude Code がセッションデータをどのくらいの期間保持し、何を送信するかを制御します。使用メトリクスとエラーレポートをオフにするスイッチは、設定キーではなく環境変数です。env キーまたはシェルで DISABLE_TELEMETRY、DISABLE_ERROR_REPORTING、または CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC を設定します。テレメトリサービス では、各環境変数が何を停止するかについて説明しています。2 つの例外は設定ファイルからオフになります。以下の feedbackDrafts は Claude が作成したフィードバック用、および以下の feedbackSurveyRate はセッションサーベイ用です。
`cleanupPeriodDays`
Claude Code が セッショントランスクリプトおよび他のアプリケーションデータ を削除する前に保持する日数を設定します。Claude Code はセッション開始後にバックグラウンド削除を実行します。保持期間を安全に判定できる限り実行されます。削除スイープはメッセージを表示せずにトランスクリプトを削除するため、保持期間より長く使用していないセッションは /resume ピッカーに表示されなくなります。
スコープ : Any file
タイプ : 日数、整数、最小値 1
デフォルト : 30
{
"cleanupPeriodDays" : 20
}
0 を設定するとバリデーションが失敗するため、長期保持の場合は 3650 などの大きな値を選択してください。Claude Code がトランスクリプトを書き込まないようにするには、プレーンテキストストレージ を参照してください。
`desktopSessionCleanupPeriodDays`
Claude Desktop または Cowork で開始または最後に続行したセッションのトランスクリプトに対して、日数での年齢制限を設定します。このキーがない場合、Claude Code は それらのトランスクリプトを任意の年齢で保持します 。Claude Code は各トランスクリプトが、この制限と cleanupPeriodDays の両方より古い場合に削除します。したがって、cleanupPeriodDays がデフォルトの 30 の場合、7 の値でも 30 日間保持されます。管理設定が cleanupPeriodDays を設定する場合、その期間が代わりに適用され、このキーは無視されます。Claude Code v2.1.248 以降が必要です。
スコープ : User or managed 。Claude Code は --settings で渡すファイルからキーを読み込み、プロジェクトおよびローカル設定では無視します。
タイプ : 日数、整数、最小値 0
デフォルト : 0。年齢制限を設定しません
{
"desktopSessionCleanupPeriodDays" : 90
}
`feedbackDrafts`
Claude が作成したフィードバック を制御します。Claude がレビュー用のフィードバックドラフトをキューに入れることができるかどうか、および Claude Code が Claude がドラフトをキューに入れたときにカードを表示するかどうかを制御します。
スコープ : User or managed
タイプ : 文字列。"notify"、"quiet"、または "off" のいずれか
"notify":Claude Code は Claude がドラフトをキューに入れたときにプロンプトの上にカードを表示します。デフォルトではセッションあたり 最大 3 枚のカード
"quiet":Claude はカードなしでドラフトを作成します。プロンプトフッターでキューに入れられたドラフトの数を確認し、/feedback でレビューします
"off":Claude Code は SendFeedback ツールを削除するため、Claude はドラフトをキューに入れることができません
デフォルト : "notify"
セッションごとのオーバーライド : CLAUDE_CODE_SEND_FEEDBACK を 0 に設定すると、1 つのセッションでこの機能がオフになります
{
"feedbackDrafts" : "quiet"
}
/config に Claude-drafted feedback として表示されます。これはこのキーをユーザー設定に書き込みます。/config 行は Claude がフィードバックドラフトを作成できるセッション でのみ表示されます。"off" を設定してもこれは非表示にならないため、同じ行から機能を再度オンにできます。管理設定の値はユーザー設定より優先されるため、管理者がこのキーを設定すると、行は管理値を表示し、変更しても効果がありません。Claude Code はプロジェクトおよびローカル設定でこのキーを無視します。
`feedbackSurveyRate`
セッション品質サーベイ がセッションがそれに適格である場合に表示される確率を設定します。0 を設定してサーベイが表示されないようにします。
スコープ : Any file
タイプ : 0 から 1 の間の数値
デフォルト : 未設定。Claude Code は Anthropic がリモートで設定する率を使用するか、Amazon Bedrock、Google Cloud の Agent Platform、および Microsoft Foundry でのビルトイン率 0.005 を使用します。これらはリモート設定を受け取りません
セッションごとのオーバーライド : CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY を 1 に設定すると、このキーが設定する率に関係なく、1 つのセッションでサーベイがオフになります
{
"feedbackSurveyRate" : 0.05
}
同じ率が VS Code 拡張機能のサーベイに適用されます。
`skipWebFetchPreflight`
WebFetch ドメイン安全性チェック をスキップします。このチェックは、フェッチする前に各リクエストされたホスト名を api.anthropic.com に送信します。Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry デプロイメント(制限的な出力を持つ)など、Anthropic へのトラフィックをブロックする環境で true を設定します。
スコープ : Any file
タイプ : ブール値
true:Claude Code は WebFetch ドメイン安全性チェックをスキップします
false:チェックはセッション内の各ホスト名への最初のフェッチの前に実行され、以前のチェックがブロックされたか失敗したホスト名に対して再度実行されます
デフォルト : 未設定。チェックはセッション内の各ホスト名への最初のフェッチの前に実行されます
{
"skipWebFetchPreflight" : true
}
チェックがスキップされた場合、WebFetch はブロックリストを参照せずに任意の URL を試行するため、Claude が到達できるドメインを制限する必要がある場合は WebFetch 権限ルール と組み合わせてください。
エンタープライズおよび管理設定
組織が管理設定を計算、更新、および組み合わせるために使用するキー。管理設定の設定 を参照してください。
`disableSideloadFlags`
起動時に --plugin-dir、--plugin-url、--agents、および --mcp-config CLI フラグを拒否します。これらのフラグは、ユーザーが strictKnownMarketplaces を単一実行でバイパスするために渡す可能性があります。Claude Code はエラーで終了し、拒否されたフラグを名前で指定します。クラウドセッション では、Claude Code はセッションを開始し、サーバーが配信した --mcp-config エントリをドロップします。ただし、プロセス内 type: "sdk" エントリと Claude Tag セッションの Slack ツールは除きます。Claude Code v2.1.193 以降が必要です。
スコープ : Managed
タイプ : ブール値
true: Claude Code は起動時に --plugin-dir、--plugin-url、--agents、および --mcp-config を拒否し、エラーで終了して名前を指定します。クラウドセッションでは、セッションを開始し、サーバーが配信した --mcp-config エントリをドロップします。ただし、プロセス内 type: "sdk" エントリと Claude Tag セッションの Slack ツールは除きます
false: Claude Code はこれらのフラグを受け入れます
デフォルト : false
{
"disableSideloadFlags" : true
}
Claude Code は、サーバーがすべてプロセス内 type: "sdk" エントリである --mcp-config を受け入れます。これにより、Agent SDK と VS Code 拡張機能は動作し続けます。ユーザーは claude mcp add またはファイル .mcp.json でサーバーを追加できます。サーバーごとの制御については、allowedMcpServers も設定してください。Claude Code v2.1.193 以降が必要です。
同じチェックは、CLAUDE_CODE_PLUGIN_DIRS 環境変数で名前が付けられたプラグインフォルダをカバーします。これには Claude Code v2.1.280 以降が必要です。変数がフォルダを名前で指定する場合、Claude Code は同じエラーで終了し、エラーは変数をアンセットするように指示します。
クラウドセッションでは、Claude Code はセッション中の MCP 更新も無視します。これは、クラウドセッション構成と SDK setMcpServers() 呼び出しの背後にあるパスです。プロセス内 type: "sdk" エントリと Claude Tag セッションの Slack ツールはそこでも除外されたままです。v2.1.268 より前では、このドロップと起動ドロップの両方も Claude Tag セッションの Slack ツールを削除していました。v2.1.239 より前では、サーバーが配信した --mcp-config はクラウドセッションの開始をブロックしていました。
デスクトップアプリは、claude.ai から同期されたプラグインや、組織がアプリを通じてデプロイするプラグインを含む、いくつかのプラグインを自身で管理します。MDM、OS レベルのポリシー、または管理設定ファイルを通じてこのキーをデバイスにデプロイする場合、デスクトップアプリはそれらのプラグインを、そのデバイス上の以下のセッションに渡しません:
ユーザーのマシン上のコードセッション : ユーザーの claude.ai アカウントに対して有効になっているスキルなしでも開始します。Claude Code が管理設定のマーケットプレイスからインストールするプラグインは引き続きロードされます。Claude Desktop on 3P では、デバイスの org-plugins ディレクトリにデプロイするプラグインからの MCP サーバーは利用可能なままです。デスクトップアプリが自身でそれらに接続するため。Claude Desktop v1.37937.0 より前では、これらのセッションは起動時に失敗していました。
ユーザーのマシン上の Cowork セッション : それらのプラグイン内のスキルとユーザーの claude.ai アカウントに対して有効になっているスキルは利用可能なままです。Claude Desktop on 3P では、デバイスの org-plugins ディレクトリにデプロイするプラグインからの MCP サーバーは利用可能なままです。デスクトップアプリが自身でそれらに接続するため。Claude Desktop v1.44121.0 より前では、これらのセッションは起動時に失敗していました。
`forceRemoteSettingsRefresh`
Claude Code が サーバー管理設定 を新たに取得するまで CLI 起動をブロックします。取得に失敗した場合、Claude Code はキャッシュされた設定または設定なしで続行する代わりに終了します。環境が管理ポリシーなしでセッションが実行される短い時間枠を受け入れられない場合に設定します。
キーが設定されていない場合、Claude Code は取得時に起動をブロックしません。ただし、開発者が起動時にサインインする場合、取得を最大 5 秒間待機します。Cloud ゲートウェイセッションは常に待機し、ゲートウェイに到達できない場合は終了します。
スコープ : Managed 。Claude Code は、最優先度のソースでなくても、管理者が制御する管理ソースからの true を尊重します。
タイプ : ブール値
true: Claude Code は起動をブロックして、サーバー管理設定を新たに取得するまで待機し、取得に失敗した場合は終了します
false: Claude Code は取得時に起動をブロックしません。ただし、サインイン起動では最大 5 秒間待機します
デフォルト : false
{
"forceRemoteSettingsRefresh" : true
}
MDM プロファイルまたは管理設定ファイルで設定して、最初のサーバーペイロードが到着する前に失敗時閉鎖起動を強制します。Claude Code は、サーバー管理設定を取得するセッションでのみチェックを適用します。それらを取得しないセッション は待機なしで開始します。claude auth サブコマンドは除外されるため、ユーザーは期限切れの認証情報が取得に失敗する理由である場合に再認証できます。失敗時閉鎖起動を強制する を参照してください。
`managedSourcesBehavior`
Claude Code が、組織が配信する最優先度の 管理ソース のみを適用するか、配信するすべての管理者ソースを組み合わせるかを選択します。デフォルトでは、Claude Code は ポリシーキー を含む最優先度のソースを取得し、残りを無視します。ポリシーキーは、このキーと wslInheritsWindowsSettings 以外の設定キーです。そのデフォルトでは、サーバー管理設定または MDM ポリシーがポリシーキーを配信すると、managed-settings.json ファイルは Claude Code がすべての管理ソースから読み取るキー のみを提供します。"merge" を使用すると、配信するすべての管理ソースがそのキーを 1 つの組み合わせたポリシーに提供します。Claude Code v2.1.242 以降が必要です。
"merge" は、ランク付けされた 最優先度のソースの下のすべてのソースが管理者の制御下にある場合にのみ設定してください。Claude Code は、permissions.allow ルールなどの下位ソースからのエントリをポリシーに追加します。
スコープ : Managed 。Claude Code はこのキーを、このキーまたはポリシーキーを含む最優先度のソースから読み取り、ランク付けされた下位のすべてのソースでこのキーを無視します。下位ソースは、上位のソースとの組み合わせにオプトインできません。Windows HKCU レジストリも 埋め込みホストからの親設定 も、マージに参加しません。
タイプ : 文字列、次のいずれか:
デフォルト : "first-wins"
デプロイする最優先度のソースでキーを配信します。サーバー管理設定を受け取らないマシンは、Claude Code がこのキーまたはポリシーキーを含む最優先度のソースからキーを読み取るため、MDM プロファイルにもキーが必要です。managed-settings.json ファイルは最下位の管理ソースであるため、そこに設定された "merge" は、それと組み合わせる下位ソースがありません。サーバー管理設定では、キーは次のようになります:
{
"managedSourcesBehavior" : "merge"
}
"merge" では、Claude Code は各キーをそのタイプで組み合わせます。このテーブルは各タイプのルールを示します。制限許可リスト、値全体取得、および最優先度ソースのみの行は、カバーするすべてのキーを名前で指定し、他の行は例を示します:
sandbox.credentials.awsPairs と sandbox.ripgrep を全体で取得するには、Claude Code v2.1.257 以降が必要です。
いくつかのキーは、テーブルが示さない条件を追加します:
policyHelper : Claude Code は、ポリシーキーを含む最優先度のソースが MDM ポリシーまたは管理設定ファイルである場合にのみそれを尊重します。サーバー管理設定では適用されません。
modelOverrides : availableModels とペアになります。Claude Code は、それを設定する最優先度のソースから modelOverrides を取得します。ただし、上位ソースが modelOverrides なしで availableModels を設定する場合は除きます。その場合、すべてのソースから modelOverrides を無視します。
forceLoginGatewayUrl 、gatewayInternalNetworks 、および forceLoginMethod の "gateway" 値 : Claude Code はサーバー管理設定からそれらのいずれも読み取りません。そのため、そこでの値は適用されず、MDM ポリシーまたは管理設定ファイルで設定されたものを隠しません。マシン上の管理ソースの中で、ポリシーキーを含む最優先度のソースのみがそれらを提供します。サーバー管理設定も存在するかどうかに関わらず。
allowedProviders : テーブルのルールの後、マシン自体のリストは結果を制限し続けます。そのエントリの Scope ノートが述べているように。
マシンで組み合わせたソースを確認するには、/status を実行し、Setting sources 行を読んでください 。
`parentSettingsBehavior`
Claude Code が、Agent SDK または IDE 拡張機能などの埋め込みホストプロセスによって提供される管理設定を適用するかどうかを選択します。管理者がデプロイした管理層も存在する場合。"first-wins" では、Claude Code はホスト提供の設定をドロップします。"merge" では、制限のみのフィルターを通じて管理層の下で適用します。ホストが起動するセッションに独自の制限を渡す必要がある場合、"merge" を設定します。たとえば、Claude Desktop がゲートウェイの出力許可リストを配信する場合。
スコープ : Managed 。Claude Code はそれを最優先度の管理者制御管理ソースから読み取ります。
タイプ : 文字列、次のいずれか:
"first-wins": Claude Code は、管理者がデプロイした管理層が存在する場合、ホスト提供の設定をドロップします
"merge": Claude Code は、制限のみのフィルターを通じて管理層の下でホスト提供の設定を適用します
デフォルト : "first-wins"
{
"parentSettingsBehavior" : "merge"
}
管理者がデプロイした管理層が存在しない場合、このキーは効果がありません。ホストの設定は、唯一の管理層として適用されます。制限値にフィルターされたままです。フィルターの制限と管理ソースの相互作用については、埋め込みホストからの親設定 および 親設定を制限する を参照してください。
`policyHelper`
起動時に管理設定を計算するためにデプロイする実行可能ファイルを実行します。デバイスの状態、ID、またはリモートサービスから静的ファイルの代わりにポリシーを導出できます。Claude Code はヘルパーを実行してから最初のプロンプトを受け入れ、それが出力する設定をセッションの管理設定として扱います。
スコープ : Managed 。macOS plist、Windows HKLM レジストリ、または管理設定ファイルから読み取ります。Claude Code は、ポリシーキー を含む最優先度の管理ソースからキーを読み取り、そのソースが 3 つのうちの 1 つである場合にのみヘルパーを実行します。サーバー管理設定、HKCU レジストリ、およびホスト提供の親設定ではキーを無視します。
タイプ : path、timeoutMs、および refreshIntervalMs を含むオブジェクト
デフォルト : 設定されていないため、ヘルパーは実行されません
サーバー管理設定が起動時にポリシーを配信する場合、ヘルパーのソースより優先され、ヘルパーは実行されません。
後の設定取得がサーバー管理設定が削除されたことを報告する場合、Claude Code はその時点でヘルパーを実行します。次の起動を待つ代わりに。その出力はセッションの残りを管理し、失敗した実行は 失敗した起動実行 と同じメッセージでセッションを終了します。
この例は、5 秒のタイムアウトでヘルパーを実行し、5 分ごとに再実行します:
{
"policyHelper" : {
"path" : "/usr/local/bin/claude-policy" ,
"timeoutMs" : 5000,
"refreshIntervalMs" : 300000
}
}
ヘルパー出力を書き込む
Claude Code はヘルパーを引数なしで実行し、その環境に CLAUDE_CODE_VERSION を設定し、stdout から JSON エンベロープを読み取ります。1 MiB でキャップされます。
設定を managedSettings キーの下に配置します。managedSettings キーのない裸の設定オブジェクトは、managedSettings が未定義で何も適用されず、Claude Code はエラーを報告しません:
{
"managedSettings" : {
"permissions" : { "deny" : [ "Read(//etc/secrets/**)" ] }
}
}
ヘルパーが managedSettings を出力する場合、そのオブジェクトは実行の唯一の管理設定ソースになります。Claude Code は MDM、ファイル、および HKCU ソースを無視し、クロスソースキー をヘルパーの出力からのみ読み取り、親設定 をマージしません。
起動 forceRemoteSettingsRefresh チェックはヘルパーの前に実行され、任意の管理ソースを読み取ります。ヘルパーが managedSettings を省略するエンベロープで 0 で終了する場合、管理設定を提供しません。他のソースは通常どおり適用されます。
ヘルパーの失敗
ヘルパー実行は次の場合に失敗します:
path は policyHelper.path のルールを破ります。
path に通常ファイルがありません。Claude Code は、同じ timeoutMs 予算内でヘルパーを開始する前にファイルをチェックするため、応答しないネットワークマウントは実行を失敗させる可能性があります。
ヘルパーが 0 以外で終了し、timeoutMs が経過してもまだ実行中であるか、まったく開始しません。たとえば、実行可能でないため。
ヘルパーが stdout または stderr に 1 MiB 以上を書き込みます。
stdout は単一の JSON オブジェクトではないか、その managedSettings に Claude Code が修復できないスキーマ違反 があります。
起動実行が失敗する場合、Claude Code は理由を出力し、起動を拒否します。0 以外の終了後、理由にはヘルパーの stderr が含まれます。stderr が空の場合は stdout が含まれます。タイムアウト後、理由は timeoutMs 制限を名前で指定し、ヘルパーの出力は含まれません。拒否は、対話型セッション、claude -p、Agent SDK セッション、バックグラウンドセッション 、およびほとんどのサブコマンドをカバーします。
拒否は意図的なため、停止復旧が必要なヘルパーは独自のキャッシュから提供し、0 で終了する必要があります。
バックグラウンド更新が失敗する場合、Claude Code は最後に成功したポリシーを有効に保ち、/status は失敗した更新をその理由とともに表示します。更新が成功するまで。各更新は、起動実行と同じ timeoutMs および失敗ルールの下で実行されます。
--debug を使用すると、Claude Code はすべての実行からヘルパーの stderr を デバッグログ に書き込みます。
Claude Code は無効な policyHelper 値を ドロップされたエントリ として報告し、残りの管理設定でセッションを開始します。ヘルパーを実行しません。無効な値には、裸のパス文字列と その最小値 より低い timeoutMs が含まれます。
ヘルパーをオフにするには、それを設定するソースからキーを削除します。
`policyHelper.path`
Claude Code が実行するヘルパー実行可能ファイルに名前を付けます。パスがルールを破る場合に何が起こるかについては、ヘルパーの失敗 を参照してください。
スコープ : Managed 。macOS plist、Windows HKLM レジストリ、または管理設定ファイルから読み取ります。policyHelper が読み取られる場所。
タイプ : 文字列、正規化された形式の絶対パス。. または .. セグメントなし。Windows では、.exe で終わるドライブレターまたは UNC パス
デフォルト : なし。policyHelper が設定されている場合は必須
{
"policyHelper" : {
"path" : "/usr/local/bin/claude-policy"
}
}
`policyHelper.timeoutMs`
Claude Code がヘルパーを待機する時間を設定してから、実行を失敗として扱います。タイムアウトした実行は 0 以外の終了と同じ方法で失敗するため、起動時に Claude Code は起動を拒否します。
スコープ : Managed 。macOS plist、Windows HKLM レジストリ、または管理設定ファイルから読み取ります。policyHelper が読み取られる場所。
タイプ : 整数、ミリ秒、最小 1000
デフォルト : 10000
{
"policyHelper" : {
"path" : "/usr/local/bin/claude-policy" ,
"timeoutMs" : 5000
}
}
`policyHelper.refreshIntervalMs`
Claude Code がバックグラウンドでヘルパーを間隔で再実行するようにして、ポリシーの変更が実行中のセッションに到達するようにします。更新が成功する場合、その出力は前の管理設定を再起動なしで置き換えます。更新が失敗する場合、Claude Code は既に持っているポリシーを保ちます。
スコープ : Managed 。macOS plist、Windows HKLM レジストリ、または管理設定ファイルから読み取ります。policyHelper が読み取られる場所。
タイプ : 整数、ミリ秒: 更新を無効にするには 0。それ以外の場合は最小 60000
デフォルト : 設定されていないため、Claude Code はヘルパーを起動時に 1 回実行します
この例は、5 分ごとにヘルパーを再実行します:
{
"policyHelper" : {
"path" : "/usr/local/bin/claude-policy" ,
"refreshIntervalMs" : 300000
}
}
`wslInheritsWindowsSettings`
WSL 上の Claude Code が Windows ポリシーチェーンから管理設定を読み取るようにします。HKLM と Windows 管理設定ファイルが /etc/claude-code と下の HKCU より優先されます。チェーンがオンの間、Claude Code は Windows 管理ドキュメントが存在しない 場合にのみ /etc/claude-code を読み取ります。HKLM レジストリ値または C:\Program Files\ClaudeCode\ フォルダ内。Windows に既にデプロイしているポリシーを WSL セッションに拡張するために設定します。同じマシン上で、ホストセッションと同じルールに従うようにします。Claude Code は、HKLM レジストリキーまたは管理設定ファイルまたは C:\Program Files\ClaudeCode\ の下のドロップインで設定されている場合にのみそれを尊重します。どちらも Windows 管理者が書き込む必要があります。
スコープ : Managed 。管理者制御の Windows ソースで。
タイプ : ブール値
true: WSL 上の Claude Code は Windows ポリシーチェーンから管理設定を読み取り、Windows 管理ドキュメントが存在しない場合にのみ /etc/claude-code を読み取ります
false: WSL は /etc/claude-code のみを読み取ります
デフォルト : false。WSL は /etc/claude-code のみを読み取ります
{
"wslInheritsWindowsSettings" : true
}
管理ソースがチェーンをオンにすると、HKCU ポリシーは HKCU もキーを true に設定する場合にのみ WSL に参加します。そのコピーはチェーンをそれ自体でオンにしません。このキーのみを含む Windows ソース。true または false に設定されている場合、ポリシーソースとしてカウントされません。下位優先度のソースはまだポリシーを提供します。このキーはネイティブ Windows に効果がありません。
Claude Code は true と false を引用符の有無にかかわらず読み取り、null をキーの削除として読み取ります。他の値を保持する管理者制御の Windows ソースは、存在する管理ドキュメント としてカウントされます。チェーンがオンの場合: /etc/claude-code も HKCU も適用されず、起動警告がキーを名前で指定します。読み取ることができない HKLM 値または Windows フォルダファイルも、チェーンがオンかどうかに関わらず /etc/claude-code が適用されるのを防ぎます。Claude Code v2.1.282 以降が必要です。
グローバル設定
これらのキーを ~/.claude.json に保存してください。設定ファイルには保存しないでください。Claude Code はそれ以外の場所ではこれらを無視します。Claude Code と /config はほとんどのキーを自動的に書き込みます。また、手動で編集することもできます。
`autoConnectIde`
外部ターミナルから Claude Code を起動するときに、実行中の IDE に自動的に接続します。VS Code または JetBrains ターミナルの外で Claude Code を実行する場合、/config に Auto-connect to IDE (external terminal) として表示されます。
スコープ : グローバル設定
タイプ : ブール値
true: Claude Code は外部ターミナルから起動するときに、実行中の IDE に自動的に接続します
false: Claude Code は外部ターミナルから自動的に接続しません。ただし、VS Code または JetBrains ターミナル内、または --ide を使用する場合は接続します
デフォルト : false
セッションごとのオーバーライド : CLAUDE_CODE_AUTO_CONNECT_IDE はこのキーより優先され、1 つのセッションでどちらの方向でも機能します
{
"autoConnectIde" : true
}
Claude Code は settings.json でこのキーを無視します。
`autoInstallIdeExtension`
VS Code ターミナルから Claude Code を実行するときに、Claude Code IDE 拡張機能を自動的にインストールします。VS Code または JetBrains ターミナル内で Claude Code を実行する場合、/config に Auto-install IDE extension として表示されます。
スコープ : グローバル設定
タイプ : ブール値
true: Claude Code は VS Code ターミナルから実行するときに IDE 拡張機能を自動的にインストールします
false: Claude Code は拡張機能を自動的にインストールしません
デフォルト : true
セッションごとのオーバーライド : CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL を 1 に設定すると、このキーが true の場合でも 1 つのセッションのインストールをスキップします
{
"autoInstallIdeExtension" : false
}
Claude Code は settings.json でこのキーを無視します。
`claudeInChromeDefaultEnabled`
Chrome 統合 をオンにして、毎回 --chrome を渡さずにすべてのインタラクティブ CLI セッションを開始します。claude remote-control を実行する場合、プロジェクト スレッドの 1 つに対して開始するセッションもこのキーに従います。ただし、bypassPermissions モードの場合は除きます。/chrome を実行して Enabled by default を選択すると、Chrome をデフォルトで有効にする で説明されているように、このキーが設定されます。/config に Claude in Chrome enabled by default として表示されます。
スコープ : グローバル設定
タイプ : ブール値
true: Claude Code は --chrome を渡すときと同様に、インタラクティブ CLI セッションが開始するときに Chrome 統合をオンにします
false: インタラクティブ CLI セッションは Chrome 統合をオフで開始し、Claude Code はセットアップを提案するのを停止 します。1 つのインタラクティブセッションでオンにするには --chrome を渡してください
デフォルト : 未設定。Chrome 統合はオフで、Claude Code はセットアップを提案できます
セッションごとのオーバーライド : --chrome と --no-chrome はこのキーより優先され、1 つのインタラクティブセッションで機能します
{
"claudeInChromeDefaultEnabled" : true
}
Claude Code は settings.json でこのキーを無視します。
`copyFullResponse`
/copy が応答に含まれるコードブロックがある場合に表示するピッカーなしで、毎回完全な応答をコピーします。そのピッカーで Always copy full response を選択すると、このキーが true に設定されます。/config に Skip the /copy picker として表示されます。
スコープ : グローバル設定
タイプ : ブール値
true: /copy はピッカーを表示せずに完全な応答をコピーします
false: 応答にコードブロックが含まれている場合、/copy はピッカーを表示し、1 つのコードブロックまたは完全な応答を選択できます
デフォルト : false
{
"copyFullResponse" : true
}
Claude Code は settings.json でこのキーを無視します。
`copyOnSelect`
フルスクリーンレンダリング またはエージェントビュー でマウスで選択を終了したときに、テキストをクリップボードに自動的にコピーします。フルスクリーンレンダリングがオンの場合、/config に Copy on select として表示されます。
スコープ : グローバル設定
タイプ : ブール値
true: Claude Code は選択を終了したときにテキストをクリップボードにコピーします
false: テキストを選択してもクリップボードは変わらず、代わりにキーボードショートカットで選択をコピー します
デフォルト : true
{
"copyOnSelect" : false
}
Claude Code は settings.json でこのキーを無視します。
`defaultToAgentsView`
引数なしで claude を実行するときに、新しい会話の代わりにエージェントビュー を開きます。エージェントビューがオフ になっていない限り、/config に Open agents view by default として表示されます。
スコープ : グローバル設定
タイプ : ブール値
true: 引数なしの claude はエージェントビューを開きます。ただし、エージェントビューがオフ になっている場合は除きます
false: 引数なしの claude は新しい会話を開始します
デフォルト : false
{
"defaultToAgentsView" : true
}
Claude Code は settings.json でこのキーを無視します。
VS Code またはJetBrains IDE が接続されているときに、Claude Code が提案する Edit または Write 変更の差分を表示する場所を選択します。"auto" は IDE の差分ビューアで開き、"terminal" はターミナルに保持します。Claude Code が VS Code または JetBrains IDE に接続されている場合のみ、/config に Diff tool として表示されます。
スコープ : グローバル設定
タイプ : 文字列、以下のいずれか:
"auto": Claude Code は VS Code または JetBrains IDE が接続されているときに IDE の差分ビューアで差分を開きます
"terminal": Claude Code は差分をターミナルに保持します
デフォルト : "auto"
{
"diffTool" : "terminal"
}
Claude Code は settings.json でこのキーを無視します。
`externalEditorContext`
Ctrl+G を押すと、Claude Code は入力中のプロンプトを外部エディタ で開きます。このキーをオンにすると、エディタバッファは Claude の前の応答で # コメント行として開始されるため、書き込み中に読むことができ、Claude Code は保存時にこれらの行を削除します。/config に Show last response in external editor として表示されます。
スコープ : グローバル設定
タイプ : ブール値
true: エディタバッファは Claude の前の応答で # コメント行として開始され、Claude Code は保存時にこれらを削除します
false: エディタバッファはプロンプトのみで開きます
デフォルト : false
{
"externalEditorContext" : true
}
オンにすると、Claude Code が開くバッファは次のようになり、マーカー行の下のテキストのみがプロンプトとして送信されます:
# ─── Claude's last response (for reference; removed on save) ───
# I added the retry loop to fetchUser in src/api.ts and a test
# for the timeout case. Want me to wire the same retry into
# fetchOrders?
# ─── Write your reply below this line ──────────────────────────
Yes, and cap it at three attempts.
Claude Code は応答の最後の 50 行を保持し、カットを # … (earlier output truncated) でマークします。
Claude Code は settings.json でこのキーを無視します。
`leftArrowOpensAgents`
空のプロンプトで ← を押して、セッションをバックグラウンドにしてエージェントビューを開き ます。このキーを false に設定してショートカットをオフにします。エージェントビューが利用可能な場合、/config に ← opens agents として表示されます。
スコープ : グローバル設定
タイプ : ブール値
true: ターミナルで開始したセッションの空のプロンプトで ← を押すと、セッションがバックグラウンドになり、エージェントビューが開きます
false: Claude Code はショートカットをオフにします。エージェントビューから接続した セッションでは、空のプロンプトで ← を押すと切断されます
デフォルト : true
{
"leftArrowOpensAgents" : false
}
Claude Code は settings.json でこのキーを無視します。
`permissionExplainerEnabled`
v2.1.256 まで、Bash または PowerShell 権限プロンプトで Ctrl+E を押してコマンドのモデル生成説明を表示でき、このキーを false に設定してそのショートカットをオフにできました。
スコープ : グローバル設定 。v2.1.256 以前。
タイプ : ブール値
デフォルト : true
現在のブランチのオープンなプルリクエストまたはマージリクエストのバッジをプロンプトフッターに表示し、そのステータス を示す色付きの下線を表示します。/config に Show PR status footer として表示されます。
スコープ : グローバル設定
タイプ : ブール値
デフォルト : true
{
"prStatusFooterEnabled" : false
}
Claude Code は settings.json でこのキーを無視します。
`teammateDefaultModel`
v2.1.233 まで、このキーをエージェントチーム のチームメイトのモデルに設定しました。プロンプトがモデルを指定しなかったチームメイト用:"sonnet" などのエイリアス、または null でリードのモデルに従う。Claude Code が現在そのようなチームメイト用に選択するモデルについては、チームメイトとモデルを指定 を参照してください。
スコープ : グローバル設定 。v2.1.233 以前。
タイプ : 文字列、モデルエイリアスまたは完全なモデル ID、または null
デフォルト : 未設定
関連項目
577 設定インデックス577 設定インデックス
578 </h2>578 </h2>
579 579
580 以下のすべてのキーはそのエントリにリンクしています。スコープは、それが入ることができる[ファイル](/docs/ja/settings#settings-files-and-who-they-affect)をリストしています。`User` は `~/.claude/settings.json`、`Project` は `.claude/settings.json`、`Local` は `.claude/settings.local.json`、`Managed` は[組織がデプロイするもの](/docs/ja/managed-settings)です。`Any file` は 4 つすべてを意味し、`Global config` は [`~/.claude.json`](#global-config-settings)を意味します。580 以下のすべてのキーはそのエントリにリンクしています。スコープは、それが入ることができる[ファイル](/docs/ja/settings#settings-files-and-who-they-affect)をリストしています。`User` は `~/.claude/settings.json`、`Project` は `.claude/settings.json`、`Local` は `.claude/settings.local.json`、`Managed` は[組織がデプロイするもの](/docs/ja/managed-settings)です。`Any file` は 4 つすべてを意味し、`Global config` は [`~/.claude.json`](#global-config-settings) を意味します。
581 581
582 <ReferenceFilter582 <ReferenceFilter
583 noun="settings"583 noun="settings"
589 }}589 }}
590 />590 />
591 591
592 | Key | Description | Topic | Scope |592 | キー | 説明 | トピック | スコープ |
593 | :- | :- | :- | :- |593 | :- | :- | :- | :- |
594 | [`advisorModel`](#advisormodel) | Claude が[アドバイザーツール](/docs/ja/advisor)に答えるときに使用するモデルを選択します | Model and responses | Any file |594 | [`advisorModel`](#advisormodel) | Claude が[アドバイザーツール](/docs/ja/advisor)に質問するときに回答するモデルを選択します | モデルと応答 | Any file |
595 | [`agent`](#agent) | すべてのセッションを、プロンプト 、ツール、モデルを持つ名前付き[サブエージェント](/docs/ja/sub-agents)として開始します | Agents, sessions, and worktrees | Any file |595 | [`agent`](#agent) | すべてのセッションをプロンプト 、ツール、モデルを持つ名前付き[サブエージェント](/docs/ja/sub-agents)として開始します | エージェント、セッション、ワークツリー | Any file |
596 | [`agentPushNotifEnabled`](#agentpushnotifenabled) | Claude が決定したときに[プッシュ通知をスマートフォンに送信](/docs/ja/remote-control#mobile-push-notifications)することを許可します | Remote, desktop, and notifications | Any file |596 | [`agentPushNotifEnabled`](#agentpushnotifenabled) | Claude が決定したときに[プッシュ通知をスマートフォンに送信](/docs/ja/remote-control#mobile-push-notifications)することを許可します | リモート、デスクトップ、通知 | Any file |
597 | [`allowAllClaudeAiMcps`](#allowallclaudeaimcps) | デプロイされた[`managed-mcp.json`](/docs/ja/managed-mcp#exclusive-control-with-managed-mcp-json)と一緒に Claude Code が自身で取得する[claude.ai コネクタ](/docs/ja/mcp)をロードします | MCP | Managed |597 | [`allowAllClaudeAiMcps`](#allowallclaudeaimcps) | デプロイされた [`managed-mcp.json`](/docs/ja/managed-mcp#exclusive-control-with-managed-mcp-json) と一緒に Claude Code が自身で取得する[claude.ai コネクタ](/docs/ja/mcp)をロードします | MCP | Managed |
598 | [`allowClaudeInChromeWithManagedMcp`](#allowclaudeinchromewithmanagedmcp) | デプロイされた[`managed-mcp.json`](/docs/ja/managed-mcp#exclusive-control-with-managed-mcp-json)と一緒に組み込み[Claude in Chrome](/docs/ja/chrome)サーバーを実行することを許可します | MCP | Managed |598 | [`allowClaudeInChromeWithManagedMcp`](#allowclaudeinchromewithmanagedmcp) | デプロイされた [`managed-mcp.json`](/docs/ja/managed-mcp#exclusive-control-with-managed-mcp-json) と一緒に組み込み[Claude in Chrome](/docs/ja/chrome) サーバーを実行することを許可します | MCP | Managed |
599 | [`allowedChannelPlugins`](#allowedchannelplugins) | メッセージをプッシュできる[チャネルプラグイン](/docs/ja/channels#restrict-which-channel-plugins-can-run)のデフォルト許可リストを置き換えます | Plugins and skills | Managed |599 | [`allowedChannelPlugins`](#allowedchannelplugins) | メッセージをプッシュできる[チャネルプラグイン](/docs/ja/channels#restrict-which-channel-plugins-can-run)のデフォルト許可リストを置き換えます | プラグインとスキル | Managed |
600 | [`allowedHttpHookUrls`](#allowedhttphookurls) | [HTTP フック](/docs/ja/hooks)がターゲットできる URL を制限します | Hooks and automation | Any file |600 | [`allowedHttpHookUrls`](#allowedhttphookurls) | [HTTP フック](/docs/ja/hooks)がターゲットにできる URL を制限します | フックと自動化 | Any file |
601 | [`allowedMcpServers`](#allowedmcpservers) | ユーザーが追加できる[MCP サーバー](/docs/ja/mcp)を許可リストに登録します | MCP | Any file |601 | [`allowedMcpServers`](#allowedmcpservers) | ユーザーが追加できる[MCP サーバー](/docs/ja/mcp)を許可リストに登録します | MCP | Any file |
602 | [`allowManagedHooksOnly `](#allowmanagedhooksonly ) | 組織がデプロイする [フック ](/docs/ja/hooks )のみを実行します | Hooks and automation | Managed |602 | [`allowedProviders `](#allowedproviders ) | マシンが使用できる [API プロバイダー ](/docs/ja/third-party-integrations )を制限します | 認証とプロバイダー | Managed |
603 | [`allowManagedMcpServersOnly `](#allowmanagedmcpserversonly ) | マネージド [MCP ](/docs/ja/mcp )許可リストが適用される唯一のものにします | MCP | Managed |603 | [`allowManagedHooksOnly `](#allowmanagedhooksonly ) | 組織がデプロイする [フック ](/docs/ja/hooks )のみを実行します | フックと自動化 | Managed |
604 | [`allowManagedPermissionRulesOnly `](#allowmanagedpermissionrulesonly ) | [マネージド設定](/docs/ja/managed-settings)を [権限ルール ](/docs/ja/permissions#managed-settings )の唯一の設定ソースにします | Permission settings | Managed |604 | [`allowManagedMcpServersOnly `](#allowmanagedmcpserversonly ) | マネージド [MCP ](/docs/ja/mcp )許可リストのみが適用されるようにします | MCP | Managed |
605 | [`alwaysThinkingEnabled `](#alwaysthinkingenabled ) | すべてのセッションで [拡張思考 ](/docs/ja/model -config #extended -thinking )をオフにします | Model and responses | Any file |605 | [`allowManagedPermissionRulesOnly `](#allowmanagedpermissionrulesonly ) | [マネージド設定 ](/docs/ja/managed -settings)を[権限ルール](/docs/ja/permissions #managed -settings )の唯一の設定ソースにします | 権限設定 | Managed |
606 | [`apiKeyHelper `](#apikeyhelper ) | 独自のコマンドで [API 認証情報 ](/docs/ja/authentication #credential -management )を生成します | Authentication and providers | Any file |606 | [`alwaysThinkingEnabled `](#alwaysthinkingenabled ) | すべてのセッションで [拡張思考 ](/docs/ja/model-config #extended -thinking )をオフにします | モデルと応答 | Any file |
607 | [`askUserQuestionTimeout `](#askuserquestiontimeout ) | 未回答の質問が [アイドル時間後に自動継続 ](/docs/ja/tools-reference #question-auto-continue -timeout )することを許可します | Interface and terminal | User or managed |607 | [`apiKeyHelper `](#apikeyhelper ) | 独自のコマンドで [API 認証情報 ](/docs/ja/authentication #credential -management )を生成します | 認証とプロバイダー | Any file |
608 | [`attribution `](#attribution ) | Claude Code がコミットとプルリクエストに追加する属性をカスタマイズします | Git and attribution | Any file |608 | [`askUserQuestionTimeout `](#askuserquestiontimeout ) | 未回答の質問がアイドル時間後に[自動継続](/docs/ja/tools-reference#question-auto-continue-timeout)することを許可します | インターフェースとターミナル | User or managed |
609 | [`attribution.commit `](#attribution-commit ) | Claude Code がコミットに追加するトレーラーを変更または非表示にします | Git and attribution | Any file |609 | [`appendPlugins `](#appendplugins ) | ユーザーがインストールするすべてのモッドの後に組織の[モッド](/docs/ja/plugins/mods/admin)を実行します | プラグインとスキル | User or managed |
610 | [`attribution.pr `](#attribution-pr ) | プルリクエスト説明の属性行を変更または非表示にします | Git and attribution | Any file |610 | [`attribution`](#attribution) | Claude Code がコミットとプルリクエストに追加する属性をカスタマイズします | Git と属性 | Any file |
611 | [`attribution.sessionUrl `](#attribution-sessionurl ) | [クラウド](/docs/ja/claude-code-on-the-web)および[リモートコントロール](/docs/ja/remote-control)コミットから claude.ai セッションリンクを省略します | Git and attribution | Any file |611 | [`attribution.commit `](#attribution-commit ) | Claude Code がコミットに追加するトレーラーを変更または非表示にします | Git と属性 | Any file |
612 | [`autoCompactEnabled `](#autocompactenabled ) | [自動コンパクション](/docs/ja/context-window)をオフまたはオンにします | Memory and context | Any file |612 | [`attribution.pr `](#attribution-pr ) | プルリクエスト説明の属性行を変更または非表示にします | Git と属性 | Any file |
613 | [`autoCompactWindow `](#autocompactwindow ) | Claude Code が [コンパクト ](/docs/ja/context -window )する前にコンテキストがどのくらい満杯になるかを設定します | Memory and context | Any file |613 | [`attribution.sessionUrl `](#attribution-sessionurl ) | [クラウド ](/docs/ja/claude -code-on-the-web )および[リモートコントロール](/docs/ja/remote-control)コミットから claude.ai セッションリンクを省略します | Git と属性 | Any file |
614 | [`autoConnectIde `](#autoconnectide ) | 外部ターミナルから実行中の [VS Code](/docs/ja/vs-code)または[JetBrains ](/docs/ja/jetbrains#from-external -terminals ) IDE に自動的に接続します | Global config settings | Global config |614 | [`autoCompactEnabled `](#autocompactenabled ) | [自動圧縮 ](/docs/ja/context -window )をオフまたはオンにします | メモリとコンテキスト | Any file |
615 | [`autoContinueAtUsageLimit `](#autocontinueatusagelimit ) | オープンセッションで待機し、claude.ai 使用制限がリセットされた後に [タスクを自動的に継続 ](/docs/ja/interactive-mode#wait-for-a-usage-limit-to -reset )します | Interface and terminal | User or managed |615 | [`autoCompactWindow `](#autocompactwindow ) | Claude Code が [圧縮 ](/docs/ja/context -window )する前にコンテキストがどのくらい満杯になるかを設定します | メモリとコンテキスト | Any file |
616 | [`autoInstallIdeExtension `](#autoinstallideextension ) | VS Code ターミナルから[IDE 拡張機能 ](/docs/ja/vs-code#install -the -extension )の自動インストールをオフにします | Global config settings | Global config |616 | [`autoConnectIde `](#autoconnectide ) | 外部ターミナルから実行中の[ VS Code](/docs/ja/vs-code)または[JetBrains](/docs/ja/jetbrains #from -external -terminals ) IDE に自動的に接続します | グローバル設定 | Global config |
617 | [`autoMemoryDirectory `](#automemorydirectory ) | [自動メモリ ](/docs/ja/memory #auto -memory )を選択したディレクトリに保存します | Memory and context | Any file |617 | [`autoContinueAtUsageLimit `](#autocontinueatusagelimit ) | オープンセッションで待機し、claude.ai 使用制限がリセットされた後に [タスクを自動的に継続 ](/docs/ja/interactive-mode #wait -for-a-usage-limit-to-reset )します | インターフェースとターミナル | User or managed |
618 | [`autoMemoryEnabled `](#automemoryenabled ) | [自動メモリ ](/docs/ja/memory #auto -memory )をオフまたはオンにします | Memory and context | Any file |618 | [`autoInstallIdeExtension `](#autoinstallideextension ) | VS Code ターミナルから [IDE 拡張機能 ](/docs/ja/vs-code #install -the-extension )の自動インストールをオフにします | グローバル設定 | Global config |
619 | [`autoMode `](#automode ) | [自動モード ](/docs/ja/permission-modes #eliminate-prompts-with- auto-mode )分類器に独自の許可および拒否ルールを追加します | Permission settings | User or managed |619 | [`autoMemoryDirectory `](#automemorydirectory ) | [自動メモリ ](/docs/ja/memory #auto-memory )を選択したディレクトリに保存します | メモリとコンテキスト | Any file |
620 | [`autoMode.classifyAllShell `](#automode-classifyallshell ) | 狭い許可ルールが一致するものでも、すべてのシェルコマンドを [自動モード分類器 ](/docs/ja/permission-modes #what-the-classifier-blocks-by -default )を通して送信します | Permission settings | User or managed |620 | [`autoMemoryEnabled `](#automemoryenabled ) | [自動メモリ ](/docs/ja/memory #auto -memory )をオフまたはオンにします | メモリとコンテキスト | Any file |
621 | [`autoScrollEnabled `](#autoscrollenabled ) | フルスクリーンレンダリングで [新しい出力に従う ](/docs/ja/fullscreen #auto-follow )ことを有効にします | Interface and terminal | Any file |621 | [`autoMode `](#automode ) | [自動モード ](/docs/ja/permission-modes #eliminate-prompts-with- auto-mode )分類器に独自の許可および拒否ルールを追加します | 権限設定 | User or managed |
622 | [`autoUpdatesChannel `](#autoupdateschannel ) | 最新ではなく安定した [リリースチャネル ](/docs/ja/setup #configure -release -channel )に従います | Updates and versioning | Any file |622 | [`autoMode.classifyAllShell `](#automode-classifyallshell ) | 狭い許可ルールに一致するものであっても、すべてのシェルコマンドを [自動モード分類器 ](/docs/ja/permission-modes #what -the -classifier-blocks-by-default )に送信します | 権限設定 | User or managed |
623 | [`availableModels `](#availablemodels ) | [ユーザーが選択できるモデルを制限 ](/docs/ja/model-config #restrict-model -selection )します | Model and responses | Any file |623 | [`autoScrollEnabled `](#autoscrollenabled ) | フルスクリーンレンダリングで [新しい出力に従う ](/docs/ja/fullscreen #auto -follow )ことをオンにします | インターフェースとターミナル | Any file |
624 | [`availableModelsMatch `](#availablemodelsmatch ) | 各 `availableModels` モデル ID エントリが [それが名前を付けるバージョンのみを許可 ](/docs/ja/model-config #block-specific-models -or -versions )するようにします | Model and responses | Managed |624 | [`autoUpdatesChannel `](#autoupdateschannel ) | 最新ではなく安定した [リリースチャネル ](/docs/ja/setup #configure -release -channel )に従います | 更新とバージョン管理 | Any file |
625 | [`awaySummaryEnabled `](#awaysummaryenabled ) | ターミナルに戻ったときに表示される [セッション要約 ](/docs/ja/interactive -mode #session -recap )をオフにします | Remote, desktop, and notifications | Any file |625 | [`availableModels `](#availablemodels ) | [ユーザーが選択できるモデルを制限 ](/docs/ja/model -config #restrict -model-selection )します | モデルと応答 | Any file |
626 | [`awsAuthRefresh `](#awsauthrefresh ) | 独自のコマンドで `.aws ` の期限切れ[Bedrock 認証情報 ](/docs/ja/amazon -bedrock #advanced -credential -configuration )をリフレッシュします | Authentication and providers | Any file |626 | [`availableModelsMatch `](#availablemodelsmatch ) | 各 `availableModels ` モデル ID エントリが[それが名前を付けるバージョンのみを許可 ](/docs/ja/model -config #block -specific -models-or-versions )するようにします | モデルと応答 | Managed |
627 | [`awsCredentialExport `](#awscredentialexport ) | 独自のコマンドから JSON として [Bedrock 認証情報 ](/docs/ja/amazon -bedrock #advanced-credential -configuration )を提供します | Authentication and providers | Any file |627 | [`awaySummaryEnabled `](#awaysummaryenabled ) | ターミナルに戻ったときに表示される [セッション要約 ](/docs/ja/interactive -mode #session -recap )をオフにします | リモート、デスクトップ、通知 | Any file |
628 | [`axScreenReader `](#axscreenreader ) | [スクリーンリーダーフレンドリーな出力 ](/docs/ja/accessibility )をレンダリングします | Interface and terminal | Any file |628 | [`awsAuthRefresh `](#awsauthrefresh ) | 独自のコマンドで `.aws` の期限切れ [Bedrock 認証情報 ](/docs/ja/amazon-bedrock#advanced-credential-configuration )をリフレッシュします | 認証とプロバイダー | Any file |
629 | [`bashEditDiffEnabled `](#basheditdiffenabled ) | すべての権限モードで [Bash コマンドが変更したファイル ](/docs/ja/hooks #bash )を記録します | Interface and terminal | User or managed |629 | [`awsCredentialExport `](#awscredentialexport ) | 独自のコマンドから JSON として [Bedrock 認証情報 ](/docs/ja/amazon-bedrock #advanced-credential-configuration )を提供します | 認証とプロバイダー | Any file |
630 | [`bashOutputMaxChars `](#bashoutputmaxchars ) | 成功したコマンドの [出力 ](/docs/ja/tools-reference#output-limits )のうち Claude が受け取るインライン量を設定します | Memory and context | Any file |630 | [`axScreenReader `](#axscreenreader ) | [スクリーンリーダーフレンドリーな出力 ](/docs/ja/accessibility )をレンダリングします | インターフェースとターミナル | Any file |
631 | [`blockedMarketplaces `](#blockedmarketplaces ) | 組織の [プラグインマーケットプレイス ](/docs/ja/plugins/overview )ソースをブロックします | Plugins and skills | Managed |631 | [`bashEditDiffEnabled `](#basheditdiffenabled ) | [Bash コマンドの実行中に変更されたファイル ](/docs/ja/hooks#bash )をすべての権限モードで記録します | インターフェースとターミナル | User or managed |
632 | [`browserExternalPageTools `](#browserexternalpagetools ) | [デスクトップ ](/docs/ja/desktop )ブラウザペインの外部ページで Claude のツールをオフにします | Tools | Managed |632 | [`bashOutputMaxChars `](#bashoutputmaxchars ) | 成功したコマンドの [出力 ](/docs/ja/tools-reference#output-limits )の量を Claude がインラインで受け取るように設定します | メモリとコンテキスト | Any file |
633 | [`channelsEnabled `](#channelsenabled ) | 組織の[チャネル ](/docs/ja/channels#enable-channels-for-your-organization )を許可します | Plugins and skills | Managed |633 | [`blockedMarketplaces `](#blockedmarketplaces ) | 組織の[プラグインマーケットプレイス ](/docs/ja/plugins/overview )ソースをブロックします | プラグインとスキル | Managed |
634 | [`claudeInChromeDefaultEnabled `](#claudeinchromedefaultenabled ) | `--chrome` を渡さずにすべてのインタラクティブ CLI セッションで [Chrome 統合 ](/docs/ja/chrome )をオンにします | Global config settings | Global config |634 | [`browserExternalPageTools `](#browserexternalpagetools ) | [デスクトップ ](/docs/ja/desktop )ブラウザペインの外部ページで Claude のツールをオフにします | ツール | Managed |
635 | [`claudeMd `](#claudemd ) | マネージド設定から組織全体の [CLAUDE.md ](/docs/ja/memory #deploy -organization -wide -claude -md )指示を注入します | Memory and context | Managed |635 | [`channelsEnabled `](#channelsenabled ) | 組織の [チャネル ](/docs/ja/channels #enable -channels -for -your -organization )を許可します | プラグインとスキル | Managed |
636 | [`claudeMdExcludes `](#claudemdexcludes ) | メモリがロードされるときに特定の [CLAUDE.md ](/docs/ja/memory#exclude-specific-claude-md-files )ファイルをスキップします | Memory and context | Any file |636 | [`claudeInChromeDefaultEnabled `](#claudeinchromedefaultenabled ) | `--chrome` を渡さずにすべてのインタラクティブ CLI セッションで [Chrome 統合 ](/docs/ja/chrome )をオンにします | グローバル設定 | Global config |
637 | [`cleanupPeriodDays `](#cleanupperioddays ) | Claude Code が [トランスクリプト ](/docs/ja/data-usage #data -retention )を削除する前に保持する日数を選択します | Privacy and telemetry | Any file |637 | [`claudeMd `](#claudemd ) | マネージド設定から組織全体の [CLAUDE.md ](/docs/ja/memory #deploy -organization-wide-claude-md )指示を注入します | メモリとコンテキスト | Managed |
638 | [`companyAnnouncements `](#companyannouncements ) | スタートアップ時に組織のアナウンスメントを表示します | Interface and terminal | Any file |638 | [`claudeMdExcludes `](#claudemdexcludes ) | メモリがロードされるときに特定の[CLAUDE.md](/docs/ja/memory#exclude-specific-claude-md-files)ファイルをスキップします | メモリとコンテキスト | Any file |
639 | [`copyFullResponse `](#copyfullresponse ) | [`/copy` ](/docs/ja/commands )がコードブロックピッカーを表示せずに完全な応答をコピーするようにします | Global config settings | Global config |639 | [`cleanupPeriodDays `](#cleanupperioddays ) | Claude Code が [トランスクリプト ](/docs/ja/data-usage#data-retention )を削除する前に保持する日数を選択します | プライバシーとテレメトリ | Any file |
640 | [`copyOnSelect `](#copyonselect ) | [フルスクリーンレンダリング](/docs/ja/fullscreen#use-the-mouse)およびエージェントビューでマウスで選択したテキストの自動コピーをオフにします | Global config settings | Global config |640 | [`companyAnnouncements `](#companyannouncements ) | スタートアップで組織のお知らせを表示します | インターフェースとターミナル | Any file |
641 | [`crossSessionInbound `](#crosssessioninbound ) | Claude Code が [他のセッションからのメッセージ ](/docs/ja/cross-session-messaging#control-inbound-messages )を配信するか、配信せずに通知を表示するか、または拒否するかを選択します | Agents, sessions, and worktrees | Any file |641 | [`copyFullResponse `](#copyfullresponse ) | [`/copy` ](/docs/ja/commands )がコードブロックピッカーを表示せずに完全な応答をコピーするようにします | グローバル設定 | Global config |
642 | [`defaultShell `](#defaultshell ) | [`!` プレフィックス ](/docs/ja/interactive-mode #shell-mode -with -prefix )で入力したシェルコマンドを実行する Bash または PowerShell を選択します | Interface and terminal | Any file |642 | [`copyOnSelect `](#copyonselect ) | [フルスクリーンレンダリング ](/docs/ja/fullscreen #use -the -mouse )およびエージェントビューでマウスで選択したテキストの自動コピーをオフにします | グローバル設定 | Global config |
643 | [`defaultToAgentsView `](#defaulttoagentsview ) | 引数なしで `claude` を実行するときに新しい会話の代わりに [エージェントビュー ](/docs/ja/agent -view )を開きます | Global config settings | Global config |643 | [`crossSessionInbound `](#crosssessioninbound ) | Claude Code が [他のセッションからのメッセージ ](/docs/ja/cross -session-messaging#control-inbound-messages )を配信するか、配信せずに通知を表示するか、拒否するかを選択します | エージェント、セッション、ワークツリー | Any file |
644 | [`defaultShell`](#defaultshell) | [`!` プレフィックス](/docs/ja/interactive-mode#shell-mode-with-prefix)で入力したシェルコマンドを実行する Bash または PowerShell を選択します | インターフェースとターミナル | Any file |
645 | [`defaultToAgentsView`](#defaulttoagentsview) | 引数なしで `claude` を実行するときに新しい会話の代わりに[エージェントビュー](/docs/ja/agent-view)を開きます | グローバル設定 | Global config |
644 | [`deniedMcpServers`](#deniedmcpservers) | URL、コマンド、または名前で特定の[MCP サーバー](/docs/ja/mcp)をブロックします | MCP | Any file |646 | [`deniedMcpServers`](#deniedmcpservers) | URL、コマンド、または名前で特定の[MCP サーバー](/docs/ja/mcp)をブロックします | MCP | Any file |
645 | [`deniedModels`](#deniedmodels) | [特定のモデルをブロック](/docs/ja/model-config#block-specific-models-or-versions)します。`availableModels` が許可するものでも | Model and responses | Managed |647 | [`deniedModels`](#deniedmodels) | [特定のモデルをブロック](/docs/ja/model-config#block-specific-models-or-versions)します。`availableModels` が許可するものであっても | モデルと応答 | Managed |
646 | [`desktopSessionCleanupPeriodDays`](#desktopsessioncleanupperioddays) | [Claude Desktop および Cowork トランスクリプト](/docs/ja/claude-directory#cleaned-up-automatically)の経過日数制限を設定します | Privacy and telemetry | User or managed |648 | [`desktopSessionCleanupPeriodDays`](#desktopsessioncleanupperioddays) | [Claude Desktop および Cowork トランスクリプト](/docs/ja/claude-directory#cleaned-up-automatically)の年齢制限を日数で設定します | プライバシーとテレメトリ | User or managed |
647 | [`dialogExpiry`](#dialogexpiry) | Claude Code が [リモートコントロール](/docs/ja/remote-control)または SDK ホストが転送されたダイアログに答えるのを待つ時間を設定します | Interface and terminal | User or managed |649 | [`dialogExpiry`](#dialogexpiry) | Claude Code がダイアログをキャンセルする前に [リモートコントロール](/docs/ja/remote-control)または SDK ホストが転送されたダイアログに応答するのを待つ時間を設定します | インターフェースとターミナル | User or managed |
648 | [`diffTool`](#difftool) | Claude の提案されたファイル変更が[VS Code](/docs/ja/vs-code)または[JetBrains](/docs/ja/jetbrains#features)差分ビューアで開くか、ターミナルに留まるかを選択します | Global config settings | Global config |650 | [`diffTool`](#difftool) | Claude の提案されたファイル変更が[VS Code](/docs/ja/vs-code)または[JetBrains](/docs/ja/jetbrains#features)差分ビューアで開くか、ターミナルに留まるかを選択します | グローバル設定 | Global config |
649 | [`disableAgentView`](#disableagentview) | バックグラウンドエージェントと[エージェントビュー](/docs/ja/agent-view)をオフにします | Agents, sessions, and worktrees | Any file |651 | [`disableAgentView`](#disableagentview) | バックグラウンドエージェントと[エージェントビュー](/docs/ja/agent-view)をオフにします | エージェント、セッション、ワークツリー | Any file |
650 | [`disableAllHooks`](#disableallhooks) | [フック](/docs/ja/hooks)、カスタム[ステータスライン](/docs/ja/statusline)、およびカスタム[`@` ファイル提案](/docs/ja/interactive-mode#quick-commands)コマンドを一度にオフにします | Hooks and automation | Any file |652 | [`disableAllHooks`](#disableallhooks) | [フック](/docs/ja/hooks)、カスタム[ステータスライン](/docs/ja/statusline)、およびカスタム[`@` ファイル提案](/docs/ja/interactive-mode#quick-commands)コマンドを一度にオフにします | フックと自動化 | Any file |
651 | [`disableArtifact`](#disableartifact) | 非推奨。`enableArtifact` を使用して[Artifact ツール](/docs/ja/artifacts)をオフにします | Remote, desktop, and notifications | Any file |653 | [`disableArtifact`](#disableartifact) | 非推奨。`enableArtifact` を使用して[Artifact ツール](/docs/ja/artifacts)をオフにします | リモート、デスクトップ、通知 | Any file |
652 | [`disableAutoMode`](#disableautomode) | 権限モードサイクルから [自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)を削除します | Permission settings | Any file |654 | [`disableAutoMode`](#disableautomode) | [自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)を権限モードサイクルから削除します | 権限設定 | Any file |
653 | [`disableBrowserExternalNavigation`](#disablebrowserexternalnavigation) | [デスクトップ](/docs/ja/desktop)ブラウザペインをユーザーと Claude の localhost に制限します | Tools | Managed |655 | [`disableBrowserExternalNavigation`](#disablebrowserexternalnavigation) | [デスクトップ](/docs/ja/desktop)ブラウザペインをユーザーと Claude の localhost に制限します | ツール | Managed |
654 | [`disableBundledSkills`](#disablebundledskills) | Claude Code に含まれる[スキル](/docs/ja/skills#bundled-skills)および [ワークフロー](/docs/ja/workflows)をオフにします | Plugins and skills | Any file |656 | [`disableBundledSkills`](#disablebundledskills) | Claude Code に含まれる[スキル](/docs/ja/skills#bundled-skills)と [ワークフロー](/docs/ja/workflows)をオフにします | プラグインとスキル | Any file |
655 | [`disableClaudeAiConnectors`](#disableclaudeaiconnectors) | [claude.ai コネクタ](/docs/ja/mcp#disable-claude-ai-connectors)をオフにして、Claude Code がそれらを取得しないようにします | MCP | Any file |657 | [`disableClaudeAiConnectors`](#disableclaudeaiconnectors) | [claude.ai コネクタ](/docs/ja/mcp#disable-claude-ai-connectors)をオフにして、Claude Code がそれらを取得しないようにします | MCP | Any file |
656 | [`disableCommandPluginSources`](#disablecommandpluginsources) | マーケットプレイス宣言コマンドを実行してインストールする[プラグイン](/docs/ja/plugins/overview)をブロックします | Plugins and skills | Managed |658 | [`disableCommandPluginSources`](#disablecommandpluginsources) | マーケットプレイス宣言コマンドを実行してインストールする[プラグイン](/docs/ja/plugins/overview)をブロックします | プラグインとスキル | Managed |
657 | [`disableDeepLinkRegistration`](#disabledeeplinkregistration) | Claude Code が[`claude-cli://` ハンドラー](/docs/ja/deep-links)を登録するのを停止します | Remote, desktop, and notifications | Any file |659 | [`disableDeepLinkRegistration`](#disabledeeplinkregistration) | Claude Code が[`claude-cli://` ハンドラー](/docs/ja/deep-links)を登録するのを停止します | リモート、デスクトップ、通知 | Any file |
658 | [`disableDesktopLocalSessions`](#disabledesktoplocalsessions) | デバイスで実行される[Desktop Code セッション](/docs/ja/desktop#local-sessions-on-managed-devices)をオフにして、SSH を他のホストとクラウドに残します | Remote, desktop, and notifications | Managed |660 | [`disableDesktopLocalSessions`](#disabledesktoplocalsessions) | デバイスで実行される[Desktop Code セッション](/docs/ja/desktop#local-sessions-on-managed-devices)をオフにして、SSH を他のホストとクラウドに残します | リモート、デスクトップ、通知 | Managed |
659 | [`disabledMcpjsonServers`](#disabledmcpjsonservers) | プロジェクトの[`.mcp.json`](/docs/ja/mcp#project-scope)から特定のサーバーを拒否します | MCP | Any file |661 | [`disabledMcpjsonServers`](#disabledmcpjsonservers) | プロジェクトの[`.mcp.json`](/docs/ja/mcp#project-scope)から特定のサーバーを拒否します | MCP | Any file |
660 | [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | [デスクトップ](/docs/ja/desktop)iOS Simulator ペインで Claude のツールをブロックします | Tools | Managed |662 | [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | [デスクトップ](/docs/ja/desktop)iOS Simulator ペインで Claude のツールをブロックします | ツール | Managed |
661 | [`disableRemoteControl`](#disableremotecontrol) | [リモートコントロール](/docs/ja/remote-control)をすべての場所でオフにします | Remote, desktop, and notifications | Any file |663 | [`disableRemoteControl`](#disableremotecontrol) | [リモートコントロール](/docs/ja/remote-control)をそれが開始できるすべての場所でオフにします | リモート、デスクトップ、通知 | Any file |
662 | [`disableSideloadFlags`](#disablesideloadflags) | [プラグイン](/docs/ja/plugins/overview)、[サブエージェント](/docs/ja/sub-agents)、および [MCP サーバー](/docs/ja/mcp)をサイドロードする CLI フラグを拒否します | Enterprise and managed settings | Managed |664 | [`disableSideloadFlags`](#disablesideloadflags) | [プラグイン](/docs/ja/plugins/overview)、[サブエージェント](/docs/ja/sub-agents)、[MCP サーバー](/docs/ja/mcp)をサイドロードする CLI フラグを拒否します | エンタープライズとマネージド設定 | Managed |
663 | [`disableSkillShellExecution`](#disableskillshellexecution) | [スキル](/docs/ja/skills)およびカスタムコマンドがインラインシェルを実行するのを停止します | Plugins and skills | Any file |665 | [`disableSkillShellExecution`](#disableskillshellexecution) | [スキル](/docs/ja/skills)とカスタムコマンドがインラインシェルを実行するのを停止します | プラグインとスキル | Any file |
664 | [`disableWorkflows`](#disableworkflows) | すべてのユーザーの [動的ワークフロー](/docs/ja/workflows)をオフにします 。自分自身の場合は `enableWorkflows` を使用します | Hooks and automation | Any file |666 | [`disableWorkflows`](#disableworkflows) | [動的ワークフロー](/docs/ja/workflows)をすべてのユーザーに対してオフにします 。自分自身の場合は `enableWorkflows` を使用します | フックと自動化 | Any file |
665 | [`editorMode`](#editormode) | 入力プロンプトで[vim キーバインディング](/docs/ja/interactive-mode#vim-editor-mode)を使用します | Interface and terminal | Any file |667 | [`editorMode`](#editormode) | 入力プロンプトで[vim キーバインディング](/docs/ja/interactive-mode#vim-editor-mode)を使用します | インターフェースとターミナル | Any file |
666 | [`effortLevel`](#effortlevel) | 保存されたレベルを持たないモデルのデフォルト[努力レベル](/docs/ja/model-config#adjust-effort-level)を設定します | Model and responses | Any file |668 | [`effortLevel`](#effortlevel) | 保存されたレベルを持たないモデルのデフォルト[努力レベル](/docs/ja/model-config#adjust-effort-level)を設定します | モデルと応答 | Any file |
667 | [`emojiCompletionEnabled`](#emojicompletionenabled) | プロンプト入力で[`:shortcode:` 絵文字の提案と置換](/docs/ja/interactive-mode#emoji-shortcodes)をオフにします | Interface and terminal | Any file |669 | [`emojiCompletionEnabled`](#emojicompletionenabled) | プロンプト入力で[`:shortcode:` 絵文字の提案と置換](/docs/ja/interactive-mode#emoji-shortcodes)をオフにします | インターフェースとターミナル | Any file |
668 | [`enableAllProjectMcpServers`](#enableallprojectmcpservers) | プロンプトなしでプロジェクト [`.mcp.json`](/docs/ja/mcp#project-server-approvals-and-workspace-trust)ファイル内のすべてのサーバーを承認します | MCP | Any file |670 | [`enableAllProjectMcpServers`](#enableallprojectmcpservers) | プロジェクト [`.mcp.json`](/docs/ja/mcp#project-server-approvals-and-workspace-trust)ファイル内のすべてのサーバーをプロンプトなしで承認します | MCP | Any file |
669 | [`enableArtifact`](#enableartifact) | 任意のファイルで `false` を使用して[Artifact ツール](/docs/ja/artifacts)をオフにします。ファイルはそれをオンに戻すことはできません | Remote, desktop, and notifications | Any file |671 | [`enableArtifact`](#enableartifact) | 任意のファイルで `false` を使用して[Artifact ツール](/docs/ja/artifacts)をオフにします。ファイルはそれをオンに戻すことはできません | リモート、デスクトップ、通知 | Any file |
670 | [`enabledMcpjsonServers`](#enabledmcpjsonservers) | プロジェクトの[`.mcp.json`](/docs/ja/mcp#project-server-approvals-and-workspace-trust)から特定のサーバーを承認します | MCP | Any file |672 | [`enabledMcpjsonServers`](#enabledmcpjsonservers) | プロジェクトの[`.mcp.json`](/docs/ja/mcp#project-server-approvals-and-workspace-trust)から特定のサーバーを承認します | MCP | Any file |
671 | [`enabledPlugins`](#enabledplugins) | スコープごとに個別の[プラグイン](/docs/ja/plugins/overview)をオンまたはオフにします | Plugins and skills | Any file |673 | [`enabledPlugins`](#enabledplugins) | スコープごとに個別の[プラグイン](/docs/ja/plugins/overview)をオンまたはオフにします | プラグインとスキル | Any file |
672 | [`enableWorkflows`](#enableworkflows) | プランのデフォルトに対して [動的ワークフロー](/docs/ja/workflows)をオンまたはオフにします | Hooks and automation | Any file |674 | [`enableWorkflows`](#enableworkflows) | [動的ワークフロー](/docs/ja/workflows)をプランのデフォルトに対してオンまたはオフにします | フックと自動化 | Any file |
673 | [`enforceAvailableModels`](#enforceavailablemodels) | [`/model` デフォルト選択](/docs/ja/model-config#enforce-the-allowlist-for-the-default-model)を `availableModels` 許可リスト内に保ちます | Model and responses | Any file |675 | [`enforceAvailableModels`](#enforceavailablemodels) | [`/model` デフォルト選択](/docs/ja/model-config#enforce-the-allowlist-for-the-default-model)を `availableModels` 許可リスト内に保ちます | モデルと応答 | Any file |
674 | [`env`](#env) | すべてのセッションとそのサブプロセスの[環境変数](/docs/ja/env-vars#in-settings-files)を設定します | Memory and context | Any file |676 | [`env`](#env) | すべてのセッションとそのサブプロセスの[環境変数](/docs/ja/env-vars#in-settings-files)を設定します | メモリとコンテキスト | Any file |
675 | [`externalEditorContext`](#externaleditorcontext) | [Ctrl+G](/docs/ja/interactive-mode#general-controls)を押して編集するときに Claude の最後の応答をコメントとして表示します | Global config settings | Global config |677 | [`externalEditorContext`](#externaleditorcontext) | [Ctrl+G](/docs/ja/interactive-mode#general-controls)を押して編集するときに Claude の最後の応答をコメントとして表示します | グローバル設定 | Global config |
676 | [`extraKnownMarketplaces`](#extraknownmarketplaces) | リポジトリまたは組織の[マーケットプレイス](/docs/ja/plugins/overview)を登録します | Plugins and skills | Any file |678 | [`extraKnownMarketplaces`](#extraknownmarketplaces) | リポジトリまたは組織の[マーケットプレイス](/docs/ja/plugins/overview)を登録します | プラグインとスキル | Any file |
677 | [`fallbackModel`](#fallbackmodel) | プライマリがオーバーロードされたときの[バックアップモデル](/docs/ja/model-config#fallback-model-chains)に名前を付けます | Model and responses | Any file |679 | [`fallbackModel`](#fallbackmodel) | プライマリがオーバーロードされたときの[バックアップモデル](/docs/ja/model-config#fallback-model-chains)に名前を付けます | モデルと応答 | Any file |
678 | [`fastMode`](#fastmode) | 利用可能なセッションで[高速モード](/docs/ja/fast-mode)をオンにします | Model and responses | Any file |680 | [`fastMode`](#fastmode) | 利用可能なセッションで[高速モード](/docs/ja/fast-mode)をオンにします | モデルと応答 | Any file |
679 | [`fastModePerSessionOptIn`](#fastmodepersessionoptin) | ユーザーが各セッションで[高速モード](/docs/ja/fast-mode)をオンにすることを要求します | Model and responses | Any file |681 | [`fastModePerSessionOptIn`](#fastmodepersessionoptin) | ユーザーが各セッションで[高速モード](/docs/ja/fast-mode)をオンにすることを要求します | モデルと応答 | Any file |
680 | [`feedbackDrafts`](#feedbackdrafts) | Claude が[フィードバックドラフト](/docs/ja/tools-reference#sendfeedback-tool-behavior)をキューに入れるかどうかを制御します | Privacy and telemetry | User or managed |682 | [`feedbackDrafts`](#feedbackdrafts) | Claude が[フィードバックドラフト](/docs/ja/tools-reference#sendfeedback-tool-behavior)をキューに入れるかどうかを制御します | プライバシーとテレメトリ | User or managed |
681 | [`feedbackSurveyRate`](#feedbacksurveyrate) | [セッション品質調査](/docs/ja/data-usage#session-quality-surveys)が表示される頻度を変更します | Privacy and telemetry | Any file |683 | [`feedbackSurveyRate`](#feedbacksurveyrate) | [セッション品質調査](/docs/ja/data-usage#session-quality-surveys)が表示される頻度を変更します | プライバシーとテレメトリ | Any file |
682 | [`fileCheckpointingEnabled`](#filecheckpointingenabled) | [`/rewind`](/docs/ja/checkpointing)が復元するファイルスナップショットをオフまたはオンにします | Memory and context | Any file |684 | [`fileCheckpointingEnabled`](#filecheckpointingenabled) | [`/rewind`](/docs/ja/checkpointing)が復元するファイルスナップショットをオフまたはオンにします | メモリとコンテキスト | Any file |
683 | [`fileSuggestion`](#filesuggestion) | 独自のコマンドから[`@` ファイルオートコンプリート](/docs/ja/interactive-mode#quick-commands)を提供します | Interface and terminal | Any file |685 | [`fileSuggestion`](#filesuggestion) | 独自のコマンドから[`@` ファイルオートコンプリート](/docs/ja/interactive-mode#quick-commands)を提供します | インターフェースとターミナル | Any file |
684 | [`footerLinksRegexes`](#footerlinksregexes) | 出力内の問題またはレビュー ID を入力ボックスの下の[クリック可能なリンク](/docs/ja/statusline#clickable-links)にします | Interface and terminal | User or managed |686 | [`footerLinksRegexes`](#footerlinksregexes) | 出力内の問題またはレビュー ID を入力ボックスの下の[クリック可能なリンク](/docs/ja/statusline#clickable-links)にします | インターフェースとターミナル | User or managed |
685 | [`forceLoginGatewayUrl`](#forcelogingatewayurl) | ログイン画面が接続する[ゲートウェイ URL](/docs/ja/claude-apps-gateway#set-the-gateway-url)を設定します | Authentication and providers | Managed |687 | [`forceLoginGatewayUrl`](#forcelogingatewayurl) | ログイン画面が接続する[ゲートウェイ URL](/docs/ja/claude-apps-gateway#set-the-gateway-url)を設定します | 認証とプロバイダー | Managed |
686 | [`forceLoginMethod`](#forceloginmethod) | [ログインを制限](/docs/ja/authentication#restrict-login-to-your-organization)して claude.ai、Claude Console、または[クラウドゲートウェイ](/docs/ja/claude-apps-gateway)にします | Authentication and providers | Any file |688 | [`forceLoginMethod`](#forceloginmethod) | [ログインを制限](/docs/ja/authentication#restrict-login-to-your-organization)して claude.ai、Claude Console、または[クラウドゲートウェイ](/docs/ja/claude-apps-gateway)にします | 認証とプロバイダー | Any file |
687 | [`forceLoginOrgUUID`](#forceloginorguuid) | [claude.ai ログインを組織にピン留め](/docs/ja/authentication#restrict-login-to-your-organization)します。マネージドソースのみがそれを強制します | Authentication and providers | Any file |689 | [`forceLoginOrgUUID`](#forceloginorguuid) | [claude.ai ログインを組織にピン留め](/docs/ja/authentication#restrict-login-to-your-organization)します。マネージドソースのみがそれを強制します | 認証とプロバイダー | Any file |
688 | [`forceRemoteSettingsRefresh`](#forceremotesettingsrefresh) | [サーバーマネージド設定](/docs/ja/server-managed-settings)が新しく取得されるまでスタートアップをブロックします | Enterprise and managed settings | Managed |690 | [`forceRemoteSettingsRefresh`](#forceremotesettingsrefresh) | [サーバーマネージド設定](/docs/ja/server-managed-settings)が新しく取得されるまでスタートアップをブロックします | エンタープライズとマネージド設定 | Managed |
689 | [`gatewayInternalNetworks`](#gatewayinternalnetworks) | `/login` が組織が内部的に使用するパブリック IPv4 スペース上の[クラウドゲートウェイ](/docs/ja/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own)に到達することを許可します | Authentication and providers | Managed |691 | [`gatewayInternalNetworks`](#gatewayinternalnetworks) | `/login` が組織が内部的に使用するパブリック IPv4 スペース上の[クラウドゲートウェイ](/docs/ja/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own)に到達することを許可します | 認証とプロバイダー | Managed |
690 | [`gcpAuthRefresh`](#gcpauthrefresh) | 独自のコマンドで[Google Cloud 認証情報](/docs/ja/google-vertex-ai#advanced-credential-configuration)をリフレッシュします | Authentication and providers | Any file |692 | [`gcpAuthRefresh`](#gcpauthrefresh) | 独自のコマンドで[Google Cloud 認証情報](/docs/ja/google-vertex-ai#advanced-credential-configuration)をリフレッシュします | 認証とプロバイダー | Any file |
691 | [`hooks`](#hooks) | Claude Code のライフサイクルのポイントで[フック](/docs/ja/hooks)として独自のコマンドを実行します | Hooks and automation | Any file |693 | [`hooks`](#hooks) | Claude Code のライフサイクルのポイントで[フック](/docs/ja/hooks)として独自のコマンドを実行します | フックと自動化 | Any file |
692 | [`httpHookAllowedEnvVars`](#httphookallowedenvvars) | [HTTP フック](/docs/ja/hooks)がヘッダーに入れることができる環境変数を制限します | Hooks and automation | Any file |694 | [`httpHookAllowedEnvVars`](#httphookallowedenvvars) | [HTTP フック](/docs/ja/hooks)がヘッダーに入れることができる環境変数を制限します | フックと自動化 | Any file |
693 | [`includeCoAuthoredBy`](#includecoauthoredby) | 非推奨。`attribution` を使用してコミットと PR の属性を非表示または変更します | Git and attribution | Any file |695 | [`includeCoAuthoredBy`](#includecoauthoredby) | 非推奨。`attribution` を使用してコミットと PR 属性を非表示または変更します | Git と属性 | Any file |
694 | [`includeGitInstructions`](#includegitinstructions) | Claude の context から組み込みコミットおよび PR 指示を削除します | Git and attribution | Any file |696 | [`includeGitInstructions`](#includegitinstructions) | Claude のコンテキストから組み込みコミットと PR 指示を削除します | Git と属性 | Any file |
695 | [`inputNeededNotifEnabled`](#inputneedednotifenabled) | Claude があなたを待っているときに[プッシュ通知](/docs/ja/remote-control#mobile-push-notifications)を取得します | Remote, desktop, and notifications | Any file |697 | [`inputNeededNotifEnabled`](#inputneedednotifenabled) | Claude があなたを待っているときに[プッシュ通知](/docs/ja/remote-control#mobile-push-notifications)を取得します | リモート、デスクトップ、通知 | Any file |
696 | [`isolatePeerMachines`](#isolatepeermachines) | Claude が[別のマシンのセッションの 1 つにメッセージを送信 ](/docs/ja/cross-session-messaging#require-approval-for-cross-machine-messages)する前に確認を求めます | Agents, sessions, and worktrees | Any file |698 | [`isolatePeerMachines`](#isolatepeermachines) | Claude が別のマシンのセッションの 1 つに[メッセージを送信 ](/docs/ja/cross-session-messaging#require-approval-for-cross-machine-messages)する前に確認を求めます | エージェント、セッション、ワークツリー | Any file |
697 | [`keybindingFlavor`](#keybindingflavor) | 非推奨で効果がありません。単語編集ショートカットは常に[readline 規約に従う](/docs/ja/interactive-mode#make-ctrl-w-delete-back-to-whitespace)ます | Interface and terminal | Any file |699 | [`keybindingFlavor`](#keybindingflavor) | 非推奨で効果がありません。単語編集ショートカットは常に[readline 規約に従う](/docs/ja/interactive-mode#make-ctrl-w-delete-back-to-whitespace) | インターフェースとターミナル | Any file |
698 | [`language`](#language) | Claude が英語以外の言語で応答するようにします | Model and responses | Any file |700 | [`language`](#language) | Claude が英語以外の言語で応答するようにします | モデルと応答 | Any file |
699 | [`leftArrowOpensAgents`](#leftarrowopensagents) | [バックグラウンドセッションとエージェントビューを開く ](/docs/ja/agent-view#switch-sessions-without-leaving-the-terminal)ショートカット `←` をオフにします | Global config settings | Global config |701 | [`leftArrowOpensAgents`](#leftarrowopensagents) | [セッションをバックグラウンドにしてエージェントビューを開く ](/docs/ja/agent-view#switch-sessions-without-leaving-the-terminal) `←` ショートカットをオフにします | グローバル設定 | Global config |
700 | [`managedMcpServers`](#managedmcpservers) | ユーザーが追加するものと一緒にすべてのユーザーにリモート[MCP サーバー](/docs/ja/managed-mcp#provide-servers-through-managed-settings)を提供します | MCP | Managed |702 | [`managedMcpServers`](#managedmcpservers) | ユーザーが追加するものと一緒にすべてのユーザーにリモート[MCP サーバー](/docs/ja/managed-mcp#provide-servers-through-managed-settings)を提供します | MCP | Managed |
701 | [`managedSourcesBehavior`](#managedsourcesbehavior) | デプロイするすべての[マネージドソース](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)を構成する代わりに、最優先のものだけを使用します | Enterprise and managed settings | Managed |703 | [`managedSourcesBehavior`](#managedsourcesbehavior) | デプロイするすべての[マネージドソース](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)を構成する代わりに、最優先度のものだけを使用します | エンタープライズとマネージド設定 | Managed |
702 | [`maxEffortLevel`](#maxeffortlevel) | すべてのモデルまたはモデルごと、すべてのプロバイダーで[努力レベル](/docs/ja/model-config#adjust-effort-level)をキャップします | Model and responses | Any file |704 | [`maxEffortLevel`](#maxeffortlevel) | すべてのモデルまたはモデルごと、すべてのプロバイダーで[努力レベル](/docs/ja/model-config#adjust-effort-level)をキャップします | モデルと応答 | Any file |
703 | [`maxProseWidth`](#maxprosewidth) | 広いターミナルで Claude の応答内の散文がどのくらい広く実行されるかをキャップします | Interface and terminal | Any file |705 | [`maxProseWidth`](#maxprosewidth) | Claude の応答の散文が広いターミナルで実行される幅をキャップします | インターフェースとターミナル | Any file |
704 | [`minimumVersion`](#minimumversion) | [自動更新](/docs/ja/setup#pin-a-minimum-version)がバージョン以下のものをインストールするのを防ぎます | Updates and versioning | Any file |706 | [`minimumVersion`](#minimumversion) | [自動更新](/docs/ja/setup#pin-a-minimum-version)がバージョン以下のものをインストールするのを防ぎます | 更新とバージョン管理 | Any file |
705 | [`model`](#model) | Claude Code が開始する[モデル](/docs/ja/model-config#set-a-default-model-for-new-sessions)を変更します | Model and responses | Any file |707 | [`model`](#model) | Claude Code が開始する[モデル](/docs/ja/model-config#set-a-default-model-for-new-sessions)を変更します | モデルと応答 | Any file |
706 | [`modelOverrides`](#modeloverrides) | [モデル ID をマップ](/docs/ja/model-config#override-model-ids-per-version)して、Bedrock ARN などのプロバイダーの ID にします | Model and responses | Any file |708 | [`modelOverrides`](#modeloverrides) | [モデル ID をマップ](/docs/ja/model-config#override-model-ids-per-version)して、Bedrock ARN などのプロバイダーの ID にします | モデルと応答 | Any file |
707 | [`modelPicker`](#modelpicker) | [`/model` ピッカー](/docs/ja/model-config#available-models)がリストするモデルを選択し、独自の順序と独自のラベルで選択します | Model and responses | User or managed |709 | [`modelPicker`](#modelpicker) | [`/model` ピッカー](/docs/ja/model-config#available-models)がリストするモデルを選択します。独自の順序と独自のラベル付きで | モデルと応答 | User or managed |
708 | [`modelPricing`](#modelpricing) | リスト価格ではなく組織の契約レートで支出を報告します | Model and responses | Managed |710 | [`modelPricing`](#modelpricing) | リスト価格の代わりに組織の契約レートで支出を報告します | モデルと応答 | Managed |
709 | [`modelSettings`](#modelsettings) | モデルごとに保存された[努力レベル](/docs/ja/model-config#adjust-effort-level)を保持するか 、1 つのモデルの努力をキャップします | Model and responses | Any file |711 | [`modelSettings`](#modelsettings) | モデルごとに保存された[努力レベル](/docs/ja/model-config#adjust-effort-level)を保つか 、1 つのモデルの努力をキャップします | モデルと応答 | Any file |
710 | [`otelHeadersHelper`](#otelheadershelper) | 独自のコマンドで回転する[OpenTelemetry](/docs/ja/monitoring-usage#dynamic-headers)ヘッダーを生成します | Authentication and providers | Any file |712 | [`otelHeadersHelper`](#otelheadershelper) | 独自のコマンドで回転する[OpenTelemetry](/docs/ja/monitoring-usage#dynamic-headers)ヘッダーを生成します | 認証とプロバイダー | Any file |
711 | [`outputStyle`](#outputstyle) | [出力スタイル](/docs/ja/output-styles)で Claude の役割、トーン、出力形式を変更します | Model and responses | Any file |713 | [`outputStyle`](#outputstyle) | Claude の役割、トーン、出力形式を [出力スタイル](/docs/ja/output-styles)で変更します | モデルと応答 | Any file |
712 | [`parentSettingsBehavior`](#parentsettingsbehavior) | [SDK または IDE ホスト](/docs/ja/managed-settings#let-an-embedding-host-add-policy)が[マネージド設定](/docs/ja/managed-settings)をデプロイするときに渡す制限を適用または削除します | Enterprise and managed settings | Managed |714 | [`parentSettingsBehavior`](#parentsettingsbehavior) | [SDK または IDE ホスト](/docs/ja/managed-settings#let-an-embedding-host-add-policy)が[マネージド設定](/docs/ja/managed-settings)をデプロイするときに渡す制限を適用または削除します | エンタープライズとマネージド設定 | Managed |
713 | [`permissionExplainerEnabled`](#permissionexplainerenabled) | v2.1.257 で削除されました。シェル権限プロンプトの `Ctrl+E` コマンド説明と一緒に削除されました | Global config settings | Global config |715 | [`permissionExplainerEnabled`](#permissionexplainerenabled) | v2.1.257 で削除されました。シェル権限プロンプトの `Ctrl+E` コマンド説明と一緒に | グローバル設定 | Global config |
714 | [`permissions`](#permissions) | 許可、質問、拒否ルール、および開始[権限モード](/docs/ja/permission-modes)を設定します | Permission settings | Any file |716 | [`permissions`](#permissions) | 許可、質問、拒否ルール、および開始[権限モード](/docs/ja/permission-modes)を設定します | 権限設定 | Any file |
715 | [`permissions.additionalDirectories`](#permissions-additionaldirectories) | Claude に[現在のディレクトリ外のディレクトリ](/docs/ja/permissions#working-directories)へのファイルアクセスを付与します | Permission settings | Any file |717 | [`permissions.additionalDirectories`](#permissions-additionaldirectories) | Claude に[現在のディレクトリ外のディレクトリ](/docs/ja/permissions#working-directories)へのファイルアクセスを付与します | 権限設定 | Any file |
716 | [`permissions.allow`](#permissions-allow) | リストされた[ツール使用](/docs/ja/permissions#permission-rule-syntax)をプロンプトなしで承認します | Permission settings | Any file |718 | [`permissions.allow`](#permissions-allow) | リストされた[ツール使用](/docs/ja/permissions#permission-rule-syntax)をプロンプトなしで承認します | 権限設定 | Any file |
717 | [`permissions.ask`](#permissions-ask) | リストされた[ツール使用](/docs/ja/permissions#permission-rule-syntax)の前に常にプロンプトを表示します | Permission settings | Any file |719 | [`permissions.ask`](#permissions-ask) | リストされた[ツール使用](/docs/ja/permissions#permission-rule-syntax)の前に常にプロンプトを表示します | 権限設定 | Any file |
718 | [`permissions.blockReadsOutsideWorkingDirectories`](#permissions-blockreadsoutsideworkingdirectories) | ファイルツールが [作業ディレクトリ](/docs/ja/permissions#working-directories)外の読み取りをすべての権限モードで拒否するようにします | Permission settings | Any file |720 | [`permissions.blockReadsOutsideWorkingDirectories`](#permissions-blockreadsoutsideworkingdirectories) | ファイルツールがすべての権限モードで [作業ディレクトリ](/docs/ja/permissions#working-directories)外の読み取りを拒否するようにします | 権限設定 | Any file |
719 | [`permissions.defaultMode`](#permissions-defaultmode) | 新しいセッションが開始する[権限モード](/docs/ja/permission-modes#which-mode-a-session-starts-in)を設定します | Permission settings | Any file |721 | [`permissions.defaultMode`](#permissions-defaultmode) | 新しいセッションが開始する[権限モード](/docs/ja/permission-modes#which-mode-a-session-starts-in)を設定します | 権限設定 | Any file |
720 | [`permissions.deny`](#permissions-deny) | リストされた[ツール使用](/docs/ja/permissions#permission-rule-syntax)をブロックします。秘密を保持するファイルの読み取りを含みます | Permission settings | Any file |722 | [`permissions.deny`](#permissions-deny) | リストされた[ツール使用](/docs/ja/permissions#permission-rule-syntax)をブロックします。秘密を保持するファイルの読み取りを含む | 権限設定 | Any file |
721 | [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | 誰もが[bypassPermissions モード](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)に入るのを防ぎます | Permission settings | Any file |723 | [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | 誰もが[bypassPermissions モード](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)に入るのを防ぎます | 権限設定 | Any file |
722 | [`plansDirectory`](#plansdirectory) | [プランモード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)がプランファイルを書き込む場所を選択します | Memory and context | Any file |724 | [`plansDirectory`](#plansdirectory) | [プランモード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)がプランファイルを書き込む場所を選択します | メモリとコンテキスト | Any file |
723 | [`pluginConfigs`](#pluginconfigs) | [プラグイン](/docs/ja/plugins/overview)の設定ダイアログで提供した回答を保存します | Plugins and skills | User or managed |725 | [`pluginConfigs`](#pluginconfigs) | [プラグイン](/docs/ja/plugins/overview)の設定ダイアログに与えた回答を保存します | プラグインとスキル | User or managed |
724 | [`pluginSuggestionMarketplaces`](#pluginsuggestionmarketplaces) | `/plugin` でプラグインインストール提案を表示できる[マーケットプレイス](/docs/ja/plugins/org#restrict-what-users-can-install)を選択します | Plugins and skills | Managed |726 | [`pluginSuggestionMarketplaces`](#pluginsuggestionmarketplaces) | `/plugin` でプラグインインストール提案を表示できる[マーケットプレイス](/docs/ja/plugins/org#restrict-what-users-can-install)を選択します | プラグインとスキル | Managed |
725 | [`pluginTrustMessage`](#plugintrustmessage) | [プラグイン](/docs/ja/plugins/overview)信頼警告に独自のテキストを追加します | Plugins and skills | Managed |727 | [`pluginTrustMessage`](#plugintrustmessage) | [プラグイン](/docs/ja/plugins/overview)信頼警告に独自のテキストを追加します | プラグインとスキル | Managed |
726 | [`policyHelper`](#policyhelper) | スタートアップで[マネージド設定](/docs/ja/managed-settings#compute-the-policy-with-a-helper-program)を計算する実行可能ファイルを実行します | Enterprise and managed settings | Managed |728 | [`policyHelper`](#policyhelper) | スタートアップで[マネージド設定](/docs/ja/managed-settings#compute-the-policy-with-a-helper-program)を計算する実行可能ファイルを実行します | エンタープライズとマネージド設定 | Managed |
727 | [`policyHelper.path`](#policyhelper-path) | Claude Code が実行する[ヘルパー実行可能ファイル](/docs/ja/managed-settings#compute-the-policy-with-a-helper-program)に名前を付けます | Enterprise and managed settings | Managed |729 | [`policyHelper.path`](#policyhelper-path) | Claude Code が実行する[ヘルパー実行可能ファイル](/docs/ja/managed-settings#compute-the-policy-with-a-helper-program)に名前を付けます | エンタープライズとマネージド設定 | Managed |
728 | [`policyHelper.refreshIntervalMs`](#policyhelper-refreshintervalms) | バックグラウンドで[ヘルパー](/docs/ja/managed-settings#compute-the-policy-with-a-helper-program)を間隔で再実行します | Enterprise and managed settings | Managed |730 | [`policyHelper.refreshIntervalMs`](#policyhelper-refreshintervalms) | バックグラウンドで[ヘルパー](/docs/ja/managed-settings#compute-the-policy-with-a-helper-program)を間隔で再実行します | エンタープライズとマネージド設定 | Managed |
729 | [`policyHelper.timeoutMs`](#policyhelper-timeoutms) | Claude Code が[ヘルパー](/docs/ja/managed-settings#compute-the-policy-with-a-helper-program)を待つ時間を設定します | Enterprise and managed settings | Managed |731 | [`policyHelper.timeoutMs`](#policyhelper-timeoutms) | Claude Code が[ヘルパー](/docs/ja/managed-settings#compute-the-policy-with-a-helper-program)を待つ時間を設定します | エンタープライズとマネージド設定 | Managed |
730 | [`preferredNotifChannel`](#preferrednotifchannel) | タスク完了の[ターミナルベルまたはデスクトップ通知](/docs/ja/terminal-config#get-a-terminal-bell-or-notification)を選択します | Remote, desktop, and notifications | Any file |732 | [`preferredNotifChannel`](#preferrednotifchannel) | タスク完了の[ターミナルベルまたはデスクトップ通知](/docs/ja/terminal-config#get-a-terminal-bell-or-notification)を選択します | リモート、デスクトップ、通知 | Any file |
731 | [`prefersReducedMotion`](#prefersreducedmotion) | [スピナー、シマー、フラッシュアニメーションを削減またはオフ ](/docs/ja/accessibility#accessibility-settings)にします | Interface and terminal | Any file |733 | [`prefersReducedMotion`](#prefersreducedmotion) | [スピナー、シマー、フラッシュアニメーションを削除またはオフ ](/docs/ja/accessibility#accessibility-settings)にします | インターフェースとターミナル | Any file |
732 | [`processWrapper `](#processwrapper ) | Claude Code のバックグラウンドプロセスを macOS および Linux の [企業ランチャー ](/docs/ja/corporate-launcher )を通して実行します | Agents, sessions, and worktrees | User or managed |734 | [`prependPlugins `](#prependplugins ) | ユーザーがインストールするすべてのモッドの前に組織の [モッド ](/docs/ja/plugins/mods/admin )を実行します | プラグインとスキル | User or managed |
733 | [`promptCacheTtl `](#promptcachettl ) | メイン会話の [プロンプトキャッシュライフタイム ](/docs/ja/prompt-caching#cache -lifetime )を選択します | Model and responses | Any file |735 | [`processWrapper `](#processwrapper ) | Claude Code のバックグラウンドプロセスを macOS および Linux の [企業ランチャー ](/docs/ja/corporate -launcher )を通じて実行します | エージェント、セッション、ワークツリー | User or managed |
734 | [`promptSuggestionEnabled `](#promptsuggestionenabled ) | 入力ボックスのグレーアウトされた [プロンプト提案 ](/docs/ja/interactive -mode #prompt -suggestions )を非表示にします | Interface and terminal | Any file |736 | [`promptCacheTtl `](#promptcachettl ) | メイン会話の [プロンプトキャッシュライフタイム ](/docs/ja/prompt -caching #cache -lifetime )を選択します | モデルと応答 | Any file |
735 | [`prStatusFooterEnabled `](#prstatusfooterenabled ) | プロンプトフッターの [PR レビューステータス ](/docs/ja/interactive-mode#pr-review -status )バッジとその背後にあるプルリクエストチェックをオフにします | Global config settings | Global config |737 | [`promptSuggestionEnabled `](#promptsuggestionenabled ) | 入力ボックスのグレーアウトされた [プロンプト提案 ](/docs/ja/interactive-mode#prompt -suggestions )を非表示にします | インターフェースとターミナル | Any file |
736 | [`prUrlTemplate `](#prurltemplate ) | PR リンクを github.com ではなく内部コードレビューツールにポイントします | Git and attribution | Any file |738 | [`prStatusFooterEnabled `](#prstatusfooterenabled ) | プロンプトフッターの[ PR レビューステータス](/docs/ja/interactive-mode#pr-review-status)バッジとその背後にあるプルリクエストチェックをオフにします | グローバル設定 | Global config |
737 | [`remote.defaultEnvironmentId `](#remote-defaultenvironmentid ) | `claude --cloud` のデフォルト[クラウド環境](/docs/ja/cloud-environments)を選択します。自己ホスト型 `ccpool_` ID はユーザーおよびマネージド設定および `--settings` からのみ読み取られます | Remote, desktop, and notifications | Any file |739 | [`prUrlTemplate `](#prurltemplate ) | PR リンクを github.com の代わりに内部コードレビューツールに指します | Git と属性 | Any file |
738 | [`remoteControlAtStartup `](#remotecontrolatstartup ) | セッション開始時に [リモートコントロール ](/docs/ja/remote-control#enable-remote-control-for-all -sessions )に自動的に接続します | Remote, desktop, and notifications | Any file |740 | [`remote.defaultEnvironmentId `](#remote-defaultenvironmentid ) | `claude --cloud` のデフォルト [クラウド環境 ](/docs/ja/cloud -environments )を選択します。自己ホスト型 `ccpool_` ID はユーザーおよびマネージド設定と `--settings` からのみ読み取られます | リモート、デスクトップ、通知 | Any file |
739 | [`requiredMaximumVersion `](#requiredmaximumversion ) | 組織が許可するバージョンより新しいバージョンで [起動を拒否 ](/docs/ja/setup #pin -a -minimum -version )します | Updates and versioning | Managed |741 | [`remoteControlAtStartup `](#remotecontrolatstartup ) | セッション開始時に [リモートコントロール ](/docs/ja/remote-control #enable -remote -control -for-all-sessions )に自動的に接続します | リモート、デスクトップ、通知 | Any file |
740 | [`requiredMinimumVersion `](#requiredminimumversion ) | 組織が要求するバージョンより古いバージョンで [起動を拒否](/docs/ja/setup#pin-a-minimum-version)します | Updates and versioning | Managed |742 | [`requiredMaximumVersion `](#requiredmaximumversion ) | 組織が許可するバージョンより新しいバージョンで [起動を拒否](/docs/ja/setup#pin-a-minimum-version)します | 更新とバージョン管理 | Managed |
741 | [`respectGitignore `](#respectgitignore ) | gitignored ファイルを [`@` ファイルピッカー ](/docs/ja/interactive-mode #quick -commands )から除外します | Interface and terminal | Any file |743 | [`requiredMinimumVersion `](#requiredminimumversion ) | 組織が要求するバージョンより古いバージョンで [起動を拒否 ](/docs/ja/setup #pin -a-minimum-version )します | 更新とバージョン管理 | Managed |
742 | [`respondToBashCommands `](#respondtobashcommands ) | [`! ` シェルコマンド ](/docs/ja/interactive-mode#shell-mode-with -prefix )実行後に Claude が応答するのを停止します | Interface and terminal | Any file |744 | [`respectGitignore `](#respectgitignore ) | gitignored ファイルを [`@ ` ファイルピッカー ](/docs/ja/interactive-mode#quick -commands )から除外します | インターフェースとターミナル | Any file |
743 | [`sandbox `](#sandbox ) | macOS、Linux、WSL2 で [Bash コマンドをファイルシステムとネットワークから分離 ](/docs/ja/sandboxing )します | Sandbox settings | Any file |745 | [`respondToBashCommands `](#respondtobashcommands ) | [`!` シェルコマンド ](/docs/ja/interactive-mode#shell-mode-with-prefix )の実行後に Claude が応答するのを停止します | インターフェースとターミナル | Any file |
744 | [`sandbox.allowAppleEvents `](#sandbox-allowappleevents ) | [サンドボックス化 ](/docs/ja/sandboxing)されたコマンドが macOS で Apple Events を送信することを許可します | Sandbox settings | User or managed |746 | [`sandbox`](#sandbox) | macOS、Linux、WSL2 で [Bash コマンドをファイルシステムとネットワークから分離 ](/docs/ja/sandboxing)します | サンドボックス設定 | Any file |
745 | [`sandbox.allowUnsandboxedCommands `](#sandbox-allowunsandboxedcommands ) | Claude が [サンドボックス ](/docs/ja/sandboxing#the-unsandboxed-retry-escape-hatch )外でブロックされたコマンドを再試行することを許可するか、禁止します | Sandbox settings | Any file |747 | [`sandbox.allowAppleEvents `](#sandbox-allowappleevents ) | [サンドボックス化 ](/docs/ja/sandboxing)されたコマンドが macOS で Apple Events を送信することを許可します | サンドボックス設定 | User or managed |
746 | [`sandbox.autoAllowBashIfSandboxed `](#sandbox-autoallowbashifsandboxed ) | [サンドボックス化 ](/docs/ja/sandboxing#auto -allow -mode )されたコマンドを権限プロンプトなしで実行します | Sandbox settings | Any file |748 | [`sandbox.allowUnsandboxedCommands `](#sandbox-allowunsandboxedcommands ) | Claude がブロックされたコマンドを [サンドボックス ](/docs/ja/sandboxing#the -unsandboxed -retry-escape-hatch )外で再試行することを許可するか、禁止します | サンドボックス設定 | Any file |
747 | [`sandbox.bwrapPath `](#sandbox-bwrappath ) | [サンドボックス ](/docs/ja/sandboxing)を `PATH` 外の bubblewrap バイナリにポイントします | Sandbox settings | Managed |749 | [`sandbox.autoAllowBashIfSandboxed `](#sandbox-autoallowbashifsandboxed ) | [サンドボックス化 ](/docs/ja/sandboxing#auto-allow-mode )されたコマンドを権限プロンプトなしで実行します | サンドボックス設定 | Any file |
748 | [`sandbox.credentials `](#sandbox-credentials ) | [サンドボックス](/docs/ja/sandboxing#protect-credentials )内の認証情報ファイルと変数を非表示またはマスクします | Sandbox settings | Any file |750 | [`sandbox.bwrapPath `](#sandbox-bwrappath ) | [サンドボックス](/docs/ja/sandboxing)を `PATH` 外の bubblewrap バイナリに指します | サンドボックス設定 | Managed |
749 | [`sandbox.credentials.allowPlaintextInject `](#sandbox-credentials-allowplaintextinject ) | [マスクされた認証情報 ](/docs/ja/sandboxing#mask -credentials)が信頼されたテストネットワーク上のプレーン HTTP サービスに到達することを許可します | Sandbox settings | User or managed |751 | [`sandbox.credentials`](#sandbox-credentials) | [サンドボックス ](/docs/ja/sandboxing#protect -credentials)内の認証情報ファイルと変数を非表示またはマスクします | サンドボックス設定 | Any file |
750 | [`sandbox.credentials.awsPairs `](#sandbox-credentials-awspairs ) | カスタム名の AWS キー変数を [再署名 ](/docs/ja/sandboxing#re-sign-aws -requests )用の 1 つの認証情報にリンクします | Sandbox settings | User or managed |752 | [`sandbox.credentials.allowPlaintextInject `](#sandbox-credentials-allowplaintextinject ) | [マスクされた認証情報 ](/docs/ja/sandboxing#mask -credentials )が信頼できるテストネットワーク上のプレーン HTTP サービスに到達することを許可します | サンドボックス設定 | User or managed |
751 | [`sandbox.credentials.envVars `](#sandbox-credentials-envvars ) | [サンドボックス ](/docs/ja/sandboxing#mask -environment -variables )内の環境変数を設定解除またはマスクします | Sandbox settings | Any file |753 | [`sandbox.credentials.awsPairs `](#sandbox-credentials-awspairs ) | カスタム名の AWS キー変数を [再署名 ](/docs/ja/sandboxing#re -sign -aws-requests )用の 1 つの認証情報にリンクします | サンドボックス設定 | User or managed |
752 | [`sandbox.credentials.files `](#sandbox-credentials-files ) | [サンドボックス](/docs/ja/sandboxing#mask-credential -files )内の認証情報ファイルの読み取りをブロックまたはマスクします | Sandbox settings | Any file |754 | [`sandbox.credentials.envVars `](#sandbox-credentials-envvars ) | [サンドボックス](/docs/ja/sandboxing#mask-environment -variables )内の環境変数を設定解除またはマスクします | サンドボックス設定 | Any file |
753 | [`sandbox.credentials.sigv4 `](#sandbox-credentials-sigv4 ) | ストリーミング、事前署名、または [SigV4A AWS リクエスト ](/docs/ja/sandboxing#re-sign -aws -requests )が失敗するか通過するかを選択します | Sandbox settings | User or managed |755 | [`sandbox.credentials.files `](#sandbox-credentials-files ) | [サンドボックス ](/docs/ja/sandboxing#mask -credential -files )内の認証情報ファイルの読み取りをブロックまたはマスクします | サンドボックス設定 | Any file |
754 | [`sandbox.enabled `](#sandbox-enabled ) | macOS 、Linux 、WSL2 で [Bash サンドボックス ](/docs/ja/sandboxing#get -started )をオンにします | Sandbox settings | Any file |756 | [`sandbox.credentials.sigv4 `](#sandbox-credentials-sigv4 ) | ストリーミング 、事前署名 、または [SigV4A AWS リクエスト ](/docs/ja/sandboxing#re -sign-aws-requests )が失敗するか通過するかを選択します | サンドボックス設定 | User or managed |
755 | [`sandbox.enableWeakerNestedSandbox `](#sandbox-enableweakernestedsandbox ) | Linux [サンドボックス](/docs/ja/sandboxing)を非特権コンテナ内で実行します | Sandbox settings | Any file |757 | [`sandbox.enabled `](#sandbox-enabled ) | macOS、 Linux、WSL2 で [Bash サンドボックス](/docs/ja/sandboxing#get-started )をオンにします | サンドボックス設定 | Any file |
756 | [`sandbox.enableWeakerNetworkIsolation `](#sandbox-enableweakernetworkisolation ) | `gh`、`gcloud`、`terraform` が macOS の [サンドボックス](/docs/ja/sandboxing#troubleshooting )内の MITM プロキシの背後で TLS を検証することを許可します | Sandbox settings | Any file |758 | [`sandbox.enableWeakerNestedSandbox `](#sandbox-enableweakernestedsandbox ) | Linux [サンドボックス](/docs/ja/sandboxing)を非特権コンテナ内で実行します | サンドボックス設定 | Any file |
757 | [`sandbox.excludedCommands `](#sandbox-excludedcommands ) | 常に [サンドボックス](/docs/ja/sandboxing)外で実行されるコマンドに名前を付けます | Sandbox settings | Any file |759 | [`sandbox.enableWeakerNetworkIsolation `](#sandbox-enableweakernetworkisolation ) | `gh`、`gcloud`、`terraform` が [サンドボックス](/docs/ja/sandboxing#troubleshooting )内の macOS で MITM プロキシの背後で TLS を検証することを許可します | サンドボックス設定 | Any file |
758 | [`sandbox.failIfUnavailable `](#sandbox-failifunavailable ) | [サンドボックス](/docs/ja/sandboxing)ができないときに起動を拒否します。サンドボックス化されていない状態で実行する代わりに | Sandbox settings | Any file |760 | [`sandbox.excludedCommands `](#sandbox-excludedcommands ) | Claude Code が [サンドボックス](/docs/ja/sandboxing)外で実行できるコマンドに名前を付けます | サンドボックス設定 | Any file |
759 | [`sandbox.filesystem `](#sandbox-filesystem ) | [サンドボックス化 ](/docs/ja/sandboxing#filesystem-isolation )されたコマンドが読み取りおよび書き込みできるパスを制御します | Sandbox settings | Any file |761 | [`sandbox.failIfUnavailable `](#sandbox-failifunavailable ) | [サンドボックス ](/docs/ja/sandboxing)ができないときに、サンドボックス化されていない状態で実行する代わりに起動を拒否します | サンドボックス設定 | Any file |
760 | [`sandbox.filesystem.allowManagedReadPathsOnly `](#sandbox-filesystem-allowmanagedreadpathsonly ) | 開発者が [組織がブロックした読み取りパス ](/docs/ja/sandboxing#keep-developers-from-widening-the -policy )を再度開くのを停止します | Sandbox settings | Managed |762 | [`sandbox.filesystem`](#sandbox-filesystem) | [サンドボックス化 ](/docs/ja/sandboxing#filesystem -isolation )されたコマンドが読み取りおよび書き込みできるパスを制御します | サンドボックス設定 | Any file |
761 | [`sandbox.filesystem.allowRead `](#sandbox-filesystem-allowread ) | [`denyRead` ](#sandbox -filesystem -denyread )がブロックする領域内での読み取りを再度開きます | Sandbox settings | Any file |763 | [`sandbox.filesystem.allowManagedReadPathsOnly `](#sandbox-filesystem-allowmanagedreadpathsonly ) | 開発者が [組織がブロックした読み取りパス ](/docs/ja/sandboxing #keep -developers -from-widening-the-policy )を再度開くのを防ぎます | サンドボックス設定 | Managed |
762 | [`sandbox.filesystem.allowWrite `](#sandbox-filesystem-allowwrite ) | [サンドボックス化 ](/docs/ja/sandboxing )されたコマンドが書き込みできるパスを追加します | Sandbox settings | Any file |764 | [`sandbox.filesystem.allowRead `](#sandbox-filesystem-allowread ) | [`denyRead` ](#sandbox-filesystem-denyread )がブロックする領域内での読み取りを再度開きます | サンドボックス設定 | Any file |
763 | [`sandbox.filesystem.denyRead `](#sandbox-filesystem-denyread ) | [サンドボックス化](/docs/ja/sandboxing)されたコマンドが特定のパスを読み取るのをブロックします | Sandbox settings | Any file |765 | [`sandbox.filesystem.allowWrite `](#sandbox-filesystem-allowwrite ) | [サンドボックス化](/docs/ja/sandboxing)されたコマンドが書き込みできるパスを追加します | サンドボックス設定 | Any file |
764 | [`sandbox.filesystem.denyWrite `](#sandbox-filesystem-denywrite ) | [サンドボックス化](/docs/ja/sandboxing)されたコマンドが特定のパスに書き込むのをブロックします | Sandbox settings | Any file |766 | [`sandbox.filesystem.denyRead `](#sandbox-filesystem-denyread ) | [サンドボックス化](/docs/ja/sandboxing)されたコマンドが特定のパスを読み取るのをブロックします | サンドボックス設定 | Any file |
765 | [`sandbox.filesystem.disabled `](#sandbox-filesystem-disabled ) | ネットワーク分離を保持しながら [ファイルシステム分離をオフ ](/docs/ja/sandboxing#disable-filesystem-isolation )にします | Sandbox settings | User or managed |767 | [`sandbox.filesystem.denyWrite `](#sandbox-filesystem-denywrite ) | [サンドボックス化 ](/docs/ja/sandboxing)されたコマンドが特定のパスに書き込むのをブロックします | サンドボックス設定 | Any file |
766 | [`sandbox.ignoreViolations `](#sandbox-ignoreviolations ) | コマンドがプローブすることが予想されるパスの違反レポートをサイレンスします | Sandbox settings | Any file |768 | [`sandbox.filesystem.disabled `](#sandbox-filesystem-disabled ) | ネットワーク分離を保ちながら[ファイルシステム分離をオフ](/docs/ja/sandboxing#disable-filesystem-isolation)にします | サンドボックス設定 | User or managed |
767 | [`sandbox.network `](#sandbox-network ) | [サンドボックス化](/docs/ja/sandboxing#network-isolation)されたコマンドが到達するホスト、ポート、ソケットを制御します | Sandbox settings | Any file |769 | [`sandbox.ignoreViolations `](#sandbox-ignoreviolations ) | コマンドがプローブすることが予想されるパスの違反レポートをサイレンスします | サンドボックス設定 | Any file |
768 | [`sandbox.network.allowAllUnixSockets `](#sandbox-network-allowallunixsockets ) | [サンドボックス化](/docs/ja/sandboxing)されたコマンドがすべての Unix ソケットに接続することを許可します | Sandbox settings | Any file |770 | [`sandbox.network`](#sandbox-network) | [サンドボックス化](/docs/ja/sandboxing#network-isolation )されたコマンドが到達するホスト、ポート、ソケットを制御します | サンドボックス設定 | Any file |
769 | [`sandbox.network.allowedDomains `](#sandbox-network-alloweddomains ) | [サンドボックス化](/docs/ja/sandboxing)されたコマンドがそれらのプロンプトを表示しないようにドメインを事前許可します | Sandbox settings | Any file |771 | [`sandbox.network.allowAllUnixSockets `](#sandbox-network-allowallunixsockets ) | [サンドボックス化](/docs/ja/sandboxing)されたコマンドがすべての Unix ソケットに接続することを許可します | サンドボックス設定 | Any file |
770 | [`sandbox.network.allowLocalBinding `](#sandbox-network-allowlocalbinding ) | [サンドボックス化](/docs/ja/sandboxing)されたコマンドが macOS で localhost ポートにバインドすることを許可します | Sandbox settings | Any file |772 | [`sandbox.network.allowedDomains `](#sandbox-network-alloweddomains ) | [サンドボックス化](/docs/ja/sandboxing)されたコマンドがプロンプトを表示しないようにドメインを事前に許可します | サンドボックス設定 | Any file |
771 | [`sandbox.network.allowMachLookup `](#sandbox-network-allowmachlookup ) | macOS [サンドボックス化](/docs/ja/sandboxing)ツール(iOS Simulator または Playwright など)が XPC サービスに到達することを許可します | Sandbox settings | Any file |773 | [`sandbox.network.allowLocalBinding `](#sandbox-network-allowlocalbinding ) | [サンドボックス化](/docs/ja/sandboxing)されたコマンドが macOS で localhost ポートにバインドすることを許可します | サンドボックス設定 | Any file |
772 | [`sandbox.network.allowManagedDomainsOnly `](#sandbox-network-allowmanageddomainsonly ) | ネットワーク許可リストを [マネージド設定 ](/docs/ja/sandboxing#keep-developers-from-widening-the-policy )にロックします | Sandbox settings | Managed |774 | [`sandbox.network.allowMachLookup `](#sandbox-network-allowmachlookup ) | macOS [サンドボックス化 ](/docs/ja/sandboxing)ツール(iOS Simulator または Playwright など)が XPC サービスに到達することを許可します | サンドボックス設定 | Any file |
773 | [`sandbox.network.allowUnixSockets `](#sandbox-network-allowunixsockets ) | [サンドボックス化 ](/docs/ja/sandboxing)されたコマンドが macOS で使用できる Unix ソケットパスをリストします | Sandbox settings | Any file |775 | [`sandbox.network.allowManagedDomainsOnly `](#sandbox-network-allowmanageddomainsonly ) | ネットワーク許可リストを [マネージド設定 ](/docs/ja/sandboxing#keep-developers-from-widening-the-policy )にロックします | サンドボックス設定 | Managed |
774 | [`sandbox.network.deniedDomains `](#sandbox-network-denieddomains ) | [サンドボックス化](/docs/ja/sandboxing)されたコマンドのドメインをブロックします。許可されたワイルドカード内でも | Sandbox settings | Any file |776 | [`sandbox.network.allowUnixSockets `](#sandbox-network-allowunixsockets ) | [サンドボックス化](/docs/ja/sandboxing)されたコマンドが macOS で使用できる Unix ソケットパスをリストします | サンドボックス設定 | Any file |
775 | [`sandbox.network.httpProxyPort `](#sandbox-network-httpproxyport ) | [サンドボックス ](/docs/ja/sandboxing#custom-proxy-configuration )HTTP トラフィックを独自のプロキシを通してルーティングします | Sandbox settings | Any file |777 | [`sandbox.network.deniedDomains `](#sandbox-network-denieddomains ) | [サンドボックス化 ](/docs/ja/sandboxing)されたコマンドのドメインをブロックします。許可されたワイルドカード内でも | サンドボックス設定 | Any file |
776 | [`sandbox.network.socksProxyPort `](#sandbox-network-socksproxyport ) | [サンドボックス](/docs/ja/sandboxing#custom-proxy-configuration)SOCKS トラフィックを独自のプロキシを通してルーティングします | Sandbox settings | Any file |778 | [`sandbox.network.httpProxyPort `](#sandbox-network-httpproxyport ) | [サンドボックス](/docs/ja/sandboxing#custom-proxy-configuration)HTTP トラフィックを独自のプロキシを通じてルーティングします | サンドボックス設定 | Any file |
777 | [`sandbox.network.strictAllowlist `](#sandbox-network-strictallowlist ) | プロンプトの代わりに [許可リスト ](/docs/ja/sandboxing#network -isolation )外のホストを拒否します | Sandbox settings | User or managed |779 | [`sandbox.network.socksProxyPort `](#sandbox-network-socksproxyport ) | [サンドボックス ](/docs/ja/sandboxing#custom -proxy-configuration )SOCKS トラフィックを独自のプロキシを通じてルーティングします | サンドボックス設定 | Any file |
778 | [`sandbox.network.tlsTerminate `](#sandbox-network-tlsterminate ) | [サンドボックス ](/docs/ja/sandboxing#network-isolation)プロキシが TLS を終了して HTTPS リクエストを読み取ることができるようにします | Sandbox settings | User or managed |780 | [`sandbox.network.strictAllowlist `](#sandbox-network-strictallowlist ) | プロンプトの代わりに [許可リスト ](/docs/ja/sandboxing#network-isolation)外のホストを拒否します | サンドボックス設定 | User or managed |
779 | [`sandbox.ripgrep `](#sandbox-ripgrep ) | [サンドボックス](/docs/ja/sandboxing)内で独自の ripgrep バイナリを使用します | Sandbox settings | User or managed |781 | [`sandbox.network.tlsTerminate `](#sandbox-network-tlsterminate ) | [サンドボックス](/docs/ja/sandboxing#network-isolation )プロキシが TLS を終了して HTTPS リクエストを読み取ることができるようにします | サンドボックス設定 | User or managed |
780 | [`sandbox.socatPath `](#sandbox-socatpath ) | [サンドボックス](/docs/ja/sandboxing)プロキシを `PATH` 外の `socat` バイナリにポイントします | Sandbox settings | Managed |782 | [`sandbox.ripgrep `](#sandbox-ripgrep ) | [サンドボックス](/docs/ja/sandboxing)内で独自の ripgrep バイナリを使用します | サンドボックス設定 | User or managed |
781 | [`showClearContextOnPlanAccept `](#showclearcontextonplanaccept ) | [プラン受け入れ画面 ](/docs/ja/permission-modes#review-and-approve-a-plan )に「コンテキストをクリア」オプションを表示します | Interface and terminal | Any file |783 | [`sandbox.socatPath `](#sandbox-socatpath ) | [サンドボックス ](/docs/ja/sandboxing )プロキシを `PATH` 外の `socat` バイナリに指します | サンドボックス設定 | Managed |
782 | [`showThinkingSummaries `](#showthinkingsummaries ) | Claude の [思考 ](/docs/ja/model -config #extended -thinking )の要約を折りたたまれたスタブの代わりに表示します | Model and responses | Any file |784 | [`showClearContextOnPlanAccept `](#showclearcontextonplanaccept ) | [プラン受け入れ画面 ](/docs/ja/permission -modes #review -and-approve-a-plan )に「コンテキストをクリア」オプションを表示します | インターフェースとターミナル | Any file |
783 | [`showTurnDuration `](#showturnduration ) | 各応答後の「Cooked for」期間を非表示にします | Interface and terminal | Any file |785 | [`showThinkingSummaries `](#showthinkingsummaries ) | 折りたたまれたスタブの代わりに Claude の[思考](/docs/ja/model-config#extended-thinking)の要約を表示します | モデルと応答 | Any file |
784 | [`skillListingBudgetFraction `](#skilllistingbudgetfraction ) | [スキルリスティング](/docs/ja/skills#skill-descriptions-are-cut-short)用にコンテキストをより多くまたはより少なく予約します | Memory and context | Any file |786 | [`showTurnDuration `](#showturnduration ) | 各応答後の「Cooked for」期間を非表示にします | インターフェースとターミナル | Any file |
785 | [`skillListingMaxDescChars `](#skilllistingmaxdescchars ) | [スキルリスティング](/docs/ja/skills#skill-descriptions-are-cut-short)内の各スキルの説明長をキャップします | Memory and context | Any file |787 | [`skillListingBudgetFraction `](#skilllistingbudgetfraction ) | [スキルリスティング](/docs/ja/skills#skill-descriptions-are-cut-short)用にコンテキストをより多くまたはより少なく予約します | メモリとコンテキスト | Any file |
786 | [`skillOverrides `](#skilloverrides ) | [SKILL.md を編集せずにスキルを非表示または折りたたむ ](/docs/ja/skills#override- skill-visibility -from -settings ) | Plugins and skills | Any file |788 | [`skillListingMaxDescChars `](#skilllistingmaxdescchars ) | [スキルリスティング ](/docs/ja/skills#skill-descriptions -are -cut-short )内の各スキルの説明の長さをキャップします | メモリとコンテキスト | Any file |
787 | [`skipAutoPermissionPrompt `](#skipautopermissionprompt ) | 組み込みデフォルトではなく自分で [自動モード ](/docs/ja/permission-modes #eliminate -prompts -with -auto -mode )に入るときに Claude Code が表示する 1 回限りの通知をスキップします | Permission settings | User or managed |789 | [`skillOverrides `](#skilloverrides ) | [スキルを非表示または折りたたむ ](/docs/ja/skills #override -skill -visibility -from -settings )。SKILL.md を編集せずに | プラグインとスキル | Any file |
788 | [`skipDangerousModePermissionPrompt `](#skipdangerousmodepermissionprompt ) | [bypassPermissions モード ](/docs/ja/permission-modes#skip-all -checks -with-bypasspermissions -mode)の前の確認ダイアログをスキップします | Permission settings | User, local, or managed |790 | [`skipAutoPermissionPrompt `](#skipautopermissionprompt ) | 組み込みデフォルトではなく自分で [自動モード ](/docs/ja/permission-modes#eliminate -prompts -with-auto -mode)に入るときに Claude Code が表示する 1 回限りの通知をスキップします | 権限設定 | User or managed |
789 | [`skipWebFetchPreflight `](#skipwebfetchpreflight ) | Anthropic に到達できないときに [WebFetch ホスト名チェック ](/docs/ja/tools -reference #webfetch -tool -behavior )をスキップします | Privacy and telemetry | Any file |791 | [`skipDangerousModePermissionPrompt `](#skipdangerousmodepermissionprompt ) | [bypassPermissions モード ](/docs/ja/permission -modes #skip -all -checks-with-bypasspermissions-mode )の前の確認ダイアログをスキップします | 権限設定 | User, local, or managed |
790 | [`spellcheck `](#spellcheck ) | インストールする [スペルチェッカー ](/docs/ja/interactive -mode #check-spelling-as -you -type )でプロンプト入力の誤字にアンダーラインを引きます | Interface and terminal | User or managed |792 | [`skipWebFetchPreflight `](#skipwebfetchpreflight ) | Anthropic に到達できないときに [WebFetch ホスト名チェック ](/docs/ja/tools -reference #webfetch -tool -behavior )をスキップします | プライバシーとテレメトリ | Any file |
791 | [`spinnerTipsEnabled `](#spinnertipsenabled ) | Claude が作業中にスピナーのヒントを非表示にします | Interface and terminal | Any file |793 | [`spellcheck `](#spellcheck ) | インストールする[スペルチェッカー](/docs/ja/interactive-mode#check-spelling-as-you-type)でプロンプト入力の単語に下線を引きます | インターフェースとターミナル | User or managed |
792 | [`spinnerTipsOverride `](#spinnertipsoverride ) | スピナーローテーションに独自のヒントを追加するか 、組み込みヒントを置き換えます | Interface and terminal | Any file |794 | [`spinnerTipsEnabled `](#spinnertipsenabled ) | Claude が作業している間 、スピナーのヒントを非表示にします | インターフェースとターミナル | Any file |
793 | [`spinnerVerbs `](#spinnerverbs ) | ターンの実行中に表示される動詞を追加または置き換えます | Interface and terminal | Any file |795 | [`spinnerTipsOverride `](#spinnertipsoverride ) | スピナーローテーションに独自のヒントを追加するか、組み込みヒントを置き換えます | インターフェースとターミナル | Any file |
794 | [`sshConfigs `](#sshconfigs ) | Desktop 環境ドロップダウンに[SSH 接続](/docs/ja/desktop#pre-configure-ssh-connections-for-your-team)を追加します | Remote, desktop, and notifications | User or managed |796 | [`spinnerVerbs `](#spinnerverbs ) | ターンの実行中に表示される動詞を追加または置き換えます | インターフェースとターミナル | Any file |
795 | [`sshHostAllowlist `](#sshhostallowlist ) | [Desktop SSH セッション ](/docs/ja/desktop#restrict -which -ssh-hosts-users -can -connect -to )が到達できるホストを制限します | Remote, desktop, and notifications | Managed |797 | [`sshConfigs `](#sshconfigs ) | [SSH 接続 ](/docs/ja/desktop#pre -configure -ssh-connections -for -your -team )をデスクトップ環境ドロップダウンに追加します | リモート、デスクトップ、通知 | User or managed |
796 | [`statusLine `](#statusline ) | [ステータスライン ](/docs/ja/statusline )をプロンプトの下にレンダリングする独自のコマンドを実行します | Interface and terminal | Any file |798 | [`sshHostAllowlist `](#sshhostallowlist ) | [Desktop SSH セッション ](/docs/ja/desktop#restrict-which-ssh-hosts-users-can-connect-to )が到達できるホストを制限します | リモート、デスクトップ、通知 | Managed |
797 | [`strictKnownMarketplaces `](#strictknownmarketplaces ) | ユーザーが追加およびインストールできる [マーケットプレイス ](/docs/ja/plugins/overview )ソースを許可リストに登録します | Plugins and skills | Managed |799 | [`statusLine `](#statusline ) | 独自のコマンドを実行して、プロンプトの下に [ステータスライン ](/docs/ja/statusline )をレンダリングします | インターフェースとターミナル | Any file |
798 | [`strictPluginOnlyCustomization `](#strictpluginonlycustomization ) | ユーザーおよびプロジェクトソースから[スキル](/docs/ja/skills)、[エージェント](/docs/ja/sub-agents)、 [フック ](/docs/ja/hooks)、[MCP サーバー](/docs/ja /mcp )をブロックします | Plugins and skills | Managed |800 | [`strictKnownMarketplaces `](#strictknownmarketplaces ) | ユーザーが追加およびインストールできる [マーケットプレイス ](/docs/ja/plugins /overview )ソースを許可リストに登録します | プラグインとスキル | Managed |
799 | [`strictPluginOnlyCustomization.agents `](#strictpluginonlycustomization-agents ) | [エージェント](/docs/ja/sub-agents)をプラグインおよびマネージドソースにロックします | Plugins and skills | Managed |801 | [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | [スキル](/docs/ja/skills)、[ エージェント](/docs/ja/sub-agents)、[フック](/docs/ja/hooks)、[MCP サーバー](/docs/ja/mcp)をユーザーおよびプロジェクトソースからブロックします | プラグインとスキル | Managed |
800 | [`strictPluginOnlyCustomization.hooks `](#strictpluginonlycustomization-hooks ) | [フック ](/docs/ja/hooks )をプラグインおよびマネージドソースにロックします | Plugins and skills | Managed |802 | [`strictPluginOnlyCustomization.agents `](#strictpluginonlycustomization-agents ) | [エージェント ](/docs/ja/sub-agents )をプラグインおよびマネージドソースにロックします | プラグインとスキル | Managed |
801 | [`strictPluginOnlyCustomization.mcp `](#strictpluginonlycustomization-mcp ) | [MCP サーバー ](/docs/ja/mcp )をプラグインおよびマネージドソースにロックします | Plugins and skills | Managed |803 | [`strictPluginOnlyCustomization.hooks `](#strictpluginonlycustomization-hooks ) | [フック ](/docs/ja/hooks )をプラグインおよびマネージドソースにロックします | プラグインとスキル | Managed |
802 | [`strictPluginOnlyCustomization.skills `](#strictpluginonlycustomization-skills ) | [スキル ](/docs/ja/skills )をプラグインおよびマネージドソースにロックします | Plugins and skills | Managed |804 | [`strictPluginOnlyCustomization.mcp `](#strictpluginonlycustomization-mcp ) | [MCP サーバー ](/docs/ja/mcp )をプラグインおよびマネージドソースにロックします | プラグインとスキル | Managed |
803 | [`subagentPromptCacheTtl `](#subagentpromptcachettl ) | サブエージェントおよびメイン会話外の他のリクエストの [プロンプトキャッシュライフタイム ](/docs/ja/prompt-caching#cache-lifetime )を選択します | Model and responses | Any file |805 | [`strictPluginOnlyCustomization.skills `](#strictpluginonlycustomization-skills ) | [スキル ](/docs/ja/skills )をプラグインおよびマネージドソースにロックします | プラグインとスキル | Managed |
804 | [`subagentStatusLine `](#subagentstatusline ) | [サブエージェント ](/docs/ja/sub -agents )タスク表示の行を独自のコマンドで書き直します | Interface and terminal | Any file |806 | [`subagentPromptCacheTtl `](#subagentpromptcachettl ) | サブエージェントおよびメイン会話外の他のリクエストの [プロンプトキャッシュライフタイム ](/docs/ja/prompt -caching#cache-lifetime )を選択します | モデルと応答 | Any file |
805 | [`switchModelsOnFlag `](#switchmodelsonflag ) | [安全分類器 ](/docs/ja/model-config#ask-before -switching )がリクエストにフラグを立てたときにモデルを自動的に切り替えるか一時停止します | Model and responses | Any file |807 | [`subagentStatusLine `](#subagentstatusline ) | 独自のコマンドで [サブエージェント ](/docs/ja/sub -agents )タスク表示の行を書き直します | インターフェースとターミナル | Any file |
806 | [`syncClaudeAiPlugins `](#syncclaudeaiplugins ) | [claude.ai アカウントで有効になっているプラグイン ](/docs/ja/plugins/loading #synced -plugins )のロードを停止し、新しいものをダウンロードするのを停止します | Plugins and skills | User, local, or managed |808 | [`switchModelsOnFlag `](#switchmodelsonflag ) | [安全分類器 ](/docs/ja/model-config #ask -before-switching )がリクエストにフラグを立てるときに自動的にモデルを切り替えるか一時停止します | モデルと応答 | Any file |
807 | [`syncClaudeAiSkills `](#syncclaudeaiskills ) | [claude.ai アカウントで有効になっているスキル ](/docs/ja/skills #how- synced-skills-behave )のロードを停止し、新しいものをダウンロードするのを停止します | Plugins and skills | User, local, or managed |809 | [`syncClaudeAiPlugins `](#syncclaudeaiplugins ) | [claude.ai アカウントで有効になっているプラグイン ](/docs/ja/plugins/loading #synced-plugins )のロードを停止し、新しいものをダウンロードするのを停止します | プラグインとスキル | User, local, or managed |
808 | [`syntaxHighlightingDisabled `](#syntaxhighlightingdisabled ) | diff およびコードブロックの構文強調表示をオフにします | Interface and terminal | Any file |810 | [`syncClaudeAiSkills `](#syncclaudeaiskills ) | [claude.ai アカウントで有効になっているスキル](/docs/ja/skills#how-synced-skills-behave)のロードを停止し、新しいものをダウンロードするのを停止します | プラグインとスキル | User, local, or managed |
809 | [`taskOutputMaxChars `](#taskoutputmaxchars ) | v2.1.277 で削除されました。それがサイズを設定した `TaskOutput` ツールと一緒に削除されました | Memory and context | Any file |811 | [`syntaxHighlightingDisabled `](#syntaxhighlightingdisabled ) | diff およびコードブロックの構文強調表示をオフにします | インターフェースとターミナル | Any file |
810 | [`teammateDefaultModel `](#teammatedefaultmodel ) | v2.1.234 で削除されました。Claude Code がチームメイトのモデルを選択する方法については[チームメイトとモデルを指定](/docs/ja/agent-teams#specify-teammates-and-models)を参照してください | Global config settings | Global config |812 | [`taskOutputMaxChars `](#taskoutputmaxchars ) | v2.1.277 で削除されました。それがサイズを設定した `TaskOutput` ツールと一緒に | メモリとコンテキスト | Any file |
811 | [`teammateMode `](#teammatemode ) | [エージェントチームチームメイトの表示 ](/docs/ja/agent-teams#choose -a -display -mode )方法を選択します | Agents, sessions, and worktrees | Any file |813 | [`teammateDefaultModel `](#teammatedefaultmodel ) | v2.1.234 で削除されました。 [チームメイトとモデルを指定 ](/docs/ja/agent-teams#specify -teammates -and -models )を参照して、Claude Code がチームメイトのモデルを選択する方法を確認してください | グローバル設定 | Global config |
812 | [`terminalProgressBarEnabled `](#terminalprogressbarenabled ) | それをサポートするターミナルでターミナルプログレスバーを非表示にします | Interface and terminal | Any file |814 | [`teammateMode `](#teammatemode ) | [エージェントチームチームメイトの表示](/docs/ja/agent-teams#choose-a-display-mode)方法を選択します | エージェント、セッション、ワークツリー | Any file |
813 | [`terminalTitleFromRename `](#terminaltitlefromrename ) | [`/rename`](/docs/ja/sessions#name-your-sessions)および `--name` がターミナルタブタイトルを変更するのを停止します | Interface and terminal | Any file |815 | [`terminalProgressBarEnabled `](#terminalprogressbarenabled ) | サポートするターミナルのターミナルプログレスバーを非表示にします | インターフェースとターミナル | Any file |
814 | [`theme `](#theme ) | インターフェイス [カラーテーマ ](/docs/ja/terminal-config #match-the -color -theme )を選択します。組み込みまたはカスタム | Interface and terminal | Any file |816 | [`terminalTitleFromRename `](#terminaltitlefromrename ) | [`/rename` ](/docs/ja/sessions #name -your -sessions )と `--name` がターミナルタブタイトルを変更するのを停止します | インターフェースとターミナル | Any file |
815 | [`timeFormat `](#timeformat ) | インターフェイスの時刻を 12 時間または 24 時間クロック、UTC、または strftime パターンで表示します | Interface and terminal | Any file |817 | [`theme `](#theme ) | インターフェース[カラーテーマ](/docs/ja/terminal-config#match-the-color-theme)を選択します。組み込みまたはカスタム | インターフェースとターミナル | Any file |
816 | [`timeZone `](#timezone ) | インターフェイスの時刻をシステムのタイムゾーン以外のタイムゾーンで表示します | Interface and terminal | Any file |818 | [`timeFormat `](#timeformat ) | インターフェースの時刻を 12 時間または 24 時間時計、UTC、または strftime パターンで表示します | インターフェースとターミナル | Any file |
817 | [`tui `](#tui ) | [フルスクリーン](/docs/ja/fullscreen)または従来のターミナルレンダラーを選択します | Interface and terminal | Any file |819 | [`timeZone `](#timezone ) | インターフェースの時刻をシステムのタイムゾーン以外のタイムゾーンで表示します | インターフェースとターミナル | Any file |
818 | [`ultracode `](#ultracode ) | Claude が尋ねられることなく各実質的なタスクの [ワークフロー ](/docs/ja/workflows#let-claude-decide-with-ultracode )を計画するようにします | Model and responses | Any file |820 | [`tui `](#tui ) | [フルスクリーン ](/docs/ja/fullscreen )またはクラシックターミナルレンダラーを選択します | インターフェースとターミナル | Any file |
819 | [`useAutoModeDuringPlan `](#useautomodeduringplan ) | [自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)分類器が [プランモード ](/docs/ja/permission-modes #analyze-before -you -edit -with-plan-mode )でシェルコマンドをレビューすることを許可します。`false` に設定してプロンプトを取得します | Permission settings | User, local, or managed |821 | [`ultracode `](#ultracode ) | Claude が尋ねられることなく、実質的なタスクごとに [ワークフロー ](/docs/ja/workflows #let -claude -decide -with-ultracode )を計画するようにします | モデルと応答 | Any file |
820 | [`verbose `](#verbose ) | 切り詰められた要約の代わりに [完全なツール出力 ](/docs/ja/cli -reference #cli -flags )を表示します 。両方が設定されている場合、 `viewMode ` が優先されます | Interface and terminal | Any file |822 | [`useAutoModeDuringPlan `](#useautomodeduringplan ) | [自動モード ](/docs/ja/permission -modes #eliminate -prompts-with-auto-mode )分類器が[プランモード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)でシェルコマンドをレビューすることを許可します 。プロンプトを取得するには `false ` を設定します | 権限設定 | User, local, or managed |
821 | [`viewMode `](#viewmode ) | すべてのセッションを [デフォルト、詳細、またはフォーカスビュー ](/docs/ja/cli-reference#cli-flags)で開始します | Interface and terminal | Any file |823 | [`verbose `](#verbose ) | 切り詰められた要約の代わりに [完全なツール出力 ](/docs/ja/cli-reference#cli-flags)を表示します。両方が設定されている場合、`viewMode` が優先されます | インターフェースとターミナル | Any file |
822 | [`vimInsertModeRemaps `](#viminsertmoderemaps ) | `jj` などの 2 キー [INSERT モードシーケンス ](/docs/ja/interactive -mode #remap-insert-mode-key -sequences )を Escape にマップします | Interface and terminal | User or managed |824 | [`viewMode `](#viewmode ) | すべてのセッションを [デフォルト、詳細、またはフォーカスビュー ](/docs/ja/cli -reference #cli -flags )で開始します | インターフェースとターミナル | Any file |
823 | [`voice `](#voice ) | [音声ディクテーション ](/docs/ja/voice -dictation )をオンにして、ホールドまたはタップモードを選択します | Interface and terminal | Any file |825 | [`vimInsertModeRemaps `](#viminsertmoderemaps ) | 2 キー [INSERT モードシーケンス ](/docs/ja/interactive -mode#remap-insert-mode-key-sequences )(`jj` など)を Escape にマップします | インターフェースとターミナル | User or managed |
824 | [`voiceEnabled `](#voiceenabled ) | 古い単一キー形式で [音声ディクテーション](/docs/ja/voice-dictation)をオンにします | Interface and terminal | Any file |826 | [`voice `](#voice ) | [音声ディクテーション](/docs/ja/voice-dictation)をオンにして、ホールドまたはタップモードを選択します | インターフェースとターミナル | Any file |
825 | [`wheelScrollAccelerationEnabled `](#wheelscrollaccelerationenabled ) | フルスクリーンレンダリングで [マウスホイール加速 ](/docs/ja/fullscreen#mouse-wheel -scrolling )をオフにします | Interface and terminal | Any file |827 | [`voiceEnabled `](#voiceenabled ) | 古い単一キー形式で [音声ディクテーション ](/docs/ja/voice -dictation )をオンにします | インターフェースとターミナル | Any file |
826 | [`workflowKeywordTriggerEnabled `](#workflowkeywordtriggerenabled ) | プロンプト内の単語 `ultracode` が [ワークフロー ](/docs/ja/workflows )を開始することを許可します。`false` に設定して入力します | Hooks and automation | Any file |828 | [`wheelScrollAccelerationEnabled `](#wheelscrollaccelerationenabled ) | フルスクリーンレンダリングで [マウスホイール加速 ](/docs/ja/fullscreen#mouse-wheel-scrolling )をオフにします | インターフェースとターミナル | Any file |
827 | [`workflowSizeGuideline `](#workflowsizeguideline ) | Claude が[動的ワークフロー ](/docs/ja/workflows)で目指すエージェント数を設定します | Hooks and automation | Any file |829 | [`workflowKeywordTriggerEnabled `](#workflowkeywordtriggerenabled ) | プロンプト内の単語 `ultracode` が[ワークフロー ](/docs/ja/workflows)を開始することを許可します。それを入力せずに入力するには `false` を設定します | フックと自動化 | Any file |
828 | [`worktree `](#worktree ) | Claude Code が git [worktrees ](/docs/ja/worktrees )を作成する方法を設定します | Agents, sessions, and worktrees | Any file |830 | [`workflowSizeGuideline `](#workflowsizeguideline ) | Claude が[動的ワークフロー ](/docs/ja/workflows )で目指すエージェント数を設定します | フックと自動化 | Any file |
829 | [`worktree.baseRef `](#worktree-baseref ) | 新しい [worktrees ](/docs/ja/worktrees)をリモートデフォルトブランチまたはローカル HEAD からブランチします | Agents, sessions, and worktrees | Any file |831 | [`worktree`](#worktree) | Claude Code が git [ワークツリー ](/docs/ja/worktrees)を作成する方法を設定します | エージェント、セッション、ワークツリー | Any file |
830 | [`worktree.bgIsolation `](#worktree-bgisolation ) | バックグラウンドセッションが [worktree ](/docs/ja/worktrees)なしで作業コピーを編集することを許可します | Agents, sessions, and worktrees | Any file |832 | [`worktree.baseRef `](#worktree-baseref ) | 新しい [ワークツリー ](/docs/ja/worktrees)をリモートデフォルトブランチまたはローカル HEAD からブランチします | エージェント、セッション、ワークツリー | Any file |
831 | [`worktree.sparsePaths `](#worktree-sparsepaths ) | 各 [worktree ](/docs/ja/worktrees)で必要なディレクトリのみをチェックアウトします | Agents, sessions, and worktrees | Any file |833 | [`worktree.bgIsolation `](#worktree-bgisolation ) | バックグラウンドセッションが [ワークツリー ](/docs/ja/worktrees)なしで作業コピーを編集することを許可します | エージェント、セッション、ワークツリー | Any file |
832 | [`worktree.symlinkDirectories `](#worktree-symlinkdirectories ) | 大きなディレクトリを各 [worktree ](/docs/ja/worktrees)に複製する代わりにシンボリックリンクします | Agents, sessions, and worktrees | Any file |834 | [`worktree.sparsePaths `](#worktree-sparsepaths ) | 各 [ワークツリー ](/docs/ja/worktrees)で必要なディレクトリのみをチェックアウトします | エージェント、セッション、ワークツリー | Any file |
833 | [`wslInheritsWindowsSettings `](#wslinheritswindowssettings ) | WSL が Windows ポリシーチェーンから [マネージド設定 ](/docs/ja/managed-settings )を読み取ることを許可します | Enterprise and managed settings | Managed |835 | [`worktree.symlinkDirectories `](#worktree-symlinkdirectories ) | 各 [ワークツリー ](/docs/ja/worktrees )で大きなディレクトリを複製する代わりにシンボリックリンクします | エージェント、セッション、ワークツリー | Any file |
836 | [`wslInheritsWindowsSettings`](#wslinheritswindowssettings) | WSL が Windows ポリシーチェーンから[マネージド設定](/docs/ja/managed-settings)を読み取ることを許可します | エンタープライズとマネージド設定 | Managed |
834 837
835 <h2 id="model-and-responses">838 <h2 id="model-and-responses">
836 モデルと応答839 モデルと応答
3490 3493
3491 ターンが完了すると、Claude Code はメインスレッドでターン出力に対して各エントリの `pattern` 正規表現をマッチングするため、遅い正規表現は完了するまで UI をブロックします。`(a+)+$` などのネストされた量指定子は特定の入力に対して指数関数的に長くかかり、セッションをフリーズさせる可能性があるため、各 `pattern` を線形に保ち、`+` または `*` のネストを避けてください。3494 ターンが完了すると、Claude Code はメインスレッドでターン出力に対して各エントリの `pattern` 正規表現をマッチングするため、遅い正規表現は完了するまで UI をブロックします。`(a+)+$` などのネストされた量指定子は特定の入力に対して指数関数的に長くかかり、セッションをフリーズさせる可能性があるため、各 `pattern` を線形に保ち、`+` または `*` のネストを避けてください。
3492 3495
3493 フッターバッジは[カスタムステータスライン](/docs/ja/statusline)が設定されている場合と並んでレンダリングされます。どちらも他方を置き換えません。セッションデータから独自のコンテンツを計算するスクリプト駆動行にはステータスラインを使用し、会話から ID をリンクに変換するにはフッターバッジを使用します。スクリプトなし。 3496 フッターバッジは[カスタムステータスライン](/docs/ja/statusline)が設定されている場合と並んでレンダリングされます。どちらも他方を置き換えません。セッションデータから独自のコンテンツを計算するスクリプト駆動行にはステータスラインを使用し、会話から ID をリンクに変換するにはフッターバッジを使用します。
3494 3497
3495 <h3 id="keybindingflavor">3498 <h3 id="keybindingflavor">
3496 `keybindingFlavor`3499 `keybindingFlavor`
3673 `spinnerTipsOverride`3676 `spinnerTipsOverride`
3674 </h3>3677 </h3>
3675 3678
3676 Claude Code が Claude の作業中に表示する[スピナーヒント](#spinnertipsenabled)に独自のヒントを追加するか、組み込みヒントを置き換えます。Claude Code はあなたのヒントを組み込みのものと同じローテーションに入れます。最も長く表示されていないヒントを選択し、クールダウン中のヒントをスキップし、優先度でタイを破ります。 3679 Claude Code が Claude の作業中に表示する[スピナーヒント](#spinnertipsenabled)に独自のヒントを追加するか、組み込みヒントを置き換えます。Claude Code はあなたのヒントを組み込みのものと同じローテーションに入れます。
3677 3680
3678 [`spinnerTipsEnabled`](#spinnertipsenabled) を `false` に設定すると、Claude Code はすべてのヒント(あなたのものを含む)を非表示にします。3681 [`spinnerTipsEnabled`](#spinnertipsenabled) を `false` に設定すると、Claude Code はすべてのヒント(あなたのものを含む)を非表示にします。
3679 3682
3681 * **タイプ**: `tips`、`tipsFile`、`label`、および `excludeDefault` フィールドを持つオブジェクト。各フィールドはオプションです3684 * **タイプ**: `tips`、`tipsFile`、`label`、および `excludeDefault` フィールドを持つオブジェクト。各フィールドはオプションです
3682 * **デフォルト**: 未設定、Claude Code は組み込みヒントのみを表示します3685 * **デフォルト**: 未設定、Claude Code は組み込みヒントのみを表示します
3683 3686
3684 ヒントオブジェクト、`tipsFile`、`label`、およびスコープ行のルール(プロジェクトおよびローカル設定がプレーン文字列のみを提供)には Claude Code v2.1.247 以降が必要です。以前のバージョンでは、プロジェクトまたはローカルファイルの `excludeDefault` も適用されます。 3687 ヒントオブジェクト、`tipsFile`、`label`、およびスコープ行のルール(プロジェクトおよびローカル設定がプレーン文字列のみを提供)には Claude Code v2.1.247 以降が必要です。
3685 3688
3686 各 `tips` エントリはプレーン文字列またはこれらのフィールドを持つオブジェクトです:3689 各 `tips` エントリはプレーン文字列またはこれらのフィールドを持つオブジェクトです:
3687 3690
4303 これを `true` に設定すると、Claude Code はどのフックとフック類似コマンドをロードするかを変更します:4306 これを `true` に設定すると、Claude Code はどのフックとフック類似コマンドをロードするかを変更します:
4304 4307
4305 * **管理フックと SDK フックが実行されます**: 管理設定からのフックと [Agent SDK](/docs/ja/agent-sdk/overview) がプロセス内で登録するフック4308 * **管理フックと SDK フックが実行されます**: 管理設定からのフックと [Agent SDK](/docs/ja/agent-sdk/overview) がプロセス内で登録するフック
4306 * **強制有効プラグインフックが実行されます**: 管理設定が [`enabledPlugins`](#enabledplugins) を通じて強制有効にするプラグインからのフック。Claude Code は完全な `plugin@marketplace` ID でマッチするため、別のマーケットプレイスからの同じ名前のプラグインはブロックされたままです。これにより、組織マーケットプレイスを通じて検証済みフックを配布しながら、その他すべてをブロックできます4309 * **強制有効プラグインフックが実行されます**: 管理設定が [`enabledPlugins`](#enabledplugins) を通じて強制有効にするプラグインからのフック。Claude Code は完全な `plugin@marketplace` ID でマッチするため、別のマーケットプレイスからの同じ名前のプラグインはブロックされたままです。これにより、組織マーケットプレイスを通じて検証済みフックを配布しながら、その他すべてをブロックできます。このようなプラグイン内の [mod](/docs/ja/plugins/mods/overview) は、[組織のものとしてカウント](/docs/ja/plugins/mods/admin#install-your-organizations-mods)される場合のみロードされます
4307 * **その他すべてはブロックされます**: ユーザー、プロジェクト、ローカルフック、他のプラグインからのフック 、エージェント frontmatter で宣言されたフック4310 * **その他すべてはブロックされます**: ユーザー、プロジェクト、ローカルフック、他のインストール済みプラグインからのフック 、エージェント frontmatter で宣言されたフック。[Claude Code に組み込まれた mod](/docs/ja/plugins/mods/overview#mods-built-into-claude-code) は実行し続けます。ユーザーの mod のみをブロックするには、代わりに [`allowManagedModsOnly`](/docs/ja/plugins/mods/admin#set-options-on-the-built-in-guard) を設定してください
4308 * **コマンドソースプラグインは無効になります**: Claude Code は [`command` ソース](/docs/ja/plugins/marketplace-reference#command-plugin-source)を持つプラグイン(管理 `enabledPlugins` で強制有効にされたプラグインを含む)も無効にします。ただし、[`disableCommandPluginSources`](#disablecommandpluginsources) を明示的に `false` に設定した場合を除きます4311 * **コマンドソースプラグインは無効になります**: Claude Code は [`command` ソース](/docs/ja/plugins/marketplace-reference#command-plugin-source)を持つプラグイン(管理 `enabledPlugins` で強制有効にされたプラグインを含む)も無効にします。ただし、[`disableCommandPluginSources`](#disablecommandpluginsources) を明示的に `false` に設定した場合を除きます
4309 * **マーケットプレイス `headersHelper` コマンドはブロックされます**: Claude Code はマーケットプレイス [`headersHelper` コマンド](/docs/ja/plugins/host-marketplace#authenticate-archive-downloads)もブロックします。ただし、[`disableCommandPluginSources`](#disablecommandpluginsources) が明示的に `false` に設定されている場合、または管理設定自体が宣言するマーケットプレイスの場合を除きます。Claude Code v2.1.238 以降が必要です4312 * **マーケットプレイス `headersHelper` コマンドはブロックされます**: Claude Code はマーケットプレイス [`headersHelper` コマンド](/docs/ja/plugins/host-marketplace#authenticate-archive-downloads)もブロックします。ただし、[`disableCommandPluginSources`](#disablecommandpluginsources) が明示的に `false` に設定されている場合、または管理設定自体が宣言するマーケットプレイスの場合を除きます。Claude Code v2.1.238 以降が必要です
4310 * **ステータスラインとファイル提案は管理設定に絞られます**: Claude Code は [`statusLine`](/docs/ja/statusline)、[`fileSuggestion`](#filesuggestion)、[`subagentStatusLine`](/docs/ja/statusline#subagent-status-lines) を管理設定からのみ読み込みます。[ステータスラインとファイル提案ゲート](#status-line-and-file-suggestion-gates)に従います4313 * **ステータスラインとファイル提案は管理設定に絞られます**: Claude Code は [`statusLine`](/docs/ja/statusline)、[`fileSuggestion`](#filesuggestion)、[`subagentStatusLine`](/docs/ja/statusline#subagent-status-lines) を管理設定からのみ読み込みます。[ステータスラインとファイル提案ゲート](#status-line-and-file-suggestion-gates)に従います
5043 * **`git`**: 任意の git URL、`url` を使用5046 * **`git`**: 任意の git URL、`url` を使用
5044 * **`url`**: `marketplace.json` ファイルへの直接 URL、`url` とオプションの `headers` および `headersHelper` を使用して認証アクセスします。`headersHelper` は値が短命すぎてリストできないヘッダーを出力するコマンドに名前を付け、Claude Code v2.1.238 以降が必要です5047 * **`url`**: `marketplace.json` ファイルへの直接 URL、`url` とオプションの `headers` および `headersHelper` を使用して認証アクセスします。`headersHelper` は値が短命すぎてリストできないヘッダーを出力するコマンドに名前を付け、Claude Code v2.1.238 以降が必要です
5045 * **`file`**: `marketplace.json` ファイルへのローカルパス、`path` を使用5048 * **`file`**: `marketplace.json` ファイルへのローカルパス、`path` を使用
5046 * **`directory`**: ローカルファイルシステムパス、`path` を使用(開発のみ) 5049 * **`directory`**: ローカルファイルシステムパス、`path` を使用。開発用、または組織が[各マシンにデプロイするマーケットプレイス](/docs/ja/plugins/mods/admin#install-your-organizations-mods)に使用します。
5047 * **`settings`**: ホストされたリポジトリなしで設定ファイルに直接宣言されたインラインマーケットプレイス、`name` および `plugins` を使用5050 * **`settings`**: ホストされたリポジトリなしで設定ファイルに直接宣言されたインラインマーケットプレイス、`name` および `plugins` を使用
5048 5051
5049 `git` ソースタイプは、自己ホストされた GitLab や Bitbucket を含む任意の git ホスティングサービスで機能します。Claude Code はそのマシンで `git clone` が使用するのと同じ認証でリポジトリをクローンします。設定された認証ヘルパーまたは SSH キー。`GITHUB_TOKEN` などのプロバイダートークンは、それを読む認証ヘルパーを通じてのみ有効になります。セットアップの詳細については、[プライベートリポジトリ](/docs/ja/plugins/host-marketplace#grant-access-to-a-private-marketplace)を参照してください。5052 `git` ソースタイプは、自己ホストされた GitLab や Bitbucket を含む任意の git ホスティングサービスで機能します。Claude Code はそのマシンで `git clone` が使用するのと同じ認証でリポジトリをクローンします。設定された認証ヘルパーまたは SSH キー。`GITHUB_TOKEN` などのプロバイダートークンは、それを読む認証ヘルパーを通じてのみ有効になります。セットアップの詳細については、[プライベートリポジトリ](/docs/ja/plugins/host-marketplace#grant-access-to-a-private-marketplace)を参照してください。
5130 5133
5131 Claude Code はプロジェクトおよびローカルエントリを無視します。これらの値をプラグインフック、MCP、および LSP 設定に置き換えるため、クローンされたリポジトリはそれらを提供できません。v2.1.207 より前では、プロジェクトおよびローカル設定も読まれていました。5134 Claude Code はプロジェクトおよびローカルエントリを無視します。これらの値をプラグインフック、MCP、および LSP 設定に置き換えるため、クローンされたリポジトリはそれらを提供できません。v2.1.207 より前では、プロジェクトおよびローカル設定も読まれていました。
5132 5135
5136 <h3 id="prependplugins">
5137 `prependPlugins`
5138 </h3>
5139
5140 マネージドプラグインのリストで、その [mods](/docs/ja/plugins/mods/overview) がユーザーがインストールするすべての mod の前に実行されます。リストされた順序で実行されます。マネージド設定でこのキーを設定する場合、リストに `sec-default@builtin` を名前付けして、組み込みガードを保持します。マネージド設定では、Claude Code はプラグインが組織のものとしてカウントされないプラグインの ID をスキップします。[組織の mod をインストールして順序を設定する](/docs/ja/plugins/mods/admin#install-your-organizations-mods)を参照してください。これらの条件と 2 つの順序付けキーがどのように機能するかについて。
5141
5142 * **Scope**: [`User or managed`](#scopes)。Claude Code はマネージド設定からキーを読みます。マネージド設定のないマシン上でのみ、Team または Enterprise プランでサインインしていないユーザーのユーザー設定からキーを読みます。プロジェクトおよびローカル設定、および `--settings` ファイルのキーを無視します。
5143 * **Type**: `plugin-name@marketplace-name` 文字列の配列
5144 * **Default**: 未設定
5145
5146 ```json managed-settings.json theme={null}
5147 {
5148 "extraKnownMarketplaces": {
5149 "acme-tools": {
5150 "source": { "source": "directory", "path": "/opt/acme/claude-plugins" }
5151 }
5152 },
5153 "enabledPlugins": { "acme-guard@acme-tools": true },
5154 "prependPlugins": ["acme-guard@acme-tools", "sec-default@builtin"]
5155 }
5156 ```
5157
5158 <h3 id="appendplugins">
5159 `appendPlugins`
5160 </h3>
5161
5162 マネージドプラグインのリストで、その [mods](/docs/ja/plugins/mods/overview) がユーザーがインストールするすべての mod の後に実行されます。リストされた順序で実行されます。`prependPlugins` と `appendPlugins` の両方にリストされている ID は、前置されます。マネージド設定では、Claude Code はプラグインが [組織のものとしてカウント](/docs/ja/plugins/mods/admin#install-your-organizations-mods)されないプラグインの ID をスキップします。
5163
5164 * **Scope**: [`User or managed`](#scopes)。Claude Code はマネージド設定からキーを読みます。マネージド設定のないマシン上でのみ、Team または Enterprise プランでサインインしていないユーザーのユーザー設定からキーを読みます。プロジェクトおよびローカル設定、および `--settings` ファイルのキーを無視します。
5165 * **Type**: `plugin-name@marketplace-name` 文字列の配列
5166 * **Default**: 未設定
5167
5168 ```json managed-settings.json theme={null}
5169 {
5170 "extraKnownMarketplaces": {
5171 "acme-tools": {
5172 "source": { "source": "directory", "path": "/opt/acme/claude-plugins" }
5173 }
5174 },
5175 "enabledPlugins": { "acme-audit@acme-tools": true },
5176 "appendPlugins": ["acme-audit@acme-tools"]
5177 }
5178 ```
5179
5133 <h2 id="mcp">5180 <h2 id="mcp">
5134 MCP5181 MCP
5135 </h2>5182 </h2>
5650 5697
5651 * **Scope**: [`Any file`](#scopes)5698 * **Scope**: [`Any file`](#scopes)
5652 * **Type**: Boolean5699 * **Type**: Boolean
5653 * `true`: Claude Code はファイルが適用されるすべてのセッションに対して Artifact ツールをオフにし、他のファイルはそれをオンに戻しません。v2.1.242 より前では、優先度の高いファイルが優先度の低いファイルの `true` をオーバーライドできました。キーはロックとして機能しません 5700 * `true`: Claude Code はファイルが適用されるすべてのセッションに対して Artifact ツールをオフにし、他のファイルはそれをオンに戻しません
5654 * `false`: 無視されます。ツールをオンのままにするには、キーを削除します5701 * `false`: 無視されます。ツールをオンのままにするには、キーを削除します
5655 * **Default**: 未設定なので、ツールはアカウントの [availability](/docs/ja/artifacts#availability) に従います5702 * **Default**: 未設定なので、ツールはアカウントの [availability](/docs/ja/artifacts#availability) に従います
5656 * **Per-session overrides**: [`CLAUDE_CODE_DISABLE_ARTIFACT`](/docs/ja/env-vars) を `1` に設定すると、1 つのセッションのツールがオフになります5703 * **Per-session overrides**: [`CLAUDE_CODE_DISABLE_ARTIFACT`](/docs/ja/env-vars) を `1` に設定すると、1 つのセッションのツールがオフになります
5737 }5784 }
5738 ```5785 ```
5739 5786
5740 ユーザー設定以外のソースがツールをオフのままにしている間、Claude Code は `/config` で **Artifacts** 行を非表示にします。そこでオンにしても何も変わらないためです。[Disable artifacts](/docs/ja/artifacts#disable-artifacts) はツールをオフにするすべての方法を一覧表示します。v2.1.242 より前では、Claude Code はプロジェクトおよびローカル設定でこのキーを無視し、[優先度スタック](/docs/ja/settings#settings-precedence) で高い位置のファイルが低いファイルのオフをオンに戻すことができました。 5787 ユーザー設定以外のソースがツールをオフのままにしている間、Claude Code は `/config` で **Artifacts** 行を非表示にします。そこでオンにしても何も変わらないためです。[Disable artifacts](/docs/ja/artifacts#disable-artifacts) はツールをオフにするすべての方法を一覧表示します。
5741 5788
5742 <h3 id="inputneedednotifenabled">5789 <h3 id="inputneedednotifenabled">
5743 `inputNeededNotifEnabled`5790 `inputNeededNotifEnabled`
5876 5923
5877 ヘルパースクリプトを通じて認証情報を提供し、組織の場合はログイン方法または組織を強制します。[認証](/docs/ja/authentication)を参照してください。5924 ヘルパースクリプトを通じて認証情報を提供し、組織の場合はログイン方法または組織を強制します。[認証](/docs/ja/authentication)を参照してください。
5878 5925
5926 <h3 id="allowedproviders">
5927 `allowedProviders`
5928 </h3>
5929
5930 マシンが Claude に到達できるサービス(Anthropic API、Amazon Bedrock、LLM ゲートウェイなど)をリストアップします。リストに記載されていないプロバイダー上のセッションは、スタートアップ時、ログイン時、および次に API に接続するときに拒否されるため、セッション中にリストに記載されていないプロバイダーに切り替えることも拒否されます。[拒否メッセージ](/docs/ja/errors#managed-settings-dont-allow-this-api-provider)には、プロバイダーを選択したものと続行するためのステップが記載されています。Claude Code v2.1.285 以降が必要です。
5931
5932 * **スコープ**: [`Managed`](#scopes)。マシン自身の管理者ソースが設定したリスト、MDM ポリシーおよび管理設定ファイルが適用し続けます。サーバー管理設定もリストを配信する場合、セッションは両方のリスト上のプロバイダーのみを使用できるため、サーバー管理リストはマシンが許可するものを狭めることはできますが、広げることはできません。マシンソースの `allowedProviders` のどれが数えられるかは、[Claude Code が管理ソースを組み合わせる方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)に従います。サーバー管理設定のみを通じて配信されたリストは、[サーバー管理設定を取得する](/docs/ja/server-managed-settings#platform-availability)セッションのみに到達します。
5933 * **タイプ**: 文字列の配列。各要素は以下のいずれか:
5934 * `"anthropic"`: claude.ai または Console サインイン、または API キーを通じた Anthropic 独自のホスト上の Anthropic API。[`forceLoginMethod`](#forceloginmethod) または [`forceLoginOrgUUID`](#forceloginorguuid) と組み合わせてサインインも制限します
5935 * `"bedrock"`: [Amazon Bedrock](/docs/ja/amazon-bedrock)
5936 * `"vertex"`: [Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)(旧 Vertex AI)
5937 * `"foundry"`: [Microsoft Foundry](/docs/ja/microsoft-foundry)
5938 * `"anthropicAws"`: [AWS 上の Claude Platform](/docs/ja/claude-platform-on-aws)
5939 * `"mantle"`: Amazon Bedrock [Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)。[Invoke API と並行して Mantle を実行する](/docs/ja/amazon-bedrock#run-mantle-alongside-the-invoke-api)セッションは両方のプロバイダーを使用するため、`"bedrock"` と `"mantle"` をまとめてリストアップします
5940 * `"customEndpoint"`: Anthropic API またはクラウドプロバイダーの API を別のホストに送信します。[LLM ゲートウェイ](/docs/ja/llm-gateway)(`ANTHROPIC_BASE_URL` で指定)、プロバイダーの `ANTHROPIC_*_BASE_URL` 変数、またはベアリソース名ではない `ANTHROPIC_FOUNDRY_RESOURCE` 値。Claude Code はそれを管理 [`env`](#env) ブロックがピンで留めた正確な値に対してのみ許可します
5941 * `"gateway"`: [Cloud ゲートウェイ](/docs/ja/claude-apps-gateway)サインイン
5942 * **デフォルト**: 未設定。任意のプロバイダーを使用できます
5943
5944 ```json managed-settings.json theme={null}
5945 {
5946 "allowedProviders": ["anthropic", "bedrock"]
5947 }
5948 ```
5949
5950 各クラウドプロバイダーのエントリは、そのプロバイダー独自のサービス(地域、FIPS、プライベートエンドポイントを含む)を意味します。
5951
5952 Claude Code がプロバイダー名として認識しないエントリは削除され、報告され、リストの残りは強制されます。空のリスト、またはすべてのエントリが認識されないリストの場合、Claude Code はすべてのプロバイダーを拒否し、マシン上で起動しません。
5953
5954 <h4 id="endpoints-that-need-a-pin-in-managed-env">
5955 管理 `env` でピンが必要なエンドポイント
5956 </h4>
5957
5958 ピンは、管理 [`env`](#env) ブロックで設定されたエンドポイント変数の値です。セッションがプロバイダーのトラフィックをそのプロバイダー独自のサービス以外の場所に送信する場合、Claude Code はセッションの値がピンと同じ場合にのみそれを許可します。これらのエンドポイントには 1 つが必要です:
5959
5960 * **`"customEndpoint"` セッション**: ホストを指定する変数(`ANTHROPIC_BASE_URL` など)
5961 * **Amazon Bedrock**: AWS SDK の `AWS_ENDPOINT_URL`、`AWS_ENDPOINT_URL_BEDROCK`、および `AWS_ENDPOINT_URL_BEDROCK_RUNTIME` 変数が Bedrock 独自のサービス外を指す場合。セッションは `"customEndpoint"` ではなく `"bedrock"` の下に留まります
5962 * **ゲートウェイサインイン URL**: セッションは `"gateway"` の下に留まり、[`forceLoginGatewayUrl`](#forcelogingatewayurl) もピンとしてカウントされます
5963
5964 どの `env` ブロックがピンとしてカウントされるかは、リストが設定されている場所によって異なります:
5965
5966 * **マシン上の管理者ソースがリストを設定**: マシン独自の管理者ソースの `env` ブロックのみがカウントされます
5967 * **サーバー管理設定のみがリストを設定**: これらのサーバー管理設定の `env` 値もカウントされます
5968
5969 リストは、クラウドプロバイダーの認証情報とテナンシー変数、または `HTTPS_PROXY` と証明書設定などのネットワークパスを判定しません。管理 `env` ブロックでフロート用にそれらを設定します。
5970
5879 <h3 id="apikeyhelper">5971 <h3 id="apikeyhelper">
5880 `apiKeyHelper`5972 `apiKeyHelper`
5881 </h3>5973 </h3>
6398 | :- | :- | :- |6490 | :- | :- | :- |
6399 | リスト | すべてのソースからのエントリを組み合わせます | [`permissions.allow`](#permissions-allow)、[`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains)、およびその他のリストキー |6491 | リスト | すべてのソースからのエントリを組み合わせます | [`permissions.allow`](#permissions-allow)、[`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains)、およびその他のリストキー |
6400 | ロック | ソースが設定する最も厳密な値を適用します。ソースが厳密な値を設定しない場合、最優先度のソースからのみより緩い値を適用します | [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly)、[`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode)、およびその他のブール値または列挙型ロック |6492 | ロック | ソースが設定する最も厳密な値を適用します。ソースが厳密な値を設定しない場合、最優先度のソースからのみより緩い値を適用します | [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly)、[`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode)、およびその他のブール値または列挙型ロック |
6401 | 制限許可リスト | 下位ソースからのエントリを追加せずに、それを設定する最優先度のソースから全体を取得します。最優先度のソースが設定しない場合、次のソースから全体を取得します | [`availableModels`](#availablemodels)、[`allowedMcpServers`](#allowedmcpservers)、[`strictKnownMarketplaces`](#strictknownmarketplaces)、[`allowedChannelPlugins`](#allowedchannelplugins)、および [`fallbackModel`](#fallbackmodel) チェーン |6493 | 制限許可リスト | 下位ソースからのエントリを追加せずに、それを設定する最優先度のソースから全体を取得します。最優先度のソースが設定しない場合、次のソースから全体を取得します | [`availableModels`](#availablemodels)、[`allowedMcpServers`](#allowedmcpservers)、[`allowedProviders`](#allowedproviders)、[` strictKnownMarketplaces`](#strictknownmarketplaces)、[`allowedChannelPlugins`](#allowedchannelplugins)、および [`fallbackModel`](#fallbackmodel) チェーン |
6402 | 値全体取得 | 下位ソースからのエントリまたはフィールドを組み合わせずに、それを設定する最優先度のソースから全体を取得します。最優先度のソースが設定しない場合、次のソースから全体を取得します | [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs)、[`sandbox.ripgrep`](#sandbox-ripgrep) |6494 | 値全体取得 | 下位ソースからのエントリまたはフィールドを組み合わせずに、それを設定する最優先度のソースから全体を取得します。最優先度のソースが設定しない場合、次のソースから全体を取得します | [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs)、[`sandbox.ripgrep`](#sandbox-ripgrep) |
6403 | 提供される MCP サーバー | すべてのソースからサーバー名を組み合わせます。2 つのソースが同じ名前を設定する場合、上位ソースの全体エントリを適用します | [`managedMcpServers`](#managedmcpservers) |6495 | 提供される MCP サーバー | すべてのソースからサーバー名を組み合わせます。2 つのソースが同じ名前を設定する場合、上位ソースの全体エントリを適用します | [`managedMcpServers`](#managedmcpservers) |
6404 | 最優先度のソースからのみ読み取ります | ポリシーキーを含む最優先度のソースからのみキーを読み取るため、最優先度のソースが何も設定しない場合でも、下位ソースの値は無視されます | [`apiKeyHelper`](#apikeyhelper)、[`awsAuthRefresh`](#awsauthrefresh)、[`awsCredentialExport`](#awscredentialexport)、[`gcpAuthRefresh`](#gcpauthrefresh)、[`otelHeadersHelper`](#otelheadershelper)、`proxyAuthHelper`、[`forceLoginOrgUUID`](#forceloginorguuid)、[`forceLoginMethod`](#forceloginmethod) の `"claudeai"` および `"console"` 値、[`parentSettingsBehavior`](#parentsettingsbehavior)、[`modelPicker`](#modelpicker)、[`policyHelper`](#policyhelper)、[`permissions.defaultMode`](#permissions-defaultmode) |6496 | 最優先度のソースからのみ読み取ります | ポリシーキーを含む最優先度のソースからのみキーを読み取るため、最優先度のソースが何も設定しない場合でも、下位ソースの値は無視されます | [`apiKeyHelper`](#apikeyhelper)、[`awsAuthRefresh`](#awsauthrefresh)、[`awsCredentialExport`](#awscredentialexport)、[`gcpAuthRefresh`](#gcpauthrefresh)、[`otelHeadersHelper`](#otelheadershelper)、`proxyAuthHelper`、[`forceLoginOrgUUID`](#forceloginorguuid)、[`forceLoginMethod`](#forceloginmethod) の `"claudeai"` および `"console"` 値、[`parentSettingsBehavior`](#parentsettingsbehavior)、[`modelPicker`](#modelpicker)、[`policyHelper`](#policyhelper)、[`permissions.defaultMode`](#permissions-defaultmode) |
6412 * **[`policyHelper`](#policyhelper)**: Claude Code は、ポリシーキーを含む最優先度のソースが MDM ポリシーまたは管理設定ファイルである場合にのみそれを尊重します。サーバー管理設定では適用されません。6504 * **[`policyHelper`](#policyhelper)**: Claude Code は、ポリシーキーを含む最優先度のソースが MDM ポリシーまたは管理設定ファイルである場合にのみそれを尊重します。サーバー管理設定では適用されません。
6413 * **[`modelOverrides`](#modeloverrides)**: `availableModels` とペアになります。Claude Code は、それを設定する最優先度のソースから `modelOverrides` を取得します。ただし、上位ソースが `modelOverrides` なしで `availableModels` を設定する場合は除きます。その場合、すべてのソースから `modelOverrides` を無視します。6505 * **[`modelOverrides`](#modeloverrides)**: `availableModels` とペアになります。Claude Code は、それを設定する最優先度のソースから `modelOverrides` を取得します。ただし、上位ソースが `modelOverrides` なしで `availableModels` を設定する場合は除きます。その場合、すべてのソースから `modelOverrides` を無視します。
6414 * **[`forceLoginGatewayUrl`](#forcelogingatewayurl)、[`gatewayInternalNetworks`](#gatewayinternalnetworks)、および [`forceLoginMethod`](#forceloginmethod) の `"gateway"` 値**: Claude Code はサーバー管理設定からそれらのいずれも読み取りません。そのため、そこでの値は適用されず、MDM ポリシーまたは管理設定ファイルで設定されたものを隠しません。マシン上の管理ソースの中で、ポリシーキーを含む最優先度のソースのみがそれらを提供します。サーバー管理設定も存在するかどうかに関わらず。6506 * **[`forceLoginGatewayUrl`](#forcelogingatewayurl)、[`gatewayInternalNetworks`](#gatewayinternalnetworks)、および [`forceLoginMethod`](#forceloginmethod) の `"gateway"` 値**: Claude Code はサーバー管理設定からそれらのいずれも読み取りません。そのため、そこでの値は適用されず、MDM ポリシーまたは管理設定ファイルで設定されたものを隠しません。マシン上の管理ソースの中で、ポリシーキーを含む最優先度のソースのみがそれらを提供します。サーバー管理設定も存在するかどうかに関わらず。
6507 * **[`allowedProviders`](#allowedproviders)**: テーブルのルールの後、マシン自体のリストは結果を制限し続けます。そのエントリの Scope ノートが述べているように。
6415 6508
6416 マシンで組み合わせたソースを確認するには、`/status` を実行し、[`Setting sources` 行を読んでください](/docs/ja/managed-settings#read-the-source-in-/status)。6509 マシンで組み合わせたソースを確認するには、`/status` を実行し、[`Setting sources` 行を読んでください](/docs/ja/managed-settings#read-the-source-in-/status)。
6417 6510