Claude Code 是 Anthropic 開發的代理式寫程式工具，直接在你的終端機中運行，能夠理解你的程式碼庫，並透過自然語言指令幫助你更快速地寫程式。
系統需求
作業系統與硬體
- 作業系統：macOS 10.15 或更新版本
- 記憶體：最少 4GB RAM
- 網路：需要網際網路連線進行身份驗證和 AI 處理
- 地區限制：僅在支援的國家提供
軟體需求
- Node.js 18 或更新版本
安裝步驟
步驟 1：安裝 Node.js
如果你尚未安裝 Node.js，請先完成以下步驟：
方法一：使用官方安裝程式
- 前往 Node.js 官網
- 下載 macOS 版本的安裝程式
- 執行安裝程式並按照指示完成安裝
方法二：使用 nvm (推薦)
# 安裝 nvm
brew install nvm
# 或使用 curl 安裝
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 建立 nvm 目錄並設定環境變數
mkdir ~/.nvm && echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
# 重新載入設定
source ~/.zshrc
# 安裝最新的 LTS 版本
nvm install --lts
nvm use --lts
步驟 2：安裝 Claude Code
開啟終端機並執行以下指令：
npm install -g @anthropic-ai/claude-code
重要提醒：
- 請勿使用
sudo npm install -g，這可能導致權限問題和安全風險 - 如果遇到權限錯誤，請參考官方的疑難排解指南
步驟 3：驗證安裝
安裝完成後，可以執行以下指令驗證：
claude doctor
這個指令會檢查你的安裝狀態和版本資訊。
身份驗證設定
導航到你的專案
cd your-project-directory
啟動 Claude Code
claude
首次啟動時，Claude Code 會引導你完成一次性的 OAuth 驗證流程。你有以下幾種身份驗證選項：
選項 1：Anthropic Console (預設)
- 透過 Anthropic Console 連線並完成 OAuth 流程
- 需要在 console.anthropic.com 啟用帳單功能
選項 2：Claude App (Pro 或 Max 方案)
- 訂閱 Claude 的 Pro 或 Max 方案
- 提供統一訂閱，同時包含 Claude Code 和網頁介面
- 使用你的 Claude.ai 帳戶登入
選項 3：企業平台
- 為企業部署設定使用 Amazon Bedrock 或 Google Vertex AI
終端機最佳化設定
支援的 Shell
- Bash
- Zsh
- Fish
初始化專案
對於首次使用者，我們建議：
1. 啟動 Claude Code
claude
2. 執行簡單指令
嘗試詢問關於你的專案：
> 總結這個專案的架構
3. 產生專案指南
> 為這個專案建立一個 CLAUDE.md 檔案，說明專案結構
4. 提交產生的檔案
> 將產生的 CLAUDE.md 檔案提交到版本庫
主要功能
從描述建立功能
用簡單的中文告訴 Claude 你想建立什麼，它會制定計畫、撰寫程式碼並確保運作正常。
除錯和修復問題
描述錯誤或貼上錯誤訊息，Claude Code 會分析你的程式碼庫、識別問題並實作修復方案。
導航任何程式碼庫
詢問關於你團隊程式碼庫的任何問題，都能得到詳盡的回答。
自動化繁瑣任務
修復煩人的 lint 問題、解決合併衝突、撰寫發布說明，全部都能用單一指令完成。
進階功能
Model Context Protocol (MCP) 支援
Claude Code 支援 MCP，讓 Claude 能夠：
- 從外部資料來源取得最新資訊
- 連接到 Google Drive、Figma、Slack 等服務
- 使用你的自訂開發工具
Unix 哲學相容
Claude Code 可組合且可指令化：
tail -f app.log | claude -p "如果在這個日誌串流中看到任何異常，請透過 Slack 通知我"
Vim 模式
Claude Code 支援 Vim 按鍵綁定的子集，可以用 /vim 啟用或透過 /config 設定。
支援的按鍵包括：
- 模式切換：
Esc(到 NORMAL)、i/I、a/A、o/O(到 INSERT) - 導航：
h/j/k/l、w/e/b、0/$/^、gg/G - 編輯：
x、dw/de/db/dd/D、cw/ce/cb/cc/C、.(重複)
疑難排解
權限問題
如果遇到權限錯誤，請勿使用 sudo。相反地：
- 檢查你的 npm 設定
- 使用 nvm 管理 Node.js 版本
- 確保正確設定 npm 全域安裝路徑
指令找不到錯誤
如果安裝後出現「command not found」錯誤：
# 檢查你的 PATH 設定
echo $PATH
# 如果需要，將 npm 全域 bin 路徑加入 PATH
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
Node.js 版本問題
確保你有相容的 Node.js 版本：
node --version # 應該是 18.0.0 或更新版本
如果版本太舊：
nvm install --lts
nvm use --lts
更新
Claude Code 會自動保持最新狀態：
- 更新檢查：在啟動時和執行期間定期執行
- 更新流程：在背景自動下載和安裝
- 通知：安裝更新時會顯示通知
- 套用更新：下次啟動 Claude Code 時生效
使用技巧
處理大型輸入
當處理大量程式碼或長指令時：
- 避免直接貼上：Claude Code 可能難以處理非常長的貼上內容
- 使用檔案為基礎的工作流程：將內容寫入檔案並要求 Claude 讀取
- 注意 VS Code 限制：VS Code 終端機特別容易截斷長貼上內容
最佳實務
- 明確的指令：使用清楚、具體的指令描述你想要的結果
- 逐步處理：對於複雜任務，分解成較小的步驟
- 利用上下文：Claude Code 能理解你的整個專案結構
- 實驗學習：從簡單的指令開始，逐漸嘗試更複雜的任務
支援與回饋
如果遇到問題或想提供回饋：
透過這個設定，你就能開始使用 Claude Code 來加速你的開發工作流程！