Claude Media
Claude Desktopのアップデート方法と設定ファイルの見分け方

Claude Desktopのアップデート方法と設定ファイルの見分け方

Claude Desktopの更新はmacOSがClaudeメニュー、WindowsがHelpメニューのCheck for Updatesです。設定ファイル2種の違いとmanaged settingsも扱います。

Claude Desktopを手動でアップデートするには、Check for Updatesを選んでアプリを再起動します。メニューの場所は、macOSならメニューバーのClaude、WindowsならHelpです。Linuxはパッケージマネージャーで更新します。

設定ファイルも1つにまとまっていません。Chat tabが読むclaude_desktop_config.jsonと、Code tabがCLIと共有するsettings.jsonは別物で、混同すると変更が反映されない原因になります。本稿は更新方法に加え、変更が効かないときにどちらのファイルを見るか、組織向けのmanaged settingsまで扱います。アプリ全体の入手方法や画面構成はClaude Desktop完全ガイドがカバーしており、本稿は更新と設定ファイル周りに絞った詳細編です。

変更が反映されないとき、どちらのファイルを見るか

原因の多くは、編集したファイルと読む側のタブが噛み合っていないことです。

くらべる

編集先は、動かしたい側で決まる

Chat tab

claude_desktop_config.json

Chat tabのローカルMCPサーバーを登録するファイルです。起動コマンド・引数・環境変数を書きます。場所と書き方はClaude Desktop MCP設定ガイドにあります。

Code tab

settings.json

Code tab(Claude Codeエンジン)がCLIと共有するファイルです。権限モード・フック・環境変数・許可ルールを書きます。ユーザー単位は~/.claude/settings.json、チーム共有のプロジェクト単位は.claude/settings.jsonです。

この2つの上に、IT部門が配布して上書きできないmanaged settingsが重なります。両方を触る場面はまれで、多くの利用者はどちらか一方で用が足ります。

Code tabの設定はCLIとどこまで共有されるか

Claude DesktopのCode tabは、ターミナル版のCLIと同じエンジンで動きます。設定の共有範囲は広く、プロジェクトのCLAUDE.md、~/.claude.jsonや.mcp.jsonのMCPサーバー定義、フックとSkills、そして~/.claude/settings.jsonの権限ルールがそのままDesktopのセッションにも適用されます。設定項目そのものの一覧はClaude Code settings.json完全ガイドに譲り、ここではDesktop特有の挙動だけを補足します。

見落としやすいのが、Chat tab用のclaude_desktop_config.jsonもCode tabのローカルセッションに読み込まれる点です。同じサーバー名をclaude_desktop_config.jsonと~/.claude.jsonの両方で定義していると、Code tabは1回だけ接続し、claude_desktop_config.json側の定義を優先して使います。Chat tab用に登録したMCPサーバーは、意識しなくてもCode tabの会話でそのまま呼び出せるということです。裏返しに、単体のCLIはclaude_desktop_config.jsonを読みません。macOSとWSLではclaude mcp add-from-claude-desktopで取り込めます。

権限モードやモデル選択などCLIのフラグに相当する操作は、Desktopでは画面上のUIに置き換わっています。

CLIのフラグDesktopでの操作
--modelDesktopでの操作送信ボタン横のモデルドロップダウン
--permission-modeDesktopでの操作送信ボタン横のモード選択
--dangerously-skip-permissionsDesktopでの操作Bypass permissionsモード(Pro/Maxは設定でトグル、Team/Enterpriseは組織ポリシーで制御)
--allowedTools / --disallowedToolsDesktopでの操作セッション単位の相当機能はなし。settings.jsonの許可ルールがそのまま効く

--printや--output-formatのようなスクリプト・自動化向けのフラグには、Desktop側の対応する操作がありません。Desktopは対話的な利用が前提です。

手元のCLIで設定の読み込み元を絞る

Desktopと同じエンジンのCLIには、どの設定を読むかを起動時に絞るフラグがあります。v2.1.285のclaude --help(一部を抜粋)では次のように表示されました。

claude --version
# 2.1.285 (Claude Code)
 
