Go back

目录

Claude Code 完整命令文档：掌握Anthropic官方CLI工具的终极指南

Claude Code 完整命令文档：掌握Anthropic官方CLI工具的终极指南

Published:  at  10:00 AM
✏️ 编辑文章

前言

Claude Code是Anthropic官方推出的强大CLI工具，为开发者提供了丰富的命令行接口和交互式功能。作为新一代AI辅助开发工具，Claude Code不仅支持基础的对话功能，还提供了项目管理、代码审查、自动化部署等专业功能。本文将为您详细介绍Claude Code的所有可用功能，帮助您充分发挥这一强大工具的潜力。

📚 知识点注释：CLI（Command Line Interface）是命令行界面的缩写，允许用户通过文本命令与计算机系统进行交互，相比图形界面具有更高的效率和自动化潜力。

无论您是刚接触Claude Code的新手，还是希望深入了解高级功能的资深开发者，这份完整文档都将为您提供所需的知识和技巧。

Table of contents

概述

Claude Code 是 Anthropic 官方的 CLI 工具，提供了丰富的命令行接口和交互式功能。本文档详细介绍了所有可用的斜杠命令、CLI 选项和自定义功能。

Claude Code的核心优势：

📚 知识点注释：MCP（Model Context Protocol）是一种标准化协议，允许AI模型与外部工具和服务进行安全、高效的交互。

内置斜杠命令

核心交互命令

Claude Code的核心交互命令为用户提供了基础的操作和信息查询功能：

会话管理

会话管理功能让您能够更好地组织和跟踪开发过程：

配置和管理

项目管理

账户管理

系统工具

MCP 集成

CLI 命令行选项

基本交互模式

Claude Code提供了多种启动和交互方式，满足不同的使用场景：

# 基础交互模式
claude                    # 启动交互式 REPL
claude "query"            # 使用初始提示启动 REPL  
claude -p "query"         # 通过 SDK 查询并退出

📚 REPL说明：REPL（Read-Eval-Print Loop）是交互式编程环境，允许用户输入命令并立即看到结果，非常适合探索性开发和快速原型制作。

会话管理选项

# 会话持久化功能
claude -c                 # 继续最近的对话
claude -r "<session-id>"   # 恢复特定会话
claude update             # 更新到最新版本

📚 会话恢复技巧：

  • 使用-c参数可以无缝继续上次的工作，保持上下文连续性
  • 会话ID可以通过/status命令查看
  • 建议定期更新以获得最新功能和安全修复

主要 CLI 标志详解

标志功能说明使用场景
--add-dir添加工作目录多模块项目管理
--allowedTools指定允许的工具安全限制和权限控制
--print/-p无交互模式打印响应脚本自动化和批处理
--output-format设置响应格式API集成和数据处理
--verbose启用详细日志调试和问题诊断
--max-turns限制代理回合数控制对话长度和成本
--model选择特定模型性能和成本优化
--permission-mode设置权限上下文企业安全管理

📚 输出格式选项：

  • text：适合人类阅读的纯文本格式
  • json：适合程序处理的结构化数据
  • stream-json：适合实时处理的流式数据

管道支持和自动化

# 高级管道操作示例
cat file | claude -p "query"              # 通过管道传输内容
ls *.py | claude -p "分析这些Python文件"    # 批量文件分析
git diff | claude -p "审查这次代码变更"     # 代码审查自动化

📚 自动化最佳实践：

  • 管道支持使Claude Code能够轻松集成到现有的开发工作流中
  • 可以与git hooks结合实现自动化代码审查
  • 支持与CI/CD流水线集成

自定义命令系统

创建自定义命令

Claude Code的自定义命令系统为开发者提供了强大的扩展能力。自定义命令可以在以下位置创建：

命令文件位置：

📚 命令优先级：项目级别的命令会覆盖同名的用户级别命令，这允许项目有特定的自定义行为。

命令语法和功能

基本命令创建

# 创建简单的响应命令
echo "自定义命令响应" > .claude/commands/mycommand

# 创建带参数的命令
echo "处理参数: $ARGUMENTS" > .claude/commands/with-args

# 执行系统命令
echo "!ls -la" > .claude/commands/listfiles

# 引用和分析文件
echo "检查文件: @filename" > .claude/commands/checkfile

高级命令示例

# 创建代码质量检查命令
cat > .claude/commands/quality-check << 'EOF'
!echo "开始代码质量检查..."
!npm run lint
!npm run test
!echo "质量检查完成，分析结果: @test-results.json"
EOF

# 创建部署准备命令  
cat > .claude/commands/deploy-prep << 'EOF'
检查部署准备状态:
- 构建状态: !npm run build
- 测试通过: !npm test  
- 安全扫描: !npm audit
- 分析构建产物: @dist/
请基于以上信息给出部署建议。
EOF

命令功能详解

功能语法说明示例
参数支持$ARGUMENTS获取命令行参数echo "Hello $ARGUMENTS"
Bash执行!command执行系统命令!git status
文件引用@filename引用文件内容@package.json
环境变量$ENV_VAR使用环境变量$NODE_ENV

📚 安全考虑：

  • 使用!前缀执行系统命令时要格外小心
  • 建议在自定义命令中添加参数验证
  • 避免在命令中硬编码敏感信息

