Skip to content

Improve Windows install notes #3

@masa-57

Description

@masa-57

The install notes assume File Explorer + install.cmd. Two known rough edges from prior Windows tests:

  • PowerShell \$HOME drift. \$HOME can resolve away from \$env:USERPROFILE under OneDrive Known Folder redirection, Git-for-Windows env, or group policy. Result: install lands in the wrong .claude tree, or two trees coexist on the same machine.
  • Execution policy. Some users hit the unsigned-script prompt and don't know what to do; others can't change policy because of group policy.

What we'd like:

  • A clean walkthrough for the OneDrive-redirected case (largest share of business laptops).
  • A non-interactive recipe that succeeds in CI or on a fresh user account.
  • PRs welcome. Working through it on your own machine and pasting the gotchas you hit is also useful.

Reference: SCO pack hit the same \$HOME issue on Windows Server 2025 in 2026-05-01 (fixed by pinning to \$env:USERPROFILE); the same fix likely applies here.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions