Claude Code 繁中入門：安裝、CLAUDE.md、skills、hooks 與權限，看不懂程式也能上手

Claude Code 是 Anthropic 的 AI 程式助理，在你的電腦或主機上讀檔、改檔、執行指令。Jason Finance 的程式、部署和資料更新都是它做的，我自己看不懂程式碼。這篇 Claude Code 教學用繁體中文整理看不懂程式的人真正用得到的部分：安裝、第一個小時、主要功能各有什麼用，以及我踩過或官方特別提醒的坑。

先說結論：Claude Code 需要付費方案（Pro、Max、Team、Enterprise 或 Console），免費方案不能用。裝好後最值得先花時間的是 CLAUDE.md 和權限設定，指令用到再學。你負責說清楚要什麼、看結果、做決定，指令交給它跑。

本文是我自己的使用整理，不是官方教學。功能、指令和支援方案都會變動，下文的官方文件於 2026 年 10 月 12 日查核，操作前請以 Claude Code 官方文件為準。

開始前：方案、電腦和網路

項目	官方要求（2026 年 10 月 12 日查核）
帳戶	Pro、Max、Team、Enterprise 或 Console；免費 claude.ai 方案不含 Claude Code；也可用 Amazon Bedrock、Google Cloud、Microsoft Foundry
作業系統	macOS 13.0 以上、Windows 10 1809 以上或 Windows Server 2019 以上、Ubuntu 20.04 以上、Debian 10 以上、Alpine Linux 3.19 以上
硬體	4 GB 以上記憶體，x64 或 ARM64 處理器
網路	需要連網
Shell	Bash、Zsh、PowerShell 或 CMD
地區	Anthropic 支援的國家與地區

資料來源：Advanced setup。

我的 Claude Code 跑在一台 Oracle Cloud 的 ARM 主機上，ARM64 可以正常使用，架設過程見〈Oracle Cloud 免費主機跑 Claude Code Remote Control〉。第一次用，裝在自己的電腦上就可以。

安裝 Claude Code：三種方式擇一

完全沒開過終端機，官方有一份 terminal guide 教怎麼打開、怎麼貼指令。不想碰終端機的話，也可以下載 Desktop 桌面版，用圖形介面使用 Claude Code。

原生安裝（官方建議）

macOS、Linux、WSL：

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

Windows PowerShell（提示字元是 PS C:\）：

irm https://claude.ai/install.ps1 | iex

Windows CMD（提示字元是 C:\，前面沒有 PS）：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Windows 不需要用系統管理員身分執行。原生安裝會在背景自動更新。

其他方式

方式	指令	要注意的事
Homebrew（macOS）	`brew install --cask claude-code`	不會自動更新，要自己 `brew upgrade claude-code`
WinGet（Windows）	`winget install Anthropic.ClaudeCode`	不會自動更新，要自己 `winget upgrade Anthropic.ClaudeCode`
apt、dnf、apk（Linux）	依官方步驟加入簽章過的套件庫	跟著系統更新，不會自己更新
npm	`npm install -g @anthropic-ai/claude-code`	需要 Node.js 22 以上；官方提醒不要用 `sudo npm install -g`

確認裝好、登入

開一個新的終端機視窗：

claude --version   # 印出版本號就是裝好了
claude doctor      # 檢查安裝與設定，不會開始對話

出現 command not found 多半是安裝路徑還沒加進 PATH，照官方排錯頁處理。接著到你的專案資料夾執行 claude，第一次會開瀏覽器登入。

如果環境裡設了 ANTHROPIC_API_KEY，而且你在詢問時同意使用它，Claude Code 會跳過登入，改用這把金鑰。要用 Remote Control 從手機連回來的話要注意：它只支援 claude.ai 訂閱登入，不支援 API key。

第一個小時：照順序做這幾件事

