Claude Code 贏麻了：躺平也能寫程式

Claude Code 是由 Anthropic 在 2024 年 12 月發布的一款 AI Coding Agent 工具，目的幫助開發者在終端機中將想法更快地轉化為程式碼，可以搜尋和讀取程式碼、編輯檔案、編寫和執行測試、提交並推送程式碼到 GitHub，以及使用命令列工具等操作。

如何使用

src: https://x.com/sidbidasari

初次安裝

初次使用前需要先安裝 Claude Code

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

更多相關安裝方法，請參考：Anthropic Quickstart - Anthropic

基礎指令

使用 Claude Code，最基礎有兩種方式，一種是互動模式也就是多輪對話的互動介面；另一個則是一次性詢問的方式，只執行一次互動操作。還有其他像是 pipeline 等方式也可以與 Claude Code 互動。

1. 啟動互動模式

   於終端機輸入 claude，按下 Enter 即可進入對話模式。輸入 /exit 或 /quit 可退出互動模式。

   claude

   
2. 一次性詢問

   不想進入互動模式？直接在命令列輸入 claude "你的問題"，即可取得即時回答，例如 "這段代碼有什麼問題？" 或 "幫我寫個快速排序"。

   claude "tell me what this project is doing"

   互動完成後會停留在互動模式，可以繼續使用 Claude Code。

3. 管道處理（Pipe）

   可以把文件或輸出的結果透過管道傳入 claude，比如：

   cat main.py | claude "optimize this code"
   cat README.md | claude "translate into chinese"
   git diff | claude "explain this change"

   可以直接分析內容、優化或翻譯，省時省力。

4. 純文字輸出

   預設輸出為 Markdown 格式，加上 -p 後就會輸出純文字並直接退出，例如：

   claude -p "generate mysql json statement example" > query.sql

   非互動、純結果導出。

5. 查看幫助

   忘記指令？輸入 claude --help，即可查看全部命令說明。

   

若想要退出 直接使用 /exit, /quit 就可以了。

配置管理

若希望更客製化的配置資訊，Claude Code 提供大量的方法可以根據個人要求進行相應配置。

1. 查看目前配置

   可查看當前使用的模型、API 金鑰等資訊。

   claude config list

2. 查看特定設定值

   claude config get <key>

   查詢某一個設定的當前值。

3. 修改設定值

   claude config set <key> <value>

   將某一個設定更新為新值。

4. 對「列表型設定」新增項目

   claude config add <key> <value>

   在清單型設定中加入一個新項。

5. 對「列表型設定」移除項目

   claude config remove <key> <value>

   從清單型設定中刪除指定項目。

更多配置管理可以參考：Anthropic Claude Code settings - Anthropic

工具管理（MCP）

Claude Code 本身也完全支援 MCP 來連結外部工具，擴展自身能力：

src: https://norahsakal.com/blog/mcp-vs-api-model-context-protocol-explained/

1. 列出所有已安裝的 MCP

   claude mcp list

   
2. 查看某個 MCP 的詳細設定

   claude mcp get playwright

   
3. 安裝常用 MCP，如下所示：
   • 安裝 Playwright：

     claude mcp add playwright -s user -- npx @playwright/mcp@latest

   • 安裝 Sequential Thinking：

     claude mcp add sequential-thinking -s user -- npx -y @modelcontextprotocol/server-sequential-thinking

   • 安裝 Puppeteer：

     claude mcp add puppeteer -s user -- npx -y @modelcontextprotocol/server-puppeteer

   • 安裝 Context7：

     claude mcp add context7 -- npx @upstash/context7-mcp

4. 移除 MCP

   claude mcp remove "playwright" -s user

5. 檢視 MCP 狀態（互動模式下）

   進入 claude 後使用，即可查看目前所有 MCP 狀態：

   /mcp

   

除此之外還可以使用 .mcp.json 設定

{
  "mcpServers": {
    "playwright": {
      "args": ["@playwright/mcp@latest", "--headless"],
      "command": "npx"
    },
    "context7": {
      "args": ["-y", "@upstash/context7-mcp@latest"],
      "command": "npx"
    }
  }
}

