Claude Code 實戰：讓 AI 代理在你的終端機裡幹活

Claude 回答你怎麼做是一回事，Claude Code 直接幫你做完是另一回事。它能讀取你的程式碼、修改檔案、執行指令，不需要你複製貼上，就在你的專案資料夾裡工作。這一篇帶你從安裝到高效使用，走完一次完整的實戰流程。

Claude Code 的工具清單

Claude Code 本質是 Agent = Model（Claude）加上 Harness（CLI 工具框架）。它能用的工具包括：

安裝與基本操作

# 需要 Node.js 18+
npm install -g @anthropic-ai/claude-code

# 登入（用 Anthropic 帳號）
claude login

# 在專案資料夾裡啟動互動模式
cd your-project
claude

CLAUDE.md：給 Claude 的專案說明書

在專案根目錄放 CLAUDE.md，Claude Code 每次啟動都會讀它，讓 Claude 了解你的專案背景。

# 天氣小工具 - 專案說明

## 專案概述
Python CLI 工具，查詢即時天氣，使用 OpenWeatherMap API

## 技術棧
- Python 3.11、requests、python-dotenv
- 測試：pytest，Linting：Ruff

## 重要規範
- 所有函式要有 Google Style Docstring 和 Type Hints
- Commit 訊息格式：Conventional Commits
- 不要修改 .env 檔案

## 常用指令
- pytest：跑測試
- ruff check . --fix：Linting
- python3 weather.py：執行主程式

權限設定：allow、ask、deny

Claude Code 的每個工具都能設定權限，控制哪些操作自動執行、哪些需要你確認。

{
  "permissions": {
    "allow": [
      "Bash(pytest)",
      "Bash(ruff *)",
      "Read"
    ],
    "ask": [
      "Bash(git commit *)",
      "Write"
    ],
    "deny": [
      "Bash(rm -rf *)"
    ]
  }
}

高效使用技巧

• 任務要具體：說修 bug 太模糊，說清楚是哪個檔案第幾行的什麼錯誤，效果好十倍。
• 一次一個任務：不要把五件事塞在一個指令裡，完成一個確認後再做下一個。
• 用 /compact 管理 context：長對話後 context 快滿了，用 /compact 壓縮後繼續，不用重新開始。
• Ctrl+C 中斷不對的執行：發現 Claude 往錯的方向走，立刻中斷，說清楚方向後再繼續。