高级功能

/plan Implement user authentication system

claude --permission-mode plan

{
  "permissions": {
    "defaultMode": "plan"
  }
}

User: /plan Add a real-time notification system

Claude: 我会为实时通知系统制定计划。

## 实现计划

### 阶段 1：基础设施
1. 安装 WebSocket 库（socket.io）
2. 搭建 WebSocket server
3. 配置连接管理

### 阶段 2：后端
4. 创建通知服务
5. 实现通知队列
6. 为通知添加数据库 schema
7. 创建 API 端点

### 阶段 3：前端
8. 搭建 WebSocket client
9. 创建通知 UI 组件
10. 实现通知状态管理
11. 添加通知权限

### 阶段 4：测试与发布
12. 编写单元测试
13. 编写集成测试
14. 更新文档
15. 部署到 staging

预计时间：3-4 小时
需要修改的文件：12 个
需要创建的新文件：8 个

准备继续吗？（yes/no/modify plan）

User: 修改计划 - 先跳过队列，后面再加

Claude: 已更新计划：
[展示删除队列后的计划]

User: 看起来不错，继续

Claude: [按修改后的计划开始实现]

# 通过 CLI 启用 plan mode
claude --permission-mode plan

# 或在 REPL 里使用 /plan
/plan Implement user authentication system

claude --model opusplan "design and implement the new API"

export MAX_THINKING_TOKENS=1024

export CLAUDE_CODE_EFFORT_LEVEL=xhigh   # low (○), medium (◐), high (●), xhigh (仅 Opus 4.7，默认), 或 max

claude --effort high "complex architectural review"

User: ultrathink Should we use microservices or a monolith for our e-commerce platform?

Claude: 让我仔细思考这个架构决策...

## 背景分析
- 团队规模：5 名开发人员
- 预期流量：初期 1 万日活用户
- 需要扩展到 10 万+ 用户
- DevOps 资源有限
- 6 个月 MVP 时间线

## 方案 1：微服务
优点：
+ 独立扩展
+ 技术灵活性
+ 团队独立性
+ 故障隔离

缺点：
- 运维复杂性
- 网络开销
- 需要分布式追踪
- 需要 DevOps 专业知识
- 初始开发较慢

## 方案 2：单体应用
优点：
+ 部署更简单
+ 初始开发更快
+ 调试更容易
+ 运维开销更低
+ 单一代码库

缺点：
- 后期扩展困难
- 全有或全无部署
- 技术锁定
- 可能出现紧耦合

## 决策因素
1. 团队规模（5 人）→ 倾向单体
2. DevOps 资源（有限）→ 倾向单体
3. 时间线（6 个月）→ 倾向单体
4. 未来扩展（10 万用户）→ 单体 + 缓存可实现
5. 复杂度预算 → 有限

## 建议
从**模块化单体**开始：
- 单一部署单元
- 清晰的模块边界
- 模块间干净的接口
- 为未来需要时提取微服务做好准备

这给你：
✓ 快速的初始开发
✓ 低运维复杂度
✓ 后期可提取服务的选项
✓ 清晰的架构

迁移路径：当用户达到 5 万+ 或特定模块需要独立扩展时，将这些模块提取为微服务。

{
  "thinking": {
    "enabled": true,
    "effort": "high"
  }
}

# 解锁 auto mode（Max 订阅者在 Opus 4.7 上不再需要此标志——可直接使用）
claude --enable-auto-mode

# 然后在 REPL 中用 Shift+Tab 切换到它

claude --permission-mode auto

{
  "permissions": {
    "defaultMode": "auto"
  }
}

claude auto-mode defaults

{
  "autoMode": {
    "hard_deny": ["Bash(rm -rf /:*)", "Bash(git push --force*)"]
  }
}

{
  "autoMode": {
    "allow": ["Bash(gh pr list:*)"]
  }
}

{
  "autoMode": {
    "allow": ["$defaults", "Bash(gh pr list:*)"],
    "soft_deny": ["$defaults", "Bash(kubectl delete:*)"],
    "environment": ["$defaults", "trusted-ci.internal"]
  }
}

# 预览将要添加的内容（不写入任何更改）
python3 10-advanced-features/setup-auto-mode-permissions.py --dry-run

# 应用保守基线
python3 10-advanced-features/setup-auto-mode-permissions.py

# 只在需要时添加更多能力
python3 10-advanced-features/setup-auto-mode-permissions.py --include-edits --include-tests
python3 10-advanced-features/setup-auto-mode-permissions.py --include-git-write --include-packages

User: Run tests in background

Claude: Started task bg-1234

