| name | local-settings-updater |
| description | プロジェクトの .claude/settings.local.json を更新する。「ローカル設定を更新して」「local settings を変更」「個人用設定を変えて」「自分だけの設定」「ローカル permissions を追加」「個人設定ファイルを編集」「settings.local を更新」などで起動。Git にコミットされない個人用の Claude Code 設定を管理。 |
| allowed-tools | Read, Write, Bash, Glob |
Local Settings Updater
プロジェクトの .claude/settings.local.json を更新します。
settings.local.json とは
settings.local.json は個人用のローカル設定ファイルです:
- Git にコミットされない: Claude Code が自動で
.gitignoreに追加 - settings.json より優先: 同じ設定がある場合、local が優先される
- 用途: 個人の好み、実験的な設定、一時的な許可設定
ワークフロー
1. 現在の設定を確認
.claude/settings.local.json が存在するか確認:
ファイルが存在する場合:
- 内容を読み込む
- 既存の設定を確認
ファイルが存在しない場合:
.claudeディレクトリが存在しない場合は作成- テンプレートから新規作成するか確認
2. 変更内容を確認
ユーザーに何を変更したいか確認:
- permissions の追加/削除(個人用の許可設定)
- allowedTools の追加/削除
- env 環境変数の設定(個人の開発環境向け)
- その他の設定
3. 設定を更新
.claude/settings.local.json を更新または作成。
4. 結果を報告
変更内容をユーザーに報告。
settings.json との使い分け
| 設定内容 | settings.json | settings.local.json |
|---|---|---|
| チーム共通ルール | ✅ | ❌ |
| 個人の許可設定 | ❌ | ✅ |
| 実験的な設定 | ❌ | ✅ |
| セキュリティポリシー | ✅ | ❌ |
| 個人の環境変数 | ❌ | ✅ |
設定項目
permissions
個人用の許可設定(チームの settings.json を上書き):
{
"permissions": {
"allow": ["Bash(docker:*)"],
"deny": []
}
}
allowedTools
個人用のツール許可:
{
"allowedTools": ["Read", "Write", "Bash", "Glob", "Grep", "WebFetch"]
}
env
個人の環境変数(注意: 機密情報は直接書かず、環境変数を参照):
{
"env": {
"DEBUG": "true",
"LOG_LEVEL": "verbose"
}
}
テンプレートからの新規作成
ファイルが存在しない場合、以下のテンプレートを使用して作成できます。
基本テンプレート
{
"permissions": {
"allow": [],
"deny": []
}
}
開発者向けテンプレート
{
"permissions": {
"allow": [
"Bash(npm:*)",
"Bash(npx:*)",
"Bash(pnpm:*)",
"Bash(yarn:*)"
],
"deny": []
},
"env": {
"DEBUG": "true"
}
}
ディレクトリ作成
.claude ディレクトリが存在しない場合:
mkdir -p .claude
重要な注意事項
- ✅ Git にコミットされない(個人設定として安全)
- ✅ settings.json の設定を上書きできる
- ✅ 実験的な設定を気軽に試せる
- ✅ ファイルが存在しない場合はテンプレートから作成可能
- ✅
.claudeディレクトリがない場合は自動作成 - ❌ チーム全体に適用したい設定は settings.json に記載
- ❌ 機密情報(API キー等)は env に直接書かない(環境変数を推奨)