Claude Code 完整使用指南：用 AI 加速程式開發

<p>Claude Code 是 Anthropic 推出的 CLI（命令列）工具，讓你直接在終端機中與 Claude 互動。它能讀取你的程式碼、執行指令、編輯檔案，就像一個 AI 結對程式夥伴坐在你旁邊。</p>

<div style="background: #eff6ff; padding: 20px; border-radius: 10px; margin-bottom: 20px;">
<h3>Claude Code 的核心優勢</h3>
<ul>
<li><strong>直接存取程式碼</strong>：不用複製貼上，Claude 能直接讀取和編輯你的檔案</li>
<li><strong>執行終端指令</strong>：可以跑測試、安裝套件、git 操作</li>
<li><strong>理解專案脈絡</strong>：自動分析專案結構和相依關係</li>
<li><strong>多檔案編輯</strong>：跨檔案的重構和修改一次完成</li>
</ul>
</div>

<div style="background: #f0fdf4; padding: 20px; border-radius: 10px; margin-bottom: 20px;">
<h3>步驟 1：安裝 Claude Code</h3>
<p>使用 npm 全域安裝：</p>
<p><code>npm install -g @anthropic-ai/claude-code</code></p>

<h3>步驟 2：登入認證</h3>
<p>在終端機執行：</p>
<p><code>claude</code></p>
<p>首次執行會引導你登入 Anthropic 帳號或設定 API key。</p>

<h3>步驟 3：進入專案目錄</h3>
<p>切換到你的專案資料夾後啟動：</p>
<p><code>cd your-project &amp;&amp; claude</code></p>
</div>

<h3>基本對話</h3>
<div style="background: #f5f5f5; padding: 15px; border-radius: 8px; margin-bottom: 15px;">
<p>直接輸入問題或需求即可：</p>
<p><code>&gt; 這個專案是做什麼的？</code></p>
<p><code>&gt; 幫我找到處理使用者認證的程式碼</code></p>
<p><code>&gt; src/api/auth.py 這個檔案有什麼問題？</code></p>
</div>

<h3>程式開發</h3>
<div style="background: #f5f5f5; padding: 15px; border-radius: 8px; margin-bottom: 15px;">
<p><code>&gt; 幫我在 models.py 加一個 UserProfile model</code></p>
<p><code>&gt; 幫我寫這個 function 的單元測試</code></p>
<p><code>&gt; 重構 utils.py，把重複的程式碼抽成共用函式</code></p>
</div>

<h3>偵錯與修復</h3>
<div style="background: #f5f5f5; padding: 15px; border-radius: 8px; margin-bottom: 15px;">
<p><code>&gt; 跑 pytest 看看有哪些測試失敗，然後修復它們</code></p>
<p><code>&gt; 這個 error log 是什麼原因？幫我修</code></p>
<p><code>&gt; 分析為什麼這個 API 回應這麼慢</code></p>
</div>

<h3>Git 操作</h3>
<div style="background: #f5f5f5; padding: 15px; border-radius: 8px; margin-bottom: 15px;">
<p><code>&gt; /commit</code>（自動生成 commit message 並提交）</p>
<p><code>&gt; 幫我看看目前的 git diff，有沒有問題</code></p>
<p><code>&gt; 建一個新的 feature branch 叫 add-search</code></p>
</div>

<div style="background: #fef3c7; padding: 20px; border-radius: 10px; margin-bottom: 20px;">
<p>在專案根目錄建立 <code>CLAUDE.md</code> 檔案，寫入專案的重要資訊：</p>
<ul>
<li><strong>專案概述</strong>：這是什麼專案、用了什麼技術</li>
<li><strong>開發規範</strong>：程式碼風格、命名規則</li>
<li><strong>常用指令</strong>：如何跑測試、如何建構</li>
<li><strong>架構說明</strong>：目錄結構、重要模組</li>
</ul>
<p>Claude Code 每次啟動都會讀取這個檔案，就像給新同事一份 onboarding 文件。</p>
</div>

<h3>1. 善用 Slash Commands</h3>
<div style="background: #eff6ff; padding: 15px; border-radius: 8px; margin-bottom: 15px;">
<ul>
<li><code>/help</code>：查看所有可用指令</li>
<li><code>/commit</code>：智慧提交程式碼</li>
<li><code>/clear</code>：清除對話歷史</li>
<li><code>/compact</code>：壓縮對話歷史，節省 token</li>
</ul>
</div>

<h3>2. 多檔案操作</h3>
<div style="background: #eff6ff; padding: 15px; border-radius: 8px; margin-bottom: 15px;">
<p>Claude Code 最強大的功能之一是跨檔案操作：</p>
<p><code>&gt; 把所有 API endpoint 從 class-based views 改成 function-based views</code></p>
<p><code>&gt; 在所有 model 加上 created_at 和 updated_at 欄位</code></p>
<p>Claude 會自動找到相關檔案並一一修改。</p>
</div>

<h3>3. 權限控制</h3>
<div style="background: #eff6ff; padding: 15px; border-radius: 8px; margin-bottom: 15px;">
<p>Claude Code 執行指令前會請你確認，避免誤操作：</p>
<ul>
<li>編輯檔案前會顯示差異</li>
<li>執行 shell 指令前會詢問許可</li>
<li>可以設定自動允許特定操作</li>
</ul>
</div>

<h3>4. 搭配 CI/CD</h3>
<div style="background: #eff6ff; padding: 15px; border-radius: 8px; margin-bottom: 15px;">
<p>Claude Code 可以整合到開發流程中：</p>
<ul>
<li>PR Review：自動分析 Pull Request 的程式碼品質</li>
<li>Bug 修復：給它 error log，讓它自動找到問題並修復</li>
<li>文件生成：自動為新功能生成文件</li>
</ul>
</div>

<div style="background: #f0fdf4; padding: 20px; border-radius: 10px; margin-bottom: 20px;">
<h3>場景：修復一個 Bug</h3>
<p>1️⃣ <code>claude</code> — 啟動 Claude Code</p>
<p>2️⃣ <code>&gt; 使用者回報登入後被登出，幫我查看 auth middleware 的問題</code></p>
<p>3️⃣ Claude 分析程式碼，找到 session 過期設定錯誤</p>
<p>4️⃣ Claude 提出修改建議，你確認後自動修改檔案</p>
<p>5️⃣ <code>&gt; 跑一下相關的測試確認修復沒問題</code></p>
<p>6️⃣ <code>&gt; /commit</code> — 自動生成 commit message 並提交</p>
<p>全程不到 5 分鐘，傳統方式可能要 30 分鐘以上。</p>
</div>