claude-code-config — portable Claude Code setup

One source of truth for my Claude Code config across machines — WSL/Linux and native Windows (home ⇄ company ⇄ any new box). Hybrid approach: config repo + idempotent bootstrap (bootstrap.sh for WSL/Linux, bootstrap.ps1 for native Windows) for personal config and CLI tools, declarative plugin re-install (via claude/settings.json) for the shareable extensions.

New machine — one command

git clone git@github.com:chuenchen309/claude-code-config.git ~/claude-code-config
~/claude-code-config/bootstrap.sh
source ~/.bashrc        # pick up shell aliases
claude                  # first launch fetches + enables all plugins

Want the repo somewhere else? Clone wherever you like and set CCC_DIR to that path (default $HOME/claude-code-config) — bootstrap.sh self-locates, and the ~/.bashrc block honors the var. (The var is deliberately not CLAUDE_CONFIG_DIR — that is Claude Code's own config-dir variable, and pointing it at the repo hijacks claude away from ~/.claude.)

bootstrap.sh is idempotent — safe to re-run any time to converge a machine back to this config.

Native Windows — one command

For a company box where Claude Code runs on native Windows (%USERPROFILE%\.claude), not WSL:

git clone git@github.com:chuenchen309/claude-code-config.git $HOME\claude-code-config
pwsh -File $HOME\claude-code-config\bootstrap.ps1   # preview first: $env:DRY_RUN=1; pwsh -File ...\bootstrap.ps1
# open a NEW PowerShell, then:
claude                                              # first launch fetches + enables all plugins

bootstrap.ps1 is the Windows port of bootstrap.sh — same idempotent, re-runnable contract. It diverges from the Linux flow only where the OS forces it:

Area	Windows behavior
MCP servers	registered with claude mcp add-json (sidesteps the Windows -- cmd /c arg-parsing bug); context7 via cmd /c npx, markitdown via absolute %USERPROFILE%\.local\bin\markitdown-mcp.exe.

Prereqs on the Windows box: Node.js on PATH (Claude Code needs it), Git for Windows (enables the Bash tool + Git Bash hook execution), and PowerShell 7 recommended (winget install Microsoft.PowerShell). bootstrap.ps1 installs uv itself if missing.

What it installs / configures

Step	Action
1	uv + markitdown, markitdown-mcp
2	checks fnm/node
3	copies settings.json, CLAUDE.md, rules/*.md into ~/.claude (backs up existing); installs claude/skills/* if any are present
4	installs ccstatusline/settings.json → ~/.config/ccstatusline/
5	adds a CCC_DIR block to ~/.bashrc that sources shell/aliases.sh
6	registers MCP servers: context7, markitdown (CONTEXT7_API_KEY opt-in, see below)
7	plugins re-install declaratively on next claude launch
8	prints a verification checklist

Layout

bootstrap.sh            idempotent orchestrator
claude/
  settings.json         5 enabled plugins + marketplaces + prefs (繁中, xhigh)
  CLAUDE.md             global instructions
  rules/                auto-loaded instruction fragments (context7)
  re-create-mcp.sh      idempotent MCP registration (called by bootstrap)
ccstatusline/settings.json  statusline display config (powerline nord-aurora)
shell/aliases.sh        shell aliases
tools/versions.lock     pinned versions reference

NEVER committed (see .gitignore)

~/.claude/.credentials.json (OAuth token) · ~/.claude.json (session + per-project state + local/user MCP) · history.jsonl · projects/ transcripts · .env · settings.local.json · runtime caches. Re-authenticate per machine instead — run /mcp inside claude for any OAuth connector.

Updating the config

Edit files here (or copy fresh from ~/.claude), commit, push. On other machines: git pull && ~/claude-code-config/bootstrap.sh.

Manual steps bootstrap can't do headlessly

• OAuth MCP connectors (Gmail/Drive/Calendar/Notion): account-managed, run /mcp inside claude to auth.
• CONTEXT7_API_KEY: this repo is public, so the key lives nowhere in it. Export it before bootstrap (export CONTEXT7_API_KEY=… / $env:CONTEXT7_API_KEY=…) and context7 registers with your own quota; leave it unset and context7 still works, just rate-limited. Already-registered servers are skipped — to switch an existing one over, claude mcp remove context7 -s user first, then re-run.