| name | claude-code-guide |
| description | Claude Code 高階開發指南 - 全面的中文教程,涵蓋工具使用、REPL 環境、開發工作流、MCP 整合、高階模式和最佳實踐。適合學習 Claude Code 的高階功能和開發技巧。 |
Claude Code 高階開發指南
全面的 Claude Code 中文學習指南,涵蓋從基礎到高階的所有核心概念、工具使用、開發工作流和最佳實踐。
何時使用此技能
當需要以下幫助時使用此技能:
- 學習 Claude Code 的核心功能和工具
- 掌握 REPL 環境的高階用法
- 理解開發工作流和任務管理
- 使用 MCP 整合外部系統
- 實現高階開發模式
- 應用 Claude Code 最佳實踐
- 解決常見問題和錯誤
- 進行大檔案分析和處理
快速參考
Claude Code 核心工具(7個)
-
REPL - JavaScript 執行時環境
- 完整的 ES6+ 支援
- 預載入庫:D3.js, MathJS, Lodash, Papaparse, SheetJS
- 支援 async/await, BigInt, WebAssembly
- 檔案讀取:
window.fs.readFile()
-
Artifacts - 視覺化輸出
- React, Three.js, 圖表庫
- HTML/SVG 渲染
- 互動式元件
-
Web Search - 網路搜尋
-
Web Fetch - 獲取網頁內容
-
Conversation Search - 對話搜尋
-
Recent Chats - 最近對話
-
End Conversation - 結束對話
大檔案分析工作流
wc -l filename.md
wc -w filename.md
wc -c filename.md
grep "^#{1,6} " filename.md
grep "```" filename.md
grep -c "keyword" filename.md
Read filename.md offset=0 limit=50
Read filename.md offset=N limit=100
Read filename.md offset=-50 limit=50
REPL 高階用法
const data = [1, 2, 3, 4, 5];
const sum = data.reduce((a, b) => a + b, 0);
_.chunk([1, 2, 3, 4], 2);
math.sqrt(16);
d3.range(10);
const content = await window.fs.readFile('path/to/file');
const result = await fetch('https://api.example.com/data');
const json = await result.json();
斜槓命令系統
內建命令:
/help - 顯示幫助
/clear - 清除對話
/plugin - 管理外掛
/settings - 配置設定
自定義命令:
建立 .claude/commands/mycommand.md:
根據需求執行特定任務的指令
使用:/mycommand
開發工作流模式
1. 檔案分析工作流
ls -la
Read file.py
grep "function" file.py
2. 演算法驗證工作流
3. 資料探索工作流
核心概念
工具許可權系統
自動授予許可權的工具:
- REPL
- Artifacts
- Web Search/Fetch
- Conversation Search
需要授權的工具:
- Bash (讀/寫檔案系統)
- Edit (修改檔案)
- Write (建立檔案)
專案上下文
Claude 自動識別:
- Git 倉庫狀態
- 程式語言(從副檔名)
- 專案結構
- 依賴配置
記憶體系統
對話記憶體:
- 儲存在當前會話
- 200K token 視窗
- 自動上下文管理
持久記憶體(實驗性):
MCP 整合
什麼是 MCP?
Model Context Protocol - 連線 Claude 到外部系統的協議。
MCP 伺服器配置
配置檔案:~/.config/claude/mcp_config.json
{
"mcpServers": {
"my-server": {
"command": "node",
"args": ["path/to/server.js"],
"env": {
"API_KEY": "your-key"
}
}
}
}
使用 MCP 工具
Claude 會自動發現 MCP 工具並在對話中使用:
"使用 my-server 工具獲取資料"
鉤子系統
鉤子型別
在 .claude/settings.json 配置:
{
"hooks": {
"tool-pre-use": "echo 'About to use tool'",
"tool-post-use": "echo 'Tool used'",
"user-prompt-submit": "echo 'Processing prompt'"
}
}
常見鉤子用途
- 自動格式化程式碼
- 執行測試
- Git 提交檢查
- 日誌記錄
- 通知傳送
高階模式
多代理協作
使用 Task 工具啟動子代理:
"啟動一個專門的代理來最佳化這個演算法"
子代理特點:
智慧任務管理
使用 TodoWrite 工具:
"建立任務列表來跟蹤這個專案"
任務狀態:
pending - 待處理
in_progress - 進行中
completed - 已完成
程式碼生成模式
漸進式開發:
- 生成基礎結構
- 新增核心功能
- 實現細節
- 測試和最佳化
驗證驅動:
- 寫測試用例
- 實現功能
- 執行測試
- 修復問題
質量保證
自動化測試
npm test
pytest
mypy script.py
tsc --noEmit
eslint src/
flake8 .
程式碼審查模式
使用子代理進行審查:
"啟動程式碼審查代理檢查這個檔案"
審查重點:
錯誤恢復
常見錯誤模式
-
工具使用錯誤
-
檔案操作錯誤
-
API 呼叫錯誤
漸進式修復策略
- 隔離問題
- 最小化復現
- 逐步修復
- 驗證解決方案
最佳實踐
開發原則
- 清晰優先 - 明確需求和目標
- 漸進實現 - 分步驟開發
- 持續驗證 - 頻繁測試
- 適當抽象 - 合理模組化
工具使用原則
- 正確的工具 - 選擇合適的工具
- 工具組合 - 多工具協同
- 許可權最小化 - 只請求必要許可權
- 錯誤處理 - 優雅處理失敗
效能最佳化
- 批次操作 - 合併多個操作
- 增量處理 - 處理大檔案
- 快取結果 - 避免重複計算
- 非同步優先 - 使用 async/await
安全考慮
沙箱模型
每個工具在隔離環境中執行:
- REPL:無檔案系統訪問
- Bash:需要明確授權
- Web:僅特定域名
最佳安全實踐
- 最小許可權 - 僅授予必要許可權
- 程式碼審查 - 檢查生成的程式碼
- 敏感資料 - 不要共享金鑰
- 定期審計 - 檢查鉤子和配置
故障排除
工具無法使用
症狀: 工具呼叫失敗
解決方案:
- 檢查許可權設定
- 驗證語法正確
- 確認檔案路徑
- 檢視錯誤訊息
REPL 效能問題
症狀: REPL 執行緩慢
解決方案:
MCP 連線失敗
症狀: MCP 伺服器無響應
解決方案:
- 檢查配置檔案
- 驗證伺服器執行
- 確認環境變數
- 檢視伺服器日誌
實用示例
示例 1:資料分析
const data = await window.fs.readFile('data.csv');
const parsed = Papa.parse(data, { header: true });
const values = parsed.data.map(row => parseFloat(row.value));
const avg = _.mean(values);
const std = math.std(values);
console.log(`平均值: ${avg}, 標準差: ${std}`);
示例 2:檔案搜尋
grep -r "TODO" src/
find . -name "*.py" -type f
示例 3:網路資料獲取
"使用 web_fetch 獲取 https://api.example.com/data 的內容,
然後在 REPL 中分析 JSON 資料"
參考檔案
此技能包含詳細文件:
- README.md (9,594 行) - 完整的 Claude Code 高階指南
包含以下主題:
- 核心工具深度解析
- REPL 高階協同模式
- 開發工作流詳解
- MCP 整合完整指南
- 鉤子系統配置
- 高階模式和最佳實踐
- 故障排除和安全考慮
使用 view 命令檢視參考檔案獲取詳細資訊。
資源
注意事項
本指南結合了:
- 官方功能和公告
- 實際使用觀察到的模式
- 概念性方法和最佳實踐
- 第三方工具整合
請在使用時參考最新的官方文件。
使用這個技能深入掌握 Claude Code 的強大功能!