claude [options] [command] [prompt]

# 基礎(chǔ)用法：單次問答
claude -p "解釋這個函數(shù)的實現(xiàn)邏輯"

# 管道輸入：將文件內(nèi)容傳給 Claude 分析
cat src/main.js | claude -p "找出所有潛在的空指針問題"

# 管道輸出：將 Claude 的輸出傳給其他命令
claude -p "列出 src/ 下所有 Java 文件的用途" | grep "Controller"

# 結(jié)合 git 工作流：分析最近的提交
git log --oneline -20 | claude -p "總結(jié)最近的提交活動，按功能分類"

# 代碼生成到文件
claude -p "生成一個 Dockerfile，用于 Spring Boot 應用" > Dockerfile

# 指定模型的非交互查詢
claude -p "解釋這段代碼" --model opus

# 最簡單的繼續(xù)方式
claude -c

# 繼續(xù)會話并指定模型
claude -c --model opus

# 繼續(xù)會話并以特定模式運行
claude -c --effort max

# 交互式選擇器（列出所有歷史會話，支持搜索過濾）
claude -r

# 恢復到指定 UUID 的會話
claude -r abc123-def456-789

# 恢復并派生新會話（保留原會話的上下文但不修改它）
claude -r abc123-def456-789 --fork-session

# 恢復鏈接到某個 PR 的會話
claude -r --from-pr 123

# 創(chuàng)建命名 worktree
claude -w feature-refactor

# worktree + tmux 會話（多窗口管理）
claude -w feature-refactor --tmux

# worktree + 指定模型 + 高努力級別（復雜重構(gòu)）
claude -w major-refactor --model opus --effort max

claude --model opus
export ANTHROPIC_MODEL=claude-opus-4-8  # 持久化設(shè)置

claude -p "格式化 JSON" --effort low
claude --effort max --model opus   # 最強組合

claude -n "修復用戶登錄超時Bug"
claude -n "重構(gòu)支付模塊" --model opus --effort max

SESSION_ID=$(uuidgen)
claude --session-id $SESSION_ID -p "分析項目結(jié)構(gòu)"

claude --debug                    # 全部調(diào)試信息
claude --debug api                # 僅 API 調(diào)用日志
claude --debug hooks              # 僅 Hooks 執(zhí)行日志
claude --debug api,hooks          # 組合過濾
claude --debug api --debug-file ./debug.log  # 寫入文件

claude --verbose -p "分析這個文件"

claude --system-prompt "You are a Python code reviewer..."

claude --append-system-prompt "始終使用 Java 17 語法。所有 public 方法必須有 Javadoc。"
claude --append-system-prompt "$(cat custom-instructions.txt)"

claude --bare -p "快速查詢"

claude --permission-mode acceptEdits
claude --permission-mode plan       # 純分析，不修改

claude --allowedTools "Bash(git *) Read Edit Write"
claude --disallowedTools "Bash(rm *) Bash(sudo *)"

claude -p "分析錯誤日志" --output-format json --json-schema '{"type":"object",...}'

claude agents                                       # 啟動管理界面
claude agents --model sonnet --effort high           # 設(shè)置 Agent 默認參數(shù)
claude agents --json                                 # JSON 輸出（腳本監(jiān)控）
claude agents --cwd /path/to/project                 # 限定項目范圍

claude auth login --console                    # API Key 計費登錄
claude auth login --claudeai                   # Claude 訂閱登錄
claude auth login --sso                        # 企業(yè) SSO 登錄
claude auth login --email dev@company.com      # 預填郵箱

claude auth status                             # 查看登錄狀態(tài)
claude auth status --json                      # JSON 輸出（腳本檢測）
claude auth logout                             # 登出

# stdio 傳輸（本地進程）
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /tmp
claude mcp add postgres -e PG_HOST=localhost -e PG_PORT=5432 -- npx -y @modelcontextprotocol/server-postgres

