Claude Code Cheatsheet

Claude Code

终端里的编码 agent。在仓库里跑 claude,接着上次用 -c,大改动先 /plan。当前钉在 v2.1.323。

v2.1.323 tag v2.1.323 更新于 2026-11-13
复制按钮会复制可直接贴进终端或 Claude Code 会话的命令

最短记忆

免费 claude.ai 不含 Claude Code。需要 Pro、Max、Ultra、Team、Enterprise 或 Console。

先装上

macOS / Linux / WSL 用下面这条;Windows PowerShell 用 irm https://claude.ai/install.ps1 | iex。包管理器:brew install --cask claude-code,或 winget install Anthropic.ClaudeCode。

curl -fsSL https://claude.ai/install.sh | bash

登录

第一次 claude 会打开浏览器;已经决定用 ANTHROPIC_API_KEY 时会跳过。Console 按量计费加 --console。用 ant auth login 的登录时,启动会点名被计费的 Console 组织;claude.ai 登录结束后接着用它,还会警告。

claude auth login

在仓库里开一轮

进入项目目录再启动。会话里 /init 起草 CLAUDE.md;文件已在时只提建议,不覆盖。

claude

接着上次

claude -c 打开当前目录最近一次对话;点名用 claude -r "名字或 ID"。默认不含 claude -p 的会话。退出时的续跑提示会先重复启动参数(如 --chrome),再接 --resume。

claude -c

按场景查

先找现在要做的事,复制那一条命令。

让它记住项目约定

/init 起草项目 CLAUDE.md(./CLAUDE.md 或 ./.claude/CLAUDE.md)。个人跨项目放 ~/.claude/CLAUDE.md,单文件尽量短于 200 行。

/initCLAUDE.md
/init

先出方案,再改代码

Plan 只读代码、不改源码,直到你批准。会话里 /plan 或 Shift+Tab;启动时用下面这条。

planShift+Tab
claude --permission-mode plan

切权限模式

交互默认 auto。Shift+Tab:auto → Manual(default)→ acceptEdits → plan → 回到 auto。dontAsk 不在这个循环里,只给 claude -p。选了 auto 但这一轮用不了(设置关掉、模型不支持,或服务端暂时关掉)时,从 Manual 起,先问你。关掉遥测或 feature flag 时(含 LLM gateway),服务器核不过的调用会问你或拒绝,不再退回内置分类器。Bedrock、Vertex、Foundry 仍走原来的路。要留着分类器,设 CLAUDE_CODE_AUTO_MODE_SERVER=0。gateway 上要强制做服务器复查,设 CLAUDE_CODE_AUTO_MODE_SERVER=1;托管设置里若关了实验性 beta,这一项也得写上。项目或插件不能把你在项目外关掉的复查重新打开。

autoacceptEdits
claude --permission-mode acceptEdits

少被问,但别放开危险命令

规则顺序 deny → ask → allow;宽的 deny 盖得住更窄的 allow,bypass 也绕不过 deny。Bash 的“不要再问”写进 .claude/settings.local.json,改文件的批准只留到这次会话结束。permissions.blockWritesOutsideWorkingDirectories 设上之后,任何权限模式下 Write、Edit、NotebookEdit 都拒绝工作目录外的路径。带上账号邮箱、又写了 User-Agent 的 shell 命令会直接拒绝,不再询问;别的命令和定时任务不会因此停下。permissions.denyInsteadOfPrompting 设上之后,本该停下等批准的调用直接拒绝,这一轮继续,终端、子 agent 和 teammate 都一样。带引号的 Bash 词也会命中 deny / ask;更宽的 deny 盖住精确的 Bash 或 PowerShell ask 时,直接拒绝,不再问。Bash allow 的变量值里带 *(如 Bash(PORT=* npm run dev))启动时会警告;写成 Bash(NODE_ENV*) 这种会再问。看起来带密钥的“不要再问”,或会写进已被 git 跟踪的 settings.local.json 时,只留到这次会话,不落盘。

/permissionsdeny
/permissions

脚本里只要最终答案

