官方教學中文版入門與安裝
Claude Code 入門與安裝
Claude Code 入門與安裝:用 4 章完成產品定位、安裝更新、登入認證、平臺入口選擇,先把終端、桌面應用、IDE、網頁和雲供應商邊界理清。
📖 本篇術語速查表
| 英文 / 縮寫 | 中文 | 一句話解釋 |
|---|---|---|
| 入門 | getting started | 裝好用上的第一組。 |
| 前提 | prerequisite | 賬號 / 訂閱 / 環境。 |
| 閱讀順序 | order | 從安裝到首次使用。 |
不想讀完?把下面這段提示詞丟給 AI 幫你跑完——幫你規劃 Claude Code 官方入門這一組從哪開始。
你是 Claude Code 入門導航顧問。
【角色】
Claude Code 入門導航顧問,按最小夠用、安全優先的原則給可落地方案,每條結論都落到能照做的具體步驟或示例,不停留在「建議」「考慮一下」這類空泛表述。
【輸入】
- 我對 Claude Code 的瞭解:___
- 是否已有訂閱:___
- 系統環境:___
- 想多快上手:___
- 經驗水平:___
【工作流程】
1. 確認前提
2. 排閱讀順序
3. 標出可跳過的
4. 給上手驗證
5. 給第一步
【輸出規範】
▌一、前提
▌二、閱讀順序
▌三、可跳過項
▌四、驗證 + 第一步
【硬約束】
- 前提缺失先補
- 按基礎定順序
- 先跑通再深入
- 不要替我臆測情況或編造不存在的功能,資訊不全先問清
- 不確定的設定或介面一律以官方文件為準,禁止照搬過時寫法這一組解決一個問題:先讓 Claude Code 在你的真實環境里正確跑起來。不要一上來就配 MCP、Hooks(鉤子)或 Subagents(子 Agent);先確認它是什麼、裝在哪、用哪個賬號登入、日常入口選哪一個。
適合從這裡開始的人:第一次安裝 Claude Code、換電腦重灌、登入方式混亂、終端 / 桌面應用 / IDE / 網頁入口不知道怎麼選,或者要給團隊寫一份最小上手路徑。
1. 這一組包含什麼
入門與安裝一共 4 章:
- Claude Code 是什麼:先理解它不是聊天框,而是進入專案現場的智慧體式程式設計工具(agentic coding tool)。
- 安裝和更新 Claude Code:選擇官方原生安裝器(native installer)、Homebrew、WinGet 或 Linux 包管理器,並驗證 PATH(命令搜尋路徑)、
claude doctor和更新策略。 - 登入與認證:區分 Claude.ai 訂閱、Console API key(控制台 API 金鑰)、Teams、Enterprise、Bedrock、Vertex AI、Microsoft Foundry。
- 選擇平臺與整合:判斷日常主入口用 CLI(終端命令列)、Desktop(桌面應用)、IDE、Web(網頁)、Mobile(移動端)、Slack 還是 CI/CD。
flowchart TD
Concept["理解產品定位"]
Install["安裝和更新"]
Auth["登入與認證"]
Platform["選擇平臺入口"]
Core["進入核心設定"]
Concept --> Install
Install --> Auth
Auth --> Platform
Platform --> Core
style Concept fill:#e0f2fe,stroke:#0284c7,stroke-width:2px
style Auth fill:#fef3c7,stroke:#f59e0b,stroke-width:2px
style Core fill:#dcfce7,stroke:#22c55e,stroke-width:2px
2. 章節入口
Claude Code 是什麼
先理解產品定位、智慧體迴圈、適合任務和不適合任務,再決定要不要安裝。
安裝和更新 Claude Code
按系統選擇安裝方式,處理 PATH、版本驗證、claude doctor、混裝和更新策略。
登入與認證
個人、團隊、Console、Bedrock、Vertex AI、Microsoft Foundry 的認證路徑和優先順序。
選擇平臺與整合
終端、桌面應用、IDE、網頁、移動端、Slack、CI/CD 各自適合什麼任務。
3. 推薦閱讀順序
新手按這個順序讀:
- 先讀“Claude Code 是什麼”,確認它適合你的工作方式。
- 再讀“安裝和更新 Claude Code”,按你的系統選一個安裝路徑,不要混裝。
- 然後讀“登入與認證”,避免 Claude.ai、Console API key(控制台 API 金鑰)和雲供應商憑據互相覆蓋。
- 最後讀“選擇平臺與整合”,確定日常主入口。
如果你已經裝好了,可以按問題跳:
claude命令不存在:看安裝章節的 PATH(命令搜尋路徑)和claude doctor。- 版本不對或更新混亂:看安裝章節的更新策略和混裝排查。
- 登入後還是不能用:看認證章節的憑據優先順序。
- 團隊要接 Bedrock / Vertex / Foundry:看認證章節的企業雲供應商部分。
- 不知道終端、桌面應用、IDE、網頁入口怎麼選:看平臺章節的入口矩陣。
4. 先不要做什麼
入門階段先不要急著做這些:
- 一上來開放
bypassPermissions。 - 直接接很多 MCP。
- 把團隊所有規則塞進
CLAUDE.md。 - 先寫 Hooks(鉤子)、Skills(技能)、Subagents(子 Agent)。
- 把 Claude Code SDK 接進產品。
這些都屬於後續章節。入門階段的目標是先得到一個穩定、可解釋、可復現的本機入口。
安裝完成不等於設定完成:能執行 claude 只是第一步。真正穩定使用前,還要繼續讀 settings、permissions 和 memory。
5. 完成後的驗收標準
讀完這一組,你應該能做到:
- 能解釋 Claude Code 和普通聊天式程式設計助手的區別。
- 能在自己的系統上安裝並驗證版本。
- 能執行
claude doctor或等價診斷流程。 - 能說清目前登入走的是 Claude.ai、Console、Bedrock、Vertex AI 還是 Foundry。
- 能判斷日常主入口用終端、桌面應用、IDE 還是網頁。
- 能知道什麼時候需要移動端、Slack、GitHub Actions 或 CI/CD 整合。
- 能進入下一組核心設定,而不是繼續靠預設設定亂跑。