# HTTP 傳輸（遠程服務）
claude mcp add --transport http my-api https://mcp.example.com/mcp
claude mcp add --transport http secure-api https://api.example.com/mcp --header "Authorization: Bearer xxx"

# OAuth 認證
claude mcp add --transport http oauth-server https://oauth.example.com/mcp --client-id "my-id" --client-secret

# 配置范圍
claude mcp add -s user filesystem -- npx @modelcontextprotocol/server-filesystem /tmp
claude mcp add -s project db-server -- npx @modelcontextprotocol/server-postgres

claude mcp list                              # 列出所有
claude mcp get filesystem                    # 查看詳情（含工具列表）
claude mcp remove filesystem                 # 刪除
claude mcp add-from-claude-desktop           # 從 Claude Desktop 導入
claude mcp serve                             # 啟動 Claude Code 作為 MCP 服務器

# 創(chuàng)建插件
claude plugin init my-skill                                   # 基礎(chǔ)腳手架
claude plugin init full-plugin --with skills,agents,hooks     # 含額外組件

# 安裝
claude plugin install my-plugin                               # 從市場安裝

# 查看
claude plugin list                                            # 已安裝列表
claude plugin list --available                                # 含市場可用
claude plugin details my-plugin                               # 組件清單 + token 估算

# 管理
claude plugin enable my-plugin                                # 啟用
claude plugin disable my-plugin                               # 禁用
claude plugin update my-plugin                                # 更新
claude plugin uninstall my-plugin                             # 卸載
claude plugin prune                                           # 清理無用的自動依賴
claude plugin validate ./my-plugin                            # 驗證清單格式
claude plugin tag ./my-plugin                                 # 創(chuàng)建發(fā)布 tag

claude ultrareview main                                      # 審查相對于 main 的變更
claude ultrareview 123                                       # 審查指定 PR
claude ultrareview main --json                               # JSON 輸出（自定義處理）
claude ultrareview main --timeout 60                         # 設(shè)置超時（默認 30 分鐘）

# 健康檢查 — 排查 CLI 安裝/配置問題
claude doctor

# 版本管理 — 安裝/切換 CLI 版本
claude install latest       # 最新版
claude install stable       # 穩(wěn)定版
claude install v2.1.168     # 指定版本

# 長期認證 — 避免反復登錄（需要 Claude 訂閱）
claude setup-token

# 項目清理 — 釋放磁盤空間
claude project purge --dry-run    # 預覽
claude project purge -i           # 交互式確認
claude project purge --all        # 清理所有項目

# 更新 CLI
claude update

# 自動模式 — 查看/優(yōu)化自動權(quán)限模式規(guī)則
claude auto-mode config           # 查看當前規(guī)則
claude auto-mode defaults         # 查看默認規(guī)則
claude auto-mode critique         # AI 評估自定義規(guī)則

/help

/clear

/compact

/cost

/context

/export                         # 導出到默認位置
/export ~/sessions/             # 導出到指定目錄

/resume                         # 打開交互式選擇器
/resume abc123                  # 恢復到指定會話

/model                          # 查看當前模型
/model opus                     # 切換：架構(gòu)設(shè)計 / 深度分析
/model sonnet                   # 切換：日常編碼（默認）
/model haiku                    # 切換：快速批量處理

/model opus     → "設(shè)計支付系統(tǒng)的微服務拆分方案"  (深度分析)
/model sonnet   → "按照方案實現(xiàn)支付模塊的代碼"    (快速編碼)

/fast                           # 啟用快速模式
/fast off                       # 關(guān)閉

/name 修復用戶模塊的死鎖問題

/review

/security-review

/code-review
/code-review --effort high      # 更深入的審查

/simplify

/verify

/fix                            # 修復最近討論的問題
/fix 登錄接口返回500錯誤         # 修復特定問題

/run                            # 按項目類型自動啟動
/run "啟動后端并測試登錄API"     # 帶指令啟動

