使用Dotfiles和GNU Stow管理你的Claude Code配置

追蹤你的AI編碼代理的配置，將其納入dotfiles倉庫是一種高效的做法。我使用Git和GNU Stow實現了這一點，這給我帶來了兩方面的好處：一方面可以回滾因多次編輯而損壞的技能，另一方面可以在新開發機上透過一條命令克隆我的整套設定。

以下是如何做到這一點的詳細說明。

你的AI配置現在是一個程式碼庫

“Claude Code配置”過去可能僅指一個設定檔案和可能存在的CLAUDE.md。但現在，我的配置包含了技能、鉤子、外掛、斜槓命令、子代理、工作流以及MCP伺服器定義。似乎還有更多。每次更新都會新增檔案，隨著新功能的釋出，檔案數量不斷增加。

模型和編碼代理變化迅速，你的工作流也隨之改變。每次釋出都意味著需要調整提示和更新技能。到了某個點，這不再是簡單的配置，而是一個小型程式碼庫。幾乎所有內容都是純文本和JSON，位於一個目錄中，非常適合用版本控制來管理。

在出現問題時回滾

一次不當的編輯後，你可能會希望有一種方式回滾更改。假設你在使用Lyra提示的個人定製版本，並不斷進行增量修改，但決定回退幾個版本——有這個設定可以讓你保留之前的工作成果。

你發現有人分享了一個技能，進行定製並持續最佳化數週。有一天它開始失效，你已經記不起它正常工作時的樣子。更糟糕的是，當你讓AI自己起草或更新技能時（Claude編輯Claude的配置），新版本可能突然崩潰。

沒有版本控制，你就丟失了最近更新的工作，但有了Git，只需git diff檢視更改，git revert即可回到正常工作的版本。這一點多次救了我。

新機器，一條命令搞定

簡化機器遷移是dotfiles流行的最初原因，現在這更加重要。你的shell別名和編輯器配置已經透過這種方式遷移。將~/.claude加入倉庫後，你的整個AI設定就能透過一條指令碼部署到新機器上，無需從頭開始重新教Claude Code你的工作流。

什麼是Dotfiles？

Dotfiles是主目錄中的隱藏配置檔案，如.zshrc、.gitconfig以及現在的.claude/。Dotfiles倉庫是一個小型Git專案，包含所有這些檔案，以及將它們連結或複製到相應位置的指令碼。你的機器的個性化設定，現在有了版本控制。如果你想檢視我的結構，可以在GitHub上檢視（yurikoval/dotfiles）。

如何管理你的Dotfiles

有許多方法可以做到這一點，任何方法都比沒有好。

最簡單的方法是在~/.claude目錄內執行git init並隨編輯提交，但這隻跟蹤了Claude的配置。Atlassian推薦使用裸倉庫並將主目錄作為工作樹，從而完全避免符號連結。如果你更喜歡工具，yadm是一個dotfiles管理器，它封裝了Git並內建了按機器區分和加密功能。

我堅持使用GNU Stow。Stow會將dotfiles倉庫中的包符號連結到你的主目錄：stow claude將~/.claude連結到位，stow -D claude則乾淨地移除它。

工具本身不如習慣重要。在進行實驗前提交，特別是在讓AI重寫自己的配置之前，這樣每次失敗的迭代都可以透過一次git revert輕鬆撤銷。

推送之前有一個警告：dotfiles倉庫正是API金鑰洩露到GitHub的常見途徑。MCP伺服器定義和.zshrc匯出經常收集金鑰。請確保你跟蹤的檔案中不包含秘密——我寫過如何在Mac上使用Keychain、1Password CLI和direnv管理開發金鑰的文章。