`~/.claude/settings.json` は [[JSON]]ファイルなのでコメントを書けない。permissionに関する設定などはコメントを書いておきたい。
2026/03/15 時点ではできなそうだがissueは上がっている。
<div class="link-card-v2">
<div class="link-card-v2-site">
<img class="link-card-v2-site-icon" src="https://github.githubassets.com/favicons/favicon.svg" />
<span class="link-card-v2-site-name">GitHub</span>
</div>
<div class="link-card-v2-title">
[FEATURE] Support JSONC format for settings files (settings.jsonc) · Issue #17968 · anthropics/claude-code
</div>
<div class="link-card-v2-content">
Problem JSON doesn't support comments, making it difficult to document configuration decisions in settings.json. ...
</div>
<img class="link-card-v2-image" src="https://opengraph.githubassets.com/8622c9f749fd2da62f5414a9dc72bb6bc618e3671cbd7447decfef43b4ce3aec/anthropics/claude-code/issues/17968" />
<a href="https://github.com/anthropics/claude-code/issues/17968"></a>
</div>
`description` プロパティを使うというアプローチも既にあるので、`hooks` だけなら要件は満たせるかも?
<div class="link-card-v2">
<div class="link-card-v2-site">
<img class="link-card-v2-site-icon" src="https://github.githubassets.com/favicons/favicon.svg" />
<span class="link-card-v2-site-name">GitHub</span>
</div>
<div class="link-card-v2-title">
Feature Request: Add a formal `description` field for comments in `settings.json` · Issue #4475 · anthropics/claude-code
</div>
<div class="link-card-v2-content">
Title: Feature Request: Add a formal description field for comments in settings.json Body: Problem: The settings ...
</div>
<img class="link-card-v2-image" src="https://opengraph.githubassets.com/538580c7a7c01da1c223a32762fbf282ce7794a7b11fed770a0554db314ea326/anthropics/claude-code/issues/4475" />
<a href="https://github.com/anthropics/claude-code/issues/4475"></a>
</div>