Codex 提示「无法将此项目用于本地聊天」怎么办:官方没单独说明,按项目类型、文件夹、Git、信任状态和运行位置排查

Codex 桌面 App 提示无法将此项目用于本地聊天?官方没有收录这句提示,但写明了本地项目、ChatGPT 项目和远程项目的区别,以及 Local、Worktree、Cloud 三种运行位置、Git 要求和信任状态。本文按官方通用说明列出排查顺序。

NNathaniel bigo··原创首发·AI 辅助撰写
12 分钟读完
资料核对于 2026-11-13 · 依据官方文档与公开资料整理 Plus 账号

结论先说

  1. 先分清项目类型。 官方的 Projects 视图里同时有 ChatGPT 项目和本地项目:前者在多个对话间共享文件和上下文,不直接访问你电脑上的文件夹;后者连接到你电脑上的文件夹。
  2. 再确认运行位置。 新对话可以选 Local、Worktree 或 Cloud;Local 和 Worktree 在你的电脑上运行,Cloud 在远程环境里运行。
  3. 本地项目要有可用的文件夹。 文件夹被移动、改名或删除之后,项目就连不上了,可以在项目菜单里编辑,或移除后重新添加。
  4. 用 Worktree 要有 Git。 Windows 上没装 Git,部分功能不可用;从 \\wsl$ 路径打开的项目,Git 可能检测不到。
  5. 仍不行就用 /feedback 附上诊断联系官方。

无法将此项目用于本地聊天的排查:项目类型、远程项目、文件夹、Git 与工作树、WSL 路径

图:本站根据 Codex 官方文档《Projects and chats》 整理的示意图

本文根据 Codex 官方文档《Projects and chats》《Codex environments》、Windows 应用页和配置页整理,资料核对于 2026-11-13。官方没有收录「无法将此项目用于本地聊天」这句提示,也没有解释触发它的条件,所以下面每一条都是官方文档里与「本地项目、本地运行」相关的通用说明,用来帮你逐项排除,不是对这句话的官方解读。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 OpenAI 官方网站。

适用于谁

  • 在 ChatGPT 桌面 App 里想用某个项目开始 Codex 本地对话,却被提示不能用的人;
  • 分不清自己的项目是 ChatGPT 项目、本地项目还是远程项目的人;
  • 想知道 Local、Worktree、Cloud 三种运行位置有什么区别的人。

一、先分清三种项目

按官方《Projects and chats》页,桌面 App 里可能碰到三类:

  • ChatGPT 项目:把相关的对话、文件、指令和来源放在一起,同一个项目里可以有 Chat 或 ChatGPT Work 开始的对话。官方在网页版部分明确写道:ChatGPT 项目不提供对你电脑上文件夹的直接访问,要让它用到哪些资料,需要上传或连接来源;
  • 本地项目:连接到你电脑上的文件夹,ChatGPT 可以读取和修改其中的文件。官方说明项目本身不需要文件夹,但可以按需附加;
  • 远程项目:连接到 SSH 主机上的项目。官方说明远程项目的对话在远程主机上读写文件、运行命令,并且目前只支持一个文件夹。

如果你要做的是「在自己电脑上让 Codex 改代码」,需要的是本地项目。看到提示后,先看这个项目的类型,再往下查。

命令行和 IDE 的做法不同:官方说明 Codex CLI 把你启动它的目录当作对话的项目,用 --cd <目录>(-C)也可以显式指定;IDE 扩展则把 IDE 里打开的文件夹或工作区当作本地项目。它们都不显示 ChatGPT 的 Projects 视图。

二、确认运行位置

官方《Codex environments》页写明:在桌面 App 里打开 ChatGPT 下拉菜单,选择 Codex,开始新对话时选择运行位置:

  • Local:直接在当前项目目录里工作;
  • Worktree:用 Git 工作树隔离改动;
  • Cloud:在自己的工作区里运行远程任务。

Local 和 Worktree 都在你的电脑上运行。官方还说明可以用 Work in 选择 This computer 或 Cloud;对本地的 Git 项目,另有独立的 Worktree 控件,让改动和当前检出隔离。

如果你选了 Cloud, 官方提醒:云端任务使用它自己环境里的文件和服务,你电脑上的本地文件、运行中的进程、浏览器登录和 VPN 访问不会自动转移过去。所以想在自己电脑上用本地项目,要确认选的是 This computer(Local)。云端任务的用法见 /guides/codex-cloud-how-to-use。

在 App 里新建本地聊天的顺序:选 Codex、选运行位置、确认项目文件夹、检查 Git 与信任

图:本站根据 Codex 官方文档《Codex environments》 整理的示意图

三、检查项目文件夹

