claude-code - 💡(How to fix) Fix /doctor flags cmd+c keybinding warning on a built-in default binding

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

On macOS, /doctor reports a keybinding warning:

Keybinding (~/.claude/keybindings.json): "cmd+c" may not work: macOS system copy

However, cmd+cselection:copy (Scroll context) is a default Claude Code binding — the selection:copy action ships with both ctrl+shift+c and cmd+c as its default keys. So /doctor is warning about Claude Code's own default configuration, which is a false positive.

This is especially noticeable when ~/.claude/keybindings.json mirrors the default binding set (e.g. an exported/generated config): /doctor flags a key the user never customized.

Error Message

/doctor should not warn about keys that are part of the default keybinding set, since the user did not introduce the conflict and the macOS system-copy fallback makes cmd+c harmless anyway.

Root Cause

On macOS, /doctor reports a keybinding warning:

Keybinding (~/.claude/keybindings.json): "cmd+c" may not work: macOS system copy

However, cmd+cselection:copy (Scroll context) is a default Claude Code binding — the selection:copy action ships with both ctrl+shift+c and cmd+c as its default keys. So /doctor is warning about Claude Code's own default configuration, which is a false positive.

This is especially noticeable when ~/.claude/keybindings.json mirrors the default binding set (e.g. an exported/generated config): /doctor flags a key the user never customized.

Code Example

Keybinding (~/.claude/keybindings.json): "cmd+c" may not work: macOS system copy
RAW_BUFFERClick to expand / collapse

Description

On macOS, /doctor reports a keybinding warning:

Keybinding (~/.claude/keybindings.json): "cmd+c" may not work: macOS system copy

However, cmd+cselection:copy (Scroll context) is a default Claude Code binding — the selection:copy action ships with both ctrl+shift+c and cmd+c as its default keys. So /doctor is warning about Claude Code's own default configuration, which is a false positive.

This is especially noticeable when ~/.claude/keybindings.json mirrors the default binding set (e.g. an exported/generated config): /doctor flags a key the user never customized.

Expected behavior

/doctor should not warn about keys that are part of the default keybinding set, since the user did not introduce the conflict and the macOS system-copy fallback makes cmd+c harmless anyway.

Suggested fix

  • Suppress the macOS-reserved-key warning for keys that match the default keybinding set, or
  • Downgrade/remove the warning for cmd+cselection:copy specifically, since system copy is a graceful fallback.

Environment

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

FAQ

Expected behavior

/doctor should not warn about keys that are part of the default keybinding set, since the user did not introduce the conflict and the macOS system-copy fallback makes cmd+c harmless anyway.

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix /doctor flags cmd+c keybinding warning on a built-in default binding