知識極客 Luka
Sign up
· 5 min read

Claude Code (Mac) 安裝指南

Claude Code 是 Anthropic 開發的代理式寫程式工具，直接在你的終端機中運行，能夠理解你的程式碼庫，並透過自然語言指令幫助你更快速地寫程式。

系統需求

作業系統與硬體

  • 作業系統：macOS 10.15 或更新版本
  • 記憶體：最少 4GB RAM
  • 網路：需要網際網路連線進行身份驗證和 AI 處理
  • 地區限制：僅在支援的國家提供

軟體需求

  • Node.js 18 或更新版本

安裝步驟

步驟 1：安裝 Node.js

如果你尚未安裝 Node.js，請先完成以下步驟：

方法一：使用官方安裝程式

  1. 前往 Node.js 官網
  2. 下載 macOS 版本的安裝程式
  3. 執行安裝程式並按照指示完成安裝

方法二：使用 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 (預設)

選項 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。相反地：

  1. 檢查你的 npm 設定
  2. 使用 nvm 管理 Node.js 版本
  3. 確保正確設定 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 終端機特別容易截斷長貼上內容

最佳實務

  1. 明確的指令：使用清楚、具體的指令描述你想要的結果
  2. 逐步處理：對於複雜任務，分解成較小的步驟
  3. 利用上下文：Claude Code 能理解你的整個專案結構
  4. 實驗學習：從簡單的指令開始，逐漸嘗試更複雜的任務

支援與回饋

如果遇到問題或想提供回饋：

  • 在 Claude Code 內使用 /bug 指令回報問題
  • 在 GitHub 上提交問題
  • 查看官方文件取得更多資訊

透過這個設定，你就能開始使用 Claude Code 來加速你的開發工作流程！

Share Share Share Share Share Email