会话与环境：
在哪聊，在哪干活

• 存在哪：~/.claude/projects/<项目目录>/<会话 ID>.jsonl，每个项目一个文件夹。默认保存 30 天，可以用 cleanupPeriodDays 设置改。
• 起个名字：启动时 claude -n auth-refactor，或者对话里 /rename auth-refactor，名字会显示在输入框上方。以后用 claude --resume auth-refactor 或 /resume auth-refactor 直接回来。
• 不起名也行：Claude Code 会根据你的第一句话自动生成一个标题，在 /resume 的列表里能看到。同时做几件事时，还是起个名字好找。

回来接着聊时，哪些会带回来

对话里几个顺手的小工具

命令行里也能分叉：claude --continue --fork-session。两个终端同时 --resume 同一个会话而不分叉，两边的消息会混在一份记录里。

• 怎么开：claude --worktree feature-auth（简写 -w）。不给名字会自动起一个，比如 bright-running-fox。对话中也可以直接说"在 worktree 里做"。
• 从哪开始：默认从远程默认分支（通常是 main）的最新版开新分支，不带你本地没推送的提交。想带上，设置里写 "worktree": { "baseRef": "head" }。
• .env 没了？worktree 是全新检出，被 git 忽略的文件不会自动带过去。在项目根目录建一个 .worktreeinclude，按 .gitignore 的写法列出 .env 等文件。
• 记得把 .claude/worktrees/ 加进 .gitignore。子代理也能各用一个 worktree：在它的配置里加 isolation: worktree。

试一试：退出会话时，worktree 会怎样？

• 怎么开：对话里输入 /sandbox，选一种模式。设置存进项目的 .claude/settings.local.json；想所有项目都开，在 ~/.claude/settings.json 里写 "sandbox": { "enabled": true }。
• 默认的墙：能写的只有项目目录、临时目录和你加进来的目录；能读整台电脑（包括 ~/.ssh！）；网络一个网站都没预先放行：Manual 模式下第一次连某个网站时问你，auto 模式下由安全员连同命令一起审。
• 只管 Bash 这类命令：Claude 用 Read、Edit 工具读写文件时，走的还是权限规则；你自己用 ! 打的命令也不在沙箱里。

试一试：同样几条命令，开不开沙箱有什么不同

假设权限模式是 Manual（每步都问你）。切换下面的开关，看每条命令的结果怎么变：

• 被墙挡住之后：Claude 会看到被拦的路径或网站，可能申请"在沙箱外重试"。Manual 模式下会弹窗问你；auto 模式下交给安全员判断。不想给它这个选项，设置 "allowUnsandboxedCommands": false。
• 跑不了的工具：docker 在沙箱里跑不起来，把 "docker *" 加进 sandbox.excludedCommands，让它在墙外按正常权限流程跑。jest 卡住的话，改用 jest --no-watchman。
• 放行网站要谨慎：放行 github.com 这种大网站，等于给了一条把数据传出去的路。

在不同地方之间交接

• 都要用 claude.ai 账号登录（Pro、Max、Team、Enterprise），用 API key 不行。Team、Enterprise 还要管理员先打开。
• Remote Control 的安全：你的电脑只往外发 HTTPS 请求，不开任何端口。连接期间，对话记录会存在 Anthropic 的服务器上用来同步；执行和文件仍然只在你的电脑上。
• 桌面端的并行会话：新建会话时勾上 worktree，每个会话就有自己的一份代码（第 4 节讲的）。网页预览的启动方式写在 .claude/launch.json 里。

示意：回答内容是虚构的，只为展示各样式的差别。

• 怎么换：/output-style concise（不分大小写），或 /config 里选 Output style。选择存进 .claude/settings.local.json，下一条消息就生效。
• 写在设置文件里："outputStyle": "Concise"，这里要区分大小写，写成 concise 会被当成默认样式。
• Proactive 不改权限：它只是让 Claude 少问"要不要这样做"，该弹的权限确认照样弹。

写一个自己的样式

---
name: Diagrams first
description: 讲解时先画图
keep-coding-instructions: true
---

讲解代码、架构或数据流时，先画一张 Mermaid 图说明结构，再用文字解释。
图里的节点不超过 15 个。

• 放在 ~/.claude/output-styles/（只给自己）或项目的 .claude/output-styles/（团队共用）。改了文件要重启 Claude Code 才读到。
• keep-coding-instructions: true：保留 Claude Code 自带的写代码规范，只改说话方式。不写这行，自定义样式会把那套规范去掉，适合让 Claude 当写作助手、数据分析师这类不写代码的角色。

• bash 版本要先装 jq（解析 JSON 的小工具），并执行 chmod +x ~/.claude/statusline.sh。保存设置后马上生效。设置文件里已经有别的内容时，只把 statusLine 这一段加进去，别整个覆盖。
• Windows 上：设置里的路径用正斜杠 C:/Users/…，反斜杠会被吃掉，脚本静悄悄地不运行。
• 它在本地运行，不花 token；每来一条新回复、切换权限模式等时刷新。脚本要快，慢的命令（比如 git status）要缓存。

终端画面为教学示意，提示文字、会话 ID 和网址是虚构的；命令、参数与官方文档一致。