/task list           # 显示所有任务
/task status bg-1234 # 查看进度
/task show bg-1234   # 查看输出
/task cancel bg-1234 # 取消任务

User: Run the full test suite in the background

Claude: Starting tests in background (task-id: bg-1234)
You can continue working while tests run.

[你可以继续对话]

User: Meanwhile, let's refactor the auth module

Claude: [在测试后台运行时处理认证模块]

[稍后，测试完成时]

Claude: 📢 Background task bg-1234 completed:
✅ 245 tests passed
❌ 3 tests failed
View results: /task show bg-1234

User: /task list

Active background tasks:
1. [bg-1234] Running tests (50% complete, 2min remaining)
2. [bg-1235] Building Docker image (25% complete, 8min remaining)
3. [bg-1236] Deploying to staging (90% complete, 30sec remaining)

User: /task status bg-1234

Task bg-1234: Running tests
Status: In progress
Progress: 120/245 tests (49%)
Started: 2025-11-08 10:30:15
Estimated completion: 2025-11-08 10:34:22

User: /task show bg-1234

[显示测试运行的实时输出]

User: /task cancel bg-1234

Cancelled background task bg-1234

User: Run the build in the background

Claude: Starting build... (task-id: bg-5001)

User: Also run the linter in background

Claude: Starting linter... (task-id: bg-5002)

User: While those run, let's implement the new API endpoint

Claude: [在构建和 lint 运行时实现 API 端点]

[10 分钟后]

Claude: 📢 Build completed successfully (bg-5001)
📢 Linter found 12 issues (bg-5002)

User: Show me the linter issues

Claude: [显示 bg-5002 的 lint 输出]

{
  "backgroundTasks": {
    "enabled": true,
    "maxConcurrentTasks": 5,
    "notifyOnCompletion": true,
    "autoCleanup": true,
    "logOutput": true
  }
}

tail -f /var/log/app.log | grep --line-buffered "ERROR"

last=$(date -u +%Y-%m-%dT%H:%M:%SZ)
while true; do
  gh api "repos/owner/repo/issues/123/comments?since=$last" || true
  last=$(date -u +%Y-%m-%dT%H:%M:%SZ)
  sleep 30
done

# 显式间隔
/loop 5m check if the deployment finished

# 自然语言
/loop check build status every 30 minutes

remind me at 3pm to push the release branch
in 45 minutes, run the integration tests

/schedule daily at 9am run the test suite and report failures

export CLAUDE_CODE_DISABLE_CRON=1

/loop 5m check the deployment status of the staging environment.
        If the deploy succeeded, notify me and stop looping.
        If it failed, show the error logs.

Shift + Tab  # 循环切换所有 6 种模式

/plan                  # 进入计划模式

claude --permission-mode plan
claude --permission-mode auto

{
  "permissions": {
    "defaultMode": "auto"
  }
}

User: Fix the bug in auth.ts

Claude: I need to modify src/auth.ts to fix the bug.
The change will update the password validation logic.

Approve this change? (yes/no/show)

User: /plan Implement user authentication system

Claude: I'll create a plan for implementing authentication.

## Implementation Plan
[详细的阶段和步骤计划]

Ready to proceed? (yes/no/modify)

User: acceptEdits
User: Fix the bug in auth.ts

Claude: [直接修改，不询问]

User: claude --permission-mode plan
User: Review this PR and suggest improvements

Claude: [读取代码，提供反馈，但不能修改]

User: claude --permission-mode default
User: Let's implement the feature together

Claude: [每次更改前请求批准]

User: claude --permission-mode acceptEdits
User: Fix all linting issues in the codebase

Claude: [自动接受文件编辑，不询问]

# 运行指定任务
claude -p "Run all tests"

# 处理管道内容
cat error.log | claude -p "Analyze these errors"

# CI/CD 集成（GitHub Actions）
- name: AI Code Review
  run: claude -p "Review PR"

# 运行指定任务并捕获输出
claude -p "Run all tests and generate coverage report"

# 结构化输出
claude -p --output-format json "Analyze code quality"

# 从标准输入接收
echo "Analyze code quality" | claude -p "explain this"

# .github/workflows/code-review.yml
name: AI Code Review

on: [pull_request]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code

      - name: Run Claude Code Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude -p --output-format json \
            --max-turns 3 \
            "Review this PR for:
            - Code quality issues
            - Security vulnerabilities
            - Performance concerns
            - Test coverage
            Output results as JSON" > review.json

      - name: Post Review Comment
        uses: actions/github-script@v7
        with:
          script: |
            const fs = require('fs');
            const review = JSON.parse(fs.readFileSync('review.json', 'utf8'));
            github.rest.issues.createComment({
              issue_number: context.issue.number,
              owner: context.repo.owner,
              repo: context.repo.repo,
              body: JSON.stringify(review, null, 2)
            });

