---
title: "Claude Code 基礎指南：安裝、權限、模型與上下文管理"
locale: zh-hant
category: tutorial
category_name: "教學課程"
translation_status: reviewed
license: cc_by
author: "injoys"
source_url: https://injoys.com/en/articles/claude-code-setup-permissions-models-context-guide
published_at: 2026-08-13T12:12:59+09:00
---

# Claude Code 基礎指南：安裝、權限、模型與上下文管理

> 從 Claude Code 的安裝與首次執行開始，逐步說明權限模式、模型選擇、上下文整理及 CLAUDE.md 的撰寫方式。並依據官方文件，修正原始資料中過度簡化的權限機制與成本相關內容。

## Key Points

- Claude Code 是一種代理型程式設計工具，可讀取及修改專案目錄中的檔案，並執行終端機工具。
- VS Code 是便利的選項，但並非必要條件；也可以在支援的終端機環境中執行 Claude Code。
- 初學者先以 Plan 模式檢視工作範圍，再切換至預設模式或 Accept Edits 模式會較為安全。
- 成本會因驗證方式、所選模型、輸入上下文及工作重複次數而有所不同。
- CLAUDE.md 並非對話記憶儲存庫，而是用於反覆提供專案結構、指令與規則的指引檔案。

Claude Code 是一款代理型開發工具，可在終端機與程式碼儲存庫中使用 Anthropic 的 Claude。它不只是回答程式碼片段，還能在獲准的範圍內探索與編輯檔案、執行命令，以及進行測試與錯誤分析。

本指南不僅說明安裝步驟，也會介紹如何安全設定權限、選擇適合工作的模型，以及管理上下文與專案指示。命令與支援環境可能會更新，因此實際安裝時，應確認官方設定文件所顯示的最新命令。

## 使用 Claude 編寫程式碼的三種方式

各種方式的差異不在於產出結果，而在於**工具與本機專案互動的範圍**。

| 方式 | 存取本機檔案 | 執行命令 | 適合的工作 | 主要限制 |
|---|---:|---:|---|---|
| Claude 網頁版 | 預設受限 | 預設無法執行 | 提問、程式碼說明、簡短範例、設計審查 | 若要將回答直接套用至專案，必須複製並執行 |
| Claude 桌面應用程式 | 依功能、整合與使用者核准而異 | 依功能與整合而異 | 文件工作、以對話為主的工作、受支援的本機整合 | 並非在所有安裝環境中都能自動控制儲存庫與 Shell |
| Claude Code | 可在專案範圍內存取 | 可依權限政策執行 | 修改實際儲存庫、測試、重構、長期專案 | 會操作 Shell 與檔案權限，因此需要審查與安全設定 |

Claude Code 並非只供專業開發人員使用。不過，由於它能執行刪除檔案、安裝相依套件、執行建置指令碼等會影響系統的工作，因此越是初學者，越建議搭配使用 Plan 模式與版本控制。

## 安裝前準備事項

請先準備以下項目。

- 從官方文件確認目前支援的作業系統與 Shell 環境。
- 準備可使用 Claude Code 的 Anthropic 帳號，或受支援的驗證與付費環境。
- 如果是既有專案，請建立 Git 儲存庫，並提交或備份變更。
- 確認專案的測試、建置與 Lint 命令。
- 可以使用 VS Code 等編輯器，但 VS Code 本身並不是 Claude Code 的必要條件。

在 Windows 上，應確認官方文件說明的 PowerShell、命令提示字元或 WSL 條件。如果是由組織管理的電腦，也應先檢查安裝權限、Proxy、防火牆與資料處理政策。

## 安裝與首次執行 Claude Code

### 1. 確認官方安裝命令

請在 Claude Code 官方設定文件中，選擇適合所用作業系統的最新安裝方式。安裝方式與命令可能變更，因此與其直接重複使用舊影片或部落格中的命令，不如以官方文件為準。

### 2. 開啟專案資料夾

建立新資料夾或移至既有儲存庫。如果使用 VS Code，可以透過 **File > Open Folder** 開啟資料夾，接著選擇 **Terminal > New Terminal**。

```bash
cd path/to/project
claude
```

執行 `claude` 後，必要時會顯示瀏覽器驗證程序。登入後，Claude Code 會以目前的工作目錄為基準掌握專案。因此，在實際儲存庫的根目錄執行，比在家目錄或範圍過大的上層資料夾執行更安全。

