Claude Code 是 Anthropic 官方推出的 AI 原生編碼工具，將大語言模型能力深度集成至終端，支持通過自然語言完成代碼生成、重構(gòu)、調(diào)試、文檔編寫等全棧開發(fā)任務(wù)。區(qū)別于傳統(tǒng)補全工具，它可理解項目上下文，實現(xiàn)真正意義上的智能協(xié)作編程。

Claude Code 基于 Node.js 構(gòu)建，安裝前請確保系統(tǒng)已安裝 Node.js 18 或更高版本。安裝過程簡潔，通常僅需數(shù)分鐘。

為什么需要 Claude Code？

傳統(tǒng)開發(fā)需在編輯器、終端、瀏覽器與文檔間頻繁切換。Claude Code 將多工作流整合于統(tǒng)一終端界面：可同步編寫代碼、運行測試、查閱文檔、協(xié)同開發(fā)。其核心優(yōu)勢在于理解項目結(jié)構(gòu)、記憶編碼習慣，成為真正懂項目的編程助手。

安裝方法

方法一：手動安裝

適用于希望掌控全流程的開發(fā)者。

# 全局安裝 Claude Code CLI
npm install -g @anthropic-ai/claude-code

# 驗證安裝
claude --version

安裝過程中 npm 會自動下載依賴并配置環(huán)境變量。如遇權(quán)限問題，macOS/Linux 用戶可在命令前加 sudo，Windows 用戶請以管理員身份運行終端。

方法二：AI Agent 協(xié)助安裝

若已使用 Cursor、Windsurf 等 AI 編程助手，可交由其自動完成安裝。AI 將檢測環(huán)境、處理依賴沖突，并按系統(tǒng)配置選擇最優(yōu)安裝路徑。

輸入指令示例：

幫我裝 anthropic 的 claude code

或更明確地指定：

安裝 claude code cli，并檢查 Node.js 版本是否兼容

AI Agent 將自動執(zhí)行以下操作：

• 檢查當前 Node.js 版本
• 提示升級（如版本不兼容）
• 執(zhí)行安裝命令
• 驗證安裝結(jié)果
• 異常時嘗試自動修復(fù)

首次啟動與初始化

安裝完成后，進入項目目錄啟動：

# 進入項目目錄
cd /path/to/your/project

# 啟動 Claude Code
claude

首次啟動將引導(dǎo)完成關(guān)鍵初始化步驟，包括登錄 Anthropic 賬戶（無賬戶者系統(tǒng)將提示注冊）。

快速開始：做點小實驗

建議先通過三個漸進式實驗熟悉核心能力：自然語言理解、內(nèi)容生成與代碼執(zhí)行。

實驗 1：對話 —— 感受 AI 的理解能力

體驗 Claude Code 的上下文感知與多輪對話能力。

可嘗試以下提問：

你好，你是誰？
什么是閉包？太長不看版本
JavaScript 和 TypeScript 有什么區(qū)別？

觀察其“倒金字塔”式回答風格：先給核心結(jié)論，再展開細節(jié)，便于快速獲取關(guān)鍵信息。

實驗 2：生成 Markdown 文檔 —— 體驗內(nèi)容創(chuàng)作

輸入指令：

幫我寫一份 Git 常用命令的 Markdown 文檔
要求：包含命令、說明、示例

Claude Code 將自動分析需求、規(guī)劃結(jié)構(gòu)（按初始化、日常開發(fā)、分支管理等場景分類）、生成規(guī)范 Markdown 內(nèi)容，并輸出表格化速查表?？勺芳印疤砑又形淖⑨尅薄鞍词褂妙l率排序”等要求進一步優(yōu)化輸出。

核心技巧

技巧 1：雙擊 Esc 回退對話 —— 撤銷誤操作

最常用快捷鍵，用于高效修正交互失誤：

