第一次啟動與登入

3.1　啟動並登入：打一個字，開門

安裝那關過了，現在來真的。啟動 Claude Code 只要做三件事：先走進你的專案資料夾、打一個字 claude、然後用瀏覽器登入一次。登入這件事一輩子只要做一次——之後它會記得你，下次直接開工。下面一步一步帶你做。

開始前先確認一件事：你要在「哪個資料夾」裡叫醒它。Claude Code 會以你「現在所在的資料夾」當作工作的專案，所以第一步是先走進去。沒有專案的話，就用第 1 章建立的 my-project 練習資料夾。

1. 1
   ✋動手做

   先走進你的專案資料夾

   複習第 1 章學的 cd 指令——它的意思就是「走進某個資料夾」。打 cd 加上你的資料夾名稱，按 Enter。如果你跟著第 1 章建立 my-project，就用下面這行。

   Windows Mac Linux

   💡

   cd my-project 說找不到？不要猜路徑

   回到第 1 章 1.6，先輸入 cd （後面留一個空格），把你建立的 my-project 資料夾直接拖進終端機，再按 Enter。終端機會填入它的完整實際路徑；進去後再打 claude。Windows 請在 Windows Terminal 的 PowerShell 分頁做這件事。

2. 2
   ✋動手做

   打一個字 claude，按 Enter

   走進資料夾後，輸入下面這個字，按 Enter。這就是「叫醒」Claude Code 的開門咒。

   claude

   複製
3. 3

   第一次啟動，它會請你登入

   第一次執行 claude，它會停下來請你登入。畫面會列出幾個登入選項，你挑一個最符合你身分的就好（提醒一下：純免費、沒有訂閱的 claude.ai 帳號目前不能用 Claude Code，至少要 Pro 以上的訂閱，或用下面其他管道登入）：

   • Claude 訂閱帳號（Pro / Max） — 最常見的選擇。如果你平常就在用 claude.ai 聊天，用同一個帳號登入就對了。
   • Claude for Teams 或 Enterprise — 公司幫你開的團隊／企業方案帳號。如果你的 Claude 是公司統一管理、發給你用的，就選這個用團隊帳號登入。
   • Anthropic Console（API，預付額度） — 走用多少付多少的方式。第一次用它登入，系統會自動幫你在 Console 開一個叫「Claude Code」的工作區，方便你日後集中查花了多少錢。
   • （公司／企業使用者） 也支援 Amazon Bedrock、Google Vertex AI、Microsoft Foundry——這幾個一般個人用不到，看不懂可以直接略過。

   ⚠️

   登入前先選對身分：三個安全關卡

   • 沒有帳號或沒有可用方案：先停在這裡。不要借用別人的帳號、不要從網路找 API key；請到官方 Claude／Anthropic 網站自行建立帳號並選擇適合的方案，或改向管理者確認可用管道。
   • 個人 Pro／Max 方案：選個人訂閱登入，瀏覽器開啟後先確認顯示的是你自己的帳號與 email，再按授權。不要在共用電腦勾選記住登入狀態。
   • 公司管理的 Teams／Enterprise 帳號：只用公司指定的身分與 SSO 流程；若畫面顯示沒權限、帳號不對或政策不允許，找 IT／管理員處理，不要改用個人帳號、Console API key 或其他方式繞過公司政策。

   授權頁面網址或要求看起來不對時，不要輸入密碼、驗證碼或批准；關掉後從 Claude Code 顯示的官方流程重新開始。

   想知道原理：為什麼花費要集中在 Console 看？

   如果你選的是「Anthropic Console（API，預付額度）」這種按用量付費的方式，系統會自動幫你在 Console 開一個叫「Claude Code」的工作區。把所有花費集中在這一個工作區裡，你日後查帳、看這個月花了多少、設用量上限，全在同一個地方一目了然，不會散落各處找不到。用「訂閱帳號」登入的人則是吃方案額度，不走這個按量計費的工作區，可以略過這段。

