Claude Desktop設定ファイルと更新方法 — 管理者向け設定まで

Claude Desktopの「設定」は1つのファイルにまとまっていません。Chat tabが読むclaude_desktop_config.jsonと、Code tabがCLIと共有するsettings.jsonは別物で、混同すると変更が反映されない原因になります。本稿ではこの2つの役割分担、組織向けのmanaged settings、そしてアプリの自動更新の仕組みを扱います。アプリ全体の入手方法や画面構成はClaude Desktop完全ガイドがカバーしており、本稿はそこから設定ファイル周りだけを切り出した詳細編です。

Claude Desktopの設定ファイルは2つある

結論から言うと、Claude Desktopには性格の異なる設定ファイルが2系統あります。Chat tabのローカルMCPサーバーを登録するclaude_desktop_config.jsonと、Code tab(Claude Codeエンジン)がCLIと共有するsettings.jsonです。

claude_desktop_config.jsonの場所と書き方はClaude Desktop MCP設定ガイドで扱っているため、本稿ではCode tab側のsettings.jsonと、組織向けの管理者設定を中心に見ていきます。

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のフラグに相当する操作は、Desktopでは画面上のUIに置き換わっています。

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

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

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

このほか、SSH接続先をあらかじめ登録するsshConfigs、接続を許可するホストを制限するsshHostAllowlist、サードパーティ展開限定でMCPサーバーを全ユーザーに配布するmanagedMcpServersもmanaged settings経由で配布します。どのmanaged settingsが実際に効くかはセッションの種類で変わり、ローカルセッションはディスク上に配置されたファイルと管理コンソールからの配信の両方を受け取りますが、クラウドセッションはAnthropic管理のVM上で動くため、デバイスに配置したファイルは届かずサーバー側から配信される設定だけが適用されます。

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

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

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

配布そのものは、macOSが.dmgインストーラーをMDM経由で、Windowsが.msixパッケージをIntune等で配布する形です。ネットワーク経由の通信はHTTPSのポート443に限られ、許可すべきホストはanthropic.com・claude.ai・claude.com系のドメインにまとまっています。プロキシー配下の環境でも、この443での到達性さえ確保されていれば同じ設定がそのまま機能します。

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

Claude Desktopの更新方法はOSによって仕組みが異なります。macOSとWindowsはアプリ起動のたびに自動でチェックし、更新があれば自動的に適用します。手動で確認したい場合は、macOSならClaudeメニューのCheck for Updates、WindowsならHelpメニューのCheck for Updatesから実行できます。Linux(ベータ)は自動配信の対象外で、aptによるシステム側の通常のパッケージ更新で反映する仕組みです。

組織で自動更新を止めたい場合は、前述のデバイス管理ポリシーが受け皿になります。macOSのMDM、Windowsのレジストリキーのいずれからも自動更新の有効・無効を切り替えられます。個々のユーザーが自分の判断で更新タイミングを遅らせる設定は用意されていません。

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

よくあるつまずき

Chat tabが起動しない・ログインできないといった基本動作の切り分けはClaudeアプリ完全ガイド、Mac固有のインストール・権限トラブルはClaude Desktop Mac設定ガイドに譲り、ここでは設定ファイル・ポリシー起因のつまずきに絞ります。

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

Windowsで拡張機能(MCP)のトグルが反応しない。設定ファイル側の記述に誤りがないか、アプリを再起動しても直らないか、タスクマネージャーでサーバーのプロセスが実際に起動しているかを順に確認します。

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

よくある質問

claude_desktop_config.jsonとsettings.jsonはどちらを編集すればいいですか

Chat tabでローカルのMCPサーバーを追加・削除したいならclaude_desktop_config.jsonです。Code tabの権限ルールやフック、環境変数を変更したいなら~/.claude/settings.jsonを編集します。両方を触る場面はまれで、多くのユーザーはどちらか一方だけで用が足ります。

DesktopとCLIで設定は自動的に同期されますか

はい。CLAUDE.md・MCPサーバー定義・フック・settings.jsonはDesktopとCLIの両方が同じファイルを読みに行くため、片方で変更すればもう片方にも反映されます。同期のための追加操作は不要です。

組織で自動更新を止めることはできますか

できます。macOSのMDM(com.anthropic.claudefordesktopドメイン)またはWindowsのグループポリシー(SOFTWARE\Policies\Claude)から、自動更新の有効・無効を制御するポリシーが用意されています。個人ユーザーが単独で無効化する設定はありません。

Linux版はどうやって更新しますか

Linux(ベータ)は自動配信の対象外です。sudo apt update && sudo apt upgradeのような、システム側の通常のパッケージ更新コマンドで反映します。

managed settingsはユーザー側の設定より必ず優先されますか

はい。managed settingsはユーザー設定・プロジェクト設定より優先度が高く、上書きできません。ただしクラウドセッションはデバイスに配置したファイルではなくサーバー側から配信される設定を受け取るなど、セッションの種類によって届く経路が異なります。

まとめ

Claude Desktopの設定は、Chat tab用のclaude_desktop_config.jsonとCode tab用のsettings.jsonという役割の異なる2つのファイルに分かれています。個人利用ならこの2つの違いを押さえておけば十分ですが、組織で導入する場合はさらにmanaged settings・管理コンソール・デバイス管理ポリシーの3層が加わり、Bypassモードの禁止や自動更新の制御まで一括で管理できます。更新自体はmacOS・Windowsが起動時の自動チェック、Linuxがapt経由という違いを覚えておくと、画面が固まったときの切り分けが早くなります。アプリ全体の入手方法や形態別の使い分けはClaudeアプリ完全ガイドを参照してください。