# 限制自主回合数
claude -p --max-turns 5 "refactor this module"

# 结构化 JSON 输出
claude -p --output-format json "analyze this codebase"

# 带 schema 验证
claude -p --json-schema '{"type":"object","properties":{"issues":{"type":"array"}}}' \
  "find bugs in this code"

# 禁用会话持久化
claude -p --no-session-persistence "one-off analysis"

claude -c

claude -r "auth-refactor" "finish this PR"

/rename auth-refactor

/fork

claude --resume auth-refactor --fork-session "try OAuth instead"

# 继续最近的对话
claude -c

# 通过名称或 ID 恢复指定会话
claude -r "auth-refactor"

# 恢复并分叉用于实验
claude --resume auth-refactor --fork-session "alternative approach"

/recap                                 # 手动触发摘要
/config                                # 切换自动摘要开/关

CLAUDE_CODE_ENABLE_AWAY_SUMMARY=0 claude   # 禁用摘要
CLAUDE_CODE_ENABLE_AWAY_SUMMARY=1 claude   # 强制启用摘要

{
  "$schema": "https://www.schemastore.org/claude-code-keybindings.json",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+e": "chat:externalEditor",
        "ctrl+u": null,
        "ctrl+k ctrl+s": "chat:stash"
      }
    },
    {
      "context": "Confirmation",
      "bindings": {
        "ctrl+a": "confirmation:yes"
      }
    }
  ]
}

"ctrl+k ctrl+s"   → 两键序列：先按 ctrl+k，再按 ctrl+s
"ctrl+shift+p"    → 同时按修饰键

User: /rew<TAB>
→ /rewind

User: /plu<TAB>
→ /plugin

User: /plugin <TAB>
→ /plugin install
→ /plugin enable
→ /plugin disable

User: <↑>  # 上一个命令
User: <↓>  # 下一个命令
User: Ctrl+R  # 搜索历史

