Claude Code命令、模式与配置完全指南

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

npm install -g @anthropic-ai/claude-code

claude update      # 别名：claude upgrade，检查并安装更新
claude doctor      # 检查安装健康度（不进会话）
claude install stable --force   # 强制重装原生构建

cd 你的项目
claude            # 启动交互式会话

/init

claude [options] [command] [prompt]

claude --bg "重构一下这个模块"     # 把一个会话丢到后台
claude agents                      # 打开代理管理界面
claude agents --json               # 输出 JSON 数组（无需 TTY，便于脚本）
claude agents --all --json         # 含已完成的后台会话
claude agents --cwd /path/to/proj  # 只看某目录下启动的会话

# HTTP 服务器
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
# 带请求头
claude mcp add --transport http corridor https://app.corridor.dev/api/mcp \
  --header "Authorization: Bearer xxx"
# stdio 服务器 + 环境变量
claude mcp add my-server -e API_KEY=xxx -- npx my-mcp-server
# stdio 服务器 + 子进程参数（注意 -- 分隔）
claude mcp add my-server -- my-command --some-flag arg1

claude auto-mode config       # 打印生效配置（你的设置覆盖默认值）的 JSON
claude auto-mode defaults     # 打印默认的 environment / allow / soft_deny / hard_deny 规则
claude auto-mode critique     # 对自定义 auto 模式规则获取 AI 反馈
claude auto-mode reset        # 从用户设置里移除 autoMode 段，恢复出厂默认

claude project purge [path]              # 删除某项目的全部 Claude Code 状态
                                         # （transcripts、tasks、文件历史、配置项）
claude import codex --dry-run            # 预览从 Codex 导入什么
claude import gemini --yes               # 直接导入
claude ultrareview --post --timeout 30   # 云端审查并把结果评论到 PR
claude gateway --config gateway.yaml     # 企业网关

claude --permission-mode bypassPermissions
# 或
claude --dangerously-skip-permissions
# 或（推荐）：允许提权可选但不默认开启
claude --allow-dangerously-skip-permissions

{
  "permissions": { "disableBypassPermissionsMode": "disable" }
}

{
  "permissions": {
    "allow": [
      "Bash(npm run test:*)",
      "Bash(git diff:*)",
      "Bash(git log:*)",
      "Read(//src/**)",
      "WebFetch(domain:docs.anthropic.com)"
    ],
    "ask": [
      "Bash(git push:*)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./secrets/**)",
      "Bash(curl:*)",
      "WebFetch"
    ],
    "additionalDirectories": ["../shared-lib"],
    "defaultMode": "acceptEdits"
  }
}

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "opus",
  "outputStyle": "default",
  "alwaysThinkingEnabled": true,
  "permissions": {
    "allow": ["Bash(npm run lint)", "Bash(npm run test:*)"],
    "ask": ["Bash(git push:*)"],
    "deny": ["Read(./.env)", "Read(./secrets/**)"],
    "additionalDirectories": ["../docs"],
    "defaultMode": "acceptEdits",
    "disableBypassPermissionsMode": "disable"
  },
  "env": {
    "ANTHROPIC_MODEL": "claude-opus-5",
    "MY_API_BASE": "https://internal.example.com"
  },
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "npx prettier --write $(jq -r '.tool_input.file_path')" }
        ]
      }
    ]
  },
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh",
    "padding": 0
  },
  "enableAllProjectMcpServers": false,
  "enabledMcpjsonServers": ["github"],
  "disabledMcpjsonServers": ["experimental"],
  "cleanupPeriodDays": 30,
  "includeCoAuthoredBy": true,
  "disableAllHooks": false,
  "enabledPlugins": {
    "my-plugin@my-marketplace": true
  },
  "apiKeyHelper": "/path/to/get-key.sh",
  "forceLoginMethod": "claudeai",
  "autoUpdates": true
}

# 项目规范
@~/.claude/my-coding-style.md
@./docs/architecture.md
@README.md

# 这个项目用 pnpm 而不是 npm

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "/path/to/validate-bash.sh",
            "timeout": 60
          }
        ]
      }
    ]
  }
}

{
  "continue": false,
  "stopReason": "自定义停止原因",
  "suppressOutput": true,
  "decision": "block",
  "reason": "阻止原因",
  "hookSpecificOutput": {
    "hookEventName": "PreToolUse",
    "permissionDecision": "allow",
    "permissionDecisionReason": "命中内部白名单",
    "additionalContext": "额外注入的上下文"
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [{
          "type": "command",
          "command": "jq -r '.tool_input.file_path' | xargs -r npx prettier --write"
        }]
      }
    ]
  }
}

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [{
          "type": "command",
          "command": "jq -e '.tool_input.file_path | test(\"\\\\.env$\") | not' > /dev/null || { echo '禁止修改 .env 文件' >&2; exit 2; }"
        }]
      }
    ]
  }
}

{
  "hooks": {
    "SessionStart": [{
      "hooks": [{
        "type": "command",
        "command": "echo \"当前分支: $(git branch --show-current)\"; git status --short"
      }]
    }]
  }
}

---
name: code-reviewer
description: 审查代码变更，关注正确性、安全性、可维护性。在用户要求 review 或提交前主动使用。
tools: Read, Grep, Glob, Bash
model: opus
---
你是一位资深代码审查者。
审查时请：
1. 优先找会导致 bug 的逻辑错误，而不是风格问题
2. 每个问题给出具体的失败场景（什么输入 → 什么错误结果）
3. 用 file:line 格式引用位置

---
description: 修复某个 GitHub Issue
argument-hint: [issue-number]
allowed-tools: Bash(gh issue view:*), Read, Edit, Bash(git:*)
model: sonnet
---
请修复 Issue #$1。
先用 `gh issue view $1` 获取 Issue 详情，然后：
1. 定位相关代码
2. 实现修复
3. 补充测试
4. 提交 commit，message 引用该 Issue