### 3. 從小型的首次請求開始

與其一開始就交付整個應用程式的製作，不如依照以下方式劃分範圍。

1. 讓它讀取並摘要專案結構。
2. 讓它提出實作計畫與預計變更的檔案。
3. 只讓它實作一項功能。
4. 讓它執行測試或靜態分析。
5. 讓它說明變更內容與剩餘風險。

請求範例：

```text
請讀取這個儲存庫，並摘要其結構與執行方式。先不要修改檔案，
只需提出新增登入表單的計畫與預計變更的檔案。
```

## 權限模式與安全設定

Claude Code 權限模式顯示的文字，可能會依版本與設定畫面而有所不同。官方設定中使用的代表性模式概念如下。

| 模式 | 運作方式 | 建議情境 |
|---|---|---|
| Default | 修改檔案或執行可能有風險的工具時，視需要要求核准 | 一般日常工作 |
| Accept Edits | 自動允許編輯檔案，但其他工具仍可能需要個別核准 | 使用 Git 追蹤變更檔案的開發工作 |
| Plan | 不修改檔案或執行命令，專注於分析與規劃 | 掌握儲存庫、設計審查、初學者的第一步 |
| Don't Ask | 拒絕未預先允許的工作，而不是提出詢問的非互動式政策 | 使用自動化環境或嚴格允許清單時 |
| Bypass Permissions | 略過權限確認程序 | 除了隔離容器等風險受控環境外，應避免使用 |

`Shift+Tab` 可用於切換互動畫面所提供的部分權限狀態。不過，並非所有設定都一定只能透過這組快速鍵循環切換，因此應確認目前畫面的狀態顯示與官方權限文件。

### 建議初學者採用的流程

1. 在 Plan 模式中取得實作計畫。
2. 檢查預計變更的檔案與要執行的命令。
3. 在 Default 或 Accept Edits 模式中實作。
4. 親自確認套件安裝、資料庫變更與刪除命令。
5. 檢查 `git diff` 與測試結果後再提交。

Bypass Permissions 並不只是方便的高速模式。錯誤命令、過度存取檔案與機密資訊外洩都可能使損害擴大，因此請勿在個人電腦或重要儲存庫中將其設為預設值。

## 模型選擇與成本管理

在互動式工作階段中使用 `/model`，可以確認或變更帳號與環境中可選擇的模型。模型名稱、別名及其供應狀態，可能會依時間點與驗證方式而有所不同，因此最好不要預設固定的模型清單來進行自動化。

```text
/model
```

一般的選擇原則如下。

| 工作類型 | 選擇標準 |
|---|---|
| 架構設計、困難的除錯、複雜推理 | 優先考慮效能較高的模型 |
| 一般實作、撰寫測試、反覆性開發 | 考慮在效能與速度間取得良好平衡的模型 |
| 簡單搜尋、格式轉換、簡短修改 | 如果帳號支援，可考慮更快速且經濟的模型 |

Opus、Sonnet、Haiku 是區分模型系列的名稱，但各系列的確切版本以及 Claude Code 支援狀態可能持續變更。有些環境可以使用 `/model sonnet` 之類的別名，但確認目前工作階段顯示的選項最為準確。

### 降低成本的實用方法

- 在必要的子目錄中執行，減少不必要的檔案探索。
- 在請求中一次明確說明目標、限制與完成條件，減少重工。
- 與其提供完整的大型記錄，不如提供錯誤周邊內容與重現步驟。
- 排除產生的檔案、建置結果、大型資料等不必要的路徑。
- 探索與設計完成後，依新的工作單位整理工作階段。
- 在可用範圍內，使用更快速且便宜的模型處理簡單工作。
- 如果透過 API 使用，請同時確認成本相關命令與 Anthropic Console 的用量資訊。

成本結構會依登入方式而異。Claude 訂閱帳號可能適用各方案的使用上限，透過 Anthropic API 或雲端供應商使用時，則可能採用以 Token 為基礎的計費方式。因此，不應假設特定模型永遠免費，或只需固定金額。

## 管理上下文視窗

上下文視窗是模型產生目前回覆時，可以參考的對話、檔案內容、工具結果、專案指示等資訊範圍。它不等同於永久記憶，也不只是對話的字元數。

