Feature request: sync global ~/.claude/CLAUDE.md across machines via Anthropic account
Problem
There's no way to sync ~/.claude/CLAUDE.md (global instructions) across multiple machines. If you develop on a laptop + a remote GPU server (or multiple workstations), you have to manually keep them in sync. Every machine has its own copy with no mechanism to ensure consistency.
Current workaround
I built a plugin (laulpogan/dotfiles-claude) that:
- Stores CLAUDE.md in a git repo
- Symlinks
~/.claude/CLAUDE.md→ the repo copy - Auto-pulls on session start via a SessionStart hook
- Provides
/dotfiles-sync,/dotfiles-edit,/dotfiles-diffcommands
It works, but it's duct tape over a gap that should be a first-party feature.
Proposed solution
Sync ~/.claude/CLAUDE.md and optionally ~/.claude/settings.json via the user's Anthropic account. When you log in to Claude Code on a new machine, your global instructions come with you.
Possible approaches:
- Account-level storage — Anthropic stores the file server-side, synced on
claude login - Git-backed with account link — User points to a git repo URL in their account settings, Claude Code pulls it on session start (what my plugin does, but built-in)
- Simple key-value sync —
claude config sync push/claude config sync pullcommands that store/retrieve from Anthropic's API
Any of these would eliminate the need for the workaround plugin.
Why this matters
- Multi-machine development is common (laptop + cloud GPU, home + office, local + CI)
- Global CLAUDE.md is where behavioral preferences, coding style, and project-agnostic instructions live
- Without sync, users either duplicate effort or drift between machines
- The plugin marketplace already has the hook infrastructure — this just needs a first-party sync target
Environment
- Claude Code CLI
- macOS + Linux (tested across both)
- Plugin workaround: https://github.com/laulpogan/dotfiles-claude
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