更多可以參考：Anthropic Connect Claude Code to tools via MCP - Anthropic

進階操作

在 claude 的互動模式中，除了輸入問題，也能使用以下命令加速流程：

壓縮對話上下文

有時因為使用的狀況會導致上下文過長，此時可以選擇清除多餘歷史，只保留摘要在上下文中。

/compact  <optional custom summarization instructions>    # Clear conversation history but keep a summary in context. Optional: /compact [instructions for summarization]

清除會話歷史

又或是可以完全重置會話，釋放上下文空間。

/clear (reset) # Clear conversation history and free up context

接續上次的對話

還可恢復之前的對話狀態繼續使用。

/resume      # Resume a conversation

記憶模式 (項目級別/全域級別)

輸入 # 可進入 記憶編輯模式，用來修改 CLAUDE.md：

• 專案級：./CLAUDE.md
• 全域級：~/.claude/CLAUDE.md

#

讀圖片

1. 拖曳圖片到終端：可以直接將圖片檔案拖拽到正在執行 Claude Code 的終端視窗中。Claude 將能夠「看到」並分析這個圖片。
2. 複製貼上圖片（macOS）：在 macOS 上，可以使用 Control + V（不是 Command + V）將其貼上到 Claude Code 中。

回撤操作

有時會希望 Claude Code 回撤此前的操作，除了可以使用 esc 或是直接告訴 Claude Code 以外，還可以參考下面 ccundo 來進行回撤。

• RonitSachdev/ccundo

實際上 Claude Code 會把相關歷史紀錄都儲存在 C:\Users\USER\.claude\projects\ （Windows）下的相關專案紀錄中。

IDE 整合

若想整合其他 IDE，則可以使用 /ide 這樣一來就可以與其整合。

像是若與 VSCode 整合，假設選取一段程式碼，Claude Code 是可以知道你所選取的程式碼區段內容。

自定義命令

對於重複性高的工作流（例如：日誌分析），可以在 .claude/commands 目錄下創建自定義的命令，是 Claude Code 支援的 專案級自定義 Slash Commands 儲存位置。你可以透過 Markdown 檔案定義常用 prompt 指令，可以用於 Claude Code 中。

---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
description: Create a git commit
---

## Context

- Current git status: !`git status`
- Current git diff (staged and unstaged changes): !`git diff HEAD`
- Current branch: !`git branch --show-current`
- Recent commits: !`git log --oneline -10`

## Your task

Based on the above changes, create a single git commit.

更多參考：Anthropic Slash commands - Anthropic

hook

Claude Code hooks 是使用者定義的 shell 命令，在 Claude Code 生命週期的各個時點執行。Hooks 提供對 Claude Code 行為的確定性控制，確保某些動作的觸發，而不是依賴 LLM 選擇執行。

舉例以下幾個場景：

• 通知：自訂當 Claude Code 等待您的輸入或執行權限時如何通知您。
• 自動格式化：在每次檔案編輯後對 .ts 檔案執行 prettier，對 .go 檔案執行 gofmt 等。
• 記錄：追蹤和計算所有執行的命令以符合合規性或除錯需求。
• 回饋：當 Claude Code 產生不符合您程式碼庫慣例的程式碼時提供自動回饋。
• 自訂權限：阻止對生產檔案或敏感目錄的修改。

更多可以參考：Anthropic Hooks reference - Anthropic

子代理（Subagent）

Claude Code 中的自定義子代理是專門的 AI 助手，可以被調用來處理特定類型的任務。

• 具有自定義系統提示（system prompt）
• 工具和獨立上下文窗口（context windows）的特定任務配置
• 可重用性
• 彈性的權限管理

更多可以參考：Anthropic Subagents - Anthropic

常見問題

連接問題

# test api/network connection
claude "test connection"

# check config
claude config get api-key
claude config get model

性能優化

# enable cache
claude config set cache-enabled true

# set max-concurrent
claude config set max-concurrent 3

# adujst timeout
claude config set timeout 30

調試模式

# enable verbose mode
claude --verbose "question"

# debug
claude --debug "debug command"

最佳實踐