实用自定义命令示例

项目管理命令

# 项目状态总览
cat > .claude/commands/project-status << 'EOF'
# 项目状态报告

## Git状态
!git status --porcelain

## 最近提交
!git log --oneline -5

## 包依赖状态  
!npm outdated

## 测试覆盖率
!npm run test:coverage

## 项目配置
@package.json
@.claude/settings.json

请基于以上信息生成项目状态摘要和建议。
EOF

# 快速部署检查
cat > .claude/commands/deploy-check << 'EOF'
部署前检查清单:

1. 代码质量: !npm run lint
2. 单元测试: !npm test  
3. 构建验证: !npm run build
4. 安全审计: !npm audit --audit-level moderate
5. 环境配置: @.env.example

参数说明: $ARGUMENTS

请验证所有检查项并给出部署建议。
EOF

开发辅助命令

# 代码审查助手
cat > .claude/commands/code-review << 'EOF'
# 代码审查请求

## 变更文件
!git diff --name-only HEAD~1

## 详细变更  
!git diff HEAD~1

## 目标文件分析
$(if [ "$ARGUMENTS" ]; then echo "@$ARGUMENTS"; fi)

请进行全面的代码审查，重点关注:
- 代码质量和最佳实践
- 潜在的安全问题
- 性能优化建议
- 测试覆盖率
EOF

# 技术债务分析
cat > .claude/commands/tech-debt << 'EOF'
# 技术债务分析

## TODO和FIXME统计
!grep -r "TODO\|FIXME\|HACK" src/ --include="*.js" --include="*.ts" --include="*.py"

## 代码复杂度分析
!find src/ -name "*.js" -o -name "*.ts" | head -10

## 测试覆盖率报告
@coverage/coverage-summary.json

## 依赖漏洞
!npm audit --json

分析结果: $ARGUMENTS
请提供技术债务优先级建议。
EOF

MCP 命令集成

MCP 系统概述

Model Context Protocol (MCP) 是Claude Code最强大的扩展机制，允许工具与数百种外部服务和平台进行集成。MCP命令从连接的服务器动态发现，为开发者提供了无限的扩展可能性。

📚 MCP架构说明：MCP采用客户端-服务器架构，Claude Code作为客户端可以连接到多个MCP服务器，每个服务器提供特定的功能集合。

动态命令发现

MCP命令遵循统一的命名格式，便于识别和使用：

/mcp__<server-name>__<prompt-name> [arguments]

命令结构解析：

常用MCP集成示例

版本控制集成

# GitHub集成命令示例
/mcp__github__create-issue "Bug: 登录功能异常"
/mcp__github__list-prs --state open --label "bug"
/mcp__github__merge-pr 123 --delete-branch
/mcp__github__create-branch "feature/new-auth-system"

# GitLab集成
/mcp__gitlab__create-mr "feat: 新增用户认证模块"
/mcp__gitlab__run-pipeline --branch main

数据库操作

# 数据库查询和管理
/mcp__database__query "SELECT * FROM users WHERE active = true"
/mcp__database__backup --table users --format sql
/mcp__database__migrate --version latest
/mcp__database__analyze-performance --slow-queries

云服务集成

# AWS服务集成
/mcp__aws__deploy-lambda --function user-auth --env production
/mcp__aws__list-ec2 --region us-west-2 --state running
/mcp__aws__backup-s3 --bucket app-data --destination backup/

# Azure集成  
/mcp__azure__create-vm --size Standard_B2s --location eastus
/mcp__azure__deploy-webapp --name myapp --resource-group prod

MCP服务器配置

配置文件示例

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "database": {
      "command": "python",
      "args": ["-m", "mcp_server_database"],
      "env": {
        "DATABASE_URL": "${DB_CONNECTION_STRING}"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-filesystem"],
      "env": {
        "ALLOWED_DIRECTORIES": "/workspace,/tmp"
      }
    }
  }
}

📚 配置安全提示：

  • 使用环境变量存储敏感信息如API密钥
  • 限制文件系统访问权限
  • 定期轮换访问令牌

MCP命令的高级用法

命令组合和工作流

# 完整的CI/CD工作流
/mcp__github__create-branch "release/v1.2.0"
/mcp__database__backup --table all
/mcp__aws__deploy-staging --version v1.2.0
/mcp__slack__notify "#team" "Staging deployment completed"

# 问题处理工作流
/mcp__monitoring__get-alerts --severity high
/mcp__database__analyze-performance --last 1h  
/mcp__aws__scale-instances --count 5
/mcp__pagerduty__create-incident "High load detected"

自定义MCP工作流

# 创建自定义工作流命令
cat > .claude/commands/release-workflow << 'EOF'
# 发布工作流

## 1. 代码质量检查
!npm run lint && npm test

## 2. 创建发布分支
/mcp__github__create-branch "release/$ARGUMENTS"

## 3. 数据库备份
/mcp__database__backup --full

## 4. 部署到staging
/mcp__aws__deploy-staging --version $ARGUMENTS

## 5. 通知团队
/mcp__slack__notify "#releases" "Release $ARGUMENTS deployed to staging"

请确认所有步骤完成后进行生产部署。
EOF

配置管理系统