.claude/skills/<skill-name>/
├── SKILL.md          # 必需：frontmatter + 指令
├── reference.md      # 可选：按需读取的参考文档
├── scripts/
│   └── helper.py     # 可选：可执行脚本
└── assets/
    └── template.txt  # 可选：模板资源

---
name: pdf-processing
description: 处理 PDF 文件——提取文本、合并、拆分、填表单。当用户提到 PDF 或需要处理 .pdf 文件时使用。
allowed-tools: Read, Bash, Write
---
# PDF 处理
## 可用工具
- `scripts/extract.py` —— 从 PDF 提取文本
- `scripts/merge.py` —— 合并多个 PDF
## 流程
1. 先用 Read 确认 PDF 是否可读
2. 调用 extract.py ...
## 参考资料
详细 API 见 reference.md

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "sentry": {
      "type": "http",
      "url": "https://mcp.sentry.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${SENTRY_TOKEN}"
      }
    }
  }
}

claude mcp list                  # 查看所有服务器
claude mcp login sentry          # 认证
claude mcp get github            # 看详情
claude mcp remove github         # 移除
claude mcp serve                 # 把 Claude Code 本身当 MCP 服务器

# 添加市场
claude plugin marketplace add anthropics/claude-code-plugins
claude plugin marketplace list
claude plugin marketplace update
# 安装与管理
claude plugin install my-plugin@my-marketplace
claude plugin list
claude plugin enable my-plugin
claude plugin details my-plugin      # 组件清单 + 预估 token 开销
claude plugin update my-plugin
claude plugin uninstall my-plugin
# 开发
claude plugin init my-plugin         # 脚手架
claude plugin validate ./my-plugin   # 校验结构
claude plugin tag ./my-plugin        # 打发布 tag

{
  "enabledPlugins": {
    "my-plugin@my-marketplace": true
  }
}

---
name: 中文技术写作
description: 用中文回答，面向有经验的工程师，直给结论
---
- 始终用简体中文回答
- 先给结论，再给理由，不要铺垫
- 代码注释用中文
- 避免"首先/其次/最后"这类连接词

# 单次提问
claude -p "总结这个项目的架构"
# 管道输入
cat error.log | claude -p "这些报错说明了什么？"
# JSON 输出（便于脚本解析）
claude -p "列出所有 TODO" --output-format json
# 流式 JSON
claude -p "重构 utils.js" --output-format stream-json --verbose
# 限制轮数与预算
claude -p "修复 lint 错误" \
  --allowedTools "Edit" "Bash(npm run lint:*)" \
  --max-turns 10 \
  --max-budget-usd 2
# 结构化输出校验
claude -p "提取 API 端点" --json-schema '{"type":"object","properties":{"endpoints":{"type":"array","items":{"type":"string"}}},"required":["endpoints"]}'

# 1. 最小权限：只放行必需的
--allowedTools "Read" "Bash(npm test:*)"
# 2. 拒绝高危：显式封禁
--disallowedTools "Bash(rm:*)" "WebFetch"
# 3. 完全跳过：仅在隔离沙箱中用
--dangerously-skip-permissions

name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]
jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "审查这个 PR 的改动，重点关注并发安全和错误处理"

/init                          # 生成 CLAUDE.md
请阅读代码库并告诉我：          # 让它先调研
1. 整体架构和数据流
2. 核心模块各自负责什么
3. 测试怎么跑

Shift+Tab → plan        # 切到计划模式
"重构用户认证模块，先用 JWT 替换 session"    # Claude 只调研、出方案
【审阅方案，确认没问题】
Shift+Tab → acceptEdits # 切到自动接受编辑
"按方案执行"

claude    # 然后：
请为 utils/parser.js 写测试，覆盖：
- 空输入
- 畸形 JSON
- 超长输入
- Unicode
先写测试，跑一遍确认失败，再实现到全部通过

用三个子代理并行调查：
1. 认证流程是怎么实现的
2. 数据库 schema 和迁移策略
3. 前端状态管理方案
每个给我一份简明报告

claude -w refactor-auth       # 在独立 worktree 里干活，不影响主分支

/review                       # 常规审查
/security-review              # 安全审查
/ultrareview                  # 云端多代理深度审查

{
  "permissions": {
    "ask": ["Bash(git push:*)", "Bash(npm publish:*)"],
    "deny": ["Read(./.env)", "Read(./secrets/**)", "Bash(curl:*)"]
  },
  "hooks": {
    "PostToolUse": [{
      "matcher": "Edit|Write",
      "hooks": [{
        "type": "command",
        "command": "jq -r '.tool_input.file_path' | xargs -r npx prettier --write"
      }]
    }]
  }
}

claude                          # 交互式会话
claude "解释这个项目"            # 带首条提示词
claude -c                       # 继续最近会话
claude -r                       # 选择恢复某个会话
claude --model opus             # 指定模型
claude -p "查询"                 # 非交互，打印后退出
claude --bg "任务"               # 后台代理
claude -w feature-x             # 在独立 worktree 中工作
claude --safe-mode              # 排查坏配置

/help          /config       /model        /permissions
/init          /memory       /compact      /context
/clear         /resume       /rewind       /cost
/agents        /skills       /hooks        /mcp
/plugin        /add-dir      /output-style /statusline
/doctor        /review       /security-review
/usage         /export       /exit

/      斜杠命令
@      引用文件
!      执行 bash
#      写入记忆

claude update                   # 更新
claude doctor                   # 体检
claude mcp list                 # MCP 服务器
claude plugin list              # 插件
claude agents                   # 后台代理
claude project purge            # 清理项目状态