Codex中切换代码仓库本质是切换项目空间:通过「New Project」选择本地仓库根目录创建空间,或用快捷键/Ctrl+Shift+P快速激活已有项目;CLI模式需先退出再cd至目标路径后运行codex。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在 Codex 中切换不同代码仓库,本质是切换当前会话绑定的项目空间与工作目录,而非简单地“换一个文件夹”。如果你正在处理多个本地项目,又不想反复关闭重开 App 或手动改路径,必须通过 Codex 的项目空间机制完成隔离与跳转。
用项目空间管理多个仓库
点击左上角「+ New Project」→ 选择「Local Folder」→ 浏览并选中目标代码仓库根目录(如 【必须是 Git 仓库根或含 package.json/pyproject.toml 的有效工程目录】)→ 点击「Create」。
创建后,该项目会出现在左侧项目列表中,带图标和名称。Codex 会自动识别 .git、构建配置、语言特征,初始化对应上下文环境。
后续每次点击该空间名称,Codex 就会加载其专属的会话历史、终端上下文、模型偏好和权限设置——这才是真正意义上的“切换仓库”,不是临时 cd。
快速切换已有项目空间
方法一:点击左侧项目列表中的任一已存项目名,立即激活该空间。
方法二:按快捷键 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入「Switch Project」,从下拉列表中选择目标项目。
方法三:右键项目列表空白处 → 「Open Recent」→ 选择最近打开过的仓库。注意:这里只显示最近 10 个,超出需手动进列表找。
在 CLI 模式下切换仓库
第一步:退出当前 codex 会话,按 Ctrl+C 或输入 exit。
第二步:终端中执行 cd /path/to/another/repo,确保当前路径是目标仓库根目录。
第三步:运行 codex(不带参数)。Codex CLI 会自动检测新路径下的工程特征,并启动全新会话上下文。
⚠️ 这一步不能省略 cd —— 如果直接在原目录下执行 codex --project /other/path,会报错或降级为无上下文模式。Codex CLI 不支持运行时跨目录热切换,必须先退出再进新目录。
终端内绑定仓库路径(仅限 Codex App)
点击右上角终端图标 → 「New Terminal」→ 在弹出窗口中勾选「Use project root as working directory」→ 确认。
这样新建的终端会自动 cd 到当前项目空间根目录,且所有命令(如 git status、npm run dev)都在正确路径下执行。
如果忘记勾选,终端默认在 Codex App 安装目录启动,执行 git 命令会提示 not a git repository。此时只能关掉重开,或手动输入 cd /your/project/path。


















