本文根據 Claude Code 官方文檔整理,資料核對於 2026-10-30。官方沒有為「粘貼失敗」「無法讀取圖片」單獨寫排查說明,這裏把官方寫明的放圖方法列出來,再給通用的排查順序。配圖為本站整理的示意圖,不是軟件截圖。
適用於誰
- 在終端裏用 Claude Code,想讓它看一張報錯截圖或設計稿,卻粘貼不上的人;
- 寫了圖片路徑,Claude 卻說讀不到的人。
結論先說
- 官方「Work with images」一節寫明,把圖放進 Claude Code 對話有三種方法:
- 拖放:把圖片拖進 Claude Code 窗口;
- 粘貼:複製圖片後在命令行裏按
Ctrl+V,在 Windows 和 WSL 上用Alt+V; - 給路徑:在提問裏直接寫圖片路徑,例如
Analyze this image: /path/to/your/image.png。
- Windows 和 WSL 先試
Alt+V。快捷鍵清單見 /guides/claude-code-keyboard-shortcuts,裏面也寫了這一條。 - 粘貼不行,就改用拖放或寫路徑,這兩種方法不依賴剪貼簿。
- 一次對話裏可以放多張圖;Claude 引用圖片時會顯示
[Image #1]這樣的標記,按住Cmd點擊(Mac)或Ctrl點擊(Windows、Linux)可以用預設的圖片查看器打開。 - 懷疑安裝或設定本身有問題時,運行
/doctor;claude完全啟動不了,就在 shell 裏運行claude doctor。

圖:本站根據 Claude Code 官方文檔 整理的示意圖
一、官方寫明的三種方法
拖放
直接把圖片文件拖進 Claude Code 所在的窗口。如果你是在編輯器自帶的終端裏用,拖放的效果取決於那個終端是否接收文件,行不通就換另外兩種。
粘貼
先複製圖片(比如截圖工具截下來的圖),回到 Claude Code 的輸入框按快捷鍵:
- macOS、Linux:
Ctrl+V; - Windows、WSL:
Alt+V。
官方把 Windows 和 WSL 單獨列出,沒有解釋原因。注意這是粘貼圖片的快捷鍵,粘貼文字用你的終端自己的快捷鍵。
給路徑
不依賴剪貼簿,最穩。把圖片儲存到本地,提問時寫路徑,路徑可以是相對的也可以是絕對的。輸入 @ 還會彈出路徑提示選單,用 Enter 或 Tab 選中,再按 Enter 發送,這是官方在「引用文件」裏寫的做法,對文件通用。
二、通用排查順序
官方沒有逐條說明,下面按從簡單到複雜:

圖:本站根據 Claude Code 官方文檔 整理的示意圖
- 換快捷鍵:Windows、WSL 用
Alt+V;其他系統用Ctrl+V。 - 確認剪貼簿裏真的是圖片:從截圖工具直接複製,或在圖片查看器裏複製,而不是複製了文件名。
- 改用拖放或路徑。
- 路徑方式讀不到:核對路徑拼寫、文件是否真的存在、你啟動
claude的目錄是否是你想的那個。 - 提示的是 API 報錯而不是找不到圖片:官方有「Error reference」頁,429、529 等的說明見本站 /guides/claude-api-error-429-rate-limit、/guides/claude-api-error-529-overloaded,其他常見報錯見 /guides/claude-code-common-errors。
- 還是不行:
/doctor檢查安裝和設定;去官方 GitHub 倉庫看是否是已知問題,或用/feedback反饋。
三、放圖之後怎麼問
官方給的幾類問法,適合直接套用:
- 「這張截圖裏的介面元素有哪些?」
- 「這是報錯截圖,原因是什麼?」
- 「這是我們現在的數據庫表結構,新功能該怎麼改?」
- 「照這個設計稿生成對應的 CSS。」
圖片適合用在文字描述不清楚或太囉嗦的時候,比如報錯截圖、介面設計和流程圖。
常見問題
Q:Claude Code 能看影片或 PDF 嗎?
官方這一節只講圖片。PDF、表格等文件,可以用 @ 引用,具體限制以官方文檔為準。
Q:網頁版 Claude 上載圖片失敗呢?
那是另一個場景,限制見 /guides/claude-file-upload-limits。
Q:還沒裝好 Claude Code?
見 /guides/claude-code-install-methods-git-npm-official。需要訂閱的話,本站有 Claude Pro 充值頁。
參考資料
- Claude Code Common workflows(Work with images) — https://code.claude.com/docs/en/common-workflows
- Claude Code Troubleshooting — https://code.claude.com/docs/en/troubleshooting
0 條評論
還沒有評論,來搶沙發~