這篇Claude使用教學只講Claude Code:從安裝到首次執行、API Key 綁定、帳號切換,再到訂閱與常見報錯排查,按步驟做就能在本機終端把Claude Code跑起來。文中命令適用於 Windows/macOS/Linux,盡量把坑點寫在前面,少走彎路。
1)安裝Claude Code:環境準備與首次執行
Claude Code依賴Node.js,建議先安裝Node.js 18及以上版本,並確認終端能用npm。隨後執行全域安裝:
npm install -g @anthropic-ai/claude-code
安裝後用
claude --version
檢查是否輸出版本號。
第一次執行Claude Code時,通常會提示設定Anthropic API Key。你也可以提前在系統裡設定環境變數ANTHROPIC_API_KEY,再啟動Claude Code,省去重複輸入。
2)帳號綁定與切換:用API Key管理最省事
Claude Code的「登入」核心是API Key綁定:一把Key對應一個計費與權限來源。想切換帳號,最穩妥的方法是更換ANTHROPIC_API_KEY(或在Claude Code首次執行生成的設定檔裡替換Key,具體路徑會在初始化時提示)。
如果你在公司與個人帳號之間切換,建議為不同終端工作階段分別設定環境變數,避免把Key寫死在全域設定裡,降低誤用與外洩風險。
3)方案差異與省錢思路:按使用情境選
Claude相關的訂閱常見有Pro與Max(價格與權益會隨官方調整),更適合網頁端高頻對話;而Claude Code更常見的成本來自API呼叫量。對開發者來說,把大任務集中在一兩天做完、其餘時間只做小改動,通常比「長期高頻開著」更省。
國內用戶如果遇到支付或網路限制,優先選擇合規的API付費管道或企業/團隊統一結算方式;不建議使用來路不明的Key,容易觸發風控導致Claude Code用到一半被中斷。
4)常見問題與錯誤排查:訂閱失敗、請求錯誤、帳號鎖定
訂閱失敗多發生在支付方式、地區或帳單資訊不匹配,先檢查卡的3DS驗證、帳單地址與幣種支援;若只用Claude Code,確認自己是否其實需要訂閱,還是只需要可用的API Key與額度。
請求錯誤(如逾時/中斷)通常是網路不穩定、並發過高或上下文過長。處理順序建議:換更穩定的網路→降低一次性輸入與改動範圍→分步驟讓Claude Code執行(先分析再修改再測試)。
帳號鎖定或Key失效時,先在控制台檢查Key是否被撤銷、額度是否用盡,以及是否觸發異常呼叫。更換新的API Key後重新啟動Claude Code通常能恢復;如果持續報錯,再檢查本機代理/憑證攔截與系統時間是否正確。