---
title: "02 - 安裝與登入"
type: note
specialty: Programming
tags: [claude-code-cli從0開始使用教學, 02-安裝, windows, wsl]
created: 2026-08-04
updated: "2026"
modified: 2026-08-04
---

# 02 - 安裝與登入

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

---

## 安裝

### 原生安裝（官方推薦）

**macOS / Linux / WSL：**
```bash
curl -fsSL https://claude.ai/install.sh | bash
```

**Windows PowerShell：**
```powershell
irm https://claude.ai/install.ps1 | iex
```

**Windows CMD：**
```batch
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

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

### 套件管理器

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

```powershell
winget install Anthropic.ClaudeCode
```

Linux 也可以用 `apt` / `dnf` / `apk`。

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

### 驗證

```bash
claude --version
```

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

---

## Windows 使用者的重要提醒

> **原生 Windows 上建議另外裝 [Git for Windows](https://git-scm.com/downloads/win)**，這樣 Claude Code 才能用 **Bash tool**。
> 沒裝的話它會改用 **PowerShell** 當 shell tool——能動，但你在網路上看到的大部分 bash 範例會不能直接抄。
>
> **WSL 環境不需要 Git for Windows。**

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

| | 原生 Windows | WSL2 |
|---|---|---|
| Claude Code 本身 | ✅ 完整支援 | ✅ 完整支援 |
| Bash tool | 需裝 Git for Windows | ✅ 原生 |
| 網路上的範例可直接用 | ⚠️ 常要改 | ✅ |
| 搭配 [[Programming/Herdr/Herdr從0開始使用教學/02-安裝與環境選擇\|Herdr]] | Herdr 是 beta | ✅ Herdr stable |
| Python 工具鏈（你的 `tools/*.py`）| 可以但常有路徑/編碼問題 | ✅ 順 |

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

---

## 登入

直接開起來就會問：

```bash
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 上的帳號指令

```bash
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（需訂閱）
```

---

## 更新與診斷

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

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

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

---

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

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

```bash
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`

```bash
cd ~/Obsidian-med-note
claude
```
然後在 session 裡：
```
/init
```
它會分析 codebase 產生一份起始 `CLAUDE.md`。**如果已經有了，`/init` 會建議改進而不是覆蓋。**（你兩個 repo 都已經有很完整的 `CLAUDE.md`，所以這步對你是「檢查有沒有可以精簡的」。）

### 2. 設一個預設權限模式

`~/.claude/settings.json`：
```json
{
  "permissions": {
    "defaultMode": "plan"
  }
}
```
一開始都從 plan mode 起步是很好的習慣，尤其是在會直接推 main 的 repo 上。細節見 [[05-權限模式與安全]]。

### 3. 確認 skill 有被讀到

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

---

## 🔗 相關筆記

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

---

*最後更新：2026-08-04*