### 主要命令

| 命令 | 用途 | 注意事項 |
|---|---|---|
| `/context` | 確認上下文使用組成 | 顯示方式可能依版本而異 |
| `/compact` | 摘要目前對話以釋放上下文空間 | 詳細資訊可能在摘要過程中被縮減 |
| `/clear` | 清除目前對話記錄並開始新對話 | 應先將必要決策與工作狀態記錄在文件中 |

並沒有一項通用標準，認定上下文超過特定比例後，回答品質就必然下降。Claude Code 也可能執行自動壓縮，而品質不僅受所含資訊量影響，也與相關性、重複內容及是否互相衝突有關。

如果出現以下徵兆，請考慮進行整理。

- 反覆忽略已修改的需求。
- 將舊的檔案狀態誤認為目前狀態。
- 混淆不同功能的條件。
- 不必要地重複讀取相同檔案。
- 對話與工具輸出變得過長。

每完成一項功能，不必一律執行 `/clear`。可以先將已完成的決策、未解決事項與測試結果記錄在專案文件或工作記錄中，再移至新的工作階段，以減少資訊遺失。

## 使用 CLAUDE.md 管理專案指示

檔名通常寫成包含大寫字母的 `CLAUDE.md`。這個檔案並非 Claude 的永久記憶，而是 Claude Code 在專案中參考的持續性指示文件。將其納入儲存庫後，便能與團隊成員共享指示，但不可記錄敏感資訊。

可以使用 `/init` 命令分析專案，並開始建立初始的 `CLAUDE.md`，但結果必須由人員審查。

### 建議包含的內容

- 專案目的與核心功能
- 使用的語言、框架與執行環境版本
- 重要目錄與模組的作用
- 安裝、開發伺服器、測試、Lint 與建置命令
- 程式碼風格與命名規則
- 不得修改的檔案或產生的程式碼
- 安全性與個人資料處理原則
- 工作完成條件與驗證程序

範例：

```markdown
# 專案指示

## 技術堆疊
- 使用 TypeScript 與 Node.js。
- 套件管理工具為 pnpm。

## 命令
- 測試：`pnpm test`
- Lint：`pnpm lint`
- 建置：`pnpm build`

## 規則
- 不讀取或提交 `.env` 與實際憑證。
- 變更公開 API 的回應格式前，先提出計畫。
- 功能變更時，新增相關測試。
```

`CLAUDE.md` 並沒有官方規定最多 200 行的限制。不過，過長的指示會占用上下文，並可能造成規則彼此衝突，因此維持簡短且具體較為實用。詳細的設計說明應拆分至其他文件，並指示所需路徑。

## 建議工作流程

同時提升安全性與結果品質的基本程序如下。

1. 確認 Git 狀態乾淨，並建立備份或提交。
2. 從儲存庫根目錄執行 Claude Code。
3. 檢查 `CLAUDE.md` 與既有文件。
4. 在 Plan 模式中取得目標、修改檔案與測試計畫。
5. 將大型工作拆分成可審查的小單位。
6. 在 Default 或 Accept Edits 模式中逐一實作。
7. 親自審查安裝、刪除、部署與資料變更命令。
8. 確認測試、Lint、型別檢查與 `git diff`。
9. 記錄完成狀態與剩餘問題。
10. 如果下一項工作與先前對話無關，請使用 `/clear` 開始新的工作階段。

## 安全檢查清單

- 避免在提示或儲存庫中暴露 `.env`、API 金鑰、憑證與客戶資料。
- 不要直接在正式環境伺服器與資料庫中進行實驗。
- 執行來源不明的 Shell 命令或安裝指令碼前，應先閱讀其內容。
- 對 Claude 撰寫的程式碼，也應檢查相依套件、授權、安全漏洞與測試。
- 執行重要工作時，應套用最小權限原則與隔離的開發環境。
- 透過 Git diff 確認自動產生的變更，並由人員承擔最終責任。

Claude Code 可以大幅縮短開發流程，但它並不是保證結果正確且安全的自動化機制。最穩定的使用方式，是結合明確指示、受限權限、小型變更單位、自動測試與人工審查。

## FAQ

### 使用 Claude Code 是否一定需要 VS Code？
不是。使用 VS Code 的整合式終端機會比較方便，但並非必要條件。只要具備官方文件所支援的作業系統與終端機環境，就可以在專案目錄中執行 `claude`。