官方《Projects and chats》里的相关做法:

  • 打开项目菜单,选 Edit project,用 Add folder 给项目附加文件夹;一个项目可以附加多个文件夹;
  • 要改默认的工作目录,指向某个文件夹并选 Make primary。新对话从主文件夹开始,Codex 也以主文件夹作为 Git 操作和 AGENTS.md、技能、config.toml 自动发现的默认位置;其他文件夹只用于文件搜索、读取和编辑,不会自动发现那里的项目文件;
  • 如果项目被移出了侧栏,官方的做法是:悬停项目名,点三个点,选 Remove 移除;要恢复,用 Add new project 按钮重新添加,或按 Cmd+O。

所以如果你的项目文件夹被移动、改名、换了盘符或者没有权限,最直接的办法是把项目重新指向现在的位置,或移除后重新添加。AGENTS.md 的读取规则见 /guides/codex-agents-md-how-it-reads。

四、Git 与工作树

如果你选的是 Worktree,或者项目要用 Git 功能,官方 Windows 应用页有两条相关说明:

  • 没有安装原生 Windows 版 Git: 应用无法使用部分功能。官方给的安装命令是在 PowerShell 或 cmd.exe 里运行 winget install Git.Git;
  • 从 \\wsl$ 打开的项目: 官方说明 Git 可能检测不到。目前最可靠的办法是把项目放在 Windows 原生磁盘上,再在 WSL 里通过 /mnt/<盘符>/... 访问。

另外,官方在 /worktree 命令的说明中写明:它需要本地工作树支持,并且在任务运行时不可用。工作树的详细用法见官方《Worktrees》页。

Windows 上的安装、沙箱和 WSL 设置见 /guides/codex-windows-app-download-install,沙箱初始化失败见 /guides/codex-windows-sandbox-setup-failed。

五、项目是否被信任

官方配置页写明:出于安全考虑,Codex 只在项目被信任时才加载项目范围的配置文件。如果项目不受信任,Codex 会忽略项目里的 .codex/ 层,包括 .codex/config.toml、项目本地的钩子和项目本地的规则,用户层和系统层配置仍会加载。可以在用户配置的 projects 表里给某个项目或工作树标记 trust_level 为 trusted 或 untrusted。

要注意:官方没有写「项目不受信任就不能本地聊天」,所以这一条只是用来解释「为什么项目里的配置没生效」,不要当作这条提示的原因。

另外,Codex 通过 .git 判断项目根目录。官方的 project_root_markers 可以改这个判断规则;设为空列表则把当前工作目录当作项目根,不再向上查找。

六、几个容易混淆的场景

  • 从手机或另一台设备继续任务: 官方说明同步对话不会上传整个本地文件夹,也不会让另一台电脑能访问它。要使用本地文件,需要在工作区开启本地电脑访问后,开始一个新的云端任务,并保持存放文件夹的电脑在线并连接。官方排查页写道:如果在电脑离线时开始了一轮,它可能在没有这些文件访问权限的云端容器里运行。
  • 设置了 SSH 远程项目: 本地聊天和远程聊天是两条路,远程项目要在远程主机上管理,见 /guides/codex-remote-control-ssh-host。
  • 改了配置没生效: 先查项目是否被信任、是否改的是你实际使用的家目录。

七、还是不行

在 Codex 里输入 /feedback,按提示附上日志或诊断提交。反馈时写明:项目类型(ChatGPT 项目、本地项目还是远程项目)、运行位置、操作系统、是否安装了 Git,以及这句提示的完整原文。其他常见报错见 /guides/codex-common-errors-summary。

常见问题

Q:本地聊天要付费吗?

Codex 随 ChatGPT 套餐提供,额度按官方规则计算,见 /guides/codex-usage-limits。如果你想要更多额度,可以看看本站的 ChatGPT Plus 充值说明,价格和额度以官方页面当前显示为准。

Q:命令行里也会遇到这句吗?

官方文档没有写。命令行把启动目录当作项目,换到正确的目录再启动即可,见 /guides/codex-cli-commands-cheatsheet。

Q:App 和命令行选哪个更省心?

见 /guides/codex-app-vs-cli-which-better。

相关教程

参考资料

  • Codex 官方文档:Projects and chats — https://learn.chatgpt.com/docs/projects
  • Codex 官方文档:Codex environments — https://learn.chatgpt.com/docs/environments/modes
  • Codex 官方文档:ChatGPT desktop app for Windows — https://learn.chatgpt.com/docs/windows/windows-app
  • Codex 官方文档:Advanced Configuration — https://learn.chatgpt.com/docs/config-file/config-advanced
  • Codex 官方文档:Troubleshooting — https://learn.chatgpt.com/docs/reference/troubleshooting