/loop 5m /run "檢查健康狀態(tài)"     # 每5分鐘
/loop 30m "檢查部署狀態(tài)"          # 每30分鐘
/loop 1h /review                  # 每小時

/batch "將所有 Controller 層的異常處理統(tǒng)一為 GlobalExceptionHandler"
/batch "將所有 DAO 接口遷移到 JPA Repository"

/workflows                       # 查看工作流狀態(tài)
/workflows stop <id>             # 停止指定工作流

/tasks                           # 查看所有任務
/tasks add "修復登錄Bug"          # 添加
/tasks done 3                    # 完成編號為3的任務
/tasks priority 1 high           # 設(shè)置優(yōu)先級

/config                          # 交互式配置
/config theme                    # 配置主題
/config model                    # 配置默認模型

/settings                        # 打開項目級
/settings user                   # 打開用戶級
/settings local                  # 打開本地覆蓋

/permissions                           # 打開權(quán)限管理
/permissions allow "Bash(git *)"       # 添加允許
/permissions deny "Bash(rm *)"         # 添加拒絕

/hooks                                         # 查看當前 hooks
/hooks add postToolUse "python3 monitor.py"    # 添加 hook

/statusline                      # 交互式配置
/statusline enable               # 啟用
/statusline disable              # 禁用

/theme light                     # 淺色
/theme dark                      # 深色

/terminal-theme                  # 切換終端配色

/ide connect                     # 連接 IDE
/ide disconnect                  # 斷開
/ide status                      # 查看狀態(tài)

/agents                          # 查看運行中的 Agent
/agents spawn "審查代碼"          # 創(chuàng)建新 Agent
/agents stop <id>                # 停止 Agent

/memory                          # 查看所有記憶
/memory add "這個項目使用 Java 17" # 添加
/memory delete <id>              # 刪除

/init

/doctor

/upgrade                         # 檢查并安裝
/upgrade check                   # 僅檢查

/bug                             # 交互式提交
/bug "Hooks 在特定場景下不觸發(fā)"    # 快速提交

{
  "bindings": [
    { "key": "Ctrl+Q", "action": "quit" },
    { "key": "Ctrl+B", "action": "toggle-sidebar" },
    { "key": "Ctrl+G", "action": "open-git-panel" },
    { "key": "Ctrl+Shift+R", "action": "run-command:/review" },
    // 和弦鍵：先按 Ctrl+K，再按 Ctrl+B
    { "key": "Ctrl+K Ctrl+B", "action": "toggle-sidebar" }
  ]
}

1. .claude/settings.local.json  (本地)   ← 不提交 git，個人偏好
2. .claude/settings.json       (項目)    ← 提交 git，團隊共享
3. ~/.claude/settings.json     (用戶)    ← 全局默認

// 用戶級 → 所有項目的默認值
{ "model": "sonnet", "theme": "dark", "effort": "medium" }

// 項目級 → 團隊約定：這個項目需要 Opus 和高努力
{ "model": "opus", "effort": "max" }
// 實際生效：model=opus, effort=max, theme=dark（繼承）

// 本地級 → 個人 override
{ "theme": "light" }
// 實際生效：model=opus, effort=max, theme=light

claude --setting-sources user,project     # 忽略本地
claude --settings ./ci-settings.json      # 加載額外配置

{
  // ═══ 環(huán)境變量 ═══
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-api03-xxx",
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com",
    "ANTHROPIC_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_MAX_TOKENS": "8192",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-sonnet-4-6",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "75",
    "CLAUDE_CODE_EFFORT_LEVEL": "max",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "true",
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  },
  // ═══ 模型與努力 ═══
  "model": "sonnet",
  "effort": "max",
  // ═══ 外觀 ═══
  "theme": "dark",
  "alwaysThinkingEnabled": true,
  // ═══ 權(quán)限 ═══
  "permissions": {
    "allow": ["Bash(git:*)", "Bash(npm:*)", "Bash(mvn:*)", "Read", "Edit", "Write"],
    "deny": ["Bash(rm -rf:*)", "Bash(sudo:*)"],
    "defaultMode": "acceptEdits"
  },
  // ═══ 狀態(tài)欄 ═══
  "statusLine": {
    "type": "command",
    "command": "echo '?? $(basename $PWD) | ?? $(git branch --show-current 2>/dev/null)'"
  },
  // ═══ Hooks ═══
  "hooks": {
    "postToolUse": "python3 ~/.claude/scripts/monitor.py"
  }
}

