Codex CLI 怎么粘贴图片:输入框粘贴、-i / --image 参数、多张图写法,以及桌面 App 要按住 Shift 拖拽

想把报错截图或设计稿发给命令行里的 Codex?官方说明可以直接粘贴进输入框,也可以用 codex -i 图片路径 或 --image 随提示词传入,多张图用逗号分隔。本文按官方 Image inputs 页整理,并说明桌面 App 和 IDE 拖拽要按住 Shift。

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

结论先说

  1. 官方说命令行有两条路:在交互输入框里粘贴图片,或者启动时用 -i / --image 把文件传进去。
  2. 粘贴没反应就用参数。 参数写法是官方给的,不依赖终端怎么处理剪贴板。
  3. 多张图用逗号分隔路径,或重复写 --image。 官方说明 Codex 接受常见格式,包括 PNG 和 JPEG。
  4. 桌面 App 和 IDE 扩展里,拖拽图片时要按住 Shift,这样应用才会接收图片,而不是把它交给编辑器。
  5. 提示词要围着图写。 官方明确说,不要只靠图片本身来表达任务,要说清让它看什么、要什么结果。

在 Codex 命令行里给图片的三种方式:粘贴进输入框、-i / --image 参数、codex exec 带图

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

本文根据 Codex 官方文档《Image inputs》和命令页整理,资料核对于 2026-11-13。官方没有写命令行里粘贴图片用哪个快捷键,所以本文把能确认的写法放在前面,粘贴不成功时给出更稳的备选。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 OpenAI 官方网站。第一次使用见 /guides/codex-getting-started。

适用于谁

  • 想把报错截图、界面截图、设计稿或架构图发给命令行里的 Codex 的人;
  • 在终端里粘贴图片没反应,不知道还有什么办法的人;
  • 在桌面 App 或 IDE 里拖拽图片总被编辑器抢走的人。

一、在交互界面里粘贴

官方 Image inputs 页的命令行部分第一句就是:把图片粘贴进交互式输入框。你可以先复制截图(系统截图工具复制到剪贴板的那种),再回到 Codex 的输入框里粘贴,粘贴后接着写提示词,比如要它解释报错、对比两张界面,或者按设计稿改样式。

要注意两点:

  • 官方没有写粘贴图片的具体按键。 不同终端模拟器对剪贴板里图片的处理不一样,有的能直接粘贴,有的什么也不发生。本文不替你断言哪个组合键一定可用;
  • 粘贴不成功不代表你的账号或 Codex 有问题,换成下面的参数写法即可。

二、更稳的写法:启动时带 -i 或 --image

官方给的两个例子:

bash
codex -i screenshot.png "Explain this error and suggest the smallest fix"
codex --image before.png,after.png "Compare these states and list the regressions"

第一条是带一张图并要求解释报错、给出最小修复;第二条是带前后两张图,要求对比并列出退化的地方。你可以把引号里的英文换成自己的中文要求,参数写法不变。

几点细节:

  • 多张图可以用逗号分隔路径,也可以重复写 --image;
  • 路径里有空格时,按你所用终端的规则加引号;
  • 命令是在你的项目目录里启动的,图片放在哪里都行,只要路径写对;
  • 这两个参数是随「第一条提示」带入的。要在对话进行到一半时补图,用粘贴的方式。

三、codex exec 和 /plan 里怎么带图

非交互模式 codex exec 同样可以带图。官方命令页写明,使用图片时必须同时提供提示词,否则运行不了;也可以用 - 作为提示词,从标准输入读取。/plan 命令的内联参数里,官方也提到可以粘贴内容或附加图片。具体的命令总览见 /guides/codex-cli-commands-cheatsheet。

四、桌面 App 和 IDE:拖拽时按住 Shift

如果你用的是桌面 App 或 IDE 扩展,官方的说法是:把图片拖进提示输入框时按住 Shift,这样界面才会把图片作为上下文接收。在 IDE 里这点尤其重要,因为不按 Shift,编辑器会把拖拽当成「在编辑器里打开这个文件」。

官方还提到,在桌面 App 里你也可以让 Codex 去检查系统里某张图片,或用截图工具来验证它在另一个应用里的工作结果。网页版的 ChatGPT 则是直接附加、粘贴或拖入图片。

五、提示词怎么围着图写

官方建议的结构是:说明图里是什么,指出要关注的区域,再说明想要的输出和限制。如果有多张图,要分别说明每一张是什么,以及怎么比较。官方的示例是:

text
Compare this checkout screen with the design. Fix spacing and typography only;
do not change behavior. Verify the result with a new screenshot.

翻成中文思路就是「对比当前页面和设计稿,只改间距和字体,不改行为,改完用新截图验证」。下面是本站按这个结构给出的几段中文提示词,括号里的内容自己填:

text
这张图是 [报错弹窗的截图]。请告诉我:1. 报错的完整文字;2. 最可能的原因;3. 在 @[文件路径] 里应该改哪里。先只分析,不要改文件。
text
图 1 是设计稿,图 2 是现在的页面。请列出两张图的差异,只关注 [按钮区域],并且只改样式,不改逻辑。改完说明你验证了什么。

写报错类提示词时,也可以参考 /guides/codex-fix-bug-error-repro-prompt:截图只是线索之一,复现步骤和约束同样重要。

六、看图和生成图不是一回事

官方在 Image inputs 页末尾区分了两类功能:图片输入是让它检查一张已有的图片;要让它创建或编辑图片,用的是图像生成功能,在官方的 Image generation 页另有说明。本文只讲前者。

图片发不进去时的判断图:命令行粘贴没反应用 -i 参数,多张图逗号分隔,桌面 App 拖拽按住 Shift,生成图片是另一个功能

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

常见问题

Q:图片里有密钥、手机号、内部地址怎么办?

发送前先打码或裁掉。图片和文字一样会被作为提示内容发送,检查清单见 /guides/ai-privacy-data-safety-checklist。

Q:支持哪些图片格式?

官方写的是「常见格式,包括 PNG 和 JPEG」,没有给完整清单。拿不准时,用 PNG 或 JPEG。

Q:用图会多花额度吗?

官方这几页没有单独写图片的计费规则。Codex 的额度按任务消耗,和套餐有关,查看方法见 /guides/codex-usage-limits。如果你经常用截图排查问题、额度不够用,可以看看本站的 ChatGPT Plus 充值说明,价格和额度以官方页面当前显示为准。

Q:同一个问题,用哪个模型看图更好?

官方的模型页写了各模型适合的任务,切换方法见 /guides/codex-switch-model-reasoning-effort。

相关教程

参考资料

  • Codex 官方文档:Image inputs — https://learn.chatgpt.com/docs/image-inputs
  • Codex 官方文档:Commands(CLI) — https://learn.chatgpt.com/docs/developer-commands?surface=cli
  • Codex 官方文档:Codex CLI — https://learn.chatgpt.com/docs/codex/cli

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 条评论

登录 后参与评论

还没有评论,来抢沙发~