claude -p 跑完就退出。没指定模式时从 Manual 起,要批准的调用会被拒绝;CI 改成 dontAsk 并加上 --allowedTools。写不了 transcript 或 ~/.claude.json 时,文本和 JSON 以 1 退出。auto 模式下因为没有可用的安全检查而拒绝动作时,同样以 1 退出。后台命令按 10 分钟停。claude.ai 登录到期前 10 天,文本会在 stderr 提醒一行。

-pjson
claude -p "explain this function" --output-format json

上下文满了

/compact 总结后继续同一段对话。/clear 开新对话,CLAUDE.md 还在,也不会停掉仍在跑的后台 agent、teammate,以及会继续跑的 workflow 的命令。

/compact/clear
/compact

并行:worktree 或后台

claude -w name 在 .claude/worktrees/ 开隔离检出。整段丢到后台用 claude --bg "task",再 claude attach <id>;不能和 -p 一起用。子 agent 的 shell 超过 3 分钟会转后台(各提供商一样),免得提示缓存过期。给正在跑的后台 agent 发消息时,它手头的命令转后台继续跑。沙箱开着时,git worktree add、move、remove 按只读失败;本会话没在里面启动、也没被授予的 worktree 里,提交同样失败。

-w--bg
claude -w feature-auth

接上 MCP

远程 HTTP 用下面这条。--scope project 写进仓库 .mcp.json,默认 local 只给你;密钥别提交,登录用 /mcp。deniedMcpServers 里的 URL 也会拦住上游相同的 Anthropic 服务器;云端会话和自托管 runner 上的 connector 同样按 URL 拦,否则按名字拒绝。MCP 的 task 在终端里会立刻转后台(不依赖 feature flag 拉取),做完再把结果告诉 Claude。要在这次调用里等完,设 CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND;整项关掉用 CLAUDE_CODE_DISABLE_MCP_TASKS=1。完成登录的那一步,bypass 和 auto 里也会先问你;dontAsk 里改用 /mcp。

mcp.mcp.json
claude mcp add --transport http notion https://mcp.notion.com/mcp

立刻更新

原生安装会后台更新,这条立刻装当前频道(latest 或 stable)。Homebrew / WinGet 用各自的升级命令。在 IDE 终端里启动不会再安装或更新 IDE 扩展;用外面终端的 /ide,或编辑器的扩展页。

updatestable
claude update

坏了先诊断

claude doctor 只读,不改文件。怀疑是 CLAUDE.md、插件或 hooks,用 claude --safe-mode 先把它们关掉。

doctorsafe-mode
claude doctor

常用流程

把几条命令串起来。

第一次进一个仓库

先信任工作区。提交的项目设置要等你信任这个目录才完全生效。

cd repo && claude→/init→/permissions

大改动先出方案

批准之前不改源码。做完用 /diff 看工作区。

--permission-mode plan→批准方案→/diff

管道或 CI 里跑

精确允许名单用 dontAsk。订阅账号的长效令牌:claude setup-token,只打印、不落盘。

claude -p→--permission-mode dontAsk→--allowedTools

CLI 索引

在系统终端运行。完整列表以官方 CLI reference 为准。

