Claude Code 搬去新機：整理設定、憑證同專案啟動步驟

搬設定之前，先分三類

換機最煩唔一定係安裝工具，而係唔記得邊份設定可共用、邊啲要重新登入、邊個專案需要特定版本。先列清單，再叫 Claude 幫你整理腳本。

• 可共用設定：shell 別名、工具清單、已審閱嘅 Claude 規則同範本。
• 憑證：帳戶登入、API key、SSH key，透過團隊支援方式取得或重新授權。
• 本機狀態：快取、對話記錄、絕對路徑、連接埠，唔應盲目同步。

公司機先跟 IT 要求，唔好用個人 bootstrap 覆蓋公司嘅代理伺服器、VPN 同安全設定。

1. Dotfiles 只收真係要共用嘅內容

dotfiles/
  README.md
  Brewfile
  shell/
    aliases.zsh
  claude/
    rules/
  templates/
    CLAUDE.md.example
  install.sh

唔需要成份 .zshrc、整個 .claude 資料夾原封不動放入 Git。先檢查密鑰、私人路徑、客戶名稱同本機權限設定；私人 repo 亦唔係密鑰管理器。

工具清單應根據實際工作需要同版本政策整理。Claude Code 按官方安裝方式安裝，唔再將舊 npm 路線當唯一方法。

2. 安裝腳本先支援預覽，同埋重跑

根據已確認工具清單，起草新機設定腳本，先唔執行。

要求：偵測作業系統同已裝工具；列出預計動作；檔案已存在就指出差異，唔用 ln -sf 蓋走；需要備份時使用唯一名稱並記錄位置。

每步有清楚結果，失敗即停止並保留進度。再次執行唔重複寫 PATH、唔刪現有專案、唔重建已存在資料夾。

登入、憑證同公司授權列成人手步驟，唔將密鑰寫入腳本或輸出。

先下載自己嘅腳本、讀完整內容同來源版本，再執行。唔好只因為一條網址屬於自己，就永久信任之後任何版本。

3. 登入與密鑰分開處理

Claude 訂閱登入可以按工具提示重新授權，未必需要 API key。其他服務各自用官方或團隊密碼管理渠道。

唔好喺命令列寫真密鑰，因為可能留喺 shell 歷史或程序資料。亦唔好用 echo 核對真值。檢查時只回報「已提供／未提供」，再做最小授權測試。

macOS Keychain、密碼管理器同 Linux 工具各有支援範圍；同步能力同存取政策要睇實際項目設定，唔可以一概話所有 Keychain 資料都唔能跨機。需要共用時，先由管理員定渠道，唔好每人自己複製。

4. 專案一個一個啟動

Clone 之前核對 repo 同存放路徑。安裝依賴前先讀專案規則、套件 scripts 同鎖定檔；套件安裝可能執行程式，唔應對一列不熟悉 repo 自動全部安裝。

先讀 README、CLAUDE.md、版本檔同 package.json，列出需要嘅工具、版本同環境變數名稱，唔讀真值。

確認本機具備條件後，按專案指定流程安裝同檢查。記錄實際指令、退出結果、可開啟嘅本機網址，以及未完成項目。

唔修改部署平台、資料庫、帳戶權限，亦唔將缺憑證當成程式壞咗。

新專案嘅 CLAUDE.md 範本只提供骨架。框架版本、指令同禁用寫法要逐項對照，唔好用舊範本令新機開始就跟錯規矩。

5. 真正驗收一次

開一個全新 Terminal，確認工具可找到、版本正確、登入可用，並完成一個本機專案嘅基本檢查。舊 Terminal 有效唔代表新視窗嘅 PATH 都正確。

之後每次修改 bootstrap，都喺相應作業系統嘅乾淨測試環境驗證。Linux container 唔能完整模擬 macOS、Keychain 或 GUI 授權。記低測過邊個平台，未測嘅就明講。

換機流程唔需要承諾半個鐘完成；最重要係任何一步卡住，都知道停咗喺邊，同唔會為咗重跑而蓋走已有工作。