claude --help
#   --setting-sources <sources>  Comma-separated list of setting sources
#                                to load (user, project, local).
#   --settings <file-or-json>    Path to a settings JSON file or a JSON
#                                string to load additional settings from
#   --strict-mcp-config          Only use MCP servers from --mcp-config,
#                                ignoring all other MCP configurations
#   --permission-mode <mode>     (choices: "acceptEdits", "auto",
#                                "bypassPermissions", "manual",
#                                "dontAsk", "plan")

--setting-sources user,projectのようにローカル設定を外して起動すれば、settings.jsonのどの層が挙動を変えているかを切り分けられます。同じ役割のフラグがDesktopの画面にあるとは限らないので、切り分けはCLI側で行い、結果を見てDesktopの設定ファイルを直す流れになります。--permission-modeが受け付ける値も、Desktopのモード選択に並ぶ名前と同一とは限りません。

組織向けのmanaged settings — 何を上書きできるか

Team・EnterpriseプランはDesktopの挙動を、管理コンソール・managed settingsファイル・デバイス管理ポリシーの3経路で統制できます。managed settingsはsettings.jsonより優先度が高く、ユーザーやプロジェクトの設定では上書きできません。

このほか、SSH接続先をあらかじめ登録するsshConfigs、接続を許可するホストを制限するsshHostAllowlist、サードパーティ展開限定でMCPサーバーを全ユーザーに配布するmanagedMcpServersもmanaged settings経由で配布します。ここに挙げたキー以外にも、allowManagedPermissionRulesOnlyやallowManagedHooksOnlyのようなmanaged設定でしか使えないキーがあります。どのmanaged settingsが実際に効くかはセッションの種類で変わり、ローカルセッションはディスク上に配置されたファイルと管理コンソールからの配信の両方を受け取りますが、Anthropic管理のVM上で動くクラウドセッションには、デバイスに配置したファイルは届きません。ただし、管理コンソールからの配信がローカルセッションに届くのは対象の組織でログインしている場合に限られます。self-hosted環境のクラウドセッションはランナーイメージ内のmanaged settingsファイルを読み、SSHセッションはリモートホスト側のファイルを読みます。

管理コンソール(claude.ai/admin-settings/claude-code)からは、次の4項目をトグルで切り替えられます。Desktopでのコード機能自体の許可、Web版セッションの許可、Remote Controlの許可、そしてBypass permissionsモードの禁止です。トグルで切り替えられるのはこの4項目で、autoModeのような個別キーはmanaged settingsとして配信します。細かい制御が必要ならmanaged settingsファイル、組織全体への一括配布ならデバイス管理ポリシー、という使い分けです。

デバイス管理ポリシーとエンタープライズ配布

IT部門による一括管理は、OS標準の仕組みに乗ります。macOSはcom.anthropic.claudefordesktopという管理設定ドメインを使い、JamfやKandjiといったMDMツールから配布します。WindowsはSOFTWARE\Policies\Claudeのレジストリキー配下で設定し、グループポリシーで設定します。有効化・無効化できるポリシーには、Claude Code機能そのものの許可、自動更新の制御、カスタム配布URLの指定が含まれます。

配布そのものは、macOSが.dmgインストーラーをMDM経由で、Windowsが.msixパッケージで配布する形です。通信は原則HTTPSの443番です(OTLP・LLMゲートウェイ・MCPサーバーで独自ポートを設定した場合を除く)。許可すべきホストはワイルドカードを許容できるかどうかで2択です。

ワイルドカードを許容できる環境では、ドメイン単位で許可します。

  • anthropic.com / *.anthropic.com
  • claude.ai / *.claude.ai
  • claude.com / *.claude.com
  • claude.app / *.claude.app
  • *.claudeusercontent.com
  • *.claudemcpcontent.com

ファイアウォールのワイルドカード数を減らしたい環境では、個別ホストの列挙が代替案です。

  • 個別ホスト: anthropic.com・api.anthropic.com・a-api.anthropic.com・a-cdn.anthropic.com・s-cdn.anthropic.com・assets-proxy.anthropic.com・claude.ai・a.claude.ai・a-cdn.claude.ai・assets.claude.ai・downloads.claude.ai・claude.com・platform.claude.com
  • ワイルドカード(動的サブドメイン向け): *.livepreview.claude.ai・*.livepreview.claude.app・*.claudeusercontent.com・*.claudemcpcontent.com