命令 什么时候用 备注
claude 在当前目录开交互会话。 claude "explain this project" 带上第一条提示。
claude -p "query" 非交互,跑完退出。 --output-format text|json|stream-json。JSON 里 claude.ai 登录到期时间是 credential_expires_at。
claude -c 继续当前目录最近的对话。 默认不含 -p 会话。连那些也续上:claude -p --continue。
claude -r "name" 按 ID 或名字恢复。 不带参数则打开选择器。--fork-session 分叉出新会话。
claude update 立刻更新到当前频道。 钉 stable 或版本号用 claude install。
claude auth login 登录。 logout 登出。status --text 看是否已登录;loginExpiresAt 是 claude.ai 登录何时到期。到期后再跑会说明已过期,-p 会点名 claude auth login 和 claude setup-token。CI 令牌:claude setup-token。
claude doctor 不启动会话的只读诊断。 要它提议并改文件,在会话里跑 /doctor。
claude --permission-mode plan 指定这一次的起点模式。 default(别名 manual)、acceptEdits、auto、dontAsk、bypassPermissions。
claude --model sonnet 这一次用哪个模型。 别名 sonnet、opus、haiku、fable。fable 指向 Fable 5.2(1M);Claude apps gateway 会话里仍是 Fable 5,除非设了 ANTHROPIC_DEFAULT_FABLE_MODEL。它不是套餐默认模型,用 /model fable 或 claude --model fable 来选;gateway 上用 /model claude-fable-5-2。用户设置里保存的 claude-fable-5-1 会改到 fable:Pro / Max 在 v2.1.321 起第一次启动就改,Team / Enterprise 等组织允许;退回用 /model claude-fable-5-1。Console、第三方,以及项目、local、托管设置里的 5.1 不动。--effort high 不写入设置。跟本会话同一模型、又没写 effort 时,子 agent 和 teammate 用本会话的档。换了模型则用那个模型已保存的档或默认档。要给没写 effort 的子 agent 指定推理档,用 CLAUDE_CODE_SUBAGENT_EFFORT。switchModelsOnFlag 设成 false(每次询问)时,子 agent 遇到被标出的消息会停,不再换模型。CLAUDE_CODE_DISABLE_ULTRATHINK 关掉 ultrathink 关键字。Opus 4.8 的 fast mode 已弃用,2026-11-30 移除;之后对该模型的 fast 请求报错,且不回退到普通 Opus 4.8。要保住加速,改用 Opus 5.5。别的模型上,fast 被限流、过载或失败时,先在同一模型改走普通速度。Vertex 的 global、us、eu 也可以开 fast,Vertex 拒绝时同样退回普通速度。认不出的模型 ID 按 1M 上下文算;要留在 200K,设 CLAUDE_CODE_DISABLE_1M_CONTEXT=1。别家窗口更小的模型一旦写满,每轮都会失败,直到 /clear。
claude --add-dir ../lib 额外授予读写目录。 默认不加载那里的 CLAUDE.md。
claude -w name 在隔离 git worktree 里启动。 路径在 .claude/worktrees/<name>。
claude --bg "task" 后台跑,马上把终端还你。 随后 claude agents、attach、logs、stop。不能和 -p 并用。
claude mcp add … 配置 MCP 服务器。 list 看状态。login <name> 走 OAuth。add / remove 会等配置锁,拿不到就以 1 退出;别的任务后写入仍可能盖掉刚保存的服务器。
claude plugin 安装和管理插件。 会话里用 /plugin。claude plugin update、/plugin 的 Update now,以及后台自动更新,都会装上新版本新增的依赖。plugin.json 的 engines["claude-code"] 写了版本范围时,范围外的不安装、不更新、不加载;安装和更新会选范围内最新的。
claude --safe-mode 关掉自定义项来排障。 脚本瘦启动用 --bare。
claude --settings ./settings.json 这一次盖过同名设置键。 免询问用 --allowedTools。
claude --teleport 把云端会话拉回本机。 需要订阅。本机这一轮给手机接着控:--remote-control。claude remote-control 在首次提问没人答时说明原因并以 1 退出;管道里没有换行的 y 也算同意。claude remote-control --settings ./settings.json 把这份设置套到它开出的每一轮;文件改了要重启才会再开新会话。连上的客户端不能把会话挪到别的目录。
claude --version 打印已安装版本。 本页钉的上游发布是 v2.1.323。

Slash 与模式

只在消息开头生效。输入 / 看你这个账号实际有的命令。

