[{"data":1,"prerenderedAt":550},["ShallowReactive",2],{"content-/claude-code-settings-customization":3,"all-pages-for-dir":548,"og-image-/claude-code-settings-customization":549},{"id":4,"title":5,"body":6,"category":530,"description":531,"extension":532,"meta":533,"navigation":360,"ogImage":534,"path":535,"project_name":536,"published":537,"publishedAt":538,"seo":539,"stem":540,"tags":541,"todo":546,"unpublished":537,"updatedAt":534,"__hash__":547},"pages/2026-03/2026-03-21/claude-code-settings-customization.md","Claude Code設定カスタマイズ - ステータスライン・自動アップデート・バージョン管理",{"type":7,"value":8,"toc":512},"minimark",[9,14,18,21,26,29,33,52,62,69,71,75,78,83,224,227,230,237,246,250,253,256,263,265,268,271,274,283,315,322,324,327,330,333,381,388,390,393,399,497,500,502,505,508],[10,11,13],"h1",{"id":12},"claude-code設定カスタマイズ","Claude Code設定カスタマイズ",[15,16,17],"p",{},"claude-code-syncのログを眺めていて、Claude Codeの設定周りを掘り下げた。ステータスラインの使用率表示を仕込み、settings.jsonの「unrecognized」問題を追いかけ、自動アップデートを止めてバージョンを固定するまでの記録。",[19,20],"hr",{},[22,23,25],"h2",{"id":24},"ステータスライン設定braille-dotsパターン","ステータスライン設定（Braille Dotsパターン）",[15,27,28],{},"Claude Codeにはターミナルのステータスラインにカスタム情報を表示する機能がある。Braille Dots（点字パターン）を使って、トークン使用率をプログレスバー風に表示する設定を入れた。",[30,31,32],"h3",{"id":32},"設定例",[15,34,35,39,40,43,44,47,48,51],{},[36,37,38],"code",{},"settings.json"," の ",[36,41,42],{},"statusLine"," フィールドに、シェルコマンドの出力をそのまま表示できる。Braille Dotsの ",[36,45,46],{},"⣿","（full）と ",[36,49,50],{},"⣀","（empty）を組み合わせると、ターミナル上で省スペースな使用率バーが作れる。",[53,54,59],"pre",{"className":55,"code":57,"language":58},[56],"language-text","⣿⣿⣿⣿⣿⣀⣀⣀⣀⣀  50%\n","text",[36,60,57],{"__ignoreMap":61},"",[15,63,64,65,68],{},"ポイントは、Braille Dotsは等幅フォントでも幅が安定しているため、ターミナルのステータスバーに向いているという点。普通のブロック文字（",[36,66,67],{},"█","）だと環境によって幅がずれることがある。",[19,70],{},[22,72,74],{"id":73},"settingsjsonフィールドのunrecognized問題","settings.jsonフィールドの「unrecognized」問題",[30,76,77],{"id":77},"症状",[15,79,80,82],{},[36,81,38],{}," に以下のフィールドを設定したところ、Claude Codeが「unrecognized field」と警告を出した。",[53,84,88],{"className":85,"code":86,"language":87,"meta":61,"style":61},"language-json shiki shiki-themes vitesse-light vitesse-light","{\n  \"statusLine\": \"...\",\n  \"enabledPlugins\": [],\n  \"language\": \"ja\",\n  \"alwaysThinkingEnabled\": true,\n  \"effortLevel\": \"high\",\n  \"voiceEnabled\": false\n}\n","json",[36,89,90,99,128,143,164,182,203,218],{"__ignoreMap":61},[91,92,95],"span",{"class":93,"line":94},"line",1,[91,96,98],{"class":97},"shFtX","{\n",[91,100,102,106,109,112,115,119,123,125],{"class":93,"line":101},2,[91,103,105],{"class":104},"sqvqQ","  \"",[91,107,42],{"class":108},"sz8Xr",[91,110,111],{"class":104},"\"",[91,113,114],{"class":97},":",[91,116,118],{"class":117},"sMJiu"," \"",[91,120,122],{"class":121},"sdGka","...",[91,124,111],{"class":117},[91,126,127],{"class":97},",\n",[91,129,131,133,136,138,140],{"class":93,"line":130},3,[91,132,105],{"class":104},[91,134,135],{"class":108},"enabledPlugins",[91,137,111],{"class":104},[91,139,114],{"class":97},[91,141,142],{"class":97}," [],\n",[91,144,146,148,151,153,155,157,160,162],{"class":93,"line":145},4,[91,147,105],{"class":104},[91,149,150],{"class":108},"language",[91,152,111],{"class":104},[91,154,114],{"class":97},[91,156,118],{"class":117},[91,158,159],{"class":121},"ja",[91,161,111],{"class":117},[91,163,127],{"class":97},[91,165,167,169,172,174,176,180],{"class":93,"line":166},5,[91,168,105],{"class":104},[91,170,171],{"class":108},"alwaysThinkingEnabled",[91,173,111],{"class":104},[91,175,114],{"class":97},[91,177,179],{"class":178},"sHkkW"," true",[91,181,127],{"class":97},[91,183,185,187,190,192,194,196,199,201],{"class":93,"line":184},6,[91,186,105],{"class":104},[91,188,189],{"class":108},"effortLevel",[91,191,111],{"class":104},[91,193,114],{"class":97},[91,195,118],{"class":117},[91,197,198],{"class":121},"high",[91,200,111],{"class":117},[91,202,127],{"class":97},[91,204,206,208,211,213,215],{"class":93,"line":205},7,[91,207,105],{"class":104},[91,209,210],{"class":108},"voiceEnabled",[91,212,111],{"class":104},[91,214,114],{"class":97},[91,216,217],{"class":178}," false\n",[91,219,221],{"class":93,"line":220},8,[91,222,223],{"class":97},"}\n",[15,225,226],{},"画面上に黄色い警告テキストが並び、「設定が効いていないのでは？」と手が止まった。",[30,228,229],{"id":229},"調査プロセス",[15,231,232,233,236],{},"まず疑ったのは、これらがまだ実験的な機能で、安定版には含まれていないケースだ。CLIの ",[36,234,235],{},"--help"," やドキュメントを読み直したが、明確な記載がない。",[15,238,239,240,242,243,245],{},"次に試したのは、フィールドを1つずつ消して再起動する方法。",[36,241,42],{}," を消すとステータス表示が消え、",[36,244,150],{}," を消すと英語に戻った。つまり、警告が出ていても設定自体は読み込まれて適用されていた。",[30,247,249],{"id":248},"結論-警告は出るが実際には有効","結論: 警告は出るが、実際には有効",[15,251,252],{},"Claude Codeの設定バリデーションは、公式に定義されたスキーマに含まれないフィールドを「unrecognized」と表示する。しかし内部的にはそれらのフィールドを読み取って動作に反映している。",[15,254,255],{},"つまり、スキーマ定義と実装の間にギャップがある状態だった。警告を見て設定を消してしまうと、むしろ意図した動作が失われる。",[15,257,258,262],{},[259,260,261],"strong",{},"教訓:"," 警告が出たら消すのではなく、実際の動作を確認する。フィールドを1つずつトグルして挙動の変化を見るのが確実だった。",[19,264],{},[22,266,267],{"id":267},"自動アップデートの停止",[15,269,270],{},"Claude Codeはデフォルトで自動アップデートが有効になっている。作業中に突然バージョンが上がると、挙動が変わって困ることがある。特にプロンプトの効き方やツールの振る舞いが変わると、再調整に時間を取られる。",[30,272,273],{"id":273},"設定方法",[15,275,276,278,279,282],{},[36,277,38],{}," に ",[36,280,281],{},"autoUpdate"," を追加する。",[53,284,286],{"className":85,"code":285,"language":87,"meta":61,"style":61},"{\n  \"autoUpdaterStatus\": \"disabled\"\n}\n",[36,287,288,292,311],{"__ignoreMap":61},[91,289,290],{"class":93,"line":94},[91,291,98],{"class":97},[91,293,294,296,299,301,303,305,308],{"class":93,"line":101},[91,295,105],{"class":104},[91,297,298],{"class":108},"autoUpdaterStatus",[91,300,111],{"class":104},[91,302,114],{"class":97},[91,304,118],{"class":117},[91,306,307],{"class":121},"disabled",[91,309,310],{"class":117},"\"\n",[91,312,313],{"class":93,"line":130},[91,314,223],{"class":97},[15,316,317,318,321],{},"これで自動アップデートが止まる。アップデートしたくなったら手動で ",[36,319,320],{},"claude update"," を実行すればよい。",[19,323],{},[22,325,326],{"id":326},"バージョンロールバック",[15,328,329],{},"アップデート後に問題が出た場合、特定のバージョンに戻す方法も確認した。",[30,331,332],{"id":332},"手順",[53,334,338],{"className":335,"code":336,"language":337,"meta":61,"style":61},"language-bash shiki shiki-themes vitesse-light vitesse-light","# 現在のバージョン確認\nclaude --version\n\n# 特定バージョンをインストール\nnpm install -g @anthropic-ai/claude-code@1.0.xx\n","bash",[36,339,340,346,356,362,367],{"__ignoreMap":61},[91,341,342],{"class":93,"line":94},[91,343,345],{"class":344},"sxvE3","# 現在のバージョン確認\n",[91,347,348,352],{"class":93,"line":101},[91,349,351],{"class":350},"senZ8","claude",[91,353,355],{"class":354},"snbK4"," --version\n",[91,357,358],{"class":93,"line":130},[91,359,361],{"emptyLinePlaceholder":360},true,"\n",[91,363,364],{"class":93,"line":145},[91,365,366],{"class":344},"# 特定バージョンをインストール\n",[91,368,369,372,375,378],{"class":93,"line":166},[91,370,371],{"class":350},"npm",[91,373,374],{"class":121}," install",[91,376,377],{"class":354}," -g",[91,379,380],{"class":121}," @anthropic-ai/claude-code@1.0.xx\n",[15,382,383,384,387],{},"npmのグローバルインストールで任意のバージョンを指定すれば、そのバージョンに固定できる。",[36,385,386],{},"autoUpdaterStatus: \"disabled\""," と組み合わせることで、意図しないバージョンアップを防げる。",[19,389],{},[22,391,392],{"id":392},"今日の設定まとめ",[15,394,395,396,398],{},"最終的な ",[36,397,38],{}," の構成。",[53,400,402],{"className":85,"code":401,"language":87,"meta":61,"style":61},"{\n  \"statusLine\": \"(Braille Dots使用率表示)\",\n  \"language\": \"ja\",\n  \"alwaysThinkingEnabled\": true,\n  \"effortLevel\": \"high\",\n  \"autoUpdaterStatus\": \"disabled\"\n}\n",[36,403,404,408,427,445,459,477,493],{"__ignoreMap":61},[91,405,406],{"class":93,"line":94},[91,407,98],{"class":97},[91,409,410,412,414,416,418,420,423,425],{"class":93,"line":101},[91,411,105],{"class":104},[91,413,42],{"class":108},[91,415,111],{"class":104},[91,417,114],{"class":97},[91,419,118],{"class":117},[91,421,422],{"class":121},"(Braille Dots使用率表示)",[91,424,111],{"class":117},[91,426,127],{"class":97},[91,428,429,431,433,435,437,439,441,443],{"class":93,"line":130},[91,430,105],{"class":104},[91,432,150],{"class":108},[91,434,111],{"class":104},[91,436,114],{"class":97},[91,438,118],{"class":117},[91,440,159],{"class":121},[91,442,111],{"class":117},[91,444,127],{"class":97},[91,446,447,449,451,453,455,457],{"class":93,"line":145},[91,448,105],{"class":104},[91,450,171],{"class":108},[91,452,111],{"class":104},[91,454,114],{"class":97},[91,456,179],{"class":178},[91,458,127],{"class":97},[91,460,461,463,465,467,469,471,473,475],{"class":93,"line":166},[91,462,105],{"class":104},[91,464,189],{"class":108},[91,466,111],{"class":104},[91,468,114],{"class":97},[91,470,118],{"class":117},[91,472,198],{"class":121},[91,474,111],{"class":117},[91,476,127],{"class":97},[91,478,479,481,483,485,487,489,491],{"class":93,"line":184},[91,480,105],{"class":104},[91,482,298],{"class":108},[91,484,111],{"class":104},[91,486,114],{"class":97},[91,488,118],{"class":117},[91,490,307],{"class":121},[91,492,310],{"class":117},[91,494,495],{"class":93,"line":205},[91,496,223],{"class":97},[15,498,499],{},"「unrecognized」の警告は出続けるが、全て動作している。警告に惑わされて設定を消してしまわないよう、このログを残しておく。",[19,501],{},[22,503,504],{"id":504},"振り返り",[15,506,507],{},"settings.jsonの警告テキストを見て「壊れているのでは」と焦ったが、フィールドを1つずつ外して再起動を繰り返すうちに、警告と実動作が一致しないことに気づいた。公式ドキュメントに載っていない設定でも、ソースコード側では対応済みというケースがClaude Codeには散見される。「動かして確かめる」が最も信頼できるデバッグ手法だと、改めて手を動かして確認できた一日だった。",[509,510,511],"style",{},"html pre.shiki code .shFtX, html code.shiki .shFtX{--shiki-default:#999999;--shiki-dark:#999999}html pre.shiki code .sqvqQ, html code.shiki .sqvqQ{--shiki-default:#99841877;--shiki-dark:#99841877}html pre.shiki code .sz8Xr, html code.shiki .sz8Xr{--shiki-default:#998418;--shiki-dark:#998418}html pre.shiki code .sMJiu, html code.shiki .sMJiu{--shiki-default:#B5695977;--shiki-dark:#B5695977}html pre.shiki code .sdGka, html code.shiki .sdGka{--shiki-default:#B56959;--shiki-dark:#B56959}html pre.shiki code .sHkkW, html code.shiki .sHkkW{--shiki-default:#1E754F;--shiki-dark:#1E754F}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sxvE3, html code.shiki .sxvE3{--shiki-default:#A0ADA0;--shiki-dark:#A0ADA0}html pre.shiki code .senZ8, html code.shiki .senZ8{--shiki-default:#59873A;--shiki-dark:#59873A}html pre.shiki code .snbK4, html code.shiki .snbK4{--shiki-default:#A65E2B;--shiki-dark:#A65E2B}",{"title":61,"searchDepth":101,"depth":101,"links":513},[514,517,522,525,528,529],{"id":24,"depth":101,"text":25,"children":515},[516],{"id":32,"depth":130,"text":32},{"id":73,"depth":101,"text":74,"children":518},[519,520,521],{"id":77,"depth":130,"text":77},{"id":229,"depth":130,"text":229},{"id":248,"depth":130,"text":249},{"id":267,"depth":101,"text":267,"children":523},[524],{"id":273,"depth":130,"text":273},{"id":326,"depth":101,"text":326,"children":526},[527],{"id":332,"depth":130,"text":332},{"id":392,"depth":101,"text":392},{"id":504,"depth":101,"text":504},"dev","Claude Codeのsettings.jsonフィールド調査、Braille Dotsステータスライン、自動アップデート停止、バージョンロールバックの方法をまとめた","md",{},null,"/claude-code-settings-customization","claude-code-tools",false,"2026-03-21T00:00:00.000Z",{"title":5,"description":531},"2026-03/2026-03-21/claude-code-settings-customization",[542,543,544,545],"Claude Code","settings","カスタマイズ","バージョン管理","memo","reO82qzUzxTe54g-MRAqHJPjZRr88yVuDl4nGmNTDA8",[],"https://log.eurekapu.com/og/blog/claude-code-settings-customization.png?v=2026-03-21T00%3A00%3A00.000Z&title=Claude%20Code%E8%A8%AD%E5%AE%9A%E3%82%AB%E3%82%B9%E3%82%BF%E3%83%9E%E3%82%A4%E3%82%BA%20-%20%E3%82%B9%E3%83%86%E3%83%BC%E3%82%BF%E3%82%B9%E3%83%A9%E3%82%A4%E3%83%B3%E3%83%BB%E8%87%AA%E5%8B%95%E3%82%A2%E3%83%83%E3%83%97%E3%83%87%E3%83%BC%E3%83%88%E3%83%BB%E3%83%90%E3%83%BC%E3%82%B8%E3%83%A7%E3%83%B3%E7%AE%A1%E7%90%86&author=Kei%20Komatsu&sig=6cce24aa42387e3a",1782528819358]