OpenAI / Codex · 提示过滤排查

OpenAI Invalid prompt 怎么解决?Codex 对话被拦截排查

如果 Codex 突然显示 “Invalid prompt: your prompt was flagged as potentially violating our usage policy”,不必先删除整个项目。本文解释这条提示代表什么,并给出两种恢复原会话的方法:在当前工作树继续,或用会话 ID 开启新会话。

更新日期:2026-09-01·作者:island AI Coding 技术团队·主词:OpenAI Invalid prompt
错误文本Invalid prompt
常见线索上下文或安全过滤
恢复方式工作树 / 会话 ID

1. 这条提示到底表示什么

Invalid prompt: your prompt was flagged as potentially violating our usage policy 的重点是 prompt 被安全系统标记,并不等同于“模型不可用”或“账号已经被封”。“potentially”也说明系统是在当前文本或上下文中发现了潜在风险,不代表每一次判断都准确。

长时间的 Coding 会话尤其容易积累旧消息、工具输出、文件内容和错误日志。新问题本身很普通,但它和历史上下文组合后可能触发过滤。先保留会话和错误时间,不要连续重复发送完全相同的请求。

边界先说清楚不要把这篇文章当作绕过安全策略的教程。合规任务可以通过澄清用途、缩短上下文来降低误判;不符合使用政策的请求应停止并改成合法、无害的目标。
OpenAI Responses 端点返回 invalid_api_key 与政策页面当前网络状态的脱敏分层探针
分层探针:脱敏无效 Key 在 Responses 端点先得到 HTTP 401,说明认证失败与 prompt 过滤不是同一分支;本次没有提交真实用户 Prompt,也没有触发或复现安全拦截。

2. 先做三项低风险检查

  1. 复制完整错误文本,记录模型、客户端版本、会话时间和是否经过 API 中转。
  2. 新开一个最短测试请求,例如让模型解释一段不含敏感内容的代码,观察是否仍然报错。
  3. 检查是否把旧会话、整仓库文件或外部工具输出自动拼接到了新提示中。

如果短请求正常,问题更像是原会话上下文触发;如果所有新会话都失败,再检查账号状态、密钥权限、Base URL 和平台响应记录。

3. 方法一:右键会话,选择“在此工作树中继续”

这是恢复原任务最省事的方式。它保留当前工作树和会话关联,适合刚刚出现一次过滤提示、代码改动还没有整理完的情况。

  1. 在 Codex 会话列表中找到出现 Invalid prompt 的会话。
  2. 右键会话,选择“在此工作树中继续”(英文界面通常是 Continue in this worktree)。
  3. 先发送一句短说明:请总结当前工作树已完成的改动和待办,不要重复上一条被拦截的提示。
  4. 确认摘要正常后,再把原任务拆成一个明确、合规的小步骤。

如果菜单项不可用或继续后马上再次失败,不要反复点击重试,直接使用下一种会话 ID 恢复方式。

4. 方法二:复制会话 ID,在新会话中恢复

当原会话上下文已经很长,或者工作树菜单无法恢复时,可以把会话 ID 带到新会话。这里的关键是传递引用,不要把整段敏感历史重新粘贴

  1. 在原会话菜单中选择“复制会话 ID”。
  2. 新开一个 Codex 会话,把复制的 ID作为 prompt 的一部分。
  3. 明确要求先读取会话状态并总结,再继续未完成工作。
  4. 新会话开始后,只补充当前必要文件和下一步目标。
新会话首条提示模板
请继续会话 SESSION_ID。
先读取该会话的工作状态,简要总结已完成内容和待办事项;
然后只执行下一步合规的软件工程任务,不要重复触发过滤的原始提示。
如需文件,请先列出要读取的路径。

SESSION_ID 替换为真实会话 ID。不要把访问令牌、API Key 或私人数据放进文章、工单或公共日志。

5. 减少误判的提示词写法

改写提示词的目标是让任务边界更清楚,不是规避检测。对普通代码任务,可以去掉与目标无关的敏感背景,明确输入、输出和测试范围。

容易造成歧义更清晰的写法
“帮我处理这个系统并绕过限制”“在本地项目中定位表单校验逻辑,解释输入边界,并补充单元测试。”
一次粘贴整段历史和全部日志只提供相关文件、最小错误片段和期望结果
让模型直接执行不明来源的脚本先要求解释脚本影响,再逐步验证每个命令
重复发送被拦截的原文保留任务目标,删除不必要的敏感细节并重新组织

6. 中转 API 用户的分层排查

使用 OpenAI 兼容中转时,错误可能来自客户端、平台网关或上游安全过滤。先看控制台请求记录和完整响应正文,确认返回层级;不要只凭客户端的一行红字判断。

  1. 控制台没有请求记录:检查 Base URL、密钥、代理和客户端是否真的发出了请求。
  2. 平台有请求且返回 Invalid prompt:保留 request id,缩短上下文后重试一次合规短请求。
  3. 短请求正常、原会话失败:优先用工作树继续或会话 ID恢复,不要立即换模型。
  4. 所有模型都失败:检查账户状态、密钥权限、平台公告和服务状态。

island AI Coding 的 OpenAI 兼容 Base URL 为 https://www.codex789.com/v1;模型代号和密钥可用范围以模型广场、创建密钥页面和控制台为准。

7. 常见问题

?OpenAI Invalid prompt 是账号被封了吗?

不一定。它表示当前提示或上下文被安全系统标记,可能是命中规则,也可能是长上下文造成的误判。用合规短请求和新会话做对照。

?Codex 对话被拦截后怎么继续?

先右键原会话,选择“在此工作树中继续”。如果菜单不可用,复制会话 ID,新开会话后让 Codex 先读取会话状态再继续。

?需要删除整个项目或重新安装 Codex 吗?

通常不需要。先保留工作树和配置,区分上下文过滤与认证、网络问题;只有明确的安装损坏证据才考虑重装。

?怎样降低再次触发 Invalid prompt 的概率?

使用清晰、合规的任务描述,减少无关历史和敏感细节,分小步骤处理,并避免自动重复提交同一条被拦截的 prompt。

* 本文为 island AI Coding 技术团队原创整理,依据 OpenAI 使用政策、Codex 客户端会话操作和公开用户反馈改写。安全过滤规则、菜单名称与客户端行为可能随版本变化;不要将本文用于规避安全限制。更新时间:2026-09-01。

参考:OpenAI 使用政策 · Codex 官方开发者文档