Claude安装教程：一行命令搞定，小白也能快速上手

② 命令行工具

2、使用官方脚本安装（推荐）

官方提供了一键安装脚本，根据你的系统选择对应的命令执行：

macOS、Linux、WSL：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

Windows CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Homebrew:

brew install --cask claude-code

WinGet:

winget install Anthropic.ClaudeCode

安装完成后，验证是否安装成功：

claude --version

如果终端输出了版本号（如 1.x.x），说明安装成功:

2.1.81 (Claude Code)

3、使用 npm 安装（不推荐）

如今官方现已不再去推荐采用 npm 安装途径, 可以优先借助上方官方脚本的方式。要是的确有必要经由 npm 进行安装, 那么得先去核查 Node.js 是否已被安装:

node --version

要是输出了版本号, 像 v18.17.0 这样的, 那就表明已经安装了。要是提示命令不存在这项情况, 那就得前往 nodejs.org 去下载并且安装。

在确定 Node.js 能够正常使用之后, 去执行下面这样的命令来完成 Claude Code 的安装。

npm install -g @anthropic-ai/claude-code

等待安装完成（可能需要几分钟）开云真人app官网登录app，然后验证：

claude --version

4、更新 Claude Code

可以直接用以下命令更新：

claude install

或者：

claude update

克劳德代码在开启以及运行之际会自行开展检查更新的操作, 于后台下载完毕之后, 下一次开启之时就将产生效用。自动更新有关的配置被书写于设置点json之中:

实例

“autoUpdatesChannel”是表示什么, 意味着“stable”, 这其中的“stable”专门指的是更新渠道, 它要么是稳定版, 而稳定版是被推荐去使用的那种版本, 要么, 就是beta这种测试版的情况。

可在Claude Code之内, 借由/config命令来开展配置, 也是可以的。

倘若你并非需要自动更新, 那么能够于 settings.json 的 env 里将其予之禁用。

实例

