Claude Code 由零安裝：Mac、Linux 同第一個小練習

安裝先跟官方入口

Claude Code 可以喺 Terminal 使用，亦有其他介面。呢篇集中 Mac 同 Linux CLI，新手唔需要先為咗安裝 Claude Code 而裝舊版 Node.js。

開始前準備 Terminal，同一個支援 Claude Code 嘅帳戶或組織提供嘅存取方式。訂閱登入同 Console API 付費係唔同渠道，唔係人人都需要自己建立 API key。官方快速入門列出目前支援方式。

1. 揀一種安裝方式

官方原生安裝適用於 macOS、Linux 同 WSL：

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

呢條指令會下載並執行官方安裝程式。先核對網域；公司機應跟 IT 批准嘅安裝方式，唔好用不明網站提供嘅「修正版」。

Mac 如果已經用 Homebrew，亦可用：

brew install --cask claude-code

兩種揀一種，唔好為咗排錯反覆裝幾套。原生 Windows 亦有官方支援方式，毋須一概改用 WSL；Windows 用戶直接按官方對應分頁做。

2. 開新 Terminal 核對

claude --version
claude --help

搵唔到 claude，先睇安裝程式輸出同 PATH。唔好一遇到權限錯誤就加 sudo，亦唔好跟舊文章將整個系統資料夾改權限。安裝問題可按官方設定文件排查。

更新方式跟安裝渠道有關；用套件管理器安裝，就按該渠道更新，唔好混用幾套更新命令。

3. 喺獨立練習資料夾登入

mkdir -p ~/claude-practice
cd ~/claude-practice
claude

第一次跟畫面登入，核對帳戶同計費方式。如果環境已經有 ANTHROPIC_API_KEY，可能影響登入或計費路徑；唔清楚時先查帳戶狀態，唔好直接印出密鑰。

毋須將 API key 貼入對話、截圖或者公開設定檔。用 API 嘅人應按組織憑證管理方式提供，並先了解用量同費用。

4. 做一個容易驗收嘅任務

目前係專用練習資料夾。請建立一份 hello.txt，內容係三行：
第一行：你好，Claude Code。
第二行：呢個係我嘅第一個練習。
第三行：我會親手檢查結果。

只改呢個檔案，唔安裝工具、唔連外部服務。完成後講明檔案位置，並讀返內容核對。

完成後親手打開 hello.txt。呢個練習唔依賴 Python 或網站框架，你可以先熟悉工作目錄、改動顯示同權限提示，再做程式任務。

5. 睇清楚目前權限模式

唔同版本、帳戶同組織設定，批准方式可能不同，唔可以假設每次讀寫都一定問你。留意畫面嘅權限模式，用 /permissions 查看規則；Shift+Tab 可以喺可用模式之間切換。

批准前睇清楚路徑、指令同範圍。新手先做細任務，唔好直接開放所有 shell 操作。Git 可以保存原始碼歷史，但未提交檔案、外部資料同 API 操作未必救得返。

用 /exit 離開。想接續之前對話，可以用 claude -c 或 /resume，而唔係假設重新輸入 claude 就必定接返上一段。

之後先加專案背景

熟悉基本操作後，先喺真正專案加入 CLAUDE.md，寫現有指令、命名慣例同限制。.claude/ 可以包含團隊要共用嘅設定或 skills，唔應一概整個加入忽略清單；憑證同本機專用檔案則要分開管理。

要用 VS Code 或 JetBrains，就按官方相應介面安裝說明，唔好將所有 AI 編輯器功能都當成 Claude Code 已有。模型亦可用 /model 查看帳戶當下選項，唔需要照抄舊版本名稱。

裝好嘅標準係：新 Terminal 搵到指令、登入渠道清楚、工作範圍正確，而且你能夠親手核對第一個改動。