Skip to content

Revert CLAUDE.md symlink for Windows users #1576

Description

@hyunbinseo

3865efe - this is an old one, but symlink does not work reliably in Windows which might hurt the DX with LLMs.

For those reasons, Git for Windows disables support for symbolic links by default (it will still read them when it encounters them). You can enable support via the core.symlinks config variable, e.g. when cloning:

git clone -c core.symlinks=true <URL>

https://gitforwindows.org/symbolic-links.html

On Windows, creating a symlink requires Administrator privileges or Developer Mode, so use the @AGENTS.md import instead.

https://code.claude.com/docs/en/memory#agents-md

Workaround is to create ./claude/CLAUDE.md with the following content:

See @../AGENTS.md

Metadata

Metadata

Assignees

No one assigned

    Labels

    workaroundWorkaround fixes problem

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions