VSCode 安装和使用 Claude Code 完整指南

VSCode 安装和使用 Claude Code 完整指南 文章目录前言一、本地 VSCode 安装配置 Claude Code1.1 环境准备1.2 安装 Claude Code CLI1.3 安装 VSCode 扩展1.4 安装 CC Switch1.5 获取 DeepSeek API Key1.6 CC Switch 配置 DeepSeek1.7 VSCode 侧最终配置1.8 验证与使用二、远程板子Ubuntu 20.04 ARM64安装 Claude Code2.1 环境背景2.2 问题分析三重障碍2.3 可选方案对比2.4 最终方案混合策略三、总结欢迎使用Markdown编辑器新的改变功能快捷键合理的创建标题有助于目录的生成如何改变文本的样式插入链接与图片如何插入一段漂亮的代码片生成一个适合你的列表创建一个表格设定内容居中、居左、居右SmartyPants创建一个自定义列表如何创建一个注脚注释也是必不可少的KaTeX数学公式新的甘特图功能丰富你的文章UML图表流程图FLowchart流程图导出与导入导出导入前言本文总结了在本地 Windows VSCode 中安装配置 Claude Code DeepSeek V4 的完整流程以及在远程 ARM64 板子Ubuntu 20.04上部署 Claude Code 的方案选型过程。参考视频在VSCode中配置Claude Code并接入DeepSeek V4(ccswitchclaudecode extension)一、本地 VSCode 安装配置 Claude Code整体架构VSCode 编辑器 └── Claude Code for VS Code插件 └── CC Switch模型网关 / 本地路由 └── DeepSeek V4-Pro / V4-FlashAPI 模型CC Switch 的作用是在不破坏 Claude Code 原生体验的前提下将 API 请求透明地桥接到第三方模型如 DeepSeek V4。1.1 环境准备依赖项要求说明操作系统Windows 10本教程基于 Windows 11VSCode≥ 1.98.0旧版本不支持该扩展Node.js≥ 18.0Claude Code CLI 的运行环境Git任意版本版本管理检查版本code--version node--version git--version1.2 安装 Claude Code CLI重要变更2026年Anthropic 官方已从 npm 迁移到原生安装器npm 方式虽仍可用但已标记为废弃。推荐使用原生安装器。方式一WinGet 安装推荐最简洁winget install Anthropic.ClaudeCode方式二PowerShell 脚本安装irmhttps://claude.ai/install.ps1|iex安装完成后确保C:\Users\用户名\.local\bin\已添加到系统 PATH 环境变量。方式三npm 安装备用需 Node.js ≥ 18npm install-g anthropic-ai/claude-code验证安装claude--version# 预期输出Claude Code v2.1.x (native)1.3 安装 VSCode 扩展第一步打开 VSCode按CtrlShiftX打开扩展面板第二步搜索Claude Code务必确认发布者为Anthropic避免第三方仿冒版本第三步点击Install安装命令行安装方式code--install-extensionanthropic.claude-code安装成功后VSCode 右上角会出现 ⚡ Spark 图标底部状态栏会出现 ✱ Claude Code 入口。三种打开方式方式操作适用场景Spark 图标 ⚡点击编辑器右上角图标快速针对当前文件提问状态栏 ✱点击底部状态栏无文件时也能对话命令面板CtrlShiftP搜索 Claude Code开启新对话标签页三种模式ShiftTab 循环切换模式说明适用场景Edit编辑Claude 提出修改逐条审核接受/拒绝需要精确控制每次编辑Auto-AcceptClaude 自动执行修改无需逐条确认脚手架搭建、原型Plan计划只读分析不修改文件架构探索、代码评审1.4 安装 CC SwitchCC Switch 是一个模型网关工具负责在本地将 Claude Code 的 API 请求路由到第三方模型。GitHub 仓库farion1231/ccswitch各平台安装方式平台安装方式Windows下载.msi安装包 或Portable.zip便携版macOSbrew tap farion1231/ccswitch brew install --cask cc-switchLinux下载.AppImage或.deb/.rpm安装包Windows 安装步骤前往 CC Switch Releases 下载最新版.msi双击运行全程默认下一步完成安装启动 CC Switch系统托盘会出现图标1.5 获取 DeepSeek API Key访问 platform.deepseek.com注册账号并登录进入API Keys→ 点击创建 API Key复制生成的sk-开头的密钥妥善保存省钱小贴士DeepSeek V4-Pro 限时 2.5 折充值 10 元就能用很久。也可以使用阿里百炼新用户送 100 万 V4 Token90 天有效。1.6 CC Switch 配置 DeepSeek第一步打开 CC Switch点击右上角按钮添加新供应商第二步供应商类型选择DeepSeek第三步填写配置参数配置项值说明API Keysk-xxxxxxxx上一步获取的密钥Base URLhttps://api.deepseek.com/anthropic注意是/anthropic端点非/v1API 格式Anthropic Messages原生关键不是 OpenAI 兼容格式主模型 (Sonnet)deepseek-v4-pro主力开发模型Haiku 模型deepseek-v4-flash子 Agent 快速任务Opus 模型deepseek-v4-pro复杂架构设计提示模型名加[1m]后缀如deepseek-v4-pro[1m]可启用 100 万 token 超长上下文。第四步点击添加保存配置第五步在首页点击刚创建的配置 → 点击启用第六步使用健康检查按钮测试连通性1.7 VSCode 侧最终配置打开 VSCode 设置Ctrl,→ 搜索claudeCode.environmentVariables→ 点击在 settings.json 中编辑{claudeCode.environmentVariables:[{name:ANTHROPIC_BASE_URL,value:https://api.deepseek.com/anthropic},{name:ANTHROPIC_AUTH_TOKEN,value:sk-你的DeepSeek_API_Key},{name:ANTHROPIC_DEFAULT_MODEL,value:deepseek-v4-pro}]}补充说明如果你已经在 CC Switch 中启用了 DeepSeek 配置Claude Code 插件通常会自动检测到 CC Switch 的路由规则无需手动配置以上环境变量。以上配置作为手动直连的备选方案。1.8 验证与使用重启 VSCode打开任意代码文件点击右上角 ⚡ 图标或按CtrlEsc切换焦点到 Claude Code输入/model查看当前模型当前模型deepseek-v4-pro核心快捷键速查操作快捷键切换编辑器 / Claude 焦点CtrlEsc新建对话CtrlN插入文件路径AltK循环切换模式ShiftTab切换扩展思考AltT回退到上一检查点Esc Esc二、远程板子Ubuntu 20.04 ARM64安装 Claude Code2.1 环境背景硬件平台飞凌 OK3568 开发板CPU 架构aarch64 / ARM64操作系统Ubuntu 20.04 LTSLinux 4.19.206使用场景开发 BMS 电池管理系统C/C 项目希望借助 AI 编程助手提高在板调试效率2.2 问题分析三重障碍在远程 ARM64 板子上使用 Claude Code 面临三重障碍。障碍一VSCode 扩展不支持 ARM64 架构Claude Code 的 VSCode 扩展anthropic.claude-code目前仅发布linux-x64版本没有linux-arm64构建。通过 VSCode Remote SSH 连接板子后无法像本地一样安装和使用 Claude Code 的图形化扩展。相关讨论见 GitHub Issuebubble 项目 #248VS Code 市场 API 在按linux-arm64平台过滤查询时返回空结果。障碍二Ubuntu 20.04 的 glibc 版本过低Ubuntu 20.04 自带的 glibc 版本为2.31版本不满足某些新版 Node.js 二进制的要求Node.js 22 需要 glibc ≥ 2.35。强行安装新版 Node.js 会报错/lib/aarch64-linux-gnu/libc.so.6: version GLIBC_2.34 not found障碍三板子资源受限嵌入式板子 CPU 性能和内存都有限通常 2-4GB RAM运行完整的 VSCode Server 本身就消耗大量资源再叠加 AI 编程助手可能不堪重负。2.3 可选方案对比针对以上问题我们梳理了四种可行方案方案思路优点缺点A升级系统Ubuntu 20.04 升级到 22.04/24.04glibc 升级到 2.35兼容性好嵌入式板子升级风险大可能破坏 BSP 驱动B只用 CLISSH 到板子终端运行 claude 命令无需 GUI 扩展资源占用低ARM64 原生支持缺少可视化 diff、检查点回退等 GUI 特性CDocker 容器板子上跑 Ubuntu 22.04 容器隔离环境不破坏宿主机容器本身有开销ARM64 镜像兼容性需验证D本地开发同步本地 VSCode 写代码scp 同步到板子编译零板子端开销体验最佳不能直接在板子上调试时使用 AI2.4 最终方案混合策略我们选择了方案 B 方案 D 的混合策略日常开发在本地 Windows VSCode 中使用 Claude Code 扩展接入 DeepSeek V4代码完成后通过scp同步到板子编译运行板上调试SSH 登录板子后在终端中直接使用 Claude Code CLI通过 npm 安装 Node.js 20 LTS 兼容版本配合tmux保持会话持久化选择理由不需升级系统—— 避免破坏飞凌 BSP 的底层依赖不依赖 ARM64 VSCode 扩展—— 直接用 CLI 绕过了架构兼容问题灵活切换—— 主力开发用本地 GUI紧急板上改 bug 也能用 CLINode.js 20 LTS 兼容 glibc 2.31—— 这是关键的技术可行性基础三、总结环境方案核心工具链本地 Windows VSCode完整 GUI 体验Claude Code Extension CC Switch DeepSeek V4-Pro远程 ARM64 板子CLI 终端模式SSH tmux Claude Code CLI DeepSeek V4-Pro关键经验CC Switch 的 Base URL 必须用/anthropic端点不能用 OpenAI 兼容的/v1端点否则模型调用会出错ARM64 板子不要试图装 VSCode 扩展 —— 目前没有linux-arm64构建版本Node.js 版本与 glibc 的匹配是核心 —— Ubuntu 20.04 选 Node.js 20 LTS 是最优解tmux 是远程 CLI 开发的必备工具 —— 断线不断任务体验提升巨大最后更新2026-06-05参考资料Claude Code 官方文档CC Switch GitHubDeepSeek API 平台B站教程视频这里写自定义目录标题前言一、本地 VSCode 安装配置 Claude Code1.1 环境准备1.2 安装 Claude Code CLI1.3 安装 VSCode 扩展1.4 安装 CC Switch1.5 获取 DeepSeek API Key1.6 CC Switch 配置 DeepSeek1.7 VSCode 侧最终配置1.8 验证与使用二、远程板子Ubuntu 20.04 ARM64安装 Claude Code2.1 环境背景2.2 问题分析三重障碍2.3 可选方案对比2.4 最终方案混合策略三、总结欢迎使用Markdown编辑器新的改变功能快捷键合理的创建标题有助于目录的生成如何改变文本的样式插入链接与图片如何插入一段漂亮的代码片生成一个适合你的列表创建一个表格设定内容居中、居左、居右SmartyPants创建一个自定义列表如何创建一个注脚注释也是必不可少的KaTeX数学公式新的甘特图功能丰富你的文章UML图表流程图FLowchart流程图导出与导入导出导入欢迎使用Markdown编辑器你好 这是你第一次使用Markdown编辑器所展示的欢迎页。如果你想学习如何使用Markdown编辑器, 可以仔细阅读这篇文章了解一下Markdown的基本语法知识。新的改变我们对Markdown编辑器进行了一些功能拓展与语法支持除了标准的Markdown编辑器功能我们增加了如下几点新功能帮助你用它写博客全新的界面设计将会带来全新的写作体验在创作中心设置你喜爱的代码高亮样式Markdown将代码片显示选择的高亮样式进行展示增加了图片拖拽功能你可以将本地的图片直接拖拽到编辑区域直接展示全新的KaTeX数学公式语法增加了支持甘特图的mermaid语法1功能增加了多屏幕编辑Markdown文章功能增加了焦点写作模式、预览模式、简洁写作模式、左右区域同步滚轮设置等功能功能按钮位于编辑区域与预览区域中间增加了检查列表功能。功能快捷键撤销Ctrl/CommandZ重做Ctrl/CommandY加粗Ctrl/CommandB斜体Ctrl/CommandI标题Ctrl/CommandShiftH无序列表Ctrl/CommandShiftU有序列表Ctrl/CommandShiftO检查列表Ctrl/CommandShiftC插入代码Ctrl/CommandShiftK插入链接Ctrl/CommandShiftL插入图片Ctrl/CommandShiftG查找Ctrl/CommandF替换Ctrl/CommandG合理的创建标题有助于目录的生成直接输入1次#并按下space后将生成1级标题。输入2次#并按下space后将生成2级标题。以此类推我们支持6级标题。有助于使用TOC语法后生成一个完美的目录。如何改变文本的样式强调文本强调文本加粗文本加粗文本标记文本删除文本引用文本H2O is是液体。210运算结果是 1024.插入链接与图片链接: link.图片:带尺寸的图片:居中的图片:居中并且带尺寸的图片:当然我们为了让用户更加便捷我们增加了图片拖拽功能。如何插入一段漂亮的代码片去博客设置页面选择一款你喜欢的代码片高亮样式下面展示同样高亮的代码片.// An highlighted blockvarfoobar;生成一个适合你的列表项目项目项目项目1项目2项目3计划任务完成任务创建一个表格一个简单的表格是这么创建的项目Value电脑$1600手机$12导管$1设定内容居中、居左、居右使用:---------:居中使用:----------居左使用----------:居右第一列第二列第三列第一列文本居中第二列文本居右第三列文本居左SmartyPantsSmartyPants 是一个文本转换工具主要功能是将普通的 ASCII 标点符号自动转换为更美观的印刷体标点符号。例如原始符号转换后说明引号“引号”直引号变弯引号单引号‘单引号’直单引号变弯单引号--–两个连字符变短破折号---—三个连字符变长破折号...…三个点变省略号创建一个自定义列表MarkdownText-to-HTMLconversion toolAuthorsJohnLuke如何创建一个注脚一个具有注脚的文本。2注释也是必不可少的Markdown将文本转换为HTML。KaTeX数学公式您可以使用渲染LaTeX数学表达式 KaTeX:Gamma公式展示Γ ( n ) ( n − 1 ) ! ∀ n ∈ N \Gamma(n) (n-1)!\quad\forall n\in\mathbb NΓ(n)(n−1)!∀n∈N是通过欧拉积分Γ ( z ) ∫ 0 ∞ t z − 1 e − t d t . \Gamma(z) \int_0^\infty t^{z-1}e^{-t}dt\,.Γ(z)∫0∞​tz−1e−tdt.你可以找到更多关于的信息LaTeX数学表达式here.新的甘特图功能丰富你的文章2014-01-072014-01-092014-01-112014-01-132014-01-152014-01-172014-01-192014-01-21已完成进行中计划一计划二现有任务Adding GANTT diagram functionality to mermaid关于甘特图语法参考 这儿,UML图表可以使用UML图表进行渲染例如下面产生的一个序列图王五李四张三王五李四张三李四想了很长时间, 文字太长了不适合放在一行.你好李四, 最近怎么样?你最近怎么样王五我很好谢谢!我很好谢谢!打量着王五...很好... 王五, 你怎么样?关于UML图表语法参考 这儿,流程图链接长方形圆圆角长方形菱形关于Mermaid语法参考 这儿,FLowchart流程图我们依旧会支持flowchart.js的流程图语法Created with Raphaël 2.3.0开始我的操作确认结束yesno关于Flowchart流程图语法参考 这儿.导出与导入导出如果你想尝试使用此编辑器, 你可以在此篇文章任意编辑。当你完成了一篇文章的写作, 在上方工具栏找到文章导出生成一个.md文件或者.html文件进行本地保存。导入如果你想加载一篇你写过的.md文件在上方工具栏可以选择导入功能进行对应扩展名的文件导入继续你的创作。mermaid语法说明 ↩︎注脚的解释 ↩︎