(reverse-i-search)`test': run all tests

User: \
> Long complex prompt
> spanning multiple lines
> \end

User: \
> Implement a user authentication system
> with the following requirements:
> - JWT tokens
> - Email verification
> - Password reset
> - 2FA support
> \end

Claude: [处理多行请求]

User: Deploy to prodcution<Backspace><Backspace>uction

[发送前就地编辑]

! npm test
! git status
! cat src/index.js

/tui          # 在会话内切换
claude --tui  # 直接以 TUI 模式启动

{
  "autoScrollEnabled": false
}

/voice

# 启动时订阅通道插件
claude --channels discord,telegram

# 订阅多个来源
claude --channels discord,telegram,imessage,webhooks

{
  "allowedChannelPlugins": ["discord", "telegram"]
}

claude --chrome      # 启用 Chrome 连接
claude --no-chrome   # 禁用 Chrome 连接

/chrome

# 使用默认会话名启动
claude remote-control

# 使用自定义名称
claude remote-control --name "Auth Refactor"

/remote-control
/remote-control "Auth Refactor"

{
  "disableRemoteControl": true
}

# 从 CLI 创建新的网页会话
claude --remote "implement the new API endpoints"

# 在本地终端恢复网页会话
claude --teleport

/teleport

/desktop

{
  "command": "npm run dev",
  "port": 3000,
  "readyPattern": "ready on",
  "persistCookies": true
}

export CLAUDE_CODE_TASK_LIST_ID=my-project-sprint-3

export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false

# 在隔离工作树中启动 Claude Code
claude --worktree
# 或
claude -w

<repo>/.claude/worktrees/<name>

{
  "worktree": {
    "sparsePaths": ["packages/my-package", "shared/"]
  }
}

{ "worktree": { "baseRef": "head" } }

/sandbox

claude --sandbox       # 启用沙盒
claude --no-sandbox    # 禁用沙盒

{
  "sandbox": {
    "bwrapPath": "/opt/bubblewrap/bin/bwrap",
    "socatPath": "/opt/socat/bin/socat"
  }
}

{
  "sandbox": {
    "network": {
      "allowedDomains": ["*.example.com"],
      "deniedDomains": ["evil.example.com"]
    }
  }
}

{
  "sandbox": {
    "enabled": true,
    "failIfUnavailable": true,
    "filesystem": {
      "allowWrite": ["/Users/me/project"],
      "allowRead": ["/Users/me/project", "/usr/local/lib"],
      "denyRead": ["/Users/me/.ssh", "/Users/me/.aws"]
    },
    "enableWeakerNetworkIsolation": true
  }
}

~/.claude/managed-settings.d/
  00-org-defaults.json
  10-team-policies.json
  20-project-overrides.json

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>disableBypassPermissionsMode</key>
  <true/>
  <key>availableModels</key>
  <array>
    <string>claude-sonnet-4-6</string>
    <string>claude-haiku-4-5</string>
  </array>
</dict>
</plist>

{
  "permissions": {
    "mode": "default"
  },
  "hooks": {
    "PreToolUse:Edit": "eslint --fix ${file_path}",
    "PostToolUse:Write": "~/.claude/hooks/security-scan.sh"
  },
  "mcp": {
    "enabled": true,
    "servers": {
      "github": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-github"]
      }
    }
  }
}

{
  "permissions": {
    "mode": "default",
    "allowedTools": ["Bash(git log:*)", "Read"],
    "disallowedTools": ["Bash(rm -rf:*)"]
  },

  "hooks": {
    "PreToolUse": [{ "matcher": "Edit", "hooks": ["eslint --fix ${file_path}"] }],
    "PostToolUse": [{ "matcher": "Write", "hooks": ["~/.claude/hooks/security-scan.sh"] }],
    "Stop": [{ "hooks": ["~/.claude/hooks/notify.sh"] }]
  },

  "mcp": {
    "enabled": true,
    "servers": {
      "github": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-github"],
        "env": {
          "GITHUB_TOKEN": "${GITHUB_TOKEN}"
        }
      }
    }
  }
}

# 模型选择
export ANTHROPIC_MODEL=claude-opus-4-7
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-7
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

# API 配置
export ANTHROPIC_API_KEY=sk-ant-...

# Thinking 配置
export MAX_THINKING_TOKENS=16000
export CLAUDE_CODE_EFFORT_LEVEL=xhigh   # low, medium, high, xhigh (仅 Opus 4.7，默认), 或 max

# 功能开关
export CLAUDE_CODE_DISABLE_AUTO_MEMORY=true
export CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=true
export CLAUDE_CODE_DISABLE_CRON=1
export CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS=true
export CLAUDE_CODE_DISABLE_TERMINAL_TITLE=true
export CLAUDE_CODE_DISABLE_1M_CONTEXT=true
export CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=true
export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false
export CLAUDE_CODE_ENABLE_TASKS=true
export CLAUDE_CODE_SIMPLE=true              # 由 --bare 标志设置

# MCP 配置
export MAX_MCP_OUTPUT_TOKENS=50000
export ENABLE_TOOL_SEARCH=true

# 提示缓存
export ENABLE_PROMPT_CACHING_1H=1      # 使用 1 小时提示缓存 TTL（默认 5 分钟）

# 任务管理
export CLAUDE_CODE_TASK_LIST_ID=my-project-tasks

# Agent Teams（实验性）
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

# Subagent 和 plugin 配置
export CLAUDE_CODE_SUBAGENT_MODEL=sonnet
export CLAUDE_CODE_PLUGIN_SEED_DIR=./my-plugins
export CLAUDE_CODE_NEW_INIT=1

# 子进程和流式处理
export CLAUDE_CODE_SUBPROCESS_ENV_SCRUB="SECRET_KEY,DB_PASSWORD"
export CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=80
export CLAUDE_STREAM_IDLE_TIMEOUT_MS=30000
export ANTHROPIC_CUSTOM_MODEL_OPTION=my-custom-model
export SLASH_COMMAND_TOOL_CHAR_BUDGET=50000

# 输出和包管理器（v2.1.129+）
export CLAUDE_CODE_FORCE_SYNC_OUTPUT=1                      # 为自动检测失败的终端强制同步输出（Emacs eat 等）
export CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1            # 启用 Homebrew/WinGet 安装的后台升级
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1         # 当设置了 ANTHROPIC_BASE_URL 时选择加入 /v1/models 网关发现

User: /config
[打开交互式配置菜单]

{
  "hooks": {
    "PreToolUse": [{ "matcher": "Bash", "hooks": ["npm test && npm run lint"] }]
  },
  "permissions": {
    "mode": "default"
  },
  "mcp": {
    "servers": {
      "project-db": {
        "command": "mcp-postgres",
        "env": {
          "DATABASE_URL": "${PROJECT_DB_URL}"
        }
      }
    }
  }
}

# 环境变量
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

{
  "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}

# 使用 tmux 分屏显示队友
claude --teammate-mode tmux

# 显式使用进程内模式
claude --teammate-mode in-process