Claude Code 常見問題

Claude Code 的設定欄位會隨版本變化。先執行 claude --version 和 claude --help 核對本機版本；模型 ID、分組、價格和協定能力以 BearLab 主控臺及實際請求為準。

為什麼消費日誌裡出現了另一個模型？

Claude Code 的主會話、子 Agent、標題產生、壓縮和快速任務可能使用不同模型。先按請求時間、模型 ID、輸入/輸出令牌和請求 ID 對照消費日誌，不要只看目前介面選擇的主模型。

少量、緊鄰主請求的呼叫通常來自輔助任務。
持續出現大量未知呼叫時，立即停用對應令牌，檢查本機程式與令牌使用範圍。
建立 Claude Code 專用令牌，能把使用者端流量與其他應用分開審計。
聯絡支援時提供請求 ID、時間範圍和模型 ID；不要傳送完整 API Key。

首次啟動提示無法連線 Anthropic

先在同一個終端檢查環境變數，不要直接修改 ~/.claude.json 繞過首次啟動狀態：

test -n "$ANTHROPIC_API_KEY" && echo "API key is set"
printf '%s\n' "$ANTHROPIC_BASE_URL"
claude --version

BearLab 的 Anthropic Base URL 使用網域名稱根目錄，Claude Code 會自行追加 /v1/messages：

export ANTHROPIC_BASE_URL="https://bearlab.ai"
export ANTHROPIC_API_KEY="sk-..."
claude

亞太地區將網域名稱替換為 https://bearlab.space。不要填寫 /v1、/v1/messages，否則可能形成重複路徑。

如何做最小連通性驗證？

先查詢模型，再向 Messages API 傳送短請求：

curl "https://bearlab.ai/v1/models" \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY"

curl "https://bearlab.ai/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "your-anthropic-model",
    "max_tokens": 64,
    "messages": [{"role": "user", "content": "Reply with OK"}]
  }'

只有模型端點存在、令牌分組可見並且 /v1/messages 回傳內容後，才繼續排查 Claude Code 本身。

常用命令

claude                              # 在目前目錄啟動互動工作階段
claude "解釋這個項目"              # 帶首條訊息啟動
claude -p "解釋這個函式"           # 一次性輸出後退出
cat build.log | claude -p "定位錯誤" # 通過標準輸入分析文字
claude -c                           # 繼續目前目錄最近的會話
claude -r <session-id>              # 恢復指定會話
claude --model <model-id>           # 指定本次會話模型
claude --add-dir ../shared          # 增加允許訪問的目錄
claude mcp                          # 管理 MCP
claude doctor                       # 檢查本機安裝和設定
claude update                       # 更新用戶端

--dangerously-skip-permissions 會繞過工具權限確認。僅能在沒有真實憑證、沒有重要文件且網路受控的臨時沙箱中使用；普通接入教學不需要它。

VS Code 中的 Claude Code 擴充功能怎麼接入？

先在 VS Code 整合式終端中執行 claude --version。
在該終端確認 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 已注入。
用 CLI 完成最小請求，排除網路、令牌和模型問題。
完全退出並重啟 VS Code，讓擴充功能重新讀取環境。
如果擴充功能仍固定使用官方帳號登入，不要把 BearLab API Key 填入 OAuth 登入框；改用 CLI 或 CC Switch 支援的設定入口。

擴充功能版本的設定欄位可能獨立於 CLI。不要寫入來源不明的 primaryApiKey 固定字串，也不要覆蓋現有官方登入狀態。

Windows 與 macOS 到哪裡檢查設定？

Windows
macOS / Linux

使用 PowerShell 檢查 $HOME\.claude\settings.json。修改前複製備份，並完全退出 Claude Code 與 VS Code。

檢查 ~/.claude/settings.json，並用 env | grep -E '^(ANTHROPIC|CLAUDE_CODE)_' 排查 shell 環境覆蓋。

如何限制上下文和非必要流量？

Claude Code 2.1.227 的本機程式包含以下開關。它們會改變使用者端行為，按需逐項啟用，不要一次複製整組不熟悉的設定：

{
  "env": {
    "CLAUDE_CODE_DISABLE_1M_CONTEXT": "1",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_TERMINAL_TITLE": "1",
    "CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS": "1"
  }
}

將它們合併進 ~/.claude/settings.json 的現有 env 物件，不能覆蓋已有 BearLab 位址、令牌或其他使用者設定。修改前備份並記錄驗證和：

cp -p ~/.claude/settings.json ~/.claude/settings.json.bak
shasum -a 256 ~/.claude/settings.json ~/.claude/settings.json.bak

CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS 會減少自動注入的動態 Git 資訊，但也會遺失相關上下文；只有確認任務不依賴 Git 狀態時再啟用。

401、403、404 怎麼排查？

401：令牌缺失、無效或同時存在衝突的憑證變數。重新開啟終端並檢查注入來源。
403：令牌分組無權存取模型、餘額不足或策略拒絕。檢視完整錯誤訊息和消費日誌。
404：Base URL 多寫了 /v1、模型 ID 不存在，或模型不支援 Anthropic Messages 協定。
429：命中速率或併發限制。使用退避重試，不要並行重複提交相同任務。
5xx：記錄請求 ID 後重試一次；持續失敗再聯絡支援。

CC Switch 和手動環境變數衝突怎麼辦？

完全退出 Claude Code。
關閉 CC Switch 對 Claude Code 的接管。
在新終端執行 env | grep -E '^(ANTHROPIC|CLAUDE_CODE)_'。
檢查 shell 設定中的重複 export、別名和包裝器。
選擇一種設定來源，再重新啟動 Claude Code。

不要在 CC Switch 接管期間手動覆蓋同一個設定文件。恢復備份前先確認接管已經關閉。

仍然失敗時需要儲存什麼？

儲存 claude --version、HTTP 狀態、錯誤正文、請求 ID、模型 ID、令牌分組和發生時間。環境變數只記錄“已設定/未設定”，API Key 只保留前後少量字符並打碼。

CC Switch

CLI

其他客戶端

圖像生成

常見問題

Claude Code 常見問題

為什麼消費日誌裡出現了另一個模型？

首次啟動提示無法連線 Anthropic

如何做最小連通性驗證？

常用命令

VS Code 中的 Claude Code 擴充功能怎麼接入？

Windows 與 macOS 到哪裡檢查設定？

如何限制上下文和非必要流量？

401、403、404 怎麼排查？

CC Switch 和手動環境變數衝突怎麼辦？

仍然失敗時需要儲存什麼？

​為什麼消費日誌裡出現了另一個模型？

​首次啟動提示無法連線 Anthropic

​如何做最小連通性驗證？

​常用命令

​VS Code 中的 Claude Code 擴充功能怎麼接入？

​Windows 與 macOS 到哪裡檢查設定？

​如何限制上下文和非必要流量？

​401、403、404 怎麼排查？

​CC Switch 和手動環境變數衝突怎麼辦？

​仍然失敗時需要儲存什麼？

為什麼消費日誌裡出現了另一個模型？

首次啟動提示無法連線 Anthropic

如何做最小連通性驗證？

常用命令

VS Code 中的 Claude Code 擴充功能怎麼接入？

Windows 與 macOS 到哪裡檢查設定？

如何限制上下文和非必要流量？

401、403、404 怎麼排查？

CC Switch 和手動環境變數衝突怎麼辦？

仍然失敗時需要儲存什麼？