IP allowlistingを有効にしている組織では、bridge.claudeusercontent.comをclaude.aiと同じプロキシー出口に通す必要があります。

アップデートはどう機能するか

OS別

更新の仕組みはOSごとに違う

  • macOS

    起動のたびに自動でチェックし、更新があれば適用します。手動ならClaudeメニューのCheck for Updatesです。

  • Windows

    macOSと同じく起動時に自動で確認・適用します。手動ならHelpメニューのCheck for Updatesです。

  • Linux(ベータ)

    自動配信の対象外です。sudo apt update && sudo apt upgradeのような、システム側の通常のパッケージ更新で反映します。

自動更新を止めたい組織は、前述のデバイス管理ポリシーで有効・無効を切り替えます。

今使っているバージョンを確認する手順もOSで異なります。macOSはClaudeメニューからAbout Claude、WindowsはHelpメニューからAbout Claudeを開くと、バージョン番号が表示されます。番号をクリックするとクリップボードにコピーされるため、サポートへの問い合わせ時にそのまま貼り付けられます。

Code tabのClaude Codeを新しくするには

Code tabのローカルセッションは、デスクトップアプリが取得した専用のClaude Codeで動きます。ターミナルのclaudeコマンドとはバージョンが別で、片方を更新してももう片方は新しくなりません。

Code tab側のバージョンは、ローカルセッションで/statusを入力し、Claude Codeの行で確認できます。新しいバージョンにするには、前述のCheck for Updatesを実行してから、新しいセッションを始めます。

よくあるつまずき

Chat tabが起動しない・ログインできないといった基本動作の切り分けはClaudeアプリ完全ガイド、Mac固有のインストール・権限トラブルはClaude Desktop Mac設定ガイドに譲り、ここでは設定ファイル・ポリシー起因のつまずきに絞ります。Code tab固有の「Error 403」や画面が固まる症状はClaude Code Desktopが起動しない・403エラーの対処法で症状別に整理しています。

管理下のネットワークで更新やMCP接続が届かない

ファイアウォールがanthropic.com・claude.ai・claude.com系のホストをHTTPS(443)で許可しているかを確認します。managed settingsやデバイス管理ポリシーで自動更新やMCP配布が止められていないかも合わせて見ます。

Windowsで拡張機能(MCP)のトグルが反応しない

次の順に切り分けます。

切り分け

トグルが反応しないときの確認順

  1. 1

    設定ファイルを読み直す

    記述に誤りがないかを確認します。JSONのカンマや括弧の閉じ忘れが典型です。

  2. 2

    アプリを再起動する

    再起動しても直らないかを見ます。

  3. 3

    プロセスを確認する

    タスクマネージャーで、サーバーのプロセスが実際に起動しているかを確認します。

  4. 4

    サーバーログを見る

    接続エラーが出ていないかをログで確認します。

Windowsでインストール後にPATHが反映されない

新しいターミナルウィンドウを開き直してください。PATHの更新は新規に開いたセッションにしか反映されません。

組織環境で設定が効かないとき、上から確かめる順序

個人環境ならclaude_desktop_config.jsonとsettings.jsonのどちらかを見れば済みますが、組織の管理下では原因が複数の層にまたがります。次の順に見ると、切り分けが速くなります。

切り分け

managed settingsが絡むときの確認順

  1. 1

    セッションの種類を特定する

    ローカル・クラウド・SSHのどれかで、設定の届く経路が変わります。

  2. 2

    その経路の managed settings を見る

    管理コンソールの4トグル、配置したファイル、デバイス管理ポリシーのうち、そのセッションに届くものだけを確認します。

  3. 3

    managed settings より下の層を見る

    settings.jsonを直しても効かないなら、同じキーがmanaged settingsに置かれて上書きされていないかを疑います。

参照した一次ソース

この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。

  1. code.claude.com/docs/en/desktop
  2. code.claude.com/docs/en/settings
この記事を共有:XはてブLinkedIn