按一次 Esc → 清除當前輸入（類似 Ctrl+C）
按兩次 Esc → 回退至上一輪對話狀態(tài)
按三次 Esc → 清空全部對話歷史

適用場景：

• 誤發(fā)指令后快速撤回執(zhí)行
• 對回復(fù)不滿意，重新組織提問
• 多輪對話導(dǎo)致上下文混亂，一鍵重置

注意：雙擊 Esc 僅撤銷對話狀態(tài)，不撤銷已執(zhí)行的代碼修改。建議高風險操作前先執(zhí)行 git commit 或 git stash。

技巧 2：@ 引用文件 —— 精準指定上下文

顯式引用提升理解準確性，避免無關(guān)文件占用 Token：

推薦寫法：

@src/utils.ts 解釋這個文件

高級用法：

@src/app.tsx @src/components/Header.tsx 這兩個文件的關(guān)系是什么？
@src/components/ 總結(jié)一下這個目錄下的所有組件
@src/utils.ts:45-60 解釋這段代碼的作用

技巧 3：! 執(zhí)行命令 —— 終端集成

無需切換窗口即可運行終端命令：

!npm test        # 運行測試
!git status      # 查看 Git 狀態(tài)
!ls -la          # 列出文件

典型場景：

• !npm test → 測試失敗后讓 Claude 分析原因并修復(fù)
• !git diff → 讓 Claude 解讀變更內(nèi)容
• !npm run build → 構(gòu)建報錯時自動診斷修復(fù)

安全提示：對 rm -rf、sudo 等敏感命令，Claude Code 會強制二次確認。

技巧 4：/plan 先規(guī)劃后編碼 —— 復(fù)雜任務(wù)的正確打開方式

對耗時超 30 分鐘的任務(wù)，優(yōu)先使用 /plan 制定分階段實施計劃。

/plan
我想添加用戶認證功能，請幫我制定實施計劃

輸出為帶進度標記的結(jié)構(gòu)化方案（數(shù)據(jù)庫設(shè)計→API 開發(fā)→前端集成→測試），支持逐階段執(zhí)行與動態(tài)調(diào)整。

技巧 5：/init 自動生成配置 —— 快速初始化項目

/init 命令自動掃描項目，生成 CLAUDE.md 配置文件，作為 Claude Code 的“項目記憶”。

/init

生成內(nèi)容涵蓋技術(shù)棧（Next.js、TypeScript 等）、常用命令、代碼規(guī)范等。新項目初始化后建議立即執(zhí)行，團隊成員亦可據(jù)此快速上手。

技巧 6：/compact 壓縮上下文 —— 節(jié)省 Token

當對話達 5–6 輪或 Claude 出現(xiàn)“遺忘”跡象時，運行 /compact 提取關(guān)鍵信息生成摘要，釋放上下文窗口（默認 200K Token）。

# 長對話后壓縮
/compact

# 壓縮后繼續(xù)工作
現(xiàn)在我們已經(jīng)完成了用戶模塊，接下來做訂單模塊

技巧 7：/commit 自動提交 —— Git 工作流自動化

/commit 自動識別變更、生成符合 Conventional Commits 規(guī)范的提交信息。

/commit

支持進階用法：/commit --yes（跳過確認）、/commit --dry-run（僅生成不提交）。

技巧 8：Shift+Tab 自動接受 —— 提高流暢度

開啟后免確認直接應(yīng)用代碼修改，提升迭代效率。

• 按 Shift+Tab → 進入自動接受模式
• 再按 Shift+Tab → 退出模式

注意事項：敏感操作（如刪文件、改配置）仍會強制詢問；建議始終配合 Git 使用以便回滾。

技巧 9：Ctrl+C 取消操作 —— 緊急制動

中斷長時間運行任務(wù)或錯誤指令：

• 按一次 Ctrl+C → 取消當前操作
• 按兩次 Ctrl+C → 完全退出 Claude Code