Nathaniel 的更多内容

  1. 01

    LangGraph 流式输出(Streaming)详解:逐字 Token 流、节点进度与自定义事件写法

    多步智能体如果等全部节点跑完才返回,网页前端就会白屏干等十几秒。本文按 LangGraph 官方文档讲清 updates、messages、custom 与 values 四种 stream_mode 的区别,以及组合订阅逐字打字机输出加工具内部实时进度的完整代码。

    其他 AI 工具0
  2. 02

    LangGraph 持久化与长期记忆怎么配:Checkpointer、Store 与 PostgreSQL 实战

    在生产环境跑 LangGraph,单靠 InMemorySaver 一重启就会丢失全部对话。本文按官方文档讲清线程内短期检查点(Checkpointer)与跨线程长期记忆(Store)的分工,以及用 langgraph-checkpoint-postgres 对接 PostgreSQL 的完整步骤。

    其他 AI 工具0
  3. 03

    LangGraph 多智能体怎么写:Supervisor 主管包与 Subgraph 隔离子图实战

    在 LangGraph 里把单个图扩展成多智能体协作有两条官方路线:快速原型用预置包 langgraph-supervisor,大型生产系统用原生子图(Subgraph)嵌套。本文讲清两种写法的完整代码、私有状态隔离防 Token 膨胀技巧以及检查点传播规则。

    其他 AI 工具0
  4. 04

    LangGraph 人工介入审批怎么写:interrupt 暂停图运行与 Command 恢复实战

    企业之所以选 LangGraph,很大程度看中它能安全挂起等待人工审批(Human-in-the-Loop)。本文按官方最新规范讲清 interrupt() 动态暂停、Checkpointer 必备条件、Command(resume=...) 恢复执行,以及防止副作用重复运行的重入规则。

    其他 AI 工具0
  5. 05

    多 Agent 协作平台怎么选:Dify、扣子(Coze)、n8n 与 LangGraph 多智能体机制对比

    搜「多agent协作平台」时,Dify、扣子、n8n 和 LangGraph 都宣称支持多智能体,但底层的调度方式完全不同。本文跳过基础安装,专门从多 Agent 角色跳转、子代理工具调用、上下文隔离与私有化部署四个维度帮你一次选准。

    其他 AI 工具0
  6. 06

    企业微信有官方 MCP 和 CLI 吗:@wecom/cli 安装初始化、长连接机器人与接入教程

    搜「企业 微信 有 mcp 吗」不用再东拼西凑民间群机器人脚本了:企业微信官方已推出 @wecom/cli 命令行工具并内置 stdio 模式的 MCP Server。本文按官方开发者文档讲清安装、智能机器人长连接初始化、业务命令与接入 Claude Code 步骤。

    Claude其他 AI 工具0

同产品的其他教程

  1. 01

    AutoGen 现在怎么样了?微软官方演进路线与 Microsoft Agent Framework 入门

    搜 AutoGen 新教程常被 0.2、0.4、社区分支和 Semantic Kernel 绕晕。按微软官方文档,微软已将 AutoGen 与 Semantic Kernel 两支团队合并推出统一的开源框架 Microsoft Agent Framework。本文讲清现状与 Python 快速上手。

    ChatGPT其他 AI 工具0
  2. 02

    多 Agent 的成本为什么翻倍、怎么控制:Token 膨胀根源与五项降本措施

    刚把单智能体拆成多 Agent,用量往往暴涨好几倍。Anthropic 工程报告统计单智能体约为聊天的 4 倍 Token,多智能体可达约 15 倍。本文拆解固定前缀重复加载、历史搬运、工具链定义与缓存失效四大根源,并给出五条实操控费办法。

    ChatGPTClaude0
  3. 03

    多 Agent 协同开发怎么落地:「一个写、一个审」双代理工作流搭建指南

    多 Agent 协同开发里投入产出比最高的模式就是「一个写、一个审」。本文依据 Anthropic 与 OpenAI 官方编码最佳实践,讲清为什么同会话自审容易漏问题,以及用只读子代理、跨模型交叉审查(Claude Code + Codex)和自动化闭环落地的具体方法。

    ClaudeCodex0
  4. 04

    多 Agent 编排模式详解:编排者-工作者、交接(Handoffs)、并行与评估循环怎么选

    搜「multi-agent orchestration 中文」会被各家框架的不同术语绕晕。本文对照 Anthropic《Building effective agents》与 OpenAI 智能体指南,把编排者-工作者、去中心化交接、并行分片投票与生成-评估循环四种标准编排拓扑讲透。

    ChatGPTClaude0
  5. 05

    多智能体(Multi-Agent)是什么、什么时候该用:Anthropic 与 OpenAI 官方判断标准

    多智能体不是代理越多越聪明。本文依据 Anthropic 研究系统架构文章与 OpenAI 官方智能体指南,讲清确定性工作流、单智能体与多智能体的区别,以及哪三类瓶颈才值得上多智能体协同。

    ChatGPTClaude0
  6. 06

    codebase-memory 类 MCP 是什么、怎么用:基于语法树图谱的本地代码索引原理与配置

    codebase-memory-mcp(DeusData/codebase-memory-mcp)是一类本地代码图谱 MCP 服务器:用 Tree-sitter 把仓库解析成函数与调用关系的 SQLite 图库,帮编码助手查调用链并省下读整份文件的额度。

    ClaudeCodex0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~