Feature request: sync global ~/.claude/CLAUDE.md across machines via Anthropic account

Resolved 💬 3 comments Opened Apr 13, 2026 by laulpogan Closed Apr 16, 2026

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-diff commands

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:

  1. Account-level storage — Anthropic stores the file server-side, synced on claude login
  2. 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)
  3. Simple key-value syncclaude config sync push / claude config sync pull commands 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

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