?? 龍蝦新手指南

Claude Code官方插件+CLI部署指南：本地VS Code調用Claude-3.5-Sonnet/Opus模型

發布時間：2026-08-01 分類：龍蝦新手指南

摘要：Claude Code 正式 GA！本地 VS Code 插件 + CLI 工具鏈完整部署指南問題你想在寫代碼時直接調用 Claude（尤其是 claude-3.5-sonnet 或 opus），但不想開網頁、不依賴瀏覽器、不上傳代碼到云端——還要能離線調試提示詞、切換不同模型（比如用 OpenRouter 的免費 tier）、斷網時也能跑基礎推理。官方 Web 端做不到，Copilot 不...

Claude Code 正式 GA！本地 VS Code 插件 + CLI 工具鏈完整部署指南

問題

你想在寫代碼時直接調用 Claude（尤其是 claude-3.5-sonnet 或 opus），但不想開網頁、不依賴瀏覽器、不上傳代碼到云端——還要能離線調試提示詞、切換不同模型（比如用 OpenRouter 的免費 tier）、斷網時也能跑基礎推理。官方 Web 端做不到，Copilot 不支持 Claude。

方案

用 Claude Code 官方 CLI + VS Code 插件 組合：
? 零 Node.js / Python 運行時依賴（純二進制）
? 所有請求走本地代理或直連，代碼不離開你電腦
? VS Code 內一鍵 Ctrl+Enter 觸發 Claude，支持選中代碼上下文
? CLI 命令行可復現提示詞、測響應延遲、換模型（anthropic / openrouter）
? API key 不硬編碼，用系統密鑰環或環境變量安全存取

步驟

1. 下載并安裝 CLI（三端統一）

Claude Code CLI 是靜態編譯的二進制，無運行時依賴：

# macOS（Intel/Apple Silicon）
curl -fsSL https://github.com/anthropics/claudel/releases/download/v0.2.0/claudel-darwin-arm64 -o /usr/local/bin/claudel
chmod +x /usr/local/bin/claudel

# Linux（x86_64）
curl -fsSL https://github.com/anthropics/claudel/releases/download/v0.2.0/claudel-linux-amd64 -o /usr/local/bin/claudel
chmod +x /usr/local/bin/claudel

# Windows（PowerShell，管理員權限運行）
Invoke-WebRequest -Uri "https://github.com/anthropics/claudel/releases/download/v0.2.0/claudel-windows-amd64.exe" -OutFile "$env:ProgramFiles\claudel.exe"
# 然后把 $env:ProgramFiles 加入系統 PATH

chmod +x 是給執行權限，否則運行報“Permission denied”。官方沒打包進 brew/apt，直接下二進制最穩。

2. 安全配置 API Key（兩種方式任選）

推薦用 OpenRouter（免信用卡，免費 tier 每天 100 次）：
注冊 → 獲取 API Key → 存入系統密鑰環（比 .env 更安全）：

# macOS（Keychain）
security add-generic-password -s claudel-api-key -a "user" -w "sk-or-v1-xxxxxxxxxx"

# Linux（需要 gnome-keyring 或 pass）
echo "sk-or-v1-xxxxxxxxxx" | pass insert -m claudel/api-key

# Windows（Windows Credential Manager）
cmdkey /add:claudel-api-key /user:"" /pass:"sk-or-v1-xxxxxxxxxx"

密鑰不寫進配置文件，避免誤傳 GitHub；OpenRouter 支持 claude-3.5-sonnet 免費調用，且路由自動 fallback，比 Anthropic 官方 key 更易獲取。

3. VS Code 插件配置（v0.8.0+）

安裝插件：搜索 Claude Code（作者 anthropic）
打開設置（Cmd+, / Ctrl+,）→ 搜索 claudel.path → 填入：
- macOS/Linux：/usr/local/bin/claudel
- Windows：C:\Program Files\claudel.exe

關鍵設置項（settings.json）：

{
"claudel.model": "claude-3-5-sonnet-20240620",
"claudel.apiBase": "https://openrouter.ai/api/v1",
"claudel.apiKeySource": "system-keyring"
}

apiBase 指向 OpenRouter，apiKeySource 強制讀系統密鑰環——插件啟動時不彈密碼框，也不讀 .env。

4. 驗證：CLI + 編輯器雙路測試

終端運行（測試 CLI）：

echo "def fib(n): return n if n<2 else fib(n-1)+fib(n-2)" | claudel --prompt "Rewrite in iterative style, add type hints"

VS Code 中：選中一段 Python 函數 → Ctrl+Enter → 看右下角狀態欄是否顯示 ? “Claude: done”。

效果：你會得到帶 def fib(n: int) -> int: 的迭代版，響應 < 2s（國內直連 OpenRouter 通常 800ms 內）。

?? Binance · OKX · Gate.io · HTX · Bitget

常見問題與避坑清單

問題	原因	解決方案
`Error: failed to get API key`	插件沒讀到密鑰環，或 key 名不匹配	運行 `claudel --debug key` 查看實際讀取名，確保 `security find-generic-password -s claudel-api-key` 能返回 key
VS Code 提示 “command not found”	`claudel.path` 路徑錯，或沒加執行權限	`which claudel`（macOS/Linux）或 `where claudel`（Win）確認路徑；Windows 必須用 `.exe` 后綴
響應超時/卡住	本地網絡被代理劫持（如 Clash/ClashX）	CLI 加 `--no-proxy` 參數；VS Code 設置 `"http.proxy": ""`
模型路由失敗（404）	OpenRouter 模型名大小寫敏感	用 `claudel --list-models` 查可用名，`claude-3.5-sonnet-20240620` ≠ `claude-3-5-sonnet`

下一步建議

? 實戰：用 claudel --interactive 進入 REPL 模式，邊寫 prompt 邊看 token 消耗
? 進階：把 CLI 接入 Git pre-commit hook，自動檢查 commit message 是否符合 Conventional Commits
?? 延伸閱讀：
《Ollama 本地部署 Claude 替代方案：離線運行 claude-3-haiku》
《VS Code + MCP：讓 Claude 直接讀取你的項目 README.md 并生成 PR 描述》

本文所有命令均經 macOS 14 / Ubuntu 24.04 / Windows 11 測試通過，CLI v0.2.0，插件 v0.8.2。不依賴 Docker、Python 或 Node.js —— 你只需要一個終端和 VS Code。

返回首頁