如何將螢幕截圖貼到 Claude Code
簡短的答案:在 Windows 上,不要依賴 Ctrl+V。使用 Claude Code 的貼上快速鍵、將圖像檔案拖曳到終端機,或在提示中按路徑參考檔案。本頁涵蓋所有三種方法、為什麼一般剪貼簿貼上不斷消失,以及如何調整螢幕截圖的大小,使其不會花費一千個符號。
您想顯示 Claude Code 一個螢幕截圖,一個錯誤對話、破損的版面配置、設計框架,而打字會花永遠。 問題是終端機不是聊天框:相同 Ctrl+V 在 Windows 中經常在其他地方粘貼影像的東西在這裡什麼都不做,特別是在 WSL 內。影像沒有丟失;終端機只是從未收到它。修復是使用不依賴脆弱的點陣圖剪貼簿路徑的路由,有三個可靠的路由。
這是 Maxisnap 發佈的指南。Maxisnap 製作一個 Windows 螢幕截圖工具,其匯出正是為這個交付而構建的,所以它出現在相關的地方,但下面的路由適用於任何螢幕截圖,來自任何工具。
我可以給 Claude Code 影像的三種方式是什麼?
Claude Code 接受以三種方式接受影像,在 Windows 上它們不相等可靠。粗略的依存順序:
| 路由 | 如何 | Windows / WSL 上的可靠性 |
|---|---|---|
| 提示中的檔案路徑 | 輸入或貼上已保存影像的路徑,例如 C:\Users\you\shot.png,在您的訊息中。 | 最可靠,無剪貼簿涉及 |
| 將檔案拖入 | 從資源管理器(或直接從捕獲工具)將影像檔案拖到終端機視窗。 | 當終端機支援拖曳時可靠 |
| 貼上快速鍵 | 使用 Claude Code 的專用貼上鍵(最新版本使用 Alt+V 用於影像)。 | 在許多設定中有效;後備是檔案路徑 |
| 每個人都嘗試的第一反射。 | 通常在終端機中無聲進行任何操作 |
Claude Code 的鍵綁定在版本之間變化,檢查其目前的文件以取得確切的貼上鍵。檔案路徑路由是保持工作的路由,無論如何。
為什麼 Ctrl+V 在終端機中什麼都不做?
因為將圖像貼入終端機是一個不同的、支援度較低的操作,與貼入文字不同。當您複製螢幕截圖時,Windows 會將點陣圖放在剪貼簿上。大多數終端機只處理文字貼上,而安靜地忽略點陣圖,所以沒有任何內容出現。在 WSL 內,差距更大:終端機的 Linux 側看不到 Windows 剪貼簿點陣圖,所以即使是會接受貼上影像的工具也永遠無法取得資料。影像是好的,它只是沒有從剪貼簿到提示的路徑。這就是為什麼使用已保存檔案而不是剪貼簿點陣圖的路由是保持運作的路由。
即使是專用的貼上快速鍵在這裡也可能不穩定:影像貼上在終端機上已被報告在某些 Windows 和 PowerShell 設定中間歇性停止工作。當剪貼簿路由對您失敗時,已保存的檔案(拖入或按路徑參考)永遠不依賴它,這就是為什麼它是值得建構的習慣。
在傳送前我應該調整螢幕截圖的大小嗎?
是的,如果你整天都在做這項工作的話。完整解析度擷取不只是很難移動——也很昂貴。Vision 模型會將圖像分割成小塊進行分析,每個小塊都會計費符號,因此 4K 螢幕截圖可能花費超過一千個圖像符號,而調整大小至合理寬度的副本只需花費幾百個符號,讀起來同樣清晰,因為模型內部無論如何都會對大型圖像進行下采樣。在圖像到達 Claude Code 之前進行正確大小調整是整個流程中成本最低的最佳化方案。
這是專用捕獲工具賺取其地方的地方。Maxisnap 的 AI 最佳化匯出 產生一份在預設最大寬度上限的副本 1600 px (在設定中可配置)並交給您已保存的檔案,準備拖入終端機或按路徑參考。如果快照顯示 API 鑰匙、令牌或客戶資料,模糊工具在檔案建立之前將其破壞性編輯,所以秘密無法從您傳送的內容中恢復。
| 您貼上什麼 | 常見的影像 token 成本 | 在 Claude Code 中 |
|---|---|---|
| 原始 4K/全螢幕截圖 | 1,000+ token | 更昂貴且可能達到大小限制 |
| Maxisnap AI 最佳化副本(寬 1600 px) | 數百個 token | 判讀清楚、成本更低、上傳更快 |
token 數字為視覺模型的典型範圍,並非 Maxisnap 的實測基準;實際數量會因模型與圖片內容而異。
$ 最快可靠的交付
1. Ctrl+Alt+5 -> drag a box around the error 2. blur any secrets, then export the AI-optimized copy 3. drag the saved file into the terminal ...or paste its path: read this: C:\Users\you\shot.png # skip Ctrl+V — the terminal usually ignores the bitmap
將螢幕截圖貼入 Claude Code,常見問題
為什麼 Ctrl+V 不會將我的螢幕截圖貼到 Claude Code?
因為終端機通常無法接受來自剪貼簿的影像,它期望文字,當您複製螢幕截圖時,它會忽略 Windows 放在那裡的點陣圖。在 WSL 內,Windows 剪貼簿點陣圖根本看不到 Linux 側。改用 Claude Code 自己的影像貼上鍵,將檔案拖入終端機,或在提示中按路徑參考已保存的檔案。
貼上快速鍵在 Claude Code 中停止工作,現在呢?
Windows 和 PowerShell 上的影像貼上可能間歇性失敗,因此不要將其作為您唯一的路由。儲存螢幕截圖並在提示中參考其檔案路徑,或將檔案拖到終端機上,兩者都不會觸及剪貼簿,所以當貼上快速鍵不工作時兩者都保持工作。值得檢查 Claude Code 的目前文件以取得最新的貼上鍵,但檔案路徑路由是永遠不會破裂的路由。
在 Windows 上新增影像的最可靠方式是什麼?
在您的訊息中按路徑參考已保存的檔案。它不會觸及剪貼簿,所以它在 Windows 終端、WSL 和透過 SSH 上的工作方式相同。將檔案拖到終端機是下一個最可靠的路由。
螢幕截圖需要特定大小嗎?
通常越小越好。完整解析度擷取可能花費超過一千個圖像符號,且更可能達到每張圖像的限制。調整大小至約 1600 像素寬的副本成本低得多,讀起來同樣清晰,因為模型無論如何都會對大型圖像進行下采樣。
在傳送螢幕截圖之前,我如何隱藏 API 鑰匙?
在檔案建立前編輯它。在 Maxisnap 中,在編輯器中拖曳模糊工具在秘密上,然後匯出。模糊被應用為破壞性的,所以鍵無法從您交給 Claude Code 的影像中恢復。
我可以用 Codex CLI 或 Gemini CLI 做同樣的事情嗎?
是的。全部三個取檔案路徑或拖曳檔案,這是 Windows 上可移植的路由。我們的 給 AI 程式設計用的螢幕截圖 頁面有每個工具的細節, AI 程式碼的螢幕錄影 涵蓋當靜止不夠時發送簡短剪輯。
在三個按鍵中捕獲、編輯和交付。
大小合適、AI 優化螢幕截圖,具有準備拖曳或參考的已保存檔案,Windows 上免費。
相關: 給 AI 程式設計用的螢幕截圖 ‧ AI 程式碼的螢幕錄影 ‧ 模糊截圖 ‧ 開發者適用的截圖工具