與雙擊 Esc 的區(qū)別：Ctrl+C 停止執(zhí)行中任務(wù)；雙擊 Esc 撤銷對話歷史。

技巧 10：/context 查看上下文使用 —— 優(yōu)化 Token 消耗

/context 顯示實時 Token 占用、引用文件數(shù)及高消耗文件列表，輔助優(yōu)化成本。

/context

輸出含健康度評估與優(yōu)化建議（如將 node_modules 加入 .claudeignore）。

技巧 11：/resume 恢復(fù)會話 —— 切換多任務(wù)對話

在多任務(wù)并行時快速切換上下文，無需重啟：

/resume

支持場景：A）修復(fù) Bug 與開發(fā)新功能來回切換；B）臨時查詢算法后返回原開發(fā)任務(wù)；C）中斷后繼續(xù)未完成工作。

核心配置

配置文件位置與優(yōu)先級

Claude Code 采用分層配置機制，優(yōu)先級從高到低為：項目級 > 用戶級 > 默認配置。

CLAUDE.md —— 項目記憶

CLAUDE.md 是項目級核心配置文件，定義技術(shù)棧、代碼規(guī)范、常用命令等。每次啟動自動加載，是團隊協(xié)作與新人上手的關(guān)鍵文檔。

快速生成方式：

claude
/init

.claudeignore —— 節(jié)省 Token

聲明無需加載的文件/目錄，可降低 40–60% Token 消耗并提升響應(yīng)速度。

推薦配置項：

# ===== 依賴目錄 =====
node_modules/
.pnp/
.pnp.js

# ===== 構(gòu)建產(chǎn)物 =====
dist/
build/
.next/
out/
*.tsbuildinfo

# ===== 日志文件 =====
*.log
npm-debug.log*
yarn-debug.log*
...

# ===== 敏感信息 =====
.env
.env.local
.env.*.local

# ===== 大型資源文件 =====
*.png
*.jpg
*.svg
*.mp4

權(quán)限配置

通過 settings.json 中的 permissions 字段精細控制操作權(quán)限：

{
  "permissions": {
    "allow": ["Bash(git status)", "Edit(src/**/*.{ts,tsx})"],
    "ask": ["Bash(git commit:*)", "Edit(package.json)"],
    "deny": ["Bash(rm -rf:*)", "Bash(sudo:*)"]
  }
}

Rules 規(guī)則目錄

大型項目可將規(guī)范拆分為模塊化規(guī)則文件，存放于 .claude/rules/ 目錄下：

.claude/
├── settings.json
├── CLAUDE.md
└── rules/
    ├── 00-security.md     # 安全規(guī)則
    ├── 01-coding-style.md # 編碼風格
    ├── 10-api.md          # API 規(guī)范
    ├── 11-frontend.md     # 前端規(guī)范
    └── 20-testing.md      # 測試規(guī)范

數(shù)字前綴控制加載順序，支持全局規(guī)則與路徑特化規(guī)則的繼承與覆蓋。

核心操作指令

Slash 命令速查

標準化內(nèi)置功能，以 / 開頭：

符號系統(tǒng)

快捷操作符組合提升效率：

組合示例：

@src/utils.ts !npm test
@src/components/ @src/pages/ 比較這兩個目錄的結(jié)構(gòu)
!git diff @src/app.tsx 解釋這些變更

國內(nèi)使用方案

因網(wǎng)絡(luò)限制，中國用戶可采用以下方式接入：

方案 1：API 代理服務(wù)

# 設(shè)置環(huán)境變量
export ANTHROPIC_BASE_URL="https://your-api-proxy.com/v1"
export ANTHROPIC_API_KEY="your-api-key"
claude

方案 2：第三方兼容工具

# 安裝兼容版本
npm install -g @some-provider/claude-code

# 配置 API
claude config set api.key your-api-key
claude config set api.baseUrl https://api.some-provider.com

方案 3：替代工具