如何設定Claude Code CLI：5分鐘快速入門

ServiceNow已有超過29,000名開發者每天使用Claude Code，安聯集團也在2026年初全面導入。這項工具的採用曲線反映了一個規律：一旦開發者在自己的終端機中體驗過代理式編程，就再也不會回到從聊天視窗複製貼上的工作方式。本快速入門指南將帶您在大約五分鐘內從零開始建立一個可運作的Claude Code工作階段，並提供可持續使用的實際設定。

重點摘要：透過npm install -g @anthropic-ai/claude-code安裝Claude Code，經由瀏覽器完成驗證，建立包含專案上下文的CLAUDE.md檔案，並在.claude/settings.json中設定權限。新增Prettier Hook以在每次編輯後自動格式化檔案。整個設定過程不到五分鐘，且設定會在工作階段之間持續保留。

重點摘要

獨立開發者：CLAUDE.md加上一個格式化Hook就能涵蓋80%的需求。從預設權限開始，隨著信任度的建立逐步預先核准工具。
團隊主管：將.claude/settings.json提交至版本庫，讓整個團隊共用相同的權限白名單和Hook。
資安工程師：三層權限模型（預設、預先核准、略過）直接對應信任等級。預設模式下，每次寫入和每個指令都需要明確核准。

先決條件

安裝Claude Code之前，您需要三樣東西：

Node.js 18或更新版本。Claude Code以npm套件形式發布。請檢查您的版本：

node --version
# v18.0.0 or higher

如需安裝或升級Node.js，請使用nvm或直接從nodejs.org下載。

具有API存取權的Anthropic帳戶。在console.anthropic.com的Settings > API Keys下建立API金鑰。Claude Code會從您的API餘額或Max訂閱方案中扣款。請在驗證步驟時備妥金鑰。

一個終端機。Claude Code可在任何終端模擬器中執行：Terminal.app、iTerm2、Windows Terminal、Alacritty，或VS Code的內建終端機。建議使用至少120欄寬的終端機，因為Claude Code顯示的檔案差異和工具輸出會受益於較寬的水平空間。

安裝

透過npm全域安裝Claude Code：

npm install -g @anthropic-ai/claude-code

驗證安裝是否成功：

claude --version

您應該會看到版本號輸出至stdout。如果出現「command not found」錯誤，請確認您的npm全域bin目錄已加入PATH。執行npm config get prefix並將其輸出的/bin子目錄加入PATH。

首次啟動時，Claude Code會開啟瀏覽器前往Anthropic控制台進行OAuth驗證。您登入、授權後，權杖會儲存在本機的~/.claude/中。您也可以在啟動前設定ANTHROPIC_API_KEY環境變數。無論哪種方式，憑證都留在您的機器上，僅用於驗證API請求。

第一次工作階段

進入任何專案目錄並執行：

cd ~/Projects/my-app
claude

Claude Code會啟動互動式REPL工作階段。首次在新專案中啟動時，它會自動執行以下操作：

掃描目錄結構以了解專案佈局
讀取設定檔案如package.json、pyproject.toml或Cargo.toml以識別技術堆疊
尋找CLAUDE.md檔案於專案根目錄中取得專案專屬指令

嘗試一個簡單的提示來確認一切正常運作：

> Explain the structure of this project

Claude會讀取您的檔案、綜合分析架構，並在終端機中回應。您會即時看到工具呼叫（每次檔案讀取、每個指令執行），以及在任何寫入操作前的權限確認請求。

設定CLAUDE.md

CLAUDE.md是有效使用Claude Code最重要的單一檔案。它位於專案根目錄，包含Claude在每次工作階段開始時讀取的指令。您可以將它視為給AI協作者的README。

建立檔案：

touch CLAUDE.md

以下是一個實用的起始範本：

# My App

## Project Context
Express.js API with React frontend. PostgreSQL database.

## Stack
- Backend: Node.js 20, Express 4, TypeScript
- Frontend: React 18, Vite
- Database: PostgreSQL 16, Prisma ORM
- Testing: Vitest for unit tests, Playwright for e2e

## Code Standards
- Use async/await, never raw Promises
- All API endpoints need input validation with Zod
- Tests required for new endpoints before merging

## Commands
- `npm run dev` starts the dev server on port 3000
- `npm test` runs the test suite
- `npx prisma migrate dev` runs database migrations

根據我的經驗，最有價值的段落是那些能防止重複犯錯的內容。如果Claude一直在您使用ESM的專案中使用CommonJS，請將此規則加入CLAUDE.md。如果有特定的測試指令或資料庫設定步驟，請記錄下來。Claude每次工作階段都會讀取CLAUDE.md，因此您放入的任何內容都會成為持久性指令。