配置文件层次结构

Claude Code采用分层配置系统，提供了灵活的配置管理方案：

配置文件位置和优先级

优先级配置文件作用域适用场景
1 (最高)企业策略组织级企业安全和合规要求
2命令行参数会话级临时覆盖和测试
3.claude/settings.local.json项目本地个人开发环境配置
4.claude/settings.json项目共享团队协作配置
5 (最低)~/.claude/settings.json用户全局个人默认设置

📚 配置继承机制：低优先级的配置会被高优先级配置覆盖，但只覆盖冲突的键值，其他配置项会保持继承关系。

企业托管设置位置

# macOS企业配置
/Library/Application Support/ClaudeCode/managed-settings.json

# Linux/Windows企业配置  
/etc/claude-code/managed-settings.json

关键配置选项详解

权限控制配置

{
  "permissions": {
    "allowedTools": ["Read", "Write", "Bash"],
    "blockedPaths": ["/etc", "/usr/bin", "~/.ssh"],
    "allowedHosts": ["github.com", "api.anthropic.com"],
    "maxFileSize": "10MB",
    "allowNetworkAccess": true,
    "requireConfirmation": ["Write", "Bash"]
  }
}

📚 权限配置最佳实践：

  • 采用最小权限原则，只授予必要的访问权限
  • 对敏感操作启用确认机制
  • 定期审查和更新权限配置

环境变量配置

{
  "env": {
    "NODE_ENV": "development",
    "API_BASE_URL": "https://api.example.com",
    "LOG_LEVEL": "debug",
    "CACHE_ENABLED": "true"
  }
}

模型和性能配置

{
  "model": "claude-3-sonnet-20240229",
  "maxTokens": 4096,
  "temperature": 0.7,
  "streaming": true,
  "timeout": 30000,
  "retryAttempts": 3
}

Hooks配置系统

{
  "hooks": {
    "beforeToolUse": [
      "echo '准备执行工具: {{toolName}}'",
      "npm run pre-tool-check"
    ],
    "afterToolUse": [
      "echo '工具执行完成: {{toolName}}'",  
      "npm run post-tool-cleanup"
    ],
    "beforeSession": [
      "echo '开始新会话'",
      "git pull"
    ],
    "afterSession": [
      "echo '会话结束'",
      "git add . && git commit -m 'Auto-commit after Claude session'"
    ]
  }
}

📚 Hooks变量说明：

  • {{toolName}}：当前执行的工具名称
  • {{sessionId}}：当前会话ID
  • {{timestamp}}：当前时间戳
  • {{workingDir}}：当前工作目录

配置管理命令详解

基础配置操作

# 查看所有配置
claude config list

# 查看特定配置项
claude config get permissions
claude config get model
claude config get env.NODE_ENV

# 设置配置项
claude config set model claude-3-opus-20240229
claude config set permissions.allowedTools '["Read", "Write"]'
claude config set env.DEBUG true

# 删除配置项
claude config unset env.TEMP_VAR
claude config unset permissions.blockedPaths[0]

高级配置操作

# 导出配置到文件
claude config export --output ./backup-config.json

# 从文件导入配置
claude config import --input ./backup-config.json

# 重置配置到默认值
claude config reset --confirm

# 验证配置格式
claude config validate

# 比较配置差异
claude config diff --between user,project

配置模板和最佳实践

开发环境配置模板

{
  "model": "claude-3-sonnet-20240229",
  "permissions": {
    "allowedTools": ["Read", "Write", "Bash", "Search"],
    "requireConfirmation": ["Bash"],
    "allowNetworkAccess": true
  },
  "env": {
    "NODE_ENV": "development",
    "LOG_LEVEL": "debug"
  },
  "hooks": {
    "beforeSession": ["git status"],
    "afterToolUse": ["echo 'Tool completed successfully'"]
  }
}

生产环境配置模板

{
  "model": "claude-3-sonnet-20240229",
  "permissions": {
    "allowedTools": ["Read"],
    "blockedPaths": ["/etc", "/usr/bin", "~/.ssh", "/var"],
    "requireConfirmation": ["Write", "Bash"],
    "allowNetworkAccess": false,
    "maxFileSize": "1MB"
  },
  "env": {
    "NODE_ENV": "production",
    "LOG_LEVEL": "warn"
  },
  "hooks": {
    "beforeToolUse": ["npm run security-check"],
    "afterToolUse": ["npm run audit-log"]
  }
}

环境变量管理

认证相关环境变量

Claude Code支持多种认证方式和云服务集成：

# Anthropic API认证
export ANTHROPIC_API_KEY="your-api-key-here"

# 云服务集成认证
export CLAUDE_CODE_USE_BEDROCK=true    # Amazon Bedrock
export CLAUDE_CODE_USE_VERTEX=true     # Google Vertex AI

# 系统设置
export DISABLE_TELEMETRY=true          # 禁用使用跟踪

📚 环境变量安全管理：

  • 使用.env文件管理本地环境变量
  • 生产环境中使用密钥管理服务
  • 定期轮换API密钥
  • 避免在版本控制中存储密钥

高级环境配置

# 性能调优
export CLAUDE_CODE_MAX_TOKENS=8192
export CLAUDE_CODE_TIMEOUT=60000
export CLAUDE_CODE_RETRY_ATTEMPTS=5

