项目文件是否保留取决于是否启用云端持久化工作空间;只要传入匹配的project_id且longmemoryprovider已启用,切换agent后文件仍保留在/workspace/下。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Agent Space中切换AI Agent(如从Codex换成Claude Code)后,项目文件是否保留,取决于你是否启用了云端持久化工作空间,而不是单纯依赖本地配置或临时会话。
Agent切换时文件保留的核心前提
Agent Space的文件保留机制与Agent类型无关,只与Workspace绑定状态有关。只要你在创建Session时显式传入了【project_id必须与代码仓库根目录名或CI/CD流水线ID严格一致】,且longMemoryProvider已启用(如MEMOS或Mem0),所有写入/workspace/下的文件都会自动持久化到云端存储层。
若未传project_id,或openLongMemory为false,则切换Agent后新建的Session将生成全新空白工作空间,原文件不可见——这不是“丢失”,而是根本未归属到可恢复的上下文锚点中。
三种典型切换场景下的文件状态
方法一:同一Workspace内切换Agent(推荐)
在Agent Space Web界面或CLI中执行agent switch --to claude-code --workspace fscloud-v2。该操作不重启Workspace,仅更换运行时模型与工具链,/workspace/fscloud-v2/下所有文件、Git状态、未提交变更均保持原样。
这一步无需额外配置,但前提是当前Workspace已通过create_session(project_id="fscloud-v2")初始化过,否则命令会报错“no bound project”。
方法二:CC Switch切换后启动新Codex实例
用CC Switch切换Codex配置→点击「应用并重启 Codex」→终端重新加载。此时新Codex进程仍会挂载原有Workspace路径(默认~/.codex/workspaces/fscloud-v2),只要没手动删掉该目录,文件全在。
⚠️ 注意:如果旧Codex曾把临时产物写在/tmp/codex-tmp或./build这类非Workspace路径下,这些文件不会跟随切换保留,因为它们不在持久化路径体系内。
方法三:完全脱离Agent Space,在本地终端直接运行claudel --workspace ./myproj
这种用法绕过了Agent Space的持久化层,所有文件仅存于本地./myproj目录。切换Agent只是换了个命令行工具,目录本身不受影响,但无法享受云端同步、Session恢复、团队协作等能力。
验证文件是否真实保留的操作步骤
第一步:切换Agent后,立即在终端执行ls -la /workspace/
第二步:确认输出中存在与project_id同名的子目录(如fscloud-v2),且其内部有.git、src/、AGENTS.md等原始结构
第三步:运行cat /workspace/fscloud-v2/.agent_space_meta.json,检查"bound_at"字段时间戳是否早于切换操作时间——若是,则证明是延续旧空间;若不存在该文件,则为全新初始化
第四步:打开Agent Space Web控制台 → 进入对应Workspace → 查看「文件浏览器」右侧状态栏,显示“Connected to cloud storage: ✅”即表示云端同步通道正常