4. 4
   ✋動手做

   跳出瀏覽器，點「同意」就完成

   選好登入方式後，它會自動幫你打開瀏覽器、帶到授權頁面。在那頁先確認是預期的官方帳號與授權內容，再點「同意（Authorize）」並切回終端機——登入就完成了。整個過程你只是在瀏覽器點一下，不用打任何指令。多數人到這裡就結束；SSH、既有 WSL2、遠端容器等進階環境才需要 3.6 的備用做法，Windows 新手不必為此改用 WSL。

   ✅ 預期會看到

   # 回到終端機後，大致會看到歡迎畫面（實際文字依版本略有不同）
   ╭─────────────────────────────────────╮
   │  ✻ Welcome to Claude Code            │
   ╰─────────────────────────────────────╯
    登入成功，可以開始工作了

   複製

3.2　認識畫面：兩種指令別搞混

登入後，你會看到 Claude Code 的歡迎畫面。上面有這次工作階段（也就是 session）的基本資訊、你最近的幾次對話、還有最新更新消息。先別急著研究每個字，這畫面就像剛打開一個 App 的首頁，看過去有印象就好。

這裡有三個你馬上能用、又很實用的指令：

• 打 /help（按 Enter）→ 列出所有你能用的指令。忘記有哪些功能時，先打它準沒錯。
• 打 /resume（按 Enter）→ 接續之前某一次對話，從上次停的地方繼續。
• 打 /status（按 Enter）→ 唯讀顯示你目前的登入狀態：用哪個帳號、哪種方式登入。之後如果覺得登入行為怪怪的，先打這個看一眼，比用猜的準。

但這裡有個新手最容易搞混的地方，現在先講清楚，後面就不會卡：有兩種「指令」，打的地方不一樣、長相也不一樣。 看下面這張表分清楚：

3.3　你的第一個對話

畫面認得了，來說第一句話。進到 Claude 之後，你就像跟同事講話一樣直接打字——中文、英文都行，打完按 Enter 送出。不用學什麼特殊語法，想問什麼就問什麼。我們先試一句最有用的：

1. 1
   ✋動手做

   問它「這個專案在做什麼？」

   直接打下面這句話，按 Enter 送出。送出後，Claude 會自己去翻你資料夾裡的檔案，再給你一份白話摘要——你完全不用手動把檔案內容貼給它，這正是它和一般聊天 AI 最不一樣的地方。

   這個專案在做什麼？

   複製

   ✅ 預期會看到

   # Claude 讀完檔案後，大致會這樣回你（內容依你的專案而不同）
   我看了一下這個專案，它主要是…（接著是一段白話摘要）

   複製
2. 2
   ✋動手做

   再追問一句，感受一下

   同一個對話裡可以一直追問。試試再打這句、按 Enter，看它怎麼回：

   這個專案用了哪些技術？

   複製

3.4　安全機制（這節務必看完）

這節短，但請務必看完——它關係到你的檔案安不安全。最重要的一句話先講：Claude Code 要動你的檔案之前，一定會先問過你、等你點頭才動手。 它不會趁你不注意偷改東西。

預設情況下，它走的是「詢問（Ask）」模式：它會先把「我打算這樣改」攤在你面前，等你按下批准，才會真的動手。你有兩種核准方式：

• 逐項核准：它每要改一個地方，就問你一次，你看一個、答應一個。看得最清楚，最適合新手。
• Accept all（全部接受）：一次放行，讓它在這趟工作階段裡不再每次問你。方便，但你就比較看不到它每一步在做什麼。

3.5　結束、重開、接續對話

今天玩夠了想收工，或下次想接著上次繼續，都很簡單。這節把「關掉、重開、接續」三件事一次講完。

要結束時

想關掉 Claude Code，有兩種方法，挑順手的：

• 打 /exit（按 Enter）。
• 或連按兩次 Ctrl + C。

下次要回來工作時

下次想繼續，跟今天開機一樣，先走進資料夾、再啟動。如果想直接從上次停的地方接著聊，可以用「接續」的方式，省得重講一遍前情提要：

1. 打開終端機，用 cd 走進你的專案資料夾。
2. 打 claude 重新開始；
3. 或打 claude -r，直接接續上一次的對話（也可以先進去、再打 /resume）。

💡 建議執行：接續上一次對話

