速查表

所有斜杠命令(点开看详情)

截至 2026-05-12(v2.1.140),CLI 自带的斜杠命令共 41 个。按用途分组。所有卡片都是可点击的——展开详细说明、例子、注意事项。

会话保养

模型与思考深度

初始化与项目骨架

计划、目标、循环

对话控制与历史

扩展系统

审查与重构

权限

界面与外观

远程、后台、调度

彩蛋

键盘快捷键

大部分快捷键在 /help 里也能看到。下面这份表是全的。⌘ 表示 macOS 的 Cmd,Windows / Linux 对应 Ctrl。

输入与发送

模式切换

IDE 集成(VS Code / JetBrains)

特殊前缀(输入框里敲)

CLI 参数

claude 命令可以直接用在 shell 里,也可以用 claude -p "..." 做非交互式调用(CI、脚本、Makefile)。完整参数表:

常用启动参数

子命令

CI 里最常见的用法

# GitHub Actions: PR 自动 review
- name: Claude review
  run: |
    claude -p "审查这次 PR 的改动,重点看安全和边界情况" \
      --model claude-opus-4-7 \
      --effort high \
      --max-budget-usd 0.50 \
      --output-format json \
      --permission-mode bypass \
      --allowed-tools Read,Grep,Glob,Bash \
      > review.json
  env:
    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

CLAUDE.md 层级

CLAUDE.md 是 Claude Code 的持久记忆。四层从广到窄,后面的覆盖前面的:

推荐的项目级 CLAUDE.md 骨架

# 项目名
<一句话说明项目是干嘛的>

## 技术栈
- 前端: React 18 + TypeScript + Vite
- 后端: FastAPI + Postgres 15
- 部署: Cloudflare Workers + Supabase

## 风格约束
- TypeScript strict mode,不写 any
- 不要用 @ts-ignore 绕过类型错误,要修根因
- React 组件用函数式 + hooks,不写 class

## 必跑命令
- 测试: pnpm test
- 类型检查: pnpm typecheck
- 开发启动: pnpm dev (端口 3000)

## 不要碰的地方
- src/legacy/ 下的代码冻结,除非明确要求
- migrations/ 里的文件已 apply,不要改

## 报告完成前必须做
- 跑 pnpm test 且输出全绿
- 跑 pnpm typecheck 无错
- 贴出实际输出,不要自报

settings.json 配置键

Claude Code 的配置放在两个地方:~/.claude/settings.json(全局)和 <repo>/.claude/settings.json(项目)。项目覆盖全局。常用键:

一份典型的项目 settings.json

{
  "model": "claude-opus-4-7",
  "effort": "high",
  "permissions": {
    "allow": [
      "Read(**)",
      "Glob(**)",
      "Grep(**)",
      "Bash(pnpm test*)",
      "Bash(pnpm typecheck*)",
      "Bash(git status)",
      "Bash(git diff*)",
      "Bash(git log*)"
    ],
    "deny": [
      "Bash(rm -rf*)",
      "Bash(git push*)",
      "Bash(npm publish*)",
      "Write(.env*)",
      "Write(**/secrets/**)"
    ]
  },
  "hooks": {
    "PreToolUse": [
      { "matcher": "Bash", "type": "command", "command": ".claude/hooks/audit.sh" }
    ],
    "Stop": [
      { "type": "command", "command": ".claude/hooks/on-stop.sh" }
    ]
  },
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "authorization_token": "${GITHUB_TOKEN}"
    }
  },
  "includeCoAuthoredBy": true
}

Hook 事件

Hook 是 Claude Code 的可编程拦截点——在关键时刻触发你的脚本(或 prompt / agent / HTTP 请求),可以观察、可以改写、也可以阻止操作。事件一览:

Handler 类型

权限模式

allow / deny glob 语法

规则形如 Tool(pattern)。Tool 是工具名(Read、Write、Bash、Edit 等),pattern 的含义因工具而异:

环境变量

MCP 传输类型

MCP(Model Context Protocol)是 Anthropic 定义的「AI 外接工具」协议。Claude Code 支持三种传输:

添加:claude mcp add <name> <config.json> 或者直接编辑 settings.json 的 mcpServers 块。会话里 /mcp 查看当前连接状态,/mcp list-tools github 看某个服务器挂了哪些工具。

版本时间线(关键节点)

最新 changelog:code.claude.com/docs/en/changelog。

更多去哪查

• 官方文档:docs.anthropic.com/en/docs/claude-code — 最权威
• Changelog:code.claude.com/docs/en/changelog — 每天一看
• GitHub Issues:github.com/anthropics/claude-code/issues — 遇到 bug 先搜这里
• Agent SDK 文档:docs.anthropic.com/en/api/agent-sdk — 想自己造 agent 时看
• MCP 协议:modelcontextprotocol.io — 写你自己的 MCP server
• 会话内:/help 永远是起点。不知道就敲它。