Claude Code CLI 完全指南 2026:Anthropic 終端AI程式設計從入門到精通

Claude Code CLI 完全指南 2026:Anthropic 終端AI程式設計從入門到精通

什麼是 Claude Code?

Claude Code 是 Anthropic 推出的命令列 AI 程式設計助手,讓你直接在終端中與 Claude 協作編寫、編輯和執行程式碼。與網頁版不同,Claude Code 深度整合到你的開發工作流中,能夠直接讀取專案檔案、執行命令並進行智慧程式碼修改。

根據 2026 年 3 月的開發者調查,Claude Code 已成為最受歡迎的 AI 程式設計工具之一,僅次於 GitHub Copilot,但在獨立 CLI 工具中排名第一。

為什麼選擇 Claude Code CLI?

核心優勢

  • 終端原生體驗:無需離開命令列,保持開發上下文
  • 專案感知能力:自動讀取專案結構和檔案內容
  • 命令執行權限:可以直接執行測試、建置命令
  • CLAUDE.md 支援:透過配置檔案定義專案規範和程式設計風格
  • 多檔案編輯:一次性修改多個相關檔案
  • Git 整合:理解版本控制上下文,生成有意義的提交資訊

與競品對比

功能Claude CodeGitHub Copilot CLICursor
終端整合✅ 原生 CLI✅ 有限支援❌ 僅 GUI
多檔案編輯✅ 支援⚠️ 部分支援✅ 支援
命令執行✅ 安全沙箱⚠️ 需確認✅ 支援
專案配置✅ CLAUDE.md❌ 無✅ .cursorrules
離線模式❌ 需連網❌ 需連網⚠️ 部分支援

安裝指南

系統要求

  • 作業系統:macOS 10.15+、Linux (Ubuntu 20.04+)、Windows 10+ (WSL2 推薦)
  • Node.js:v18.0 或更高版本
  • Anthropic API Key:需要有效的訂閱

方法一:npm 安裝(推薦)

# 全域安裝
npm install -g @anthropic/claude-code

# 驗證安裝
claude --version

方法二:Homebrew(macOS/Linux)

# 新增 Anthropic tap
brew tap anthropic/claude-code

# 安裝
brew install claude-code

方法三:直接下載(Windows)

  1. 存取 Claude Code 發佈頁面
  2. 下載最新的 Windows 安裝包
  3. 執行安裝程式並新增到 PATH

配置 API Key

# 設定 API Key(首次執行會提示)
export ANTHROPIC_API_KEY="your-api-key-here"

# 或寫入配置檔案
echo "export ANTHROPIC_API_KEY='your-api-key-here'" >> ~/.bashrc
source ~/.bashrc

快速入門

基本使用

# 在當前專案目錄啟動 Claude Code
claude

# 直接提問
claude "幫我建立一個 Express.js 伺服器"

# 指定模型
claude --model claude-sonnet-4-20260514 "最佳化這個函數的效能"

常用命令

# 檢視說明
claude --help

# 列出可用模型
claude --list-models

# 顯示使用統計
claude --usage

# 清除對話歷史
claude --clear

CLAUDE.md 配置檔案

CLAUDE.md 是 Claude Code 的核心功能,讓你定義專案規範和程式設計風格。

建立 CLAUDE.md

在專案根目錄建立 CLAUDE.md 檔案:

# 專案規範

## 技術堆疊
- Node.js 22+
- TypeScript 5.x
- Express.js
- PostgreSQL

## 程式碼風格
- 使用 ES6+ 語法
- 優先使用 async/await 而非 Promise
- 函數長度不超過 50 行
- 必須編寫單元測試

## 目錄結構
/src
  /controllers - 路由處理器
  /models - 資料模型
  /middleware - 中介軟體
  /utils - 工具函數

## 命名約定
- 檔案:kebab-case.ts
- 類別:PascalCase
- 函數/變數:camelCase
- 常數:UPPER_SNAKE_CASE

## 提交資訊格式
feat: 新功能
fix: 修復 bug
docs: 文件更新
refactor: 程式碼重構
test: 新增測試

CLAUDE.md 最佳實踐

  1. 保持簡潔:只包含關鍵規範,避免冗長
  2. 具體明確:使用具體範例而非抽象描述
  3. 定期更新:隨專案演進更新配置
  4. 團隊共享:提交到版本控制,確保團隊一致

實戰範例

範例 1:建立新專案

claude "建立一個 Node.js + TypeScript + Express 的專案骨架,包含以下功能:
- JWT 認證
- PostgreSQL 資料庫連線
- ESLint 和 Prettier 配置
- Jest 測試框架
- Docker 配置檔案"

範例 2:程式碼重構

claude "重構 src/controllers/user.controller.ts 檔案:
1. 提取重複邏輯到 utils 函數
2. 新增錯誤處理中介軟體
3. 最佳化資料庫查詢效能
4. 新增輸入驗證"

範例 3:生成測試

claude "為 src/services/auth.service.ts 編寫完整的單元測試,包含:
- 正常流程測試
- 邊界條件測試
- 錯誤處理測試
- 效能測試案例"

範例 4:程式碼審查

claude "審查最近提交的程式碼變更,檢查:
- 潛在的安全漏洞
- 效能問題
- 程式碼風格一致性
- 缺失的錯誤處理
- 測試覆蓋率"

高階技巧

1. 使用 Slash 命令

# 在對話中使用
/commit 生成提交資訊
/test 執行測試套件
/explain 解釋程式碼
/search 搜尋程式碼庫

2. 多檔案操作

claude "將所有 JavaScript 檔案轉換為 TypeScript:
1. 重新命名 .js 為 .ts
2. 新增型別註解
3. 建立對應的 .d.ts 宣告檔案
4. 更新 package.json 配置"

3. 安全模式

對於生產環境,建議啟用安全模式:

claude --sandbox "執行資料庫遷移"

4. 自訂提示範本

建立 .claude/prompts 目錄儲存常用提示:

# .claude/prompts/review.md
請審查以下程式碼,重點關注:
1. 安全性問題
2. 效能瓶頸
3. 可維護性
4. 測試覆蓋率

常見問題

Q: Claude Code 免費嗎?

A: Claude Code 需要 Anthropic API 訂閱。根據使用量計費,建議檢視 定價頁面 瞭解最新價格。

Q: 如何處理大專案?

A: 使用 --context 引數限制檔案範圍:

claude --context "src/**/*.ts" "重構使用者認證模組"

Q: 可以離線使用嗎?

A: 不可以,Claude Code 需要連網呼叫 Anthropic API。

Q: 如何保護敏感資訊?

A: 使用 .claudeignore 檔案排除敏感檔案:

# .claudeignore
.env
*.key
node_modules/
dist/

效能最佳化建議

  1. 限制上下文:只包含必要的檔案
  2. 分批處理:大任務拆分為多個小請求
  3. 快取配置:CLAUDE.md 會被快取,避免頻繁修改
  4. 選擇合適模型:簡單任務使用 claude-haiku,複雜任務使用 claude-sonnet

總結

Claude Code CLI 是 2026 年開發者必備的工具之一。它將 AI 程式設計助手無縫整合到終端工作流中,透過 CLAUDE.md 配置實現專案級定製,大幅提升開發效率。

開始使用

npm install -g @anthropic/claude-code
claude

相關資源


最後更新:2026 年 3 月 25 日