"env": {

设定为“1”状态, 来达到禁止自动更新的效果, 但若设为“0”, 又或者干脆将该行内容删除, 如此这般就会恢复自动更新。

倘若经由Homebrew或者WinGet来进行安装的Claude Code, 是不具备支持自动更新这一特性的, 是需要手动去执行底下所提及这个命令来予以更新的:

# macOS Homebrew
brew upgrade claude-code
#Windows WinGet
winget upgrade Anthropic.ClaudeCode

5、常见安装问题排查

问题一：提示 npm command not found

问题二：提示 permission denied

问题三：安装速度很慢或卡住

以下是终端推荐, 要是你认为系统默认终端的相关体验处于一般的状况下, 以下介绍到的这些终端, 在运用Claude Code这样的情况下具备更佳的体验:

卸载 Claude Code

根据你当初的安装方式选择对应的卸载命令。

1、官方脚本安装（原生安装）

删除 Claude Code 的可执行文件和版本文件：

macOS、Linux、WSL：

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Windows PowerShell：

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

2、Homebrew 安装

brew uninstall --cask claude-code

3、WinGet 安装

winget uninstall Anthropic.ClaudeCode

4、npm 安装

npm uninstall -g @anthropic-ai/claude-code

5、删除配置文件（可选）

上述所表明的命令, 仅仅是实现了对可执行程序的卸载操作, 然而配置文件以及历史记录并不会自行被删除掉。要是你期望达成将所有数据予以彻底清除的目的, 这里面涵盖了设置、授权工具、MCP服务器配置以及会话历史等内容, 那就必须额外去执行如下的命令:

删除配置文件, 这是不可恢复的操作, 一旦执行, 所有本地设置, 以及所有历史记录, 都将会永久丢失, 所以在执行之前, 请务必进行确认这个操作才可以。

macOS、Linux、WSL：

# 删除全局用户设置和状态
rm -rf ~/.claude
rm ~/.claude.json
# 删除当前项目的本地设置（在项目目录中执行）
rm -rf .claude
rm -f .mcp.json

Windows PowerShell：

# 删除全局用户设置和状态
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force
# 删除当前项目的本地设置（在项目目录中执行）
Remove-Item -Path ".claude" -Recurse -Force
Remove-Item -Path ".mcp.json" -Force

登录 Claude Code1、首次登录流程

在项目目录中启动 Claude Code：

claude

一开始启动的时候, Claude Code会引领你去完成登录这件事。进入界面之后呢, 你能够手动输入登录命令:

/login

根据终端里给出的提示达成登录授权就行, 登录完毕后, 凭据会存放于本地, 下次开启时不用再次进行登录, 要是需要更换账号, 再度执行 /login 便可。

2、支持的账号类型

你可以使用以下任意一种账号类型登录：

首先, Claude订阅账号, 这是被推荐的那种, 其次CLAUDE CONSOLE账号, 此账号用于API访问, 最后, 针对Console账号, 会自动创建工作区。

在头一回运用Claude Console账号去认证Claude Code之际, 系统会自行于你的Console里创建出一个称作"Claude Code" 的工作区, 其用途在于:

启动第一次会话1、在项目目录中启动

把终端打开, 首先要切换到所在的项目目录, 接着启动Claude Code。如此这般Claude才能够读取项目文件, 进而提供有针对性的帮助。

cd /path/to/your/project
claude

2、欢迎界面

启动之后, 你将会看见Claude Code的欢迎界面, 其中包含着当前会话的信息, 还有最近的对话记录, 以及最新更新的说明。

3、查看可用命令

在输入框中输入 /help 可以查看所有可用功能：

/help

输入 /resume 可以恢复之前中断的对话：

/resume

在输入框中直接输入 /，会弹出所有可用命令的补全列表：

详细的凭据管理信息可参考官方文档的 部分。

提出第一个问题1、理解项目

来到项目目录, 开启 Claude Code 之后, 能够先叫它剖析你的代码库。

what does this project do?

Claude 会自动读取项目文件，并给出项目概要。

Claude Code会按照需求自动去读取文件, 你根本不需要手动将文件内容复制粘贴到对话里, 它能够自行寻找到所需的上下文。

2、更多项目相关问题

你还可以询问更具体的信息：

what technologies does this project use?

where is the main entry point?

explain the folder structure

3、询问 Claude Code 的能力

也可以直接问 Claude 关于它自己能做什么：

what can Claude Code do?

how do I use slash commands in Claude Code?

can Claude Code work with Docker?

Claude有访问自身文档的能力, 对于关乎自身功能与特性的问题, 它能够给出准确的回答。

进行第一次代码修改1、动手试一个简单任务

接下来, 使 Claude Code 切实去编写代码, 我们构建一个测试目录, 让其于 test.py 文件里增添一个 Hello World 函数。

cd runoob-test    # 进入测试目录（没有则新建一个）
claude            # 启动 Claude Code

进入界面后开云app官方入口网站，输入：

在 test.py 文件中添加 hello world 函数

Claude Code 会将建议的代码修改展示出来, 并且在执行以前请求你的确认, 你选择 yes 之后按下回车便可应用:

2、Claude Code 的修改工作流

每次代码修改，Claude Code 都会按以下流程执行：

查找到相关文件, 于项目里自动定位出需修改的文件, 展示建议的修改, 以差异对比的样式去展示即将要做的改动, 恳请你的批准, 执行之前必定要经过你的确认, 而后执行编辑, 确认之后写入文件。

能够逐个去审批每一处的修改, 或者在当前会话里开启那种“全部接受”的模式以进行批量确认亦可。

使用 Git 功能

Claude Code使得Git操作转变为如同日常对话那般简易, 仅需径直运用自然语言去描述你打算做的事情就行。

1、基础 Git 操作

查看已修改的文件：

what files have I changed?

提交更改（Claude 会自动生成提交信息）：

commit my changes with a descriptive message

2、更复杂的 Git 操作

创建新分支：

create a new branch called feature/quickstart

查看最近的提交历史：

show me the last 5 commits

协助解决合并冲突：

help me resolve merge conflicts

修复 Bug 或添加功能1、添加新功能

以自然语言去描述你所想添加的功能, Claude Code会寻觅到恰当的位置进而将其予以实现:

add input validation to the user registration form

2、修复现有问题

描述 Bug 现象开云正版app下载，让 Claude 定位并修复：

there's a bug where users can submit empty forms - fix it

3、Claude Code针对问题处理流程定位相关代码, 在代码库当中去寻觅和问题有关联的文件与函数, 理解上下文, 剖析代码逻辑, 领会问题得以产生的根本缘由, 接着实现解决方案, 给出修改方面的建议并且展示diff, 随后运行测试, 要是项目里存在测试的话, Claude会试着去运行以此来验证修复会出现的效果, 还有其他常见工作流代码重构。

refactor the authentication module to use async/await instead of callbacks

编写测试

write unit tests for the calculator functions

更新文档

update the README with installation instructions

代码审查

review my changes and suggest improvements

Claude Code是你进行AI结对编程时的伙伴, 如同和一位颇具经验的同事交流这般, 与它对话, 去叙述你期望达成的内容, 不存在对特定命令格式的拘泥, 以自然语言进行表述就行, 它会协助你搜寻到最佳的实现途径。

常用命令速查表命令行命令（在终端中使用）命令功能示例

claude

启动交互模式（最常用）

claude

claude "任务描述"

执行一次性任务后退出交互模式

claude "fix the build error"

claude -p "查询内容"

执行单次查询后立即退出（适合脚本集成）

claude, 针对“解释这个函数”给出作答。

claude -c

继续当前目录的最近一次对话

claude -c

claude -r

从历史中选择并恢复一次对话

claude -r

claude commit

让 Claude 自动生成 Git 提交信息并提交

claude commit

claude update

手动更新 Claude Code 到最新版本

claude update

claude --version

查看当前安装的版本号

claude --version

Claude Code界面里用于交互模式的命令, 该命令具备功能示例。

/help

显示所有可用命令和功能说明

/help

/login

标签： Claude安装教程 命令行工具 npm安装 更新ClaudeCode 常见安装问题排查