# 调试和日志
export CLAUDE_CODE_DEBUG=true
export CLAUDE_CODE_LOG_LEVEL=debug
export CLAUDE_CODE_LOG_FILE=/var/log/claude-code.log

# 网络配置
export CLAUDE_CODE_PROXY=http://proxy.company.com:8080
export CLAUDE_CODE_NO_PROXY=localhost,127.0.0.1,.local

# 缓存配置  
export CLAUDE_CODE_CACHE_DIR=/tmp/claude-cache
export CLAUDE_CODE_CACHE_TTL=3600

高级功能详解

Hooks 系统深度应用

Hooks系统允许在特定事件发生时自动执行自定义脚本，是实现工作流自动化的关键功能。

完整Hooks配置示例

{
  "hooks": {
    "beforeSession": [
      "echo '=== 开始Claude会话 ==='",
      "git status --porcelain | head -10",
      "npm run pre-session-check"
    ],
    "afterSession": [
      "echo '=== 结束Claude会话 ==='", 
      "git add .",
      "git commit -m 'Auto-commit: Claude session completed' || true"
    ],
    "beforeToolUse": [
      "echo '准备执行工具: {{toolName}}'",
      "echo '参数: {{toolArgs}}'",
      "npm run security-scan"
    ],
    "afterToolUse": [
      "echo '工具执行完成: {{toolName}}'",
      "echo '执行时间: {{duration}}ms'",
      "npm run cleanup-temp-files"
    ],
    "onError": [
      "echo '错误发生: {{errorMessage}}'",
      "npm run error-reporting"
    ]
  }
}

Hooks脚本示例

# 创建pre-session-check脚本
cat > scripts/pre-session-check.sh << 'EOF'
#!/bin/bash
echo "🔍 执行会话前检查..."

# 检查Git状态
if [ -n "$(git status --porcelain)" ]; then
    echo "⚠️  存在未提交的更改"
    git status --short
fi

# 检查依赖更新
echo "📦 检查依赖更新..."
npm outdated || true

# 检查磁盘空间
echo "💾 检查磁盘空间..."
df -h . | tail -1

echo "✅ 检查完成"
EOF

chmod +x scripts/pre-session-check.sh

权限系统精细化控制

基于角色的权限配置

{
  "permissions": {
    "roles": {
      "developer": {
        "allowedTools": ["Read", "Write", "Search", "Bash"],
        "allowedPaths": ["./src", "./tests", "./docs"],
        "blockedPaths": ["./config/secrets", "./.env"],
        "requireConfirmation": ["Bash"]
      },
      "reviewer": {
        "allowedTools": ["Read", "Search"],
        "allowedPaths": ["./"],
        "blockedPaths": [],
        "requireConfirmation": []
      },
      "admin": {
        "allowedTools": ["*"],
        "allowedPaths": ["./"],
        "blockedPaths": [],
        "requireConfirmation": ["Write", "Bash"]
      }
    },
    "currentRole": "developer",
    "allowRoleSwitch": false
  }
}

时间和条件权限

{
  "permissions": {
    "timeRestrictions": {
      "allowedHours": "09:00-18:00",
      "allowedDays": ["Mon", "Tue", "Wed", "Thu", "Fri"],
      "timezone": "UTC"
    },
    "conditionalPermissions": {
      "requireGitClean": true,
      "requireTestsPassing": true,
      "requireBranchProtection": ["main", "production"]
    }
  }
}

模型选择和性能优化

智能模型选择策略

{
  "modelSelection": {
    "rules": [
      {
        "condition": "tokenCount < 1000",
        "model": "claude-3-haiku-20240307",
        "reason": "简单任务使用轻量模型"
      },
      {
        "condition": "hasCodeReview = true",
        "model": "claude-3-sonnet-20240229", 
        "reason": "代码审查需要平衡性能"
      },
      {
        "condition": "complexity = high",
        "model": "claude-3-opus-20240229",
        "reason": "复杂任务需要最强模型"
      }
    ],
    "fallback": "claude-3-sonnet-20240229"
  }
}

性能监控配置

{
  "performance": {
    "monitoring": {
      "logTokenUsage": true,
      "logResponseTime": true,
      "alertOnSlowResponse": 5000,
      "alertOnHighTokenUsage": 10000
    },
    "optimization": {
      "enableCaching": true,
      "cacheTimeout": 3600,
      "compressRequests": true,
      "batchRequests": true
    }
  }
}

已安装的自定义命令完整指南

Claude Code预装了30+专业开发命令，覆盖了从分析调试到部署管理的完整开发生命周期。

分析和调试命令组

/analyze - 多维度代码和系统分析

# 基础代码分析
/analyze --code --think

# 深度架构分析  
/analyze --arch --think-hard

# 全面安全审计
/analyze --security --ultrathink

# 性能分析
/analyze --perf --watch

# 交互式分析
/analyze --interactive

支持的分析模式：

模式功能描述适用场景
code代码质量和规范性分析日常开发和代码审查
arch系统架构和设计分析重构和系统优化
profile性能瓶颈和资源分析性能调优
security安全漏洞和风险分析安全审计
perf运行时性能监控生产环境监控
watch持续监控模式长期观察
interactive交互式探索分析深度调研

