欢迎关注 youcans@xidian【嵌入式软件AI编程】专栏
【嵌入式软件AI编程】03. STM32 VS Code 开发环境与工具链
【嵌入式软件AI编程】04. AI 编程 的STM32开发流程
【嵌入式软件AI编程】10. Claude Code的安装与配置

本专栏结合STM32项目实践，介绍嵌入式软件AI编程的实战路径。本专栏内容来自图书《嵌入式系统AI编程》，即将出版。

---

第02章 Claude Code安装与基本使用

上一章已经完成STM32 VS Code开发环境的搭建，并通过示例工程验证了基本开发流程。在此基础上，本章将介绍Claude Code的安装与基本使用，为AI协同开发做好准备。
本章首先介绍Claude Code的安装、登录与配置，随后说明会话启动、文件阅读、项目理解和命令执行等基本操作，最后介绍在VS Code中使用Claude Code的方法。
通过本章的实践，读者将能够完成Claude Code基本环境配置，掌握常用交互方式，并为后续在STM32项目中使用Claude Code参与工程分析、代码编写和问题排查奠定基础。

2.1 Claude Code的安装与配置

Claude Code是Anthropic公司推出的面向软件开发的AI编程工具，可用于代码阅读、代码编写、问题排查和项目分析。开发者可以通过自然语言提出需求，获得与当前项目相关的代码分析、实现建议和问题排查支持。
本节将介绍Claude Code的安装与初始配置，重点完成CLI安装、账号登录、环境验证和模型服务配置。完成本节后，读者即可在本地终端中启动Claude Code，并为后续基本操作和VS Code集成做好准备。

2.1.1 安装 Claude Code CLI

Claude Code可以通过CLI、Web、IDE集成等方式使用，其中CLI是Claude Code的核心入口，功能完整、运行稳定，也便于后续接入其他AI模型。由于官方脚本安装方式需要Claude账号认证，且容易受到网络环境影响，本书采用WinGet包管理器安装Claude Code CLI，适合在Windows系统中快速完成部署。

第1步：检查WinGet是否可用。

WinGet是Windows系统中的包管理工具，可用于安装和管理常用软件。在安装Claude Code CLI之前，应先检查当前系统是否支持WinGet。
打开Windows终端或PowerShell，执行以下命令：
winget --version

如果终端显示WinGet的版本号，例如“v1.28.240”，说明系统已经支持WinGet。

第2步：安装Claude Code CLI。

确认WinGet可用后，在终端中执行以下命令：

winget install Anthropic.Claude Code

终端会搜索并安装Claude Code。安装过程需要联网。安装过程中如提示确认软件来源或许可协议，按提示输入“Y”并按Enter键继续安装。
安装完成后，终端显示如图2-1所示。关闭并重新打开终端窗口，使claude命令生效。

图2-1 使用Winget安装Claude Code CLI

第3步：更换为国内镜像源。

如果安装过程中出现下载失败、连接超时或无法访问软件源等情况，可以临时更换为国内镜像源后重新安装。如果已经安装成功，可跳过本步骤。
更换镜像源需要以管理员身份打开PowerShell，然后依次执行以下命令（以教育网镜像源为例）：

winget source remove winget
winget source add winget https://mirrors.cernet.edu.cn/winget-source --trust-level trusted
winget source update
winget install Anthropic.Claude Code

第4步：验证安装结果。

重新打开终端，执行以下命令：

claude --version

如果终端显示Claude Code的版本信息，例如“2.1.200”，说明claude命令可以正常调用，Claude Code CLI安装完成。

第5步：首次启动Claude Code

完成版本验证后，继续执行以下命令启动Claude Code：

claude

首次启动时，Claude Code可能会依次出现以下提示，按提示处理即可。
（1）选择终端显示样式：该设置只影响文字显示效果，可以保持默认选项。
（2）阅读安全提示：阅读终端显示的安全提醒后，按Enter键继续。
（3）信任当前文件夹：如果当前目录可信，选择“Yes”；否则选择“No”退出，然后切换到可信目录后重新启动。
（4）登录或继续配置：拥有Claude账号的读者可按提示登录；没有账号的读者可先退出，下一节将通过配置第三方模型来使用Claude Code。
Claude Code登录成功后进入交互界面，如图2-2所示。图中显示的是“Opus5”模型。

图 2-2 Claude Code CLI 登录后的交互界面

需要说明的是，能启动Claude Code并进入初始化或登录界面，说明CLI已安装成功。能否使用默认模型，还取决于账号权限、网络环境和模型服务配置。下一节将介绍第三方模型配置方法，使Claude Code能够通过其他AI模型服务完成基本交互。

版权声明：

欢迎关注 youcans@xidian【嵌入式软件AI编程】专栏
转发必须注明原文链接：
【嵌入式软件AI编程】10. Claude Code的安装与配置
Copyright by ai4mcu@qq.com
Crated：2026-09