Preflight Checklist
What's Wrong?
[BUG] Claude Desktop black screen with Windows HDR enabled (NVIDIA RTX 4080 + high-refresh monitor)
Preflight Checklist
What's Wrong?
Claude Desktop renders a black screen when Windows 11 HDR is enabled. The app window appears but content is completely black/unrenderable. Other Electron-based apps (Discord, VS Code) work correctly with HDR enabled on the same system. The issue is specific to Claude Desktop's MSIX-packaged Electron build.
Expected Behavior
Claude Desktop should render normally with Windows HDR enabled, consistent with how other Electron apps (Discord, VS Code) handle HDR on the same hardware and OS configuration.
Environment
| Component |
Detail |
| Claude Desktop version |
1.1.3189.0 (MSIX package) |
| Package |
Claude_1.1.3189.0_x64__pzs8sxrjxfjjc |
| Executable path |
C:\Program Files\WindowsApps\Claude_1.1.3189.0_x64__pzs8sxrjxfjjc\app\Claude.exe |
| OS |
Windows 11 25H2 (Build 26200.7840) |
| GPU |
NVIDIA GeForce RTX 4080 |
| NVIDIA driver |
591.86 (32.0.15.9186) |
| CPU |
AMD (no integrated GPU) |
| Monitor |
Samsung Odyssey G7 LC27G7xT |
| Resolution |
2560×1440 @ 240Hz |
| Color depth |
10-bit, scRGB linear color space |
| HDR |
Windows HDR enabled |
| Connection |
DisplayPort |
| Windows Updates |
KB5077181 (Feb 11, 2026), KB5077869 (Feb 11, 2026) |
Reproduction Steps
- Enable HDR in Windows Settings → System → Display
- Launch Claude Desktop
- App window opens but content is black/blank
- Disabling HDR immediately resolves the issue
What Was Tried (All Failed)
1. Environment Variable — ELECTRON_EXTRA_LAUNCH_ARGS
Set as a User environment variable via sysdm.cpl:
--disable-gpu-compositing → No effect
--disable-gpu --disable-software-rasterizer → No effect
Conclusion: Claude Desktop's MSIX packaging appears to ignore ELECTRON_EXTRA_LAUNCH_ARGS, unlike standard Electron apps (Discord, VS Code) which respect this variable.
2. Electron flags config file
Created %APPDATA%\Claude\electron-flags.conf with various flag combinations:
--disable-gpu-compositing
--disable-direct-composition
And separately:
--disable-gpu
--disable-software-rasterizer
Result: No effect. Claude Desktop does not appear to read this file.
3. NVIDIA Control Panel per-app profile
Attempted to add Claude.exe to NVIDIA Control Panel → Manage 3D Settings → Program Settings with:
- Power management mode → Prefer maximum performance
- Threaded optimization → Off
- Vertical sync → On
Result: WindowsApps folder is access-restricted. Even after locating the correct path (...\app\Claude.exe) and adding the profile, the black screen persisted.
4. Windows Graphics Settings per-app GPU override
Settings → System → Display → Graphics → attempted to set Claude to "Power saving" (integrated GPU).
Result: Not applicable — system has AMD CPU with no integrated GPU (discrete RTX 4080 only).
5. Registry-based MPO (Multiplane Overlay) fixes
Attempted disabling MPO via:
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Dwm]
"OverlayTestMode"=dword:00000005
And separately:
"OverlayMinFPS"=dword:00000000
Result: OverlayTestMode=5 on Windows 11 24H2/25H2 no longer properly disables MPO and caused additional desktop-wide black screen flashes during window transitions. OverlayMinFPS=0 alone did not resolve the Claude Desktop issue. Both were reverted.
6. GPU cache clearing
Remove-Item "$env:APPDATA\Claude\GPUCache" -Recurse -Force
Remove-Item "$env:APPDATA\Claude\Cache" -Recurse -Force
Result: No effect after restart.
Key Observation
Discord and VS Code (both Electron apps) work perfectly with HDR enabled on the same system. The critical difference is:
- Discord/VS Code: Standard installer (Squirrel/NSIS) — respects
ELECTRON_EXTRA_LAUNCH_ARGS and Chromium flags
- Claude Desktop: MSIX package — appears to sandbox or ignore all external GPU flag mechanisms
This strongly suggests the issue is in how Claude Desktop's MSIX build initializes GPU compositing under HDR, and that it does not expose any user-configurable way to pass Chromium launch flags.
Suggested Fix
- Respect
ELECTRON_EXTRA_LAUNCH_ARGS environment variable like other Electron apps do
- Add
--disable-gpu-compositing or equivalent HDR-safe flags to the Electron config when HDR is detected
- Expose GPU settings in Claude Desktop's settings UI (similar to Discord's "Hardware Acceleration" toggle)
- Consider reading
%APPDATA%\Claude\electron-flags.conf for advanced users
Related Issues
Workaround
Use claude.ai in a browser (Edge/Chrome) installed as a PWA (Progressive Web App) via Edge → Apps → Install this site as an app. Browser-based access handles HDR correctly.
# [BUG] Claude Desktop black screen with Windows HDR enabled (NVIDIA RTX 4080 + high-refresh monitor)
Preflight Checklist
What's Wrong?
Claude Desktop renders a black screen when Windows 11 HDR is enabled. The app window appears but content is completely black/unrenderable. Other Electron-based apps (Discord, VS Code) work correctly with HDR enabled on the same system. The issue is specific to Claude Desktop's MSIX-packaged Electron build.
Expected Behavior
Claude Desktop should render normally with Windows HDR enabled, consistent with how other Electron apps (Discord, VS Code) handle HDR on the same hardware and OS configuration.
Environment
| Component |
Detail |
| Claude Desktop version |
1.1.3189.0 (MSIX package) |
| Package |
Claude_1.1.3189.0_x64__pzs8sxrjxfjjc |
| Executable path |
C:\Program Files\WindowsApps\Claude_1.1.3189.0_x64__pzs8sxrjxfjjc\app\Claude.exe |
| OS |
Windows 11 25H2 (Build 26200.7840) |
| GPU |
NVIDIA GeForce RTX 4080 |
| NVIDIA driver |
591.86 (32.0.15.9186) |
| CPU |
AMD (no integrated GPU) |
| Monitor |
Samsung Odyssey G7 LC27G7xT |
| Resolution |
2560×1440 @ 240Hz |
| Color depth |
10-bit, scRGB linear color space |
| HDR |
Windows HDR enabled |
| Connection |
DisplayPort |
| Windows Updates |
KB5077181 (Feb 11, 2026), KB5077869 (Feb 11, 2026) |
Reproduction Steps
- Enable HDR in Windows Settings → System → Display
- Launch Claude Desktop
- App window opens but content is black/blank
- Disabling HDR immediately resolves the issue
What Was Tried (All Failed)
1. Environment Variable — ELECTRON_EXTRA_LAUNCH_ARGS
Set as a User environment variable via sysdm.cpl:
--disable-gpu-compositing → No effect
--disable-gpu --disable-software-rasterizer → No effect
Conclusion: Claude Desktop's MSIX packaging appears to ignore ELECTRON_EXTRA_LAUNCH_ARGS, unlike standard Electron apps (Discord, VS Code) which respect this variable.
2. Electron flags config file
Created %APPDATA%\Claude\electron-flags.conf with various flag combinations:
--disable-gpu-compositing
--disable-direct-composition
And separately:
--disable-gpu
--disable-software-rasterizer
Result: No effect. Claude Desktop does not appear to read this file.
3. NVIDIA Control Panel per-app profile
Attempted to add Claude.exe to NVIDIA Control Panel → Manage 3D Settings → Program Settings with:
- Power management mode → Prefer maximum performance
- Threaded optimization → Off
- Vertical sync → On
Result: WindowsApps folder is access-restricted. Even after locating the correct path (...\app\Claude.exe) and adding the profile, the black screen persisted.
4. Windows Graphics Settings per-app GPU override
Settings → System → Display → Graphics → attempted to set Claude to "Power saving" (integrated GPU).
Result: Not applicable — system has AMD CPU with no integrated GPU (discrete RTX 4080 only).
5. Registry-based MPO (Multiplane Overlay) fixes
Attempted disabling MPO via:
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Dwm]
"OverlayTestMode"=dword:00000005
And separately:
"OverlayMinFPS"=dword:00000000
Result: OverlayTestMode=5 on Windows 11 24H2/25H2 no longer properly disables MPO and caused additional desktop-wide black screen flashes during window transitions. OverlayMinFPS=0 alone did not resolve the Claude Desktop issue. Both were reverted.
6. GPU cache clearing
Remove-Item "$env:APPDATA\Claude\GPUCache" -Recurse -Force
Remove-Item "$env:APPDATA\Claude\Cache" -Recurse -Force
Result: No effect after restart.
Key Observation
Discord and VS Code (both Electron apps) work perfectly with HDR enabled on the same system. The critical difference is:
- Discord/VS Code: Standard installer (Squirrel/NSIS) — respects
ELECTRON_EXTRA_LAUNCH_ARGS and Chromium flags
- Claude Desktop: MSIX package — appears to sandbox or ignore all external GPU flag mechanisms
This strongly suggests the issue is in how Claude Desktop's MSIX build initializes GPU compositing under HDR, and that it does not expose any user-configurable way to pass Chromium launch flags.
Suggested Fix
- Respect
ELECTRON_EXTRA_LAUNCH_ARGS environment variable like other Electron apps do
- Add
--disable-gpu-compositing or equivalent HDR-safe flags to the Electron config when HDR is detected
- Expose GPU settings in Claude Desktop's settings UI (similar to Discord's "Hardware Acceleration" toggle)
- Consider reading
%APPDATA%\Claude\electron-flags.conf for advanced users
Related Issues
Workaround
Use claude.ai in a browser (Edge/Chrome) installed as a PWA (Progressive Web App) via Edge → Apps → Install this site as an app. Browser-based access handles HDR correctly.
What Should Happen?
Claude Desktop should render normally with Windows HDR enabled, consistent with how other Electron apps (Discord, VS Code) handle HDR on the same hardware and OS configuration. The MSIX-packaged build should either respect ELECTRON_EXTRA_LAUNCH_ARGS environment variable, read electron-flags.conf from %APPDATA%\Claude, or include a Hardware Acceleration toggle in settings.
Error Messages/Logs
Get-WinEvent -LogName Application -MaxEvents 20 | Where-Object {$_.Message -like "*Claude*" -or $_.Message -like "*Electron*" -or $_.Message -like "*GPU*"} | Format-List TimeCreated, Message
If that returns nothing, just put:
No crash logs available. App renders black screen without crashing — no error dialog, no Event Viewer entries. The window frame is visible but content area is entirely black.
Steps to Reproduce
- System: NVIDIA RTX 4080 + Samsung Odyssey G7 (2560x1440 @ 240Hz, 10-bit, scRGB) + AMD CPU (no iGPU)
- Enable HDR in Windows Settings → System → Display
- Launch Claude Desktop (v1.1.3189.0 MSIX)
- App window opens but content area is entirely black
- Disable HDR → Claude Desktop renders normally
- Discord and VS Code (also Electron) work fine with HDR on the same system
Attempted workarounds (all failed):
- ELECTRON_EXTRA_LAUNCH_ARGS with --disable-gpu, --disable-gpu-compositing
- electron-flags.conf in %APPDATA%\Claude\
- NVIDIA Control Panel per-app profile
- Registry MPO fixes (OverlayTestMode, OverlayMinFPS)
- GPU cache clearing
Root cause: MSIX packaging ignores all standard Chromium/Electron GPU flag mechanisms
Claude Model
None
Is this a regression?
Yes, this worked in a previous version
Last Working Version
No response
Claude Code Version
Claude Desktop 1.1.3189.0 (MSIX) — not a Claude Code issue
Platform
Anthropic API
Operating System
Windows
Terminal/Shell
Windows Terminal
Additional Information
No response
Preflight Checklist
What's Wrong?
[BUG] Claude Desktop black screen with Windows HDR enabled (NVIDIA RTX 4080 + high-refresh monitor)
Preflight Checklist
What's Wrong?
Claude Desktop renders a black screen when Windows 11 HDR is enabled. The app window appears but content is completely black/unrenderable. Other Electron-based apps (Discord, VS Code) work correctly with HDR enabled on the same system. The issue is specific to Claude Desktop's MSIX-packaged Electron build.
Expected Behavior
Claude Desktop should render normally with Windows HDR enabled, consistent with how other Electron apps (Discord, VS Code) handle HDR on the same hardware and OS configuration.
Environment
Reproduction Steps
What Was Tried (All Failed)
1. Environment Variable —
ELECTRON_EXTRA_LAUNCH_ARGSSet as a User environment variable via
sysdm.cpl:--disable-gpu-compositing→ No effect--disable-gpu --disable-software-rasterizer→ No effectConclusion: Claude Desktop's MSIX packaging appears to ignore
ELECTRON_EXTRA_LAUNCH_ARGS, unlike standard Electron apps (Discord, VS Code) which respect this variable.2. Electron flags config file
Created
%APPDATA%\Claude\electron-flags.confwith various flag combinations:And separately:
Result: No effect. Claude Desktop does not appear to read this file.
3. NVIDIA Control Panel per-app profile
Attempted to add Claude.exe to NVIDIA Control Panel → Manage 3D Settings → Program Settings with:
Result: WindowsApps folder is access-restricted. Even after locating the correct path (
...\app\Claude.exe) and adding the profile, the black screen persisted.4. Windows Graphics Settings per-app GPU override
Settings → System → Display → Graphics → attempted to set Claude to "Power saving" (integrated GPU).
Result: Not applicable — system has AMD CPU with no integrated GPU (discrete RTX 4080 only).
5. Registry-based MPO (Multiplane Overlay) fixes
Attempted disabling MPO via:
And separately:
Result:
OverlayTestMode=5on Windows 11 24H2/25H2 no longer properly disables MPO and caused additional desktop-wide black screen flashes during window transitions.OverlayMinFPS=0alone did not resolve the Claude Desktop issue. Both were reverted.6. GPU cache clearing
Result: No effect after restart.
Key Observation
Discord and VS Code (both Electron apps) work perfectly with HDR enabled on the same system. The critical difference is:
ELECTRON_EXTRA_LAUNCH_ARGSand Chromium flagsThis strongly suggests the issue is in how Claude Desktop's MSIX build initializes GPU compositing under HDR, and that it does not expose any user-configurable way to pass Chromium launch flags.
Suggested Fix
ELECTRON_EXTRA_LAUNCH_ARGSenvironment variable like other Electron apps do--disable-gpu-compositingor equivalent HDR-safe flags to the Electron config when HDR is detected%APPDATA%\Claude\electron-flags.conffor advanced usersRelated Issues
Workaround
Use
# [BUG] Claude Desktop black screen with Windows HDR enabled (NVIDIA RTX 4080 + high-refresh monitor)claude.aiin a browser (Edge/Chrome) installed as a PWA (Progressive Web App) via Edge → Apps → Install this site as an app. Browser-based access handles HDR correctly.Preflight Checklist
What's Wrong?
Claude Desktop renders a black screen when Windows 11 HDR is enabled. The app window appears but content is completely black/unrenderable. Other Electron-based apps (Discord, VS Code) work correctly with HDR enabled on the same system. The issue is specific to Claude Desktop's MSIX-packaged Electron build.
Expected Behavior
Claude Desktop should render normally with Windows HDR enabled, consistent with how other Electron apps (Discord, VS Code) handle HDR on the same hardware and OS configuration.
Environment
Claude_1.1.3189.0_x64__pzs8sxrjxfjjcC:\Program Files\WindowsApps\Claude_1.1.3189.0_x64__pzs8sxrjxfjjc\app\Claude.exeReproduction Steps
What Was Tried (All Failed)
1. Environment Variable —
ELECTRON_EXTRA_LAUNCH_ARGSSet as a User environment variable via
sysdm.cpl:--disable-gpu-compositing→ No effect--disable-gpu --disable-software-rasterizer→ No effectConclusion: Claude Desktop's MSIX packaging appears to ignore
ELECTRON_EXTRA_LAUNCH_ARGS, unlike standard Electron apps (Discord, VS Code) which respect this variable.2. Electron flags config file
Created
%APPDATA%\Claude\electron-flags.confwith various flag combinations:And separately:
Result: No effect. Claude Desktop does not appear to read this file.
3. NVIDIA Control Panel per-app profile
Attempted to add Claude.exe to NVIDIA Control Panel → Manage 3D Settings → Program Settings with:
Result: WindowsApps folder is access-restricted. Even after locating the correct path (
...\app\Claude.exe) and adding the profile, the black screen persisted.4. Windows Graphics Settings per-app GPU override
Settings → System → Display → Graphics → attempted to set Claude to "Power saving" (integrated GPU).
Result: Not applicable — system has AMD CPU with no integrated GPU (discrete RTX 4080 only).
5. Registry-based MPO (Multiplane Overlay) fixes
Attempted disabling MPO via:
And separately:
Result:
OverlayTestMode=5on Windows 11 24H2/25H2 no longer properly disables MPO and caused additional desktop-wide black screen flashes during window transitions.OverlayMinFPS=0alone did not resolve the Claude Desktop issue. Both were reverted.6. GPU cache clearing
Result: No effect after restart.
Key Observation
Discord and VS Code (both Electron apps) work perfectly with HDR enabled on the same system. The critical difference is:
ELECTRON_EXTRA_LAUNCH_ARGSand Chromium flagsThis strongly suggests the issue is in how Claude Desktop's MSIX build initializes GPU compositing under HDR, and that it does not expose any user-configurable way to pass Chromium launch flags.
Suggested Fix
ELECTRON_EXTRA_LAUNCH_ARGSenvironment variable like other Electron apps do--disable-gpu-compositingor equivalent HDR-safe flags to the Electron config when HDR is detected%APPDATA%\Claude\electron-flags.conffor advanced usersRelated Issues
Workaround
Use
claude.aiin a browser (Edge/Chrome) installed as a PWA (Progressive Web App) via Edge → Apps → Install this site as an app. Browser-based access handles HDR correctly.What Should Happen?
Claude Desktop should render normally with Windows HDR enabled, consistent with how other Electron apps (Discord, VS Code) handle HDR on the same hardware and OS configuration. The MSIX-packaged build should either respect ELECTRON_EXTRA_LAUNCH_ARGS environment variable, read electron-flags.conf from %APPDATA%\Claude, or include a Hardware Acceleration toggle in settings.
Error Messages/Logs
Steps to Reproduce
Attempted workarounds (all failed):
Root cause: MSIX packaging ignores all standard Chromium/Electron GPU flag mechanisms
Claude Model
None
Is this a regression?
Yes, this worked in a previous version
Last Working Version
No response
Claude Code Version
Claude Desktop 1.1.3189.0 (MSIX) — not a Claude Code issue
Platform
Anthropic API
Operating System
Windows
Terminal/Shell
Windows Terminal
Additional Information
No response