Claude Code 問題大全：遇到報錯別慌，看這篇就夠
整理版優先睇
Claude Code 常見問題速查：遇到報錯按圖索驥即可解決
呢篇文章係 Claude Code 系列嘅排障篇，作者整合咗使用過程中成日遇到嘅六大問題同對應解決方案。整體嚟講，遇到問題唔使慌，只要對住速查表做返對應操作，絕大多數情況都搞得掂。
具體問題包括 OAuth 驗證失敗、長時間冇反應、模型名顯示錯、命令列參數執行錯、API/Tools Error、npm 安裝權限錯。每個問題都有好具體嘅解決方法，例如 OAuth 失敗要關代理再用驗證碼驗證；冇反應就按 Ctrl+C 中斷再用 claude -c 恢復；API 錯誤通常係網絡問題，重啓再試就得。特別係 WSL 環境成日出錯，建議換 macOS 或 Ubuntu。
文章仲提供徹底清理方法（刪 ~/.claude）同問題速查表，方便快速定位。最後總結系列文章結構，由認知到排障，鼓勵讀者即刻打開終端試用。總之呢篇係實用嘅應急手冊，值得收藏。
- 結論：速查表可快速定位解決方案，大部分問題有對應操作
- 方法：OAuth 失敗要關代理並用驗證碼驗證；無響應用 Ctrl+C 中斷後以 claude -c 恢復
- 差異：WSL 環境易出錯，建議改用 macOS 或 Ubuntu
- 啟發：遇到 API 錯誤通常是網絡問題，重啓即解；模型名錯誤係正常現象
- 可行動點：收藏系列、在真實項目使用、堅持一週、轉發同事
常見問題即時排解
Claude Code 使用中可能遇到六大常見問題，以下逐一提供解決方案。
OAuth 驗證失敗時，瀏覽器沒反應或提示驗證失敗。解決方法是先關掉代理，再登錄；如果還不行，無視瀏覽器，複製終端連結手動打開，用驗證碼方式驗證。
關代理並用驗證碼驗證可解決 OAuth 失敗
長時間無響應時，光標一直閃沒有輸出。按 Ctrl+C 中斷，重啓 Claude Code；如果還卡，殺掉進程重來，用 claude -c 恢復上次會話，工作進度不會丟失。
回覆裏顯示的模型名不對，這是正常現象。Claude Code 對簡單任務會自動選擇輕量模型，不影響使用。
模型名稱錯誤是正常現象，無需擔心
bash 命令執行失敗在 WSL 上很常見，建議換 macOS 或 Ubuntu，體驗更好。
API Error 或 Tools Error 通常是網絡問題。退出 Claude Code，用 claude -c 重新進入；如果還不行，聯繫 API 代理的售後。
API 錯誤通常由網絡引起，重啓並檢查網絡
npm install -g 時報權限錯誤，不要用 sudo。檢查 npm 全局安裝路徑的權限，或者換成官方原生安裝方式。
不要用 sudo 解決 npm 權限問題
徹底清理與速查表
如果想重裝或清理登錄信息，可以執行 rm -rf ~/.claude 然後重新配置。
rm -rf ~/.claude 徹底清理配置
問題速查表，方便快速定位：
OAuth 失敗：關代理，用驗證碼
無響應：Ctrl+C，claude -c 恢復
API 錯誤：重啓，檢查網絡
npm 權限：別用 sudo
WSL 報錯：換 macOS/Ubuntu
重裝：刪 ~/.claude
系列總結與行動清單
最好的文檔，是遇到問題時能立刻找到答案的文檔。呢6篇文章帶你從0到精通 Claude Code：認知篇、安裝篇、基礎篇、實戰篇、進階篇、排障篇。而家打開終端，輸入 claude，你嘅編程方式從今日開始改變。
最好的文檔係能立刻找到答案的文檔
- 1 收藏呢個系列，遇到問題隨時查
- 2 將 Claude Code 用喺一個真實項目度
- 3 堅持用一週，養成習慣
- 4 轉發俾仲喺度手工編程嘅同事
工具幾好，都會出問題。
報錯點算好？
呢篇就係你嘅急救手冊。
遇到問題，Ctrl+F 搜關鍵詞，揾到答案。
❌ 問題 1：OAuth 驗證失敗
症狀：登入嗰陣彈出嘅瀏覽器冇反應，或者話驗證失敗。
解決方案 ：
熄咗代理，再登入 如果都係唔得，唔好理個瀏覽器 複製終端嗰條連結，手動打開 用驗證碼方式驗證
❌ 問題 2：長時間冇反應
症狀：輸入指令之後，光標一直閃，冇輸出。
解決方案 ：
按 Ctrl+C中斷重啟 Claude Code 如果仲係卡住，殺咗個進程再嚟過 用 claude -c恢復上次會話
你嘅工作進度唔會唔見。
❌ 問題 3：模型名稱顯示錯誤
症狀：回覆入面顯示嘅模型名唔啱。
解釋 ：
這是正常現象。
Claude Code 對簡單任務會自動揀輕量模型。
唔影響使用，唔使擔心。
❌ 問題 4：命令行參數執行錯誤
症狀：bash 指令執行失敗，報奇怪嘅錯誤。
解決方案 ：
這在 WSL 上好常見。
建議換 macOS 或 Ubuntu，體驗會好啲。
❌ 問題 5：API Error / Tools Error
症狀：彈出 API 錯誤或者工具錯誤。
解決方案 ：
通常是網絡問題 退出 Claude Code 用 claude -c重新入返如果都係唔得，揾 API 代理嘅售後
❌ 問題 6：npm 安裝權限錯誤
症狀：npm install -g 時報權限錯誤。
解決方案：
不要用 sudo 。
檢查 npm 全域安裝路徑嘅權限，或者改用官方原生安裝方式。
🧹 徹底清理 Claude Code
如果想重裝或者清理登入資訊：
rm -rf ~/.claude
然後重新配置。
📊 問題速查表
claude -c 恢復 | |
~/.claude 目錄 |
🎬 系列總結
最好嘅文檔，係遇到問題嗰陣可以即刻揾到答案嘅文檔。
呢 6 篇文章，帶你由 0 到精通 Claude Code：
認知篇：理解佢係乜 安裝篇：國內點樣裝 基礎篇：核心指令 實戰篇：7 個真實場景 進階篇：6 個進階技能 排障篇：問題速查
而家，打開終端，輸入 claude。
你寫程式嘅方式，由今日開始改變。
📋 最終行動清單
[ ] 收藏呢個系列，遇到問題隨時查 [ ] 將 Claude Code 用喺一個真實項目度 [ ] 堅持用一個禮拜，養成習慣 [ ] 轉發俾仲喺度「手動寫程式」嘅同事
覺得有用？每篇都可以獨立分享。
等更多人告別低效率嘅程式方式。
工具再好，也會出問題。
報錯了怎麼辦？
這篇是你的急救手冊。
遇到問題，Ctrl+F 搜關鍵詞，找到答案。
❌ 問題 1：OAuth 驗證失敗
症狀：登錄時跳出的瀏覽器沒反應，或提示驗證失敗。
解決方案 ：
關掉代理，再登錄 如果還不行，無視瀏覽器 複製終端裏的連結，手動打開 用驗證碼方式驗證
❌ 問題 2：長時間無響應
症狀：輸入命令後，光標一直閃，沒有輸出。
解決方案 ：
按 Ctrl+C中斷重啓 Claude Code 如果還卡，殺掉進程重來 用 claude -c恢復上次會話
你的工作進度不會丟。
❌ 問題 3：模型名稱顯示錯誤
症狀：回覆裏顯示的模型名不對。
解釋 ：
這是正常現象。
Claude Code 對簡單任務會自動選擇輕量模型。
不影響使用，不用擔心。
❌ 問題 4：命令行參數執行錯誤
症狀：bash 命令執行失敗，報奇怪的錯誤。
解決方案 ：
這在 WSL 上很常見。
建議換 macOS 或 Ubuntu，體驗更好。
❌ 問題 5：API Error / Tools Error
症狀：提示 API 錯誤或工具錯誤。
解決方案 ：
通常是網絡問題 退出 Claude Code 用 claude -c重新進入如果還不行，聯繫 API 代理的售後
❌ 問題 6：npm 安裝權限錯誤
症狀：npm install -g 時報權限錯誤。
解決方案：
不要用 sudo 。
檢查 npm 全局安裝路徑的權限，或者換成官方原生安裝方式。
🧹 徹底清理 Claude Code
如果想重裝或清理登錄信息：
rm -rf ~/.claude
然後重新配置。
📊 問題速查表
claude -c 恢復 | |
~/.claude 目錄 |
🎬 系列總結
最好的文檔，是遇到問題時能立刻找到答案的文檔。
這 6 篇文章，帶你從 0 到精通 Claude Code：
認知篇：理解它是什麼 安裝篇：國內怎麼裝 基礎篇：核心命令 實戰篇：7 個真實場景 進階篇：6 個高級技能 排障篇：問題速查
現在，打開終端，輸入 claude。
你的編程方式，從今天開始改變。
📋 最終行動清單
[ ] 收藏這個系列，遇到問題隨時查 [ ] 把 Claude Code 用在一個真實項目裏 [ ] 堅持用一週，養成習慣 [ ] 轉發給還在"手工編程"的同事
覺得有用？每篇都可以獨立分享。
讓更多人告別低效編程。