📚 分析命令最佳实践：

  • 开发阶段使用--code --think进行快速检查
  • 重构前使用--arch --think-hard进行深度分析
  • 上线前使用--security --ultrathink进行安全审计

/check - 代码质量验证和测试运行

# 全面质量检查（推荐）
/check

# 特定类型检查
/check --lint-only
/check --test-only  
/check --build-only

# 修复模式
/check --fix-all
/check --fix-lint

检查项目清单：

📚 质量保证原则：/check命令确保所有检查项都通过，不仅报告问题，还会自动修复可修复的问题。

/troubleshoot - 问题诊断和解决方案

# 全面故障诊断
/troubleshoot

# 特定问题诊断
/troubleshoot --error "Module not found"
/troubleshoot --performance
/troubleshoot --network

诊断流程：

  1. 环境检查：Node.js版本、依赖完整性
  2. 配置验证：配置文件格式和内容
  3. 权限检查：文件和目录访问权限
  4. 网络诊断：API连接和代理设置
  5. 日志分析：错误日志和性能指标
  6. 解决方案：自动修复和手动指导

构建和部署命令组

/build - 通用项目构建器

# React应用构建
/build --react --magic

# API项目构建  
/build --api --c7

# 全栈应用构建
/build --fullstack --production

# 移动应用构建
/build --mobile --platform ios,android

# CLI工具构建
/build --cli --target multiple

构建模板和特性：

模板技术栈特色功能
reactReact + TypeScript + ViteHMR、懒加载、PWA支持
apiExpress + TypeScript + Prisma自动API文档、认证中间件
fullstackNext.js + TypeScript + TailwindSSR、API路由、数据库集成
mobileReact Native + Expo跨平台、原生模块集成
cliNode.js + Commander + Inquirer交互式CLI、多平台支持

📚 Magic模式说明：--magic标志启用智能构建优化，包括自动依赖分析、代码分割和性能优化。

/deploy - 安全应用部署

# 分阶段部署
/deploy --env staging --think

# 生产环境部署  
/deploy --env prod --think-hard

# 回滚部署
/deploy --rollback --ultrathink

# 蓝绿部署
/deploy --strategy blue-green --env prod

# 金丝雀部署
/deploy --strategy canary --traffic 10%

部署策略对比：

策略风险等级回滚时间适用场景
rolling中等5-10分钟常规更新
blue-green低立即重要更新
canary最低立即实验性功能
recreate高5-15分钟架构变更

📚 部署安全检查：

  • 自动备份数据库和配置
  • 健康检查和回滚机制
  • 流量监控和异常检测
  • 部署日志和审计跟踪

设计和文档命令组

/design - 系统架构和API设计

# REST API设计
/design --api --think

# 领域驱动设计
/design --ddd --think-hard

# 产品需求文档
/design --prd --stakeholder frontend,backend

# 微服务架构设计
/design --microservices --scale high

# 数据库设计
/design --database --type postgresql

设计模式和方法论：

设计类型方法论输出物工具集成
apiOpenAPI 3.0Swagger文档Postman, Insomnia
ddd领域驱动设计领域模型图PlantUML, Mermaid
prd敏捷开发需求文档Jira, Notion
microservices12-Factor服务拆分图Docker, K8s
database数据建模ERD图dbdiagram.io

/document - 专业文档创建

# API文档生成
/document --type api --format openapi

# README文档创建
/document --type readme --style detailed

# 架构文档
/document --type architecture --diagram mermaid

# 用户手册
/document --type manual --audience developer

# 发布说明
/document --type release --version v2.1.0

文档格式和平台支持：

{
  "formats": {
    "markdown": "GitHub, GitLab, Bitbucket",
    "html": "静态网站生成",
    "pdf": "正式文档发布", 
    "docusaurus": "技术文档网站",
    "mkdocs": "项目文档站点",
    "gitbook": "在线文档平台"
  }
}

/explain - 技术文档和知识传递

# 初学者教程
/explain --depth beginner --style tutorial "React hooks"

# 高级技术解析
/explain --depth advanced --visual "B-tree indexes"

# 专家级深度分析
/explain --depth expert --interactive "分布式系统一致性"

# 可视化解释
/explain --visual --animation "HTTP请求生命周期"

解释深度和风格：

深度目标受众内容特点示例场景
beginner新手开发者基础概念、步骤详细技术入门
intermediate有经验开发者最佳实践、常见问题技能提升
advanced高级开发者深层原理、性能优化架构设计
expert技术专家前沿技术、创新方案技术研究

开发工具命令组

/git - Git工作流管理

# 智能提交
/git --commit "Add user profile API"

# 创建PR  
/git --pr --reviewers alice,bob --labels api,feature

# 设置Git工作流
/git --flow --type gitflow

# Pre-commit钩子设置
/git --pre-commit --hooks lint,test,security

Git工作流模式：

graph TD
    A[Feature Branch] --> B[Development] 
    B --> C[Code Review]
    C --> D[Integration Testing]
    D --> E[Staging Deployment]
    E --> F[Production Release]
    
    G[Hotfix Branch] --> H[Emergency Fix]
    H --> I[Direct to Production]

/test - 全面测试框架

