VS Code 聯(lián)動 Claude Code 安裝教程
適用系統(tǒng):Ubuntu
1. 前置準備
1.1 系統(tǒng)要求
- 操作系統(tǒng):Ubuntu 20.04 或更高版本
- Node.js:18.x 或更高版本
- npm:9.x 或更高版本
1.2 檢查環(huán)境版本
node --version npm --version
版本過低? 使用 nvm 安裝最新版本:
# 安裝 nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash # 重新加載 shell source ~/.bashrc # 安裝最新 LTS 版本 nvm install --lts
1.3 創(chuàng)建工作目錄
?? 重要:目錄名使用連字符(-),避免空格
mkdir -p ~/claude-code cd ~/claude-code
2. 安裝 Claude Code CLI
2.1 全局安裝
npm install -g @anthropic-ai/claude-code
2.2 驗證安裝
claude --version
? 顯示版本號即為安裝成功
3. 安裝 code-server
3.1 下載并安裝
# 下載最新版本 wget https://github.com/coder/code-server/releases/download/v4.23.1/code-server-4.23.1-amd64.deb # 安裝 sudo dpkg -i code-server-4.23.1-amd64.deb # 如果缺少依賴 sudo apt-get install -f
3.2 配置 code-server
# 創(chuàng)建配置目錄 mkdir -p ~/.config/code-server # 生成配置文件 cat > ~/.config/code-server/config.yaml <<EOF bind-addr: 127.0.0.1:8080 auth: password password: 你的密碼 cert: false EOF
3.3 啟動服務
方式一:手動啟動
code-server --config ~/.config/code-server/config.yaml
方式二:系統(tǒng)服務(推薦)
sudo systemctl enable code-server@$USER sudo systemctl start code-server@$USER
3.4 訪問 Web 界面
瀏覽器打開:http://localhost:8080
輸入你設(shè)置的密碼即可使用
4. 配置 Claude Code
4.1 交互式配置
claude configure
按提示完成配置:
- 界面語言(建議中文)
- Coding 套餐
- API 密鑰
- 編碼工具
4.2 手動配置(高級)
配置文件位置:~/.claude/settings.json
使用第三方提供商示例:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
"ANTHROPIC_AUTH_TOKEN": "你的認證令牌",
"API_TIMEOUT_MS": "3000000"
},
"enabledPlugins": {
"你的插件名": true
},
"language": "chinese"
}4.3 驗證配置
claude
?? 提示:如果能正常響應對話,說明配置成功
5. 安裝 Claude Code VS Code 擴展
5.1 通過擴展市場安裝
- 打開 code-server Web 界面
- 點擊左側(cè) 擴展圖標(方塊)
- 搜索 "Claude Code"
- 選擇 Anthropic 發(fā)布的擴展
- 點擊 安裝
5.2 配置擴展
?? 重要:使用第三方提供商需跳過登錄
方法一:通過設(shè)置界面
- 打開設(shè)置(Ctrl+,)
- 搜索 Claude Code login
- 勾選 Disable Login Prompt
方法二:手動編輯
編輯 ~/.local/share/code-server/User/settings.json:
{
"claudeCode.disableLoginPrompt": true
}5.3 打開 Claude Code 面板
方式一:Spark 圖標
- 點擊編輯器右上角的 ? 圖標
方式二:命令面板
- 按
Ctrl+Shift+P - 輸入 "Claude Code"
- 選擇打開方式
方式三:狀態(tài)欄
- 點擊右下角的 "? Claude Code"
5.4 測試連接
在面板中發(fā)送測試消息,正?;貜图幢硎境晒??
6. 常見問題及解決方案
? 問題 1:Failed to spawn Claude Code process
癥狀
Error: spawn /path/to/claude code EACCES
原因
- 路徑中包含空格
- 配置文件路徑錯誤
- CLI 未正確安裝
解決方案
# 步驟 1:檢查 VS Code 設(shè)置
cat ~/.local/share/code-server/User/settings.json
# 步驟 2:搜索錯誤路徑
grep -r "claude code" ~/.local/share/code-server/User/
# 步驟 3:批量修復
find ~/.local/share/code-server/User/History/ -name "*.json" \
-exec sed -i '/"claudeCode.claudeProcessWrapper"/d' {} \;
# 步驟 4:驗證 CLI 安裝
which claude
claude --version
# 步驟 5:重啟服務
sudo systemctl restart code-server@$USER
# 步驟 6:刷新瀏覽器(Ctrl+F5)? 問題 2:登錄界面卡住
癥狀
顯示登錄選項(Google/GitHub/Email)但無法登錄
解決方案
編輯 ~/.local/share/code-server/User/settings.json:
{
"claudeCode.disableLoginPrompt": true
}重啟 code-server 并刷新瀏覽器
? 問題 3:終端無法連接 IDE
癥狀
執(zhí)行 /ide 命令時提示找不到可用的 IDE
解決方案
# 1. 確認 code-server 正在運行 # 2. 切換到正確的項目目錄 cd ~/claude-code/項目1 # 3. 啟動 Claude Code claude # 4. 連接 IDE /ide
?? 確保終端目錄與 IDE 打開的項目目錄一致
? 問題 4:擴展安裝后無響應
解決方案
# 檢查版本 code-server --version # 需要 1.98.0+ claude --version # 查看日志 # Ctrl+Shift+P → "Show Logs" → "Extension Host" # 重載窗口 # Ctrl+Shift+P → "Developer: Reload Window"
? 問題 5:環(huán)境變量不生效
解決方案
# 檢查配置文件 cat ~/.claude/settings.json # 驗證 JSON 格式 cat ~/.claude/settings.json | jq . # 檢查項目級配置 cat ~/your-project/.claude/settings.local.json
? 問題 6:權(quán)限錯誤 (EACCES)
解決方案
# 檢查可執(zhí)行文件權(quán)限 ls -la $(which claude) # 添加執(zhí)行權(quán)限 chmod +x $(which claude) # 修復 npm 全局目錄權(quán)限 sudo chown -R $USER:$(id -gn $USER) ~/.npm-global
?? 最佳實踐
? 命名規(guī)范
使用連字符命名目錄,避免空格
- ? ~/claude-code
- ? ~/claude code
? 配置管理
重置配置時可安全刪除:
- ~/.claude/settings.json
- ~/.local/share/code-server/User/
? 版本控制
將配置文件加入版本控制方便同步
? 保持更新
# 更新 CLI npm update -g @anthropic-ai/claude-code # 更新 code-server sudo apt-get update && sudo apt-get upgrade code-server
?? 技術(shù)支持
- Claude Code 文檔:https://code.claude.com/docs
- code-server 文檔:https://coder.com/docs
- 問題反饋:https://github.com/anthropics/claude-code/issues
到此這篇關(guān)于VS Code 聯(lián)動 Claude Code 安裝教程的文章就介紹到這了,更多相關(guān)VSCode Claude Code安裝內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持腳本之家!
相關(guān)文章

2026最新Claude Code的安裝并連接VScode的保姆級教程(使用CC Switch或ollama連接)
本文詳細介紹了使用ClaudeCode和CCSwitch在本地部署Claude,并連接深Seek、智譜AI、Ollama等模型的過程,最后說明了在VScode中使用Claude的方法,本文結(jié)合圖文、示例代碼給大2026-04-10