# CLAUDE.md

## 項目概述
Spring Boot 3.2 + Vue 3 的監(jiān)控數(shù)據(jù)采集分析平臺。

## 技術(shù)棧
- Backend: Java 17 + Spring Boot 3.2.5 + JPA
- Frontend: Vue 3 + Vite + Element Plus
- DB: MySQL 8.0 + Flyway 遷移
- Cache: Redis 7

## 構(gòu)建命令
- 后端: `mvn clean package -DskipTests`
- 前端: `cd frontend && npm run dev`
- 測試: `mvn test -Dtest=ClassName#methodName`

## 代碼規(guī)范
- 所有 public 方法必須有 Javadoc
- Controller 層使用 @Valid 做參數(shù)校驗
- 異常統(tǒng)一由 GlobalExceptionHandler 處理

## API 路由
- /api/v1/** — 數(shù)據(jù)上報
- /admin/** — 管理后臺

cp ~/.claude/settings.json.bak.json ~/.claude/settings.json

{ "mcpServers": { "blender": { "command": "uvx", "args": ["blender-mcp"] } } }

{"display":"用戶命令","pastedContents":{},"timestamp":1781165706131,"project":"/path","sessionId":"uuid"}

agents/
├── anr-reviewer.md              # Android ANR 審查
├── gpu-cpu-reviewer.md          # GPU/CPU 性能審查
├── memory-leak-reviewer.md      # 內(nèi)存泄露審查
├── perf-integrator.md           # 性能審查整合
└── marketing-*.md               # 各平臺營銷策略師

skills/
├── figma-to-android/            # Figma → Android UI
├── self-evolution/              # 自進化（review.md + evolve.md）
├── android-code-style/          # Android 代碼規(guī)范
├── pdf/ docx/ pptx/ xlsx/      # 辦公文檔處理
└── ...                          # 20+ Skill

{ "pid":14464, "sessionId":"uuid", "cwd":"/path", "name":"task-name", "status":"idle" }

ls -la ~/.claude/backups/
cp ~/.claude/backups/.claude.json.backup.1781164919093 ~/.claude/settings.json  # 恢復

cd ~/.claude && git log --oneline -20    # 查看配置變更歷史

~/.claude/
├── ?? CLAUDE.md                   # 用戶全局指令
├── ?? settings.json               # 用戶全局配置
├── ?? settings.json.bak.json      # 配置備份
├── ?? .mcp.json                   # 用戶級 MCP 配置
├── ?? history.jsonl               # 命令歷史 (~200KB)
├── ?? .gitignore                  # Git 忽略規(guī)則
├── ?? .last-cleanup               # 清理時間戳
├── ?? mcp-needs-auth-cache.json   # MCP 認證緩存
│
├── ?? .git/                       # 配置版本控制
├── ?? agents/                     # 自定義 Agent (11個)
├── ?? skills/                     # 已安裝 Skill (20+)
├── ?? teams/                      # Agent Teams 配置
├── ?? scripts/                    # 輔助腳本 (monitor.py, auto_review.py)
├── ?? evolution/                  # 自進化 (changelog, logs, reviews)
│
├── ?? sessions/                   # 會話索引 (<pid>.json)
├── ?? session-env/                # 會話環(huán)境快照
├── ?? projects/                   # 項目狀態(tài) (<session>.jsonl + memory/)
├── ?? tasks/                      # 任務列表
├── ?? plans/                      # 計劃文檔
│
├── ?? file-history/               # 文件編輯歷史
├── ?? paste-cache/                # 粘貼緩存
├── ?? shell-snapshots/            # Shell 環(huán)境快照
├── ?? cache/                      # 通用緩存
├── ?? backups/                    # 配置備份 (~70KB×N)
│
├── ?? ide/                        # IDE 鎖文件
├── ?? telemetry/                  # 遙測隊列
└── ?? gomoku/                     # 五子棋存檔

claude project purge --dry-run    # 預覽
find ~/.claude/projects -name "*.jsonl" -mtime +7 -delete  # 清理7天前

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projects", "/tmp"]
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": { "PG_HOST": "localhost", "PG_PASSWORD": "${PG_PASSWORD}" }
    },
    "git": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-git", "/path/to/repo"]
    }
  }
}

{
  "mcpServers": {
    "sentry": {
      "transport": "http",
      "url": "https://mcp.sentry.dev/mcp",
      "headers": { "Authorization": "Bearer ${SENTRY_TOKEN}" }
    }
  }
}

用戶輸入命令
    ├── ?? preCommand     ← 命令執(zhí)行前
    ├── Claude 處理...
    │   ├── ?? preToolUse    ← 工具調(diào)用前
    │   ├── 工具執(zhí)行...
    │   └── ?? postToolUse   ← 工具調(diào)用后
    └── ?? postCommand    ← 命令執(zhí)行后

{
  "hooks": {
    "postToolUse": "python3 ~/.claude/scripts/monitor.py --tool '$tool_name' --exit '$exit_code'"
  }
}

{
  "hooks": {
    "preToolUse": "if echo '$tool_input' | grep -q 'rm -rf'; then echo '?? 危險操作已攔截'; exit 1; fi"
  }
}

{
  "hooks": {
    "postCommand": "git status --porcelain | grep -q '^M' && git add -A"
  }
}

{
  "hooks": {
    "postCommand": "osascript -e 'display notification \"命令執(zhí)行完畢\" with title \"Claude Code\"'"
  }
}

{
  "permissions": {
    "defaultMode": "acceptEdits",
    "allow": [
      "Bash(git:*)", "Bash(npm:*)", "Bash(mvn:*)", "Bash(docker:ps,logs,compose*)",
      "Bash(ls,cat,echo,pwd,mkdir,touch,cp,mv,find)",
      "Read", "Edit", "Write", "Glob", "Grep"
    ],
    "deny": ["Bash(rm -rf:*)", "Bash(sudo:*)", "Bash(curl:*)", "Bash(ssh:*)"]
  }
}

my-plugin/
├── plugin.json                  # 必需：插件元數(shù)據(jù)
├── SKILL.md                     # 必需：Skill 主文檔
├── agents/                      # 可選：自定義 Agent
├── hooks/                       # 可選：Hooks 配置
├── mcp/                         # 可選：MCP 配置
└── .claude/settings.local.json  # 插件級權(quán)限

# 1. 創(chuàng)建
claude plugin init my-plugin --with skills,agents,hooks,mcp

# 2. 編輯 SKILL.md 和 plugin.json

# 3. 本地驗證
claude plugin validate ./my-plugin
claude --plugin-dir ./my-plugin    # 本地測試

# 4. 發(fā)布
cd ./my-plugin && git init && git add -A && git commit -m "v1.0.0"
claude plugin tag .

---
name: security-auditor
description: 專注于安全漏洞審查的專家
model: opus
tools: Read, Grep, Glob, Bash(git *), Bash(grep *)
effort: xhigh
---

# 安全審查專家

## 審查重點
1. OWASP Top 10：注入、認證失效、敏感數(shù)據(jù)泄露
2. 認證與授權(quán)：JWT 使用、權(quán)限繞過、Session 安全
3. 注入攻擊：SQL 注入、命令注入、XSS
4. 數(shù)據(jù)保護：硬編碼密鑰、日志敏感信息

## 輸出格式
- 嚴重級別：Critical / High / Medium / Low
- 文件路徑 + 行號 + 問題描述 + 修復建議

claude --agent security-auditor
claude agents --agent my-agent --model sonnet

                 ┌─────────────┐
                 │  Team Lead  │  ← 協(xié)調(diào)，分配任務，匯總
                 └──────┬──────┘
         ┌──────────────┼──────────────┐
         ▼              ▼              ▼
  ┌───────────┐  ┌───────────┐  ┌───────────┐
  │ Code      │  │ Security  │  │ Test      │
  │ Reviewer  │  │ Auditor   │  │ Writer    │
  └───────────┘  └───────────┘  └───────────┘

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
claude --agent team-lead
# 在 Team Lead 中創(chuàng)建 Team、分配任務、派發(fā) Agent、匯總結(jié)果

export const meta = {
  name: 'comprehensive-review',
  description: '多維度代碼審查',
  phases: [
    { title: '掃描', detail: '掃描變更文件' },
    { title: '審查', detail: '并行審查' },
    { title: '驗證', detail: '交叉驗證' }
  ]
}

phase('掃描')
const changedFiles = await agent('列出變更文件', {
  schema: { type: 'object', properties: { files: { type: 'array' } } }
})

phase('審查')
const findings = await pipeline(
  [{ key: 'bugs' }, { key: 'security' }, { key: 'perf' }],
  dim => agent(`審查 ${dim.key}`, { schema: FINDINGS_SCHEMA }),
  review => parallel(
    review.findings.map(f => () =>
      agent(`驗證: ${f.title}`, { schema: VERDICT_SCHEMA })
    )
  )
)

return { confirmed: findings.flat().filter(f => f.verdict?.isReal) }

const result = await agent('分析代碼質(zhì)量')                    // 返回文本
const bugs = await agent('查找Bug', { schema: BUG_SCHEMA })  // 返回驗證過的 JSON
await agent('重構(gòu)', { isolation: 'worktree' })               // 隔離環(huán)境中運行
await agent('審查', { agentType: 'security-auditor' })       // 使用特定 Agent

// 所有任務并發(fā)，全部完成后返回
const results = await parallel([
  () => agent('任務A'),
  () => agent('任務B'),
  () => agent('任務C')
])

// 每個 item 獨立流經(jīng)所有階段，階段間不等待
const results = await pipeline(
  items,
  item => stage1(item),
  result => stage2(result)
)

phase('審查')          // 開始新階段
log('發(fā)現(xiàn) 5 個問題')    // 輸出進度

執(zhí)行 → 監(jiān)控 → 復盤 → 改寫 → 沉淀 → (反饋到下次執(zhí)行)

claude --ide              # 啟動時連接 IDE
claude --chrome           # Chrome 集成
/ide connect              # 會話中連接
Ctrl+Shift+I              # 快捷鍵

claude -c                                       # 繼續(xù)昨天
# 在會話中：討論 → 生成代碼 → /run → /fix → /review → commit

# 快速審查
/review → /code-review → /simplify

# 深度審查（重要 PR）
claude ultrareview main --timeout 60

claude -w refactor --model opus --effort max    # 隔離環(huán)境
/batch "將認證模塊從 Session 遷移到 JWT"         # 批量執(zhí)行
/review → /verify                                # 審查驗證

claude -p "審查這次變更：$(git diff origin/main...HEAD)" \
  --output-format json --permission-mode bypassPermissions

claude -p "修復 lint 錯誤：$(npm run lint 2>&1)" \
  --permission-mode bypassPermissions

/loop 10m /run "檢查 API 健康"
/loop 1h "檢查過去1小時的應用日志，報告新增錯誤"

claude mcp add db -e PG_HOST=prod -- npx @modelcontextprotocol/server-postgres
# 在會話中自然語言："查詢今天 crash_log 表的錯誤分布"
claude mcp remove db                             # 用完移除