# 测试驱动开发
/test --tdd

# 覆盖率报告
/test --coverage --threshold 80

# 端到端测试
/test --e2e --browser chrome,firefox

# 变异测试
/test --mutation --strict

# 快照测试
/test --snapshot --update

测试类型和工具：

测试类型工具选择覆盖范围执行时间
unitJest, Vitest单个函数/模块秒级
integrationTesting Library模块间交互分钟级
e2ePlaywright, Cypress完整用户流程分钟到小时
mutationStryker测试质量验证小时级
snapshotJestUI/输出一致性秒级

/review - AI代码审查

# 安全性审查
/review --files src/auth.ts --persona security

# 质量审查带证据
/review --commit HEAD --quality --evidence

# 交互式PR审查
/review --pr 123 --all --interactive

# 性能审查
/review --files src/api/ --persona performance

# 架构审查
/review --scope architecture --persona architect

审查角色和专业领域：

角色关注重点输出格式专业深度
security漏洞、权限、加密安全报告深度
performance性能瓶颈、优化性能分析深度
architect设计模式、架构架构建议深度
qa测试覆盖、边界质量报告中等
refactorer代码重构、清理重构建议中等

项目管理命令组

/cleanup - 项目清理和维护

# 代码清理预览
/cleanup --code --dry-run

# 依赖清理
/cleanup --deps --all

# Git历史清理
/cleanup --git --aggressive

# 配置文件整理
/cleanup --cfg --normalize

清理类型和效果：

清理类型清理对象安全等级预期效果
code未使用代码、注释高代码整洁
files临时文件、缓存高磁盘空间
deps未使用依赖中等安全性提升
git历史记录、大文件低仓库优化
cfg配置标准化高配置一致性

/estimate - 项目复杂度和时间估算

# 功能估算
/estimate "Add user authentication"

# 项目级估算
/estimate --scope project --detail high --team medium

# 重构估算
/estimate --type refactor "Migrate to TypeScript"

# 迁移估算  
/estimate --type migration "Move to cloud"

估算维度和方法：

{
  "estimationFactors": {
    "complexity": ["low", "medium", "high", "expert"],
    "scope": ["feature", "epic", "project", "product"],
    "team": ["individual", "small", "medium", "large"],
    "risk": ["low", "medium", "high", "critical"],
    "dependency": ["none", "internal", "external", "critical"]
  },
  "methodologies": {
    "story_points": "敏捷开发标准",
    "time_based": "基于工时估算",
    "complexity_points": "基于复杂度评分",
    "effort_estimation": "基于历史数据"
  }
}

/improve - 基于证据的增强和优化

# 代码质量改进
/improve --quality

# 性能优化迭代
/improve --perf --iterate

# 架构重构
/improve --arch --think-hard

# 用户体验改进
/improve --ux --data-driven

# 安全性增强
/improve --security --compliance

高级工具命令组

/spawn - 并行专门化代理

# 研究型代理
/spawn --agent researcher "OAuth 2.0 best practices"

# 并行多代理
/spawn --mode parallel --agent "builder,reviewer" "User auth, Profile API"

# 序列化工作流
/spawn --mode sequential "Research → Build → Review"

# 专业化代理组合
/spawn --team "researcher,architect,builder,qa" --task "microservices design"

代理类型和能力：

代理类型专业领域输出物协作模式
researcher技术调研、最佳实践研究报告独立/协作
builder代码实现、原型开发可运行代码协作/序列
reviewer代码审查、质量保证审查报告协作/序列
optimizer性能优化、重构优化方案独立/协作
documenter文档编写、知识整理技术文档独立/协作

/next - 生产质量实现

# 执行下一个任务
/next

# 指定执行模式
/next --mode strict --quality production

# 跳过特定步骤
/next --skip research --focus implementation

# 详细执行计划
/next --plan --verbose

执行流程和质量标准：

graph TD
    A[需求分析] --> B[技术研究]
    B --> C[架构设计] 
    C --> D[实现计划]
    D --> E[代码实现]
    E --> F[测试验证]
    F --> G[文档编写]
    G --> H[部署准备]
    
    I[质量门槛] -.-> E
    I -.-> F
    I -.-> G
    I -.-> H

环境设置命令组

/dev-setup - 开发环境设置

# 完整开发环境设置
/dev-setup

# 特定技术栈设置
/dev-setup --stack react,node,postgresql

# 容器化环境
/dev-setup --docker --compose

# CI/CD集成
/dev-setup --cicd github-actions

/python-setup - Python环境设置

# Python项目初始化
/python-setup

# 特定Python版本
/python-setup --version 3.11 --virtual-env

# 数据科学环境
/python-setup --profile datascience

# Web开发环境
/python-setup --profile web --framework fastapi

通用标志和选项系统

所有自定义命令都支持通用标志，提供了一致的用户体验：

思考和推理模式

标志推理深度适用场景执行时间
--plan无推理查看执行计划秒级
--think基础推理日常开发任务分钟级
--think-hard深度推理复杂技术决策5-10分钟
--ultrathink最大推理关键架构设计10-30分钟

执行模式

标志执行方式风险等级适用场景
--dry-run预览模式无风险方案验证
--watch持续监控低风险长期观察
--interactive交互模式可控探索性任务
--batch批处理中等自动化处理

