返回博客

Claude Code 入門指南:在終端機中使用你的 AI 助手

手把手教香港及澳門用戶安裝和使用 Claude Code,不只是寫程式,還能寫作、研究、管理檔案等。

什麼是 Claude Code?

Claude Code 是 Anthropic 推出的官方命令列 AI 助手。它直接在你的終端機中運行,能夠理解你的檔案和專案、執行各種操作,並透過自然語言與你互動。

很多人以為它只是給程式員用的工具——其實不然。無論你是寫程式、寫文章、做研究、整理檔案,還是學習新知識,Claude Code 都能幫上忙。它就像一個坐在你身邊、隨時待命的全能助手。

你能用它做什麼?

  • 編程開發 — 生成、修改、除錯程式碼,支援所有主流語言
  • 寫作編輯 — 撰寫電郵、潤色文章、翻譯文件
  • 研究分析 — 搜尋網頁資料、分析數據檔案、總結文件重點
  • 檔案操作 — 批量重新命名、格式轉換、Git 版本控制
  • 學習問答 — 用最簡單的方式解釋任何概念,逐步引導學習

準備工作

在開始之前,請確認你已具備以下條件:

  • macOS 電腦(Windows 和 Linux 亦可使用,安裝方式類似)
  • Claude Max 或 Pro 訂閱:Claude Code 需要有效的 Claude 訂閱才能使用。如果你還沒有訂閱,可參考我們的 Apple ID 註冊教程 透過 App Store 訂閱
  • 穩定的網路連線:由於香港及澳門地區無法直接連接 Claude 服務,建議先配置好 OpenHK 代理服務,確保連線暢通
  • 預先登入 Claude 帳戶:連接 OpenHK 網路後,先在瀏覽器中打開 claude.ai 並登入你的帳戶,這樣後續 Claude Code CLI 授權時會更順暢

安裝步驟

1. 打開終端機

在 macOS 上,按 Cmd + Space 打開 Spotlight,輸入「Terminal」並按 Enter。

2. 執行安裝命令

在終端機中貼上以下命令並按 Enter:

curl -fsSL https://claude.ai/install.sh | sh

3. 驗證安裝

安裝完成後,輸入以下命令確認安裝成功:

claude --version

如果看到版本號碼,表示安裝成功。

4. 首次啟動與登入

在終端機中輸入:

claude

首次啟動時,Claude Code 會引導你登入 Claude 帳戶。按照提示在瀏覽器中完成授權即可。

開始使用

切換到工作目錄

使用 cd 命令進入你想讓 Claude Code 工作的資料夾,例如:

cd ~/Documents/my-project

cd 是「change directory」的縮寫,~ 代表你的用戶主目錄。常用操作:

  • cd ~/Desktop — 切換到桌面
  • cd ~/Documents — 切換到文件資料夾
  • cd .. — 返回上一層目錄

啟動 Claude Code

進入目標資料夾後,輸入以下命令啟動:

claude

Claude Code 會自動了解當前資料夾內的檔案結構。

試試這些指令

你可以用自然語言向 Claude Code 提問或下達指令,例如:

  • 「幫我寫一封請假電郵,語氣要正式」
  • 「把這個資料夾裡所有 .jpeg 檔案重新命名為日期格式」
  • 「解釋什麼是 API,用最簡單的方式」
  • 「讀取 data.csv 並告訴我銷售額最高的前五個產品」
  • 「幫我在 src/utils.ts 中新增一個日期格式化函數」
  • 「搜尋網上關於 2026 年香港科技趨勢的資料」

切換模型

Claude Code 預設使用 Sonnet 模型。如果你想使用更強大的 Opus 模型,可以在對話中輸入:

/model

按 Enter 後會彈出選單,選擇 Opus 模型,然後使用方向鍵左右切換思考強度(effort level),按 Enter 確認:

  • High effort — 更深入的思考,適合大部分複雜任務
  • Max effort — 最高強度思考,適合最具挑戰性的問題

思考強度越高,Claude 的「智商」越高,輸出品質越好,但同時 用量(usage)消耗也越快。建議日常使用 High effort,遇到特別困難的問題再切換到 Max effort。

使用 Plan Mode

當你有一個較大的任務時,可以先讓 Claude Code 制定計劃再執行。按 Shift + Tab 或輸入 /plan 即可切換到 Plan Mode。

進入 Plan Mode 後,Claude Code 會先分析你的需求、研究相關檔案,然後提出一個詳細的執行方案給你審閱。你確認方案後,它才會開始實際操作。這樣可以避免方向錯誤,特別適合複雜任務。

為你的專案建立 CLAUDE.md

如果你正在一個已有的專案中使用 Claude Code,強烈建議先執行 /init 指令:

/init

Claude Code 會分析你的整個專案結構,然後自動生成一份 CLAUDE.md 檔案。這份檔案就像是你寫給 Claude 的「專案說明書」,裡面包含:

  • 專案架構 — 資料夾結構、使用的框架和技術
  • 常用命令 — 如何建置、測試、部署你的專案
  • 程式碼風格 — 命名規範、慣用模式等

為什麼這很重要? 每次你啟動 Claude Code,它都會自動讀取 CLAUDE.md。這意味著 Claude 從一開始就了解你的專案背景,不需要你每次都重新解釋。

你也可以隨時手動編輯 CLAUDE.md,加入任何你希望 Claude 記住的專案規則或偏好。

實用命令

在 Claude Code 的對話中,你可以使用以下斜線命令:

  • /init — 為當前專案生成 CLAUDE.md 說明檔
  • /model — 切換 AI 模型(如 /model opus
  • /plan — 進入計劃模式,先規劃再執行
  • /help — 查看所有可用命令
  • /clear — 清除目前對話歷史
  • /compact — 壓縮對話上下文,釋放記憶體

小貼士

  • 直接說需求:不需要寫提示詞模板,用最自然的方式描述你想做什麼
  • 善用檔案上下文:Claude Code 能讀取你目錄中的檔案,所以可以直接引用檔案名稱
  • 複雜任務用 Plan Mode:先讓 Claude 制定計劃,確認後再執行,避免走錯方向
  • 善用 CLAUDE.md:用 /init 為專案生成說明檔,讓 Claude 每次啟動都自動了解你的專案

常見問題

Q:登入時瀏覽器沒有自動打開? 手動複製終端機中顯示的 URL,貼到瀏覽器中完成授權。

Q:無法連接到 Claude 服務? 請確認你的 OpenHK 代理服務 配置正確並已啟用。

Q:安裝時出現權限錯誤? 嘗試在命令前加上 sudosudo curl -fsSL https://claude.ai/install.sh | sh,然後輸入電腦密碼。

Q:我不會寫程式,也能用嗎? 完全可以!Claude Code 的用途遠不止編程。寫郵件、整理檔案、做研究、學習新知識,你都可以用自然語言直接和它對話完成。