如果你刚开始接触 Claude Code,看到“终端”“IDE”“API Key”这些词,可能会有一点懵。
别急。Claude Code 并不是只能在黑乎乎的命令行窗口里使用。你可以根据自己的习惯,选择终端、代码编辑器、桌面应用或网页端。
这篇文章不讲复杂配置,先帮你弄明白一件事:我应该从哪里开始用 Claude Code?
说明:本文根据 Claude Code 官方教程第二集《Installing Claude Code》安装介绍视频整理。安装时请以官方页面显示的最新命令为准。
一、Claude Code 是什么?
Claude Code 是 Anthropic 推出的 AI 编程工具。
Anthropic(开发 Claude 的人工智能公司)是 Claude 背后的团队。Claude Code 可以读取你的项目文件,理解代码结构,并协助你修改代码、查找问题或处理重复任务。
你可以把它理解成一个“能进入项目文件夹工作的 Claude”。
普通的 Claude 聊天窗口更像是线上问答。Claude Code 则可以在你允许的范围内,直接查看项目目录里的文件。
目录(Directory)就是电脑中的文件夹。 子文件夹(Subfolder)就是某个文件夹里面继续嵌套的文件夹。
这里有一个小提醒:你在哪个目录中启动 Claude Code,它就可以访问这个目录以及里面的子文件夹。
如果你不希望它看到无关文件,第一次使用时,不要直接在整个硬盘或过大的文件夹中启动。进入具体项目文件夹后再运行,会更清楚,也更安全。
二、安装 Claude Code,有哪些方式?
Claude Code 支持 macOS、Linux、WSL 和 Windows。
WSL(Windows Subsystem for Linux,适用于 Linux 的 Windows 子系统)可以让 Windows 用户在电脑中使用 Linux 环境。
不同系统的安装方式略有差异。
1. macOS、Linux 或 WSL
最直接的方式是使用官方提供的 curl 命令。
curl(一个常见的命令行下载工具)可以从网络获取安装脚本,并在终端中执行安装。
如果你是 macOS 用户,也可以使用 Homebrew。
Homebrew(macOS 常用的软件包管理工具)有点像手机里的应用商店,只不过它通过命令行安装软件。
需要注意:通过 Homebrew 安装 Claude Code 后,不支持自动更新。如果你想更快用到新功能,优先考虑官方推荐的安装方式。命令行具体参考官方链接即可。
2. Windows
Windows 用户可以根据自己使用的工具选择安装方式:
在 PowerShell (Windows 自带的命令行工具)中,使用官方提供的
Invoke-RestMethod命令。在 CMD (Command Prompt,命令提示符)中,使用官方提供的 curl 命令。
也可以使用 winget(Windows 软件包管理工具) 安装。和 Homebrew 一样,通过 winget 安装后,也不支持自动更新。
如果你看完还是不知道怎么选,可以记住一个简单原则:优先使用官方安装页面推荐的默认方式。
三、第一次在终端中运行 Claude Code
安装完成后,先进入你的项目文件夹,再运行 Claude Code。
终端(Terminal)就是输入命令的窗口。在 macOS 中,你可以打开“终端”应用;在 Windows 中,可以打开 PowerShell 或 CMD。
第一次启动时,Claude Code 会引导你完成基础设置,例如:
选择界面颜色主题;
登录 Claude 账户;
或者使用 API Key。
API Key(应用程序接口密钥)可以理解成一串用于身份验证的密码。程序可以通过它调用 Claude 服务。
如果你所在的公司使用 Claude Enterprise,请选择对应的企业账户选项。
Claude Enterprise(Claude 企业版)是面向组织和团队的版本,通常由公司统一管理。
国内的大模型也支持 Claude Code。具体配置方式可以搜索大模型名字+配置 Claude Code API。大模型的官方链接中会有详细介绍。
四、不习惯终端?可以直接在 VS Code 里使用
如果你平时使用 VS Code 写代码,可以安装 Claude Code 扩展。
VS Code(Visual Studio Code)是一款常见的代码编辑器。扩展(Extension)可以理解成安装在编辑器里的插件,用来增加新功能。
安装步骤不复杂:
打开 VS Code。
找到扩展面板。
搜索
Claude Code。找到 Anthropic 发布的扩展。
确认它带有蓝色认证标记,再点击安装。
安装后,如果没有立即生效,重启一次 VS Code。
安装完成后,可以按下快捷键打开命令面板:
Windows:
Control + Shift + PmacOS:
Command + Shift + P
命令面板(Command Palette)是 VS Code 中用于搜索和执行功能的入口。
在命令面板中搜索 Claude Code,就可以打开新的 Claude Code 标签页。如果你打开文件时看到了 Claude 图标,也可以直接点击它。
如果你不想使用图形界面,还可以在设置文件中关闭 UI,只保留终端体验。
UI(User Interface,用户界面)就是你看到的按钮、面板和窗口。
五、使用 JetBrains IDE,也可以安装插件
如果你使用 IntelliJ IDEA、PyCharm 或 WebStorm,可以从 JetBrains Marketplace 安装 Claude Code 插件。
JetBrains IDE(JetBrains 公司推出的一系列开发工具)包括 IntelliJ IDEA、PyCharm、WebStorm 等。
IDE(Integrated Development Environment,集成开发环境)是用于编写、运行和管理代码的软件。Marketplace(插件市场)就是下载编辑器插件的地方。
安装插件后,重启 IDE。重新打开时,你会看到 Claude 图标。点击图标,就可以打开 Claude Code 面板。
六、不想折腾环境?试试桌面版
Claude Desktop 中也可以运行 Claude Code。
Claude Desktop(Claude 桌面应用)安装并登录后,顶部会出现 code 入口。整体体验和 Claude 聊天窗口比较接近,但它可以在指定文件夹中工作,也可以调整文件访问权限。
权限(Permission)指的是 Claude Code 可以查看或修改哪些文件、可以执行哪些操作。
桌面版适合这类场景:
你不想一直盯着终端;
你希望 Claude 在后台处理任务;
你想在处理其他事情时,让 Claude 同时工作。
七、临时不在电脑旁,也可以使用网页版
网页版入口是 claude.ai/code。
它的体验与桌面版相似,但有一个限制:只能处理 GitHub 仓库。
GitHub(常用的代码托管平台)可以在线保存和管理代码。仓库(Repository)就是存放某个项目代码和版本记录的地方。
网页版适合远程处理项目,也适合同时开启多个会话。
会话(Session)可以理解成一次独立的 Claude Code 工作窗口。多个会话并行运行,就是让 Claude 同时处理几件不同的事情。
八、小白到底应该选哪个版本?
如果你只是想尽快开始,可以按下面的方式选:
如果你完全没有概念,我的建议是:
新手先从 VS Code 扩展或 Claude Desktop 开始。
这两种方式更容易理解。等你熟悉 Claude Code 的工作方式后,再尝试终端版。终端版通常能更快获得新功能,也更适合长期使用。
九、开始之前,记住这三件事
1. 在具体项目文件夹中启动
不要一上来就让 Claude Code 读取过大的目录。项目范围越明确,操作越可控。
2. 看清楚权限再确认
当 Claude Code 请求读取文件、修改文件或执行命令时,先看一眼它准备做什么。
3. 安装命令以官方页面为准
工具会更新,安装方式也可能变化。本文帮你理解每种入口的区别,真正安装时,请复制官方页面提供的最新命令。
写在最后
Claude Code 并没有想象中那么难上手。
你不需要第一天就学会所有命令,也不用一开始就研究复杂配置。先选一个顺手的入口,让它在一个简单的小项目里帮你读文件、解释代码,或者做一次小修改。
用几次之后,那些看起来有点吓人的术语,就会慢慢变成普通工具。
夜雨聆风