命令组合和工作流最佳实践

完整开发工作流示例

# 1. 项目初始化和环境设置
/dev-setup --stack react,typescript,tailwind
/init
/add-dir src tests docs

# 2. 需求分析和设计
/design --api --think-hard
/document --type api --format openapi

# 3. 代码实现和测试
/build --react --magic
/test --tdd --coverage

# 4. 质量保证和审查
/check --fix-all
/review --all --interactive

# 5. 部署和监控
/deploy --env staging --think
/analyze --perf --watch

持续集成工作流

# CI/CD管道命令序列
/cleanup --code --dry-run
/test --all --coverage --threshold 90
/check --strict
/review --commit HEAD --evidence
/build --production --optimize
/deploy --env production --strategy blue-green

故障排除和最佳实践

常见问题诊断

健康检查流程

# 系统健康检查
claude /doctor

# 详细诊断信息
claude /doctor --verbose --export diagnosis.json

# 特定问题检查
claude /doctor --check network,permissions,config

健康检查清单：

配置验证

# 验证所有配置
claude config validate

# 查看配置继承
claude config list --show-inheritance

# 诊断权限问题
claude /permissions --diagnose

# 测试MCP连接
claude /mcp --test-connections

性能优化建议

模型选择优化

{
  "optimizationRules": {
    "简单任务": {
      "model": "claude-3-haiku-20240307",
      "maxTokens": 1024,
      "temperature": 0.3
    },
    "代码审查": {
      "model": "claude-3-sonnet-20240229", 
      "maxTokens": 4096,
      "temperature": 0.1
    },
    "复杂设计": {
      "model": "claude-3-opus-20240229",
      "maxTokens": 8192, 
      "temperature": 0.7
    }
  }
}

缓存和会话管理

# 启用智能缓存
claude config set cache.enabled true
claude config set cache.ttl 3600

# 会话管理优化
claude config set session.maxHistory 50
claude config set session.autoSave true

# 压缩长对话
claude /compact "保留技术讨论和决策要点"

安全最佳实践

权限最小化原则

{
  "securityProfile": {
    "development": {
      "allowedTools": ["Read", "Write", "Search"],
      "requireConfirmation": ["Bash"],
      "blockedPaths": [".env", "secrets/"],
      "allowNetworkAccess": true
    },
    "production": {
      "allowedTools": ["Read"],
      "requireConfirmation": ["*"],
      "blockedPaths": ["/etc", "/usr", "secrets/", ".env"],
      "allowNetworkAccess": false
    }
  }
}

API密钥管理

# 使用密钥管理工具
export ANTHROPIC_API_KEY=$(aws ssm get-parameter --name "/claude/api-key" --with-decryption --query "Parameter.Value" --output text)

# 密钥轮换脚本
#!/bin/bash
OLD_KEY=$ANTHROPIC_API_KEY
NEW_KEY=$(generate-new-api-key)
export ANTHROPIC_API_KEY=$NEW_KEY
claude /status && retire-old-key $OLD_KEY

团队协作最佳实践

项目配置标准化

{
  "teamSettings": {
    "sharedConfig": {
      "model": "claude-3-sonnet-20240229",
      "permissions": {
        "allowedTools": ["Read", "Write", "Search"],
        "requireConfirmation": ["Bash"]
      },
      "hooks": {
        "beforeSession": ["git status"],
        "afterSession": ["git add . && git commit -m 'Auto-commit after Claude session' || true"]
      }
    },
    "developmentProfile": {
      "extends": "sharedConfig",
      "permissions": {
        "allowedTools": ["Read", "Write", "Search", "Bash"]
      }
    },
    "productionProfile": {
      "extends": "sharedConfig", 
      "permissions": {
        "allowedTools": ["Read"],
        "requireConfirmation": ["*"]
      }
    }
  }
}

工作流标准化

# 团队工作流模板
cat > .claude/workflows/feature-development.sh << 'EOF'
#!/bin/bash
echo "🚀 开始功能开发工作流"

# 1. 环境检查
claude /doctor --quiet

# 2. 分支管理
git checkout -b feature/$1
claude /add-dir src tests

# 3. 需求分析
claude /design --feature "$1" --think

# 4. 实现循环
while true; do
  claude /build --incremental
  claude /test --quick
  claude /review --files changed
  
  read -p "继续开发? (y/n): " continue
  [[ $continue != "y" ]] && break
done

# 5. 完成检查
claude /check --all
claude /cleanup --code

echo "✅ 功能开发完成"
EOF

实际应用场景和案例

企业级应用案例

大型项目重构案例

背景：某金融科技公司需要将传统单体应用重构为微服务架构

Claude Code应用流程：

# 第一阶段：现状分析
/analyze --arch --ultrathink --target monolith-app/
/document --type architecture --current-state

# 第二阶段：设计新架构
/design --microservices --scale enterprise --compliance financial
/estimate --scope project --detail high --risk high

# 第三阶段：迁移计划
/spawn --agent "architect,planner" --task "migration strategy"
/document --type migration-plan --phases 4

# 第四阶段：分步实施
for service in auth user payment order; do
  /build --microservice --name $service --parent monolith
  /test --integration --service $service
  /deploy --env staging --strategy canary --traffic 5%