初始化配置

創建 CLAUDE.md

CLAUDE.md 是 Claude Code 中的重要配置文件，用來定義 Claude Code 的行為與上下文資訊，會被自動讀取到上下文中。

通常包含以下資訊：

• 項目概述
• 開發環境設置
• 代碼庫結構
• 使用指南
• 開發工作流程
• 限制和注意事項

創建的方式可以使用 /init 命令，或是手動建立：

/init

Claude Code 讀取 CLAUDE.md 設定檔的優先順序和搜尋路徑：

1. 專案根目錄：./CLAUDE.md（推薦使用，可提交至 git，團隊成員共享相同的配置）
2. 專案本地：./CLAUDE.local.md（不須提交到 git，通常添加到 .gitignore，用於個人開發環境的特殊設置）
3. 全域設定：~/.claude/CLAUDE.md（適用於所有沒有專案特定配置的情況）

父目錄和子目錄中也會被自動讀取。

配置工具權限

Claude Code 中也需要進行權限的控管，避免非預期行為的發生。透過以下方式進行權限設定：

• 使用 /permissions 命令
• 手動編輯 .claude/settings.json
• 啟用 --allowedTools 參數
• 使用 --dangerously-skip-permissions

MCP 工具

Claude Code 可透過三種方式連接任意數量的 MCP 伺服器：

• 專案配置中（在該目錄執行 Claude Code 時可用）
• 全域設定中（所有項目可用）
• 提交到 .mcp.json⁠ 檔案（任何在你程式碼庫工作的成員都可用）。例如，你可以在 .mcp.json⁠ 新增 Puppeteer 和 Sentry 伺服器，方便每位工程師開箱即用。
• 用 MCP 時，建議用 --mcp-debug⁠ 標誌來幫助排查設定問題。

上下文管理

若希望更好的使用上下文，可以參考以下用法：

• 使用 @ 引用文件
• 任務切換時使用 /clear 清空上次任務訊息
• 長時間會話使用 /compact 定期壓縮上下文
• 將重要資訊透過 #（memory 功能） 記錄到 CLAUDE.md 中
• 使用 /resume 恢復歷史會話；也可以啟動時恢復，指令為 claude --continue。

小技巧

ANTHROPIC_AUTH_TOKEN = "sk-..."
ANTHROPIC_BASE_URL = "..."

claude --dangerously-skip-permissions

think
think hard
think harder
ultrathink

claude --continue
claude --resume

claude mcp list
claude mcp get <name>
claude mcp remove <name>

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

Claude Code 的最大優勢在於其靈活性和終端原生體驗，不會綁定你到特定的 IDE，而是作為一個 CLI 工具，可以與任何現有的 IDE 配合使用。相比 Cursor、Windsurf 等 AI 編程工具需要完全切換到新的 IDE 環境或學習全新界面，Claude Code 讓開發者能保持原有的工作流程，同時在熟悉的終端環境中獲得 AI 協助。反映並體現了現代開發者對效率與靈活性的追求，就像我們習慣在手機上快速切換各種 app 來完成不同任務，Claude Code 讓開發者無需離開熟悉的終端環境，就能透過自然語言指令快速將想法轉化為程式碼，同時也反映了當代「工具應該適應人，而非人適應工具」的理念，讓 AI 助手融入開發者既有的工作流程中，而不是強迫改變習慣，這正是現代生活與 AI 協作所追求「無縫整合」體驗的最佳體現。

不過話說回來，Claude Code 是真的貴... 💸 用起來很爽，但荷包會哭泣。

參考來源

• Claude Code 官方網站
• Claude Code 官方文件
• Anthropic 團隊如何使用 Claude Code
• Anthropic Learn
• Claude Code 官方教學影片
• Claude Code 教學影片播放清單
• Claude Code 功能介紹影片
• 用神器 Claude Code！打造贴身 AI 秘书团【小白教程】-哔哩哔哩
• Claude Code 初识：已经在用 Cursor 的我，为何还要用 CC 🤔-哔哩哔哩
• Claude Code 指令指南（ctok.ai）
• Claude Code 中文文檔（deeptoai）