02 - 安裝與登入

← 01-什麼是Claude-Code | 00-Index | 下一篇 → 03-第一次使用與基本操作

---

安裝

原生安裝（官方推薦）

macOS / Linux / WSL：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

Windows CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

⚠️ 分不清自己在 PowerShell 還是 CMD？

• 看到 The token '&&' is not a valid statement separator → 你在 PowerShell，不是 CMD
• 看到 'irm' is not recognized... → 你在 CMD，不是 PowerShell
• 提示字元有 PS C:\ 是 PowerShell，只有 C:\ 是 CMD

✅ 原生安裝會自動在背景更新，不用自己管版本。

套件管理器

brew install --cask claude-code          # 穩定通道（約落後一週，會跳過重大 regression）
brew install --cask claude-code@latest   # 最新通道

winget install Anthropic.ClaudeCode

Linux 也可以用 apt / dnf / apk。

⚠️ Homebrew 和 WinGet 裝的不會自動更新，要自己 brew upgrade claude-code / winget upgrade Anthropic.ClaudeCode。

驗證

claude --version

會印出版本號加 (Claude Code)。

---

Windows 使用者的重要提醒

原生 Windows 上建議另外裝 Git for Windows，這樣 Claude Code 才能用 Bash tool。 沒裝的話它會改用 PowerShell 當 shell tool——能動，但你在網路上看到的大部分 bash 範例會不能直接抄。

WSL 環境不需要 Git for Windows。

那我到底該用 WSL 還是原生 Windows？

	原生 Windows	WSL2
Claude Code 本身	✅ 完整支援	✅ 完整支援
Bash tool	需裝 Git for Windows	✅ 原生
網路上的範例可直接用	⚠️ 常要改	✅
搭配 Herdr	Herdr 是 beta	✅ Herdr stable
Python 工具鏈（你的 tools/*.py）	可以但常有路徑/編碼問題	✅ 順

👉 建議 WSL2。理由跟 Herdr 那篇一樣：你的兩個 repo 的維運腳本（Python、ImageMagick、git worktree）在 Linux 上單純很多。

---

登入

直接開起來就會問：

claude

第一次會導到瀏覽器完成驗證。之後憑證會存在系統上，不用再登。

要換帳號或重新驗證，在 session 裡打：

/login

可用的帳號類型

類型	說明
Claude Pro / Max / Team / Enterprise（推薦）	訂閱制，你用的是這個
Claude Console	API 存取，預付額度，會自動建一個 “Claude Code” workspace 做成本追蹤
Amazon Bedrock / Google Cloud Agent Platform / Microsoft Foundry	企業雲
自架 Claude apps gateway	企業 SSO

⚠️ 如果你設了 ANTHROPIC_API_KEY 環境變數，Claude Code 會跳過登入流程、改問你要不要用那把 key。不小心設到會讓你以為訂閱沒生效——記得檢查。

CLI 上的帳號指令

claude auth login              # 登入
claude auth login --console    # 用 Console 帳號（走 API 計費）
claude auth logout
claude auth status             # JSON 輸出；--text 給人看。已登入 exit 0，未登入 exit 1
claude setup-token             # 產生 CI / 腳本用的長效 OAuth token（需訂閱）

---

更新與診斷

claude update                  # 手動更新
claude install stable          # 重裝指定通道（也接受版本號如 2.1.118 或 latest）
claude doctor                  # 不開 session，直接印安裝與設定診斷

claude doctor 檢查安裝健康度、設定檔的語法錯誤、Remote Control 可用性。設定改壞了先跑這個。

在 session 裡的版本是 /doctor，那個是完整的 setup checkup，而且會提出修正建議。

---

一個開場就該做的事：安全模式救援

設定改到爛掉、某個 skill 或 hook 讓 Claude Code 開不起來時：

claude --safe-mode

會停用所有客製：CLAUDE.md、skills、plugins、hooks、MCP servers、自訂指令與 agent、output style、workflow、自訂主題、自訂 keybinding、status line、LSP、auto memory 全部不載入。

💡 記下這個指令。你有 12 個 skill 掛著，哪天其中一個寫壞了，這是最快的止血方式。

---

建議的初始設定

安裝完先做這三件事：

1. 在專案裡產生 CLAUDE.md

cd ~/Obsidian-med-note
claude

然後在 session 裡：

/init

它會分析 codebase 產生一份起始 CLAUDE.md。如果已經有了，/init 會建議改進而不是覆蓋。（你兩個 repo 都已經有很完整的 CLAUDE.md，所以這步對你是「檢查有沒有可以精簡的」。）

2. 設一個預設權限模式

~/.claude/settings.json：

{
  "permissions": {
    "defaultMode": "plan"
  }
}

一開始都從 plan mode 起步是很好的習慣，尤其是在會直接推 main 的 repo 上。細節見 05-權限模式與安全。

3. 確認 skill 有被讀到

/context

看 Memory files 區塊有沒有你的 CLAUDE.md，以及打 / 看得不看得到你的自訂 skill。

---

🔗 相關筆記

• 01-什麼是Claude-Code — 上一步
• 03-第一次使用與基本操作 — 下一步
• 05-權限模式與安全 — defaultMode 該設什麼
• 14-疑難排解與速查表 — 裝不起來看這裡
• Herdr 02 - 安裝與環境選擇 — 同樣的 WSL2 建議

---

最後更新：2026-08-04