done

# 第五阶段：监控和优化
/analyze --perf --microservices --dashboard
/improve --arch --based-on monitoring-data

成果：

初创公司快速原型案例

背景：AI初创公司需要快速构建MVP产品

Claude Code加速开发：

# 快速启动（1天）
/dev-setup --stack nextjs,supabase,vercel
/design --prd --mvp --stakeholder founder,user
/build --fullstack --template saas --magic

# 功能迭代（每周）
/spawn --mode parallel --agent "researcher,builder" "用户反馈分析,新功能开发"
/test --e2e --user-journey critical
/deploy --env production --strategy rolling

# 持续优化
/analyze --user-behavior --a-b-testing
/improve --ux --data-driven --iterate

成果：

开源项目维护案例

大型开源库维护

挑战：维护一个有10万+stars的开源JavaScript库

Claude Code解决方案：

# 日常维护自动化
/git --pr-review --auto-assign --quality-gate
/test --regression --all-node-versions
/document --api --auto-update --format multiple

# 社区管理
/spawn --agent reviewer --task "PR分类和初审"
/analyze --community --metrics contributors,issues,engagement

# 版本发布
/estimate --type release --scope major --breaking-changes
/build --library --optimization aggressive --compatibility wide
/deploy --npm --registry public --strategy gradual

教育和培训场景

编程教学辅助

应用场景：计算机科学课程的编程作业辅导

# 学生代码辅导
/review --educational --persona teacher --gentle
/explain --depth beginner --visual --concept "递归算法"
/test --educational --hints enabled --progressive

# 作业批改辅助
/analyze --code --educational --rubric provided
/document --feedback --constructive --improvement-plan

技术团队培训

# 技能评估
/analyze --team-skills --gap-analysis --role senior-developer
/design --training-plan --duration 3-months --focus architecture

# 实践项目
/build --training-project --complexity progressive --mentoring
/review --peer --learning-focused --best-practices

未来发展趋势和展望

技术演进方向

AI辅助开发的下一步

智能化程度提升：

集成生态扩展

graph TD
    A[Claude Code] --> B[IDE集成]
    A --> C[云服务平台]
    A --> D[开发工具链]
    A --> E[监控系统]
    
    B --> B1[VSCode]
    B --> B2[IntelliJ]
    B --> B3[Vim/Neovim]
    
    C --> C1[AWS]
    C --> C2[Azure] 
    C --> C3[GCP]
    C --> C4[Vercel]
    
    D --> D1[Docker]
    D --> D2[Kubernetes]
    D --> D3[Terraform]
    D --> D4[Ansible]
    
    E --> E1[Prometheus]
    E --> E2[Grafana]
    E --> E3[ELK Stack]
    E --> E4[APM Tools]

行业应用前景

企业级采用趋势

预期发展：

教育领域转型

变革影响：

技术挑战与机遇

当前面临的挑战

技术挑战：

解决方向：

未来机遇空间

新兴领域：

总结

Claude Code作为Anthropic官方的CLI工具，代表了AI辅助开发的最新水平。通过本文的全面介绍，我们可以看到Claude Code不仅提供了丰富的内置功能，还具备强大的扩展能力和自定义特性。

核心价值总结

🚀 开发效率革命

🔧 技术架构优势

🌍 生态系统建设

最佳实践建议

对于个人开发者

  1. 从基础开始：先掌握核心斜杠命令，逐步探索高级功能
  2. 建立工作流：根据项目类型定制专属的开发流程
  3. 持续学习：关注新功能发布，及时更新使用方式
  4. 社区参与：分享使用经验，贡献自定义命令

对于技术团队

  1. 标准化配置：建立团队统一的配置和工作流标准
  2. 安全策略：制定完善的权限管理和安全使用规范
  3. 培训计划：系统性的团队培训和技能提升
  4. 效果评估：定期评估使用效果，优化工作流程

对于企业组织

  1. 试点项目：从小规模项目开始验证效果
  2. 安全合规：确保符合企业安全和合规要求
  3. 成本控制：建立合理的使用策略和成本管理机制
  4. 文化变革：培养AI辅助开发的组织文化

展望未来

Claude Code的出现标志着软件开发进入了一个新的时代。AI不再是简单的代码生成工具，而是成为了开发者的智能伙伴，能够理解复杂的技术需求，提供专业的解决方案，并持续学习和改进。

随着技术的不断发展，我们有理由相信：

Claude Code不仅是一个工具，更是通向未来软件开发新范式的桥梁。掌握和善用这一工具，将帮助开发者在AI时代保持竞争优势，创造更大的价值。

感谢您阅读这份完整的Claude Code文档指南。希望这份指南能够帮助您充分发挥Claude Code的强大能力，提升开发效率，创造更优秀的软件产品。

🔗 相关资源：

本文档将持续更新，跟踪Claude Code的最新发展和功能特性。

✏️ 编辑文章
Share this post on:
Share this post via WhatsApp Share this post on Facebook Share this post on X Share this post via Telegram Share this post on Pinterest Share this post via email

💬 评论交流

ℹ️
GitHub登录评论
使用GitHub账户登录，支持丰富的Markdown格式，评论将同步到GitHub Discussions。