在專案資料夾裡啟動：cd 到專案再執行 claude。官方提到，直接在家目錄啟動時「信任這個資料夾」的選擇不會被記住，每次都會再問。
看一下現在的權限模式：畫面下方的狀態列會顯示 auto mode on、manual mode on 等字樣，按 Shift+Tab 可以切換，下面會說明差別。
執行 /init：Claude 會讀整個專案，產生一份初版 CLAUDE.md。
把 CLAUDE.md 改成你的規則：加上它從程式碼看不出來的事，例如「用繁體中文跟我溝通」「發佈前先問我」。
執行 /context：確認 CLAUDE.md 有被讀到（列在 Memory files 底下），也看得到對話已經用掉多少空間。
交代一件小事：例如「這個專案是做什麼的？用白話跟我說」。先讀不改，看它理解得對不對。
讓它改一個小地方：看它怎麼詢問權限、改了什麼，改完請它說明。
用 Git 留紀錄：確認專案在 Git 裡，改壞了可以還原。/rewind 也能把對話和程式碼倒回之前的狀態。
設好不能碰的東西：在 .claude/settings.json 禁止讀取 .env 這類存放密碼的檔案（範例在下一節）。
輸入 / 看指令清單：知道 /help、/usage 在哪就夠了，其他用到再查。

Claude Code 教學：主要功能，看不懂程式的人怎麼用

功能	是什麼	看不懂程式的人拿來做什麼
CLAUDE.md	每次開工都會讀到的專案說明	寫下溝通語言、哪些事要先問你、網站的固定規則
Auto memory	Claude 自己記的筆記	你糾正過的事，下次不用再講
Skills	一份 `SKILL.md` 寫好的固定流程	每次都一樣的工作：潤稿、發文前檢查、產生報告
Hooks	在特定時間點一定會執行的指令	等你回覆時發通知、擋下修改重要檔案
權限模式	決定哪些動作要先問你	依工作的風險，選擇要被問多少次
settings.json	設定檔，含允許、詢問、禁止規則	把「不准讀密碼檔」這類規則寫死
MCP	連接外部工具的標準	讓 Claude 直接查 Notion、資料庫或監控資料
斜線指令	輸入 `/` 開頭的指令	看用量、壓縮對話、切換模型
Remote Control	從手機或網頁接手電腦上的 session	人不在電腦前也能交代工作、看進度

CLAUDE.md：寫給 Claude 的工作守則

官方記憶文件列出幾個位置：專案的 ./CLAUDE.md（或 ./.claude/CLAUDE.md）會隨 Git 分享給團隊；~/.claude/CLAUDE.md 套用到你所有的專案；./CLAUDE.local.md 是只給自己看的，要加進 .gitignore。

幾個重點：

建議每份 200 行以內，太長會吃掉對話空間，也比較不容易被遵守。
可以用 @檔案路徑 匯入其他文件，但匯入的內容一樣在開工時載入，不會省空間。
CLAUDE.md 是背景資訊，不是強制設定。官方寫明，不管 Claude 怎麼判斷都必須擋下的動作，要用 PreToolUse hook。
用 /memory 可以開啟、編輯這些檔案，也能開關 auto memory。auto memory 存在 ~/.claude/projects/<專案>/memory/，每次開工載入 MEMORY.md 的前 200 行或前 25KB。

一個多語言網站的 CLAUDE.md 實際要寫哪些規則、怎麼分段，另外寫在〈CLAUDE.md 範例：多語言網站〉。

Skills：把固定流程做成一個指令

Skill 是一個資料夾，裡面一定要有 SKILL.md：開頭的 description 告訴 Claude 什麼時候該用，內文寫步驟。放在 ~/.claude/skills/<名稱>/ 是你所有專案都能用，放在專案的 .claude/skills/<名稱>/ 則跟著 repo 分享。

用法有兩種：Claude 判斷 description 符合你的需求時自動載入，或你輸入 /名稱 直接叫用。會造成影響的流程（例如部署）可以在 frontmatter 設 disable-model-invocation: true，只有你下指令才會執行。官方也說明，舊的自訂指令（.claude/commands/）已經併入 skills，原本的檔案照樣能用。

和 CLAUDE.md 不同，skill 的內文只在用到時才載入，長篇說明放在 skill 裡比較不佔空間。

Hooks：一定會發生的事

Hooks 是你自己定義的指令，Claude Code 在特定時間點執行，不靠 AI 判斷要不要做。常用的時間點：

