[DOCS] Windows startup "Connect to GitHub" popup from Git Credential Manager is undocumented for background git commands

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/troubleshoot-install

Section/Topic

Windows-specific troubleshooting, Git credential / authentication behavior on startup

Current Documentation

The Windows troubleshooting guide currently has a row in the error table about missing shells and a short "Claude Code on Windows requires either Git for Windows (for bash) or PowerShell" section, but nothing about background git commands, Git Credential Manager, or "Connect to GitHub" popups. Searching the rest of the mirror for git credential, GCM, connect to github, and cached credentials returns only the v2.1.169 changelog entry line that describes the fix:

"Fixed Git Credential Manager's 'Connect to GitHub' popup appearing on Windows at startup when background git commands ran without cached credentials"

There is no corresponding user-facing explanation of the original behavior, why the popup appeared for users without cached credentials, or what changed for Windows users running background git commands from Claude Code sessions.

What's Wrong or Missing?

A. No Windows-specific credential-manager troubleshooting entry

The troubleshoot-install error table at https://code.claude.com/docs/en/troubleshoot-install only covers the default AWS / Bedrock / Vertex / Foundry credential chain. A Windows user who saw the GCM "Connect to GitHub" prompt at startup has no documented path in the troubleshooting guide to understand what triggered it or whether it is expected.

B. Background git command behavior on Windows is undocumented

The v2.1.169 changelog references "background git commands" running without cached credentials, but there is no doc page that explains when Claude Code spawns git in the background on Windows, how cached vs. uncached credentials interact with that, or which environment variable / config option a user could use to suppress the GCM prompt.

C. No mention of Git Credential Manager as a Windows integration point

The Windows install guidance recommends installing Git for Windows so the Bash tool works, and notes that PowerShell is the fallback shell. It does not call out that Git for Windows ships with Git Credential Manager and that GCM can interact with Claude Code's startup git operations. Users who have not pre-authenticated to GitHub through GCM have no signal in the docs that they may be prompted at startup.

Suggested Improvement

Add a short Windows-specific section to https://code.claude.com/docs/en/troubleshoot-install that covers GCM behavior at startup. Suggested structure:

Git Credential Manager "Connect to GitHub" popup on Windows

The [Git for Windows](https://git-scm.com/downloads/win) installer ships with Git Credential Manager, which can prompt you to "Connect to GitHub" the first time a git operation runs without cached credentials. Claude Code may run git commands in the background as soon as a session starts (for example to read repository state), so the popup can appear before you have sent your first message.

To avoid the prompt, authenticate with GitHub through GCM once before starting Claude Code:

In PowerShell or Git Bash

git credential-manager github login

After you sign in, GCM caches the credentials and Claude Code's background git operations no longer trigger the popup. As of v2.1.169, Claude Code no longer triggers the prompt when cached credentials are missing for background git calls, but the popup can still appear if a foreground git command runs before you have authenticated.

The same section should be linked from any "Git on Windows" sub-section added under the existing shell-setup guidance, and the entry in the error table should reference it for users who reach the troubleshoot page with a "Connect to GitHub" dialog on screen.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/troubleshoot-install | Primary location for Windows troubleshooting rows; the only place in the mirror that should describe GCM / startup popup behavior for users |
| https://code.claude.com/docs/en/changelog | Source of the v2.1.169 fix line that motivated this issue; cited so docs readers can correlate the fix with the new troubleshooting guidance |
| https://code.claude.com/docs/en/setup | Setup guide that recommends Git for Windows; should cross-link to the GCM section once it exists |

Total scope: 3 pages affected (one primary, two cross-references)

Other context:

• The fix was released in v2.1.169 and the changelog describes it as Windows-only.
• Git Credential Manager is bundled with Git for Windows, which the docs already recommend for Bash-tool support, so this is a natural extension of existing Windows setup guidance rather than a new topic.
• The behavior was not previously documented as a known Windows issue in any troubleshooting row, so this is missing documentation rather than an outdated entry.