★ FEATURED ARTICLE 1. 中文目录名下的会话为什么说没就没如果你正在用 Claude Code 写代码项目文件夹叫「简历」「测试中文目录」或者「黑马微服务资料」那你可能已经踩到一个很隐蔽的坑昨天聊了半小时的会话今天--resume里翻不到了。没删过、没清理过就是凭空消失。我实测下来这个问题跟 Claude Code 存储会话的路径编码规则直接相关。它会把项目路径里的/换成-同时把非拉丁字符中文、日文、韩文、阿拉伯文、俄文等也统一替换成-。于是C:\Users\...\Desktop\测试中文目录会被编码成C--Users-...-Desktop-------六个汉字变成六个连字符。问题就出在这里只要两个目录的非拉丁字符数量相同编码后的目录名就完全一样。项目甲和测试乙都是 3 个汉字映射到.claude/projects/下就是同一个目录会话全部混在一起。清理一个另一个的对话跟着没--resume里能看到另一个项目的聊天记录cleanupPeriodDays默认 30 天清理时把两个项目当成一个处理。这篇就围绕这个场景把 TaoToken 的配置骨架、可复制的settings.json、以及切换目录后验证会话是否恢复的具体动作讲清楚。适合所有用非 ASCII 目录名开发、又想让 Claude Code 会话稳定不丢的人。核心检索词就三个Claude Code、中文目录名、路径编码。2. TaoToken 前置统一 Key 与 API 通道在动手改目录名之前先把模型接入通道理顺。TaoToken 的作用是给 Claude Code 这类编码工具提供一个统一的 API 入口你只需要一个 Key就能在多个模型之间切换不用每个工具单独配一套凭证。官网入口在这里https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 基础地址是https://taotoken.net/api 这个地址不加 UTM 参数直接用于配置。你需要先拿到 Key。进入控制台创建 API Key控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite创建好之后Key 一般形如sk-开头的一串字符。把它存到环境变量里不要硬编码进项目文件。Windows 下可以用系统环境变量macOS/Linux 下写进~/.zshrc或~/.bashrcexport TAOTOKEN_API_KEYsk-你的key如果你用的是 Claude Code 的 Anthropic 兼容通道接入文档在这里里面有 base_url 和 header 的完整说明接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteClaude Code Anthropic 配置https://taotoken.net/doc/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite这一步的意义在于后面无论你怎么改目录名、怎么切换项目模型通道是稳定的。会话丢失是本地路径编码问题跟 API 通道无关但把通道先固定下来排障时就能排除掉「是不是 Key 失效了」这类干扰项。3. 可复制配置settings.json 骨架与 ASCII 目录规范Claude Code 的配置分两层全局的~/.claude/settings.json和项目级的.claude/settings.local.json。会话存储路径由 Claude Code 自己决定你改不了它的编码规则但你可以通过目录命名和配置来规避碰撞。先看全局配置骨架重点是模型通道部分{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的key }, cleanupPeriodDays: 30, autoUploadSessions: false }这里有两个参数值得说。cleanupPeriodDays默认 30 天它按编码后的目录名操作。如果你的两个中文目录碰撞到同一个编码名清理时会一起删。建议先把它调大比如 90给自己留出排查时间。autoUploadSessions如果开启碰撞项目的会话会被合并上传建议先关掉等目录规范整理完再决定。项目级配置.claude/settings.local.json里通常放权限相关的「不再询问」设置。注意这份设置也存在编码后的项目目录下所以碰撞的两个项目会共享同一份权限。你为项目甲授予的权限测试乙打开时自动获得。这不是你想要的隔离效果。真正要做的第一件事是把项目目录名改成纯 ASCII。对照表如下原目录名风险建议改为简历2 个汉字 → 2 个连字符resume-site测试中文目录6 个汉字 → 6 个连字符test-cn-dir项目甲3 个汉字 → 3 个连字符project-a测试乙3 个汉字 → 3 个连字符project-b黑马微服务资料8 个汉字 → 8 个连字符heima-microsvc改名的操作很简单但要注意改名后 Claude Code 会把它当成一个新项目旧会话不会自动迁移。所以顺序是——先备份旧会话再改名再验证。# 查看当前所有编码后的项目目录 ls ~/.claude/projects/ # 备份整个 projects 目录 cp -r ~/.claude/projects ~/.claude/projects.bak # 重命名项目目录示例 mv ~/Desktop/测试中文目录 ~/Desktop/test-cn-dir如果你在 Windows 上路径是C:\Users\你的用户名\.claude\projects\用资源管理器或 PowerShell 操作都行。备份这一步别省后面验证会话是否恢复时备份就是你的对照样本。4. 验证请求切换目录后会话是否恢复改完目录名怎么确认会话状态是对的分三步走。第一步确认编码后的目录名不再碰撞。在旧目录和新目录各打开一次 Claude Code然后看.claude/projects/下生成了什么ls -la ~/.claude/projects/ | grep Desktop如果看到两个不同的 ASCII 目录名比如C--Users-...-Desktop-test-cn-dir和C--Users-...-Desktop-project-a说明编码后不再相同碰撞解除。如果还是看到一串连字符说明目录名里还有非拉丁字符继续改。第二步验证--resume列表。进入新命名的目录执行cd ~/Desktop/test-cn-dir claude --resume正常情况下你只会看到这个项目自己的会话。如果列表里出现了别的项目的对话说明还有碰撞残留检查是不是有另一个同长度非拉丁目录存在。第三步发一个真实请求确认模型通道和会话存储都正常。在 Claude Code 里输入一句简单的话比如「帮我列一下当前目录的文件」然后退出再--resume看这条会话在不在。这一步同时验证了两件事TaoToken 的 API 通道通不通会话有没有正确落盘。如果你想单独验证模型通道可以用模型对话页面直接测模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite在对话页面里选一个模型发一条消息能正常返回就说明 Key 和通道没问题。这样排障时就能把「通道问题」和「路径编码问题」分开。实测下来改名 备份 三步验证这套流程走完会话丢失的情况基本不会再出现。关键是别在中文目录下直接开 Claude Code尤其是那种多个中文目录汉字数相同的场景。5. 本篇常见错排查报错一--resume找不到任何会话先看.claude/projects/下有没有对应的编码目录。如果目录名是一串连字符说明当前项目路径含非拉丁字符。解决办法是把目录改成 ASCII或者接受会话存在碰撞目录里的事实。注意改名后旧会话不会自动跟过来需要手动从备份里找。报错二清理一个项目另一个项目的对话也没了这是碰撞的典型症状。两个非拉丁字符数相同的目录映射到同一个编码名claude project purge或cleanupPeriodDays清理时按编码名操作一删全删。排查方法列出.claude/projects/下所有纯连字符目录看是否有多个真实项目共用。解决方法是把目录名改成 ASCII让编码名唯一。报错三在 A 项目里授予的权限B 项目自动生效.claude/settings.local.json里的「不再询问」权限存在编码后的项目目录下。碰撞时两个项目共享同一份设置。这不是权限系统的问题是路径编码碰撞的连带影响。改成 ASCII 目录名后权限自然隔离。报错四autoUploadSessions上传的会话混在一起开启自动上传时碰撞项目的会话会被合并。如果你在意会话归属先关掉这个开关整理完目录再开。配置项在全局settings.json里。报错五改了目录名但 Claude Code 还是读旧路径Claude Code 可能缓存了项目路径。退出所有 Claude Code 进程删掉.claude.json里对应的项目条目先备份再重新进入新目录。如果用的是 IDE 插件重启 IDE。报错六TaoToken 通道返回 401 或 403这跟路径编码无关是 Key 或 header 的问题。检查ANTHROPIC_API_KEY是否设置正确ANTHROPIC_BASE_URL是否是https://taotoken.net/api。如果用的是 Claude Code 的 Anthropic 兼容模式对照接入文档确认 header 格式。排障入口API Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite6. 长期编码与 Agent 场景的稳定通道如果你只是偶尔用 Claude Code 聊几句改个目录名就够了。但如果你把 Claude Code 当成日常编码工具甚至跑 Agent 任务那会话稳定性和通道稳定性都得考虑。长期编码场景下建议做三件事。第一所有项目目录统一用 ASCII 命名团队里约定好规范比如team-project-name这种格式。第二定期检查.claude/projects/下有没有纯连字符目录有就说明还有漏网的中文路径。第三把模型通道固定到 TaoToken用统一的 Key 管理多个工具避免每个工具一套凭证带来的排障成本。Coding Plan 适合需要长期、稳定调用额度的场景Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewriteAgent 类任务对会话连续性要求更高一旦路径碰撞导致会话混在一起Agent 的上下文就可能串项目。所以目录规范这件事越早做越好。我自己的做法是新项目创建时就用英文名中文名只作为显示用途不进入文件系统路径。最后留一个可执行的动作现在打开你的.claude/projects/目录看看有没有纯连字符的文件夹。如果有对照本文第 3 节的表格把对应的真实项目目录改成 ASCII 名然后按第 4 节的三步验证走一遍。这一步花不了十分钟但能避免以后某天发现对话莫名其妙消失。
阅读完成 · 觉得有帮助？