事件	什麼時候	例子
`Notification`	Claude 等你回覆或核准時	跳出桌面通知
`PreToolUse`	工具執行前，可以擋下	禁止修改 `.env`、`.git/`
`PostToolUse`	工具執行成功後	改完檔案自動排版
`SessionStart`	session 開始或恢復時	載入當天要知道的資訊
`Stop`	Claude 回覆結束時	提醒、記錄

設定寫在 settings.json 的 hooks 區塊，輸入 /hooks 可以查看。官方範例用一個腳本檢查要修改的路徑，符合 .env、package-lock.json、.git/ 就以結束碼 2 擋下，Claude 會收到被擋的原因。看不懂腳本也沒關係，可以請 Claude 照官方範例寫，再請它示範一次被擋下的情況。

權限模式：決定 Claude 要問你多少次

依官方說明：

模式	不用問就能做的事	適合
`default`（畫面顯示 Manual）	只有讀取	敏感的工作、想逐一確認
`acceptEdits`	讀取、改檔、常見的檔案指令（`mkdir`、`mv`、`cp` 等）	你會看修改內容的時候
`plan`	讀取，先寫計畫給你核准再動手	改東西前先看它打算怎麼做
`auto`	全部，由另一個模型在背景審查	長時間工作、不想一直被問
`dontAsk`	事先允許的工具，其他一律拒絕	自動化腳本
`bypassPermissions`	全部，不檢查	只適合隔離的容器或虛擬機

要知道兩件事：

新版預設是 auto 模式：Claude Code v2.1.283 以後，終端機和 VS Code 的互動 session 預設從 auto 開始。舊版只有 Pro、Max、Team 方案預設 auto，其他是 Manual。官方也提醒，auto 模式減少詢問，但不保證安全，敏感操作仍要自己看。
按 Shift+Tab 循環切換；想固定從 Manual 開始，在 ~/.claude/settings.json 設 "permissions": {"defaultMode": "default"}。

settings.json：把規則寫死

設定檔有幾層，優先順序由高到低：組織的 managed settings、命令列參數、.claude/settings.local.json（自己、這個專案）、.claude/settings.json（整個專案共用）、~/.claude/settings.json（自己、所有專案）。

最實用的是權限規則。官方範例：

{
  "permissions": {
    "allow": ["Bash(npm run lint)", "Bash(npm run test *)"],
    "deny": ["Read(./.env)", "Read(./.env.*)"]
  }
}

deny 規則在每一種模式都有效，連 bypassPermissions 也擋得住。你在權限詢問時選「Yes, and don’t ask again」，Claude Code 會自動把規則寫進 .claude/settings.local.json。定期用 /permissions 看一下累積了哪些允許規則。

MCP：讓 Claude 連到其他工具

MCP 是連接外部系統的開放標準。連上之後，Claude 可以直接查 issue、資料庫或監控資料，不用你複製貼上。用 claude mcp add 新增，/mcp 查看狀態和登入。

官方提醒：連接前要確認信任這個 server，會抓外部內容的 server 有 prompt injection（藏在內容裡的惡意指令）的風險；Anthropic 不負責稽核 MCP server 的安全。我的建議是先只接官方或自己用的服務。

斜線指令：先記這幾個

指令	作用
`/help`	說明與指令清單
`/init`	產生 CLAUDE.md
`/memory`	編輯 CLAUDE.md、開關 auto memory
`/context`	看對話空間用了多少
`/compact`	把目前的對話壓縮成摘要
`/clear`	開新對話，清空內容
`/rewind`	把對話或程式碼倒回之前（別名 `/undo`）
`/permissions`	管理允許、詢問、禁止規則
`/usage`	看費用與方案用量（`/cost` 是別名）
`/remote-control`	讓這個 session 可以從手機或網頁接手（別名 `/rc`）

說明以官方指令列表為準。

Remote Control：人不在電腦前也能交代工作

Remote Control 讓你用 claude.ai/code 或 Claude 手機 App，接手電腦上正在跑的 Claude Code。程式碼的執行和檔案都留在原本那台機器上。支援 Pro、Max、Team、Enterprise，不支援 API key；Team 和 Enterprise 要先由 Owner 在管理設定開啟。

