Claude Code ガイド

Appearance

破壊的変更：Windowsの旧マネージド設定パスのサポートを終了 ​

原文（日本語に翻訳） ​

破壊的変更：C:\ProgramData\ClaudeCode\managed-settings.json のWindows旧マネージド設定フォールバックを削除。C:\Program Files\ClaudeCode\managed-settings.json を使用してください

原文（英語） ​

Breaking change: Removed deprecated Windows managed settings fallback at C:\ProgramData\ClaudeCode\managed-settings.json — use C:\Program Files\ClaudeCode\managed-settings.json

概要 ​

Claude Code v2.1.75で、Windowsにおける旧マネージド設定ファイルのパス C:\ProgramData\ClaudeCode\managed-settings.json のサポートが完全に削除されました。これは主にEnterpriseプランでWindowsを使用する組織の管理者に影響する破壊的変更です。このパスに設定ファイルが存在していても、v2.1.75以降は読み込まれなくなります。新しいパス C:\Program Files\ClaudeCode\managed-settings.json に設定ファイルを移行する必要があります。

基本的な使い方 ​

旧パス（廃止） ​

C:\ProgramData\ClaudeCode\managed-settings.json

このパスはv2.1.75から読み込まれなくなります。

新パス（正しい場所） ​

C:\Program Files\ClaudeCode\managed-settings.json

実践例 ​

移行手順（Windows管理者向け） ​

PowerShellで移行を実行する場合：

powershell
# 旧パスに設定ファイルが存在するか確認
$oldPath = "C:\ProgramData\ClaudeCode\managed-settings.json"
$newPath = "C:\Program Files\ClaudeCode\managed-settings.json"

if (Test-Path $oldPath) {
    # 新しいディレクトリが存在しない場合は作成
    $newDir = Split-Path $newPath
    if (-not (Test-Path $newDir)) {
        New-Item -ItemType Directory -Path $newDir -Force
    }

    # 設定ファイルをコピー
    Copy-Item -Path $oldPath -Destination $newPath -Force
    Write-Host "設定ファイルを移行しました: $newPath"

    # 旧ファイルをバックアップとして残す（確認後に削除可能）
    Rename-Item -Path $oldPath -NewName "managed-settings.json.bak"
    Write-Host "旧ファイルをバックアップとして保存: $oldPath.bak"
} else {
    Write-Host "旧パスに設定ファイルは存在しません"
}

グループポリシーやMDMでの展開 ​

組織でグループポリシーやMDM（Microsoft Intune等）を使用してClaude Codeの設定を配布している場合：

powershell
# managed-settings.jsonの配布先を更新する必要があります
# 旧配布先: C:\ProgramData\ClaudeCode\managed-settings.json
# 新配布先: C:\Program Files\ClaudeCode\managed-settings.json

# Intuneのスクリプトなどを更新してください
$targetPath = "C:\Program Files\ClaudeCode\managed-settings.json"
$settingsContent = @{
    "disallowedTools" = @("Bash", "Edit")
    "autoApproveTools" = @("Read")
} | ConvertTo-Json

# 管理者権限でファイルを作成
New-Item -ItemType File -Path $targetPath -Force
Set-Content -Path $targetPath -Value $settingsContent

設定ファイルの確認 ​

powershell
# 新パスの設定ファイルが正しく読み込まれているか確認
# Claude Codeを起動して設定が反映されているかテスト
claude
# → 以前と同じポリシーが適用されていれば移行成功

注意点 ​

  • 影響範囲: この変更は主にWindowsでEnterpriseまたはTeamプランを使用し、マネージド設定を組織全体に配布している管理者に影響します。個人ユーザーへの影響はほぼありません
  • 緊急度: v2.1.75へのアップデート前に移行を完了することを強く推奨します。アップデート後は旧パスの設定が無視されます
  • 権限: C:\Program Files\ClaudeCode\ への書き込みには管理者権限が必要です
  • 既存の設定は引き続き有効: 設定ファイルの内容（JSONの構造やポリシー設定）は変更不要です。パスのみが変更されました

関連情報 ​