### Claude 網頁版與 Claude Code 最大的差異是什麼？
Claude 網頁版主要提供對話與程式碼回答，而 Claude Code 則可在獲准的範圍內讀取及修改實際的專案檔案，並執行終端機工具。因此生產力更高，但必須謹慎管理檔案與指令權限。

### 初學者應該從哪種權限模式開始？
先在 Plan 模式中檢視變更計畫與目標檔案，再使用 Default 或 Accept Edits 模式實作，這樣的流程較為安全。套件安裝、刪除檔案、變更資料庫等作業，最好不要設為自動核准。

### Don't Ask 模式會自動執行所有作業嗎？
不是。Don't Ask 通常是一種政策，對未事先允許的作業會直接拒絕，而不是詢問使用者。應將其與略過所有權限確認的 Bypass Permissions 區分開來。

### 如何在 Claude Code 中變更模型？
在互動式工作階段中輸入 `/model`，即可查看並選擇目前帳戶與環境中可使用的模型。模型版本與別名可能會變更，因此應以目前的選單為準，而不是舊有清單。

### 使用 Sonnet 的成本一定最低嗎？
不一定。成本不僅取決於模型單價，也會因輸入上下文、輸出長度、重試次數、快取運用情況，以及驗證與付款方式而有所不同。對於簡單作業，較經濟的模型可能更有利；但在困難的作業中，效能較高的模型也可能因減少重做而降低整體成本。

### /clear 與 /compact 有什麼差異？
`/clear` 用於清除目前的對話記錄，並像新工作階段一樣重新開始。`/compact` 會摘要既有對話以騰出上下文空間，但在摘要過程中，部分細節可能會被簡化。

### 上下文超過 80% 時，回答品質一定會變差嗎？
並不存在這種普遍適用的正式臨界值。除了使用比例外，品質也會受到資訊的相關性、重複、衝突，以及工具輸出大小的影響。透過 `/context` 查看狀態，並在出現混淆舊有需求等訊號時進行整理，會比較合理。

### 檔案名稱應該是 claude.md 還是 CLAUDE.md？
官方文件將專案指示檔案標示為 `CLAUDE.md`。由於有些作業系統與工具會區分大小寫，因此直接使用官方標示較為安全。

### CLAUDE.md 必須在 200 行以下嗎？
並沒有官方規定最多 200 行的限制。不過，過長的指示會占用更多上下文，也可能造成規則衝突，因此最好簡潔地寫下核心指令與限制，並將詳細說明拆分至其他文件。

### 可以在 CLAUDE.md 中寫入 API 金鑰或密碼嗎？
不可以。CLAUDE.md 可能會提交至儲存庫並與團隊共享，因此不應記錄實際的憑證、客戶資料或私密金鑰。機密資訊應透過組織核准的環境變數或機密管理系統來管理。

### 何時應該使用 Bypass Permissions？
僅應在可限制略過權限所造成損害的受控環境中謹慎評估使用，例如隔離的容器或一次性沙箱。建議不要在個人電腦、重要儲存庫或正式環境中將其設為預設模式。

## Sources

- [Claude Code 概覽](https://code.claude.com/docs/en/overview)
- [Claude Code 設定](https://code.claude.com/docs/en/setup)
- [Claude Code 權限](https://code.claude.com/docs/en/permissions)
- [Claude Code 模型設定](https://code.claude.com/docs/en/model-config)
- [Claude Code 費用](https://code.claude.com/docs/en/costs)
- [Claude Code 記憶體與 CLAUDE.md](https://code.claude.com/docs/en/memory)
- [Claude Code 互動模式](https://code.claude.com/docs/en/interactive-mode)

## Images

![顯示程式碼的筆電、檔案樹、權限盾牌與連接工作流程的插圖](https://injoys.com/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6NzQ0NCwicHVyIjoiYmxvYl9pZCJ9fQ==--d808896af034f2719d1a1a65b061553a991d3196/ai-572421ed.webp)
![中央伺服器連接程式碼、權限鎖、工作流程、文件、資料庫與雲端服務](https://injoys.com/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6NzQ1MCwicHVyIjoiYmxvYl9pZCJ9fQ==--e073adddcaf8ad6bf81bc0a0b0ca1d385d6d6a38/ai-c02b920d.webp)