開啟方式是在 session 裡輸入 /remote-control，或執行 claude remote-control。想讓它在一台主機上長期待命，可以參考我用 systemd 做成常駐服務的方法：〈Oracle Cloud 免費主機跑 Claude Code Remote Control〉。

新手最常卡住的三件事

權限詢問：看懂再按，不要一路按 Yes

Manual 模式下，Claude 改檔、執行指令、連網前都會問你。看不懂指令也可以問它：「這個指令會做什麼？會刪掉東西嗎？」官方寫明，核准前檢查建議的程式碼和指令是使用者的責任。

我的做法（推論，不是官方建議）：常見又不會造成損害的指令（跑測試、看狀態）選「不再詢問」；刪除、推送、改正式設定的指令每次都看。被問太多次覺得煩，就改用 auto 模式，再用 deny 規則和 hooks 守住真正不能碰的東西。

對話太長：會自動壓縮，只在對話裡講的規則可能不見

對話接近上限時，Claude Code 會自動壓縮成摘要，完整的工具輸出和中間過程會消失。壓縮後，專案根目錄的 CLAUDE.md 和 auto memory 會從檔案重新載入，最近改過的檔案最多重讀 5 個。

實際上的意思是：

要一直遵守的規則寫進 CLAUDE.md，不要只在對話裡講一次。
一件事做完、要換主題時用 /clear 開新對話。
開始長任務前可以先 /compact 重點放在 XX，指定摘要要保留什麼。
用 /context 看還剩多少空間。

金鑰和密碼：不貼在對話裡，也不放進 Git

不要把 API 金鑰、資料庫密碼、私鑰貼進對話。 需要時讓服務自己的登入流程處理，或存在只有你看得到的設定檔。
存放密碼的檔案（.env 等）加進 .gitignore，再用 deny 規則禁止 Claude 讀取。
官方說明，登入憑證在 macOS 存在鑰匙圈，Linux 存在權限 0600 的檔案。
截圖給 Claude 或貼到網路上之前，遮掉 IP、帳號、token。

我實際怎麼用：Git、預覽、依影響決定要不要問我

Jason Finance 從第一個 commit 開始就是 Claude Code 在寫。幾個做法供參考：

Claude Code 住在主機上：一台 Oracle Cloud 的 ARM 主機，Remote Control 做成 systemd 服務，SSH 斷線後繼續運作。我用手機的 Claude App 連過去，用中文交代工作。
Git 就是內容管理系統：文章是 Markdown 檔，push 到 main 分支就自動部署。草稿先推到 preview 分支，產生含草稿的預覽網址給我看過才發佈。
依影響決定要不要問我：寫在 CLAUDE.md 裡。讀檔、測試、一般的 commit 直接做；發佈我沒看過的內容、改正式設定要我決定；刪資料開工前說明一次範圍和風險。細節在〈看不懂程式也能架網站〉。
規則寫成測試，不只寫在 CLAUDE.md：例如每篇文章一定要屬於一個主題、描述不能超過 160 字，不符合就建置失敗。CLAUDE.md 是背景資訊、可能被忽略，測試和 hooks 才擋得住。

整套網站怎麼架的見〈Jason Finance 從零到一〉。更多文章在 AI 創業主題頁。

常見問題

Claude Code 要付費嗎？免費方案可以用嗎？

依官方安裝說明，Claude Code 需要 Pro、Max、Team、Enterprise 或 Console 帳戶，免費的 claude.ai 方案不包含 Claude Code。也可以透過 Amazon Bedrock、Google Cloud 或 Microsoft Foundry 等第三方平台使用。

Claude Code 怎麼安裝？Windows 可以用嗎？

官方建議用原生安裝：macOS、Linux、WSL 在終端機執行官方安裝腳本，Windows 在 PowerShell 或 CMD 執行對應指令，不需要系統管理員權限。也可以用 Homebrew、WinGet 或 Linux 套件管理工具安裝，或改用 Desktop 桌面版。裝好後執行 claude --version 確認。