您也可以在家目錄（~/.claude/CLAUDE.md）放置CLAUDE.md作為跨所有專案適用的全域指令，並在子目錄中放置僅適用於monorepo特定部分的上下文。

權限基礎

Claude Code以三個權限層級運作，決定代理擁有多少自主權：

預設模式在每次檔案寫入、指令執行或破壞性操作前都會請求權限。您能確切看到Claude打算做什麼，並逐步核准或拒絕每個步驟。建議從這裡開始。

預先核准權限讓您將特定工具和模式加入白名單，這樣Claude就不必每次都詢問。您可以在專案的.claude/settings.json中設定：

{
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(npm test)",
      "Bash(npx prisma migrate dev)"
    ]
  }
}

此範例允許Claude讀取檔案、搜尋程式碼庫，以及執行測試和資料庫遷移指令而無需詢問。寫入檔案或執行其他bash指令時仍會詢問。

危險略過權限（--dangerously-skip-permissions）會停用所有確認提示。此旗標專門用於CI/CD流程和自動化工作流程中無人在場核准的情境。永遠不要在您重視的程式碼庫的互動式工作階段中使用它。

權限系統是Claude Code能安全用於實際專案的原因。從預設模式開始，觀察哪些核准變得重複，然後選擇性地僅預先核准那些特定操作。

您的第一個Hook

Hook是在Claude Code生命週期特定時間點執行的shell指令。它們在LLM的機率行為之上提供確定性保證。以下是一個實用的第一個Hook：在Claude編輯檔案後自動格式化。

在專案中建立或編輯.claude/settings.json：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$FILE_PATH\" 2>/dev/null || true"
          }
        ]
      }
    ]
  }
}

此Hook在每次Edit或Write工具呼叫後觸發。Claude Code會將$FILE_PATH設為被修改的檔案。Prettier會就地格式化它，而|| true確保在Prettier未安裝或檔案類型不支援時，Hook不會阻擋Claude。

其他我推薦的實用入門Hook：

Bash的PreToolUse：阻擋危險指令如rm -rf /或git push --force
SessionStart：將當前日期、活躍的git分支或環境變數注入上下文（SessionStart Hook的stdout會輸入至Claude的上下文中）
Stop：在Claude完成任務時自動執行測試套件

Hook將Claude Code從對話式工具轉變為受管控的開發環境。即使只有一兩個精心選擇的Hook，也能消除整類錯誤。

下一步

本快速入門涵蓋了基礎要素：安裝、您的第一次工作階段、專案設定、權限和一個入門Hook。如需完整參考，涵蓋所有5個核心系統（CLAUDE.md層級、完整權限模型、Hook架構、自訂斜線指令和多代理工作流程），請閱讀Claude Code完整指南。

該指南涵蓋上下文視窗管理、子代理委派、技能自動啟用，以及數月每日使用Claude Code後浮現的模式。如果您覺得本快速入門有用，完整指南是自然的下一步。

常見問題

Claude Code的費用是多少？

Claude Code支援兩種計費模式。API按量計費模式依照標準Anthropic API費率按Token收費。一般30-60分鐘的工作階段費用約$0.50-$3.00，取決於程式碼庫大小和生成量。另外，Anthropic的Max方案（個人$100/月、團隊$200/月）包含Claude Code用量並享有更高的速率限制。您可以在console.anthropic.com監控API用量。

我可以在VS Code中使用Claude Code嗎？

可以。Claude Code可在任何終端機中運作，包括VS Code的內建終端機。在VS Code中開啟終端面板，導航至您的專案目錄，然後如同在獨立終端機中一樣執行claude。Claude Code在磁碟上讀寫檔案，因此變更會立即顯示在VS Code編輯器分頁中。不需要另外安裝VS Code擴充功能。有些開發者會在編輯器旁保持一個專門的終端分割視窗用於Claude Code，這對於即時檢視變更非常有效。

Claude Code在生產環境程式碼庫中使用安全嗎？

Claude Code的預設權限模式在每次檔案寫入和每個指令執行前都會要求明確核准。未經您的確認，磁碟上不會有任何變更。權限系統結合可阻擋危險操作（如強制推送或破壞性shell指令）的Hook，使其適用於生產環境。我每天都在服務真實使用者的專案上使用Claude Code。關鍵在於從預設模式開始，在核准前了解每個工具呼叫的作用，並僅逐步預先核准您信任的操作。版本控制是您最後的安全網：在開始任何重要的Claude Code工作階段前先提交，這樣您隨時可以還原。