先装上
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
终端里的编码 agent。在仓库里跑 claude,接着上次用 -c,大改动先 /plan。当前钉在 v2.1.323。
免费 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 行。
/init
Plan 只读代码、不改源码,直到你批准。会话里 /plan 或 Shift+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,这一项也得写上。项目或插件不能把你在项目外关掉的复查重新打开。
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 时,只留到这次会话,不落盘。
/permissions
claude -p 跑完就退出。没指定模式时从 Manual 起,要批准的调用会被拒绝;CI 改成 dontAsk 并加上 --allowedTools。写不了 transcript 或 ~/.claude.json 时,文本和 JSON 以 1 退出。auto 模式下因为没有可用的安全检查而拒绝动作时,同样以 1 退出。后台命令按 10 分钟停。claude.ai 登录到期前 10 天,文本会在 stderr 提醒一行。
claude -p "explain this function" --output-format json
/compact 总结后继续同一段对话。/clear 开新对话,CLAUDE.md 还在,也不会停掉仍在跑的后台 agent、teammate,以及会继续跑的 workflow 的命令。
/compact
claude -w name 在 .claude/worktrees/ 开隔离检出。整段丢到后台用 claude --bg "task",再 claude attach <id>;不能和 -p 一起用。子 agent 的 shell 超过 3 分钟会转后台(各提供商一样),免得提示缓存过期。给正在跑的后台 agent 发消息时,它手头的命令转后台继续跑。沙箱开着时,git worktree add、move、remove 按只读失败;本会话没在里面启动、也没被授予的 worktree 里,提交同样失败。
claude -w feature-auth
远程 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。
claude mcp add --transport http notion https://mcp.notion.com/mcp
原生安装会后台更新,这条立刻装当前频道(latest 或 stable)。Homebrew / WinGet 用各自的升级命令。在 IDE 终端里启动不会再安装或更新 IDE 扩展;用外面终端的 /ide,或编辑器的扩展页。
claude update
claude doctor 只读,不改文件。怀疑是 CLAUDE.md、插件或 hooks,用 claude --safe-mode 先把它们关掉。
claude doctor
把几条命令串起来。
先信任工作区。提交的项目设置要等你信任这个目录才完全生效。
批准之前不改源码。做完用 /diff 看工作区。
精确允许名单用 dontAsk。订阅账号的长效令牌:claude setup-token,只打印、不落盘。
在系统终端运行。完整列表以官方 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。 |
只在消息开头生效。输入 / 看你这个账号实际有的命令。
| 命令 | 做什么 | 备注 |
|---|---|---|
| /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 来调用工具;打开和给组织关掉见 官方文档。