# 接續上一次的對話（會列出清單讓你挑）
claude -r

# 接續「最近一次」對話（不用選，直接接最後那次）
claude -c

想切換帳號，或懷疑登入怪怪的，就重新登入一次

如果你想換另一個帳號登入（例如公司帳號換回個人帳號），或覺得目前的登入狀態哪裡不太對勁，不用重灌、也不用刪設定檔，先試最乾淨的做法：登出、再重新走一次登入流程。

# 登出目前的帳號
/logout

# 重新登入（會再跳出瀏覽器，走一次登入流程）
/login

多數說不出原因的登入怪問題，/logout 後重新 /login 一次就能解決，比對照一堆設定慢慢查快得多。

3.6　登入卡住了？對症下藥

登入偶爾會卡關，這很正常，多半不是你操作錯誤，而是環境（遠端連線、舊設定殘留、系統鎖住）在搗蛋。下面把新手最容易遇到的幾種登入怪狀況列出來，照著對就好。

3.7　進階：多帳號、CI 自動化與長效登入

這節帶一點進階但實際用得到的技巧，服務兩種人：手上同時管著好幾個 Claude 帳號的人，還有想讓 Claude Code 在排程任務、CI（程式碼自動建置測試的流程）這類「沒有瀏覽器、沒有人在旁邊按同意」的環境裡自動跑的人。新手可以先跳過這節，之後真的碰到類似需求再回來看。

同時管好幾個帳號，不用一直登出登入

Claude Code 預設把所有東西（登入憑證、快取、個人設定）都塞進同一個地方。如果你要在「公司帳號」和「個人帳號」之間切換，每次都 /logout、/login 太累人，還容易混淆——這時候可以幫每個帳號分開一個獨立的設定資料夾，讓兩邊互不干擾。

💡 建議指令：用環境變數指定各帳號自己的設定資料夾

# 用一個獨立的資料夾啟動「公司帳號」的 session，跟個人帳號的設定分開
CLAUDE_CONFIG_DIR="$HOME/.claude-team" claude

每次打整串太麻煩的話，可以包成一個捷徑指令（shell 的 alias），寫進你的 shell 設定檔裡，之後打一個好記的名字就能啟動：

# 寫進 ~/.zshrc 或 ~/.bashrc，之後打 claude-team 就能直接切換
alias claude-team='CLAUDE_CONFIG_DIR="$HOME/.claude-team" claude'

甚至可以在啟動時順手換個顏色主題（/color），讓畫面一眼就能分辨自己現在是在哪個帳號的 session 裡，降低手滑用錯帳號改錯專案的風險。

沒有瀏覽器的環境：CI、排程任務要怎麼登入

前面教的登入方式都要「跳出瀏覽器、點一下同意」，但排程任務、CI 伺服器這類沒有人盯著螢幕的環境做不到這件事。官方為此準備了一個指令，可以先在自己電腦上手動登入一次，換來一組長效的通行憑證，之後就能讓腳本免互動直接使用。

💡 建議指令：產生長效登入憑證

# 走一次互動登入，成功後會直接把長效憑證印在終端機上（不會自動存檔）
claude setup-token

把印出來的那串內容存成環境變數 CLAUDE_CODE_OAUTH_TOKEN，排程腳本啟動時讀取它，就不用每次都手動登入。幾件要注意的事：這組憑證用的是你的訂閱額度（要 Pro／Max／Team／Enterprise 其中一種方案才能用），效期以官方當下設定為準（目前公告是一年），而且只能用來跑 Claude、不能拿來開遠端遙控（Remote Control）session。如果你的自動化改用 --bare 模式啟動，這個環境變數不會被讀取，得改用 API key 或自訂的驗證腳本，這已經是更進階的企業用法，一般個人使用者用不到，這裡先知道有這回事就好。

本章小結

恭喜你！從「裝好」到「真正開始用」這一關，你已經跨過去了。現在你會的事情有：走進專案資料夾、用 claude 叫醒它、登入一次、跟它說第一句話、看懂它要改檔時的核准提示，還會關掉和接續對話，遇到登入卡關也知道從哪裡查起。