命令 做什么 备注
/init 起草项目 CLAUDE.md。 已有文件只给建议。/memory 用来编辑说明。
/plan 进入 plan 模式。 也可 Shift+Tab。批准前不改源码。
/permissions 管理 allow / ask / deny。 别名 /allowed-tools。规则详情里连按两次 Ctrl+C 会返回或取消。
/config 主题、模型等少数个人项。 别名 /settings。/status 看版本、账号、加载了哪些设置。Auto mode server 显示已开启,只代表服务器复查真的到了这一轮。在 Auto (default) 上按空格,存成 Don't Ask,不是 Plan。
/model 换模型,并存成新会话默认。 选择器里按 s 只改这一次。推理档用 /effort。
/compact 总结后继续同一段对话。 /clear 开新对话。/context 看窗口被什么占满;之后 Claude 只读短表,每类留最大的 10 行,按需加载的 MCP 工具在调用前每个服务器一行。
/rewind 把对话和/或代码退回检查点。 /diff 看工作区改动。
/mcp 连接、登录、启用或停用 MCP。 OAuth 在这里完成。
/resume 按 ID 或名字继续,或打开选择器。 别名 /continue。
/doctor 检查安装和设置,确认后才改。 终端里的 claude doctor 只读。
/btw 旁问一句,不写进对话历史。 不带问题则翻最近一次旁问。
/add-dir 这一轮额外授予一个目录。 /cd 把整个会话挪到新目录,对话保留。
/background 把当前会话拆到后台。 别名 /bg。/tasks 的 Earlier in this session 列出已结束的子 agent,离开列表或重启后仍可再打开并留言。
/usage 看用量和限额。 别名 /cost、/stats。走 Claude apps gateway、没有花费上限、且 gateway 不低于这个版本时,会多出今天、本周和本月的花费。终端里 Fable 的周限额会写出何时重置。
/plugin 插件菜单。 自写技能放 .claude/skills/<name>/SKILL.md,用 /name 调用。
/exit 离开会话。 接在后台会话上时只是 detach。登录、登出用 /login、/logout。后台会话里的 /logout 会登出这台机器上的全部会话,并删掉存着的 MCP 登录和插件密钥。

这些路径各管什么

同名设置键从高到低:组织托管、本次 --settings、.claude/settings.local.json、.claude/settings.json、~/.claude/settings.json。

路径 装什么 谁写
~/.claude/settings.json 这台机器上所有项目的偏好。 你,或 /config。自有设置里优先级最低。会话进行中删掉的设置文件会保持删除;刚手改的内容不会被这一轮里的保存盖掉。
.claude/settings.json 团队共享的权限、hooks、环境变量。 提交进 git。这里的 defaultMode: auto 不会当起点。
.claude/settings.local.json 只对你、只在这个项目。 Bash 的“不要再问”写在这里。别提交。看起来带密钥,或这份文件已被 git 跟踪时,规则只留到这次会话。这里的 defaultMode: auto 也不会当起点。
~/.claude.json 账号、MCP、每个项目的信任决定。 Claude Code 自己写。不用手改。不是合法 JSON 时,非交互启动会失败并说明怎么恢复,文件保持原样;空文件且没有备份则按缺失启动。网络家目录写不进去时,登出和 mcp remove 会失败。家里同时有两份配置时,stderr 会说明哪一份在用。
CLAUDE.md · .claude/CLAUDE.md · ~/.claude/CLAUDE.md 持久说明。越靠近启动目录越靠后。 你。/init 起草项目文件。已有 AGENTS.md 也会当项目说明读。
.claude/rules/*.md 按主题拆开的说明。 带 paths 的只在碰到匹配文件时加载。
.claude/skills/<name>/SKILL.md 用 /name 调用的流程。 个人技能放 ~/.claude/skills/。Bash 沙箱开着时,启动目录下面更深的 .claude/skills 只有在那里启动,或 /cd 过去,才会加载。~/.claude/plugins 里面的 .claude/skills 不会加载。
.mcp.json 团队共享的 MCP。只在项目根。 claude mcp add --scope project。本机要批准。密钥别放这里。
.claude/worktrees/ claude -w 的隔离检出。 Claude Code 创建。
使用习惯

大改动 /plan,小改动留在 auto。权限靠 /permissions,不靠 CLAUDE.md。密钥留在 local,别进 .mcp.json。上下文满了 /compact,重来用 /clear。实验性的 Code Mode 里,Claude 写 JavaScript 来调用工具;打开和给组织关掉见 官方文档。

已复制