Claude Code 安装与使用 | 菜鸟教程

在正式安装之前，先了解一下 Claude Code 有哪几种使用方式，选择最适合自己的方式入手。
目前 Claude Code 也提供了桌面版，可在以下地址下载：https://claude.com/download
本教程以 CLI 方式为主，因为它最稳定、最通用，也最接近 Claude Code 的设计初衷。
官方提供了一键安装脚本，根据你的系统选择对应的命令执行：
如果终端输出了版本号（如 1.x.x），说明安装成功:
官方目前已不再推荐使用 npm 安装方式，建议优先使用上方的官方脚本。如果确实需要通过 npm 安装，请先确认已安装 Node.js：
如果输出了版本号（如 v18.17.0），说明已安装。如果提示命令不存在，请前往 nodejs.org 下载并安装。
确认 Node.js 可用后，执行以下命令安装 Claude Code：
等待安装完成（可能需要几分钟），然后验证：
Claude Code 在启动和运行时会自动检查更新，后台下载完成后，下次启动即生效。自动更新相关配置写在 settings.json 中：
也可以在 Claude Code 内部通过 /config 命令进行配置。
如果你不需要自动更新，可以在 settings.json 的 env 中禁用：
通过 Homebrew 或 WinGet 安装的 Claude Code 不支持自动更新，需要手动执行以下命令更新：
问题一：提示 npm command not found
问题二：提示 permission denied
终端推荐：如果你觉得系统默认终端体验一般，以下这些终端在使用 Claude Code 时体验更佳：
更多终端工具参考：https://www.runoob.com/w3cnote/terminal-tools.html
根据你当初的安装方式选择对应的卸载命令。
删除 Claude Code 的可执行文件和版本文件：
以上命令只卸载了可执行程序，配置文件和历史记录不会自动删除。如果你希望完全清除所有数据（包括设置、授权工具、MCP 服务器配置和会话历史），需要额外执行以下命令：
⚠️ 删除配置文件是不可恢复的操作，所有本地设置和历史记录将永久丢失，执行前请确认。
在项目目录中启动 Claude Code：
首次启动时，Claude Code 会引导你完成登录。你也可以在进入界面后手动输入登录命令：
按照终端中的提示完成登录授权即可。登录后，凭据会保存在本地，下次启动无需重复登录。如果需要切换账号，重新执行 /login 即可。
首次使用 Claude Console 账号认证 Claude Code 时，系统会自动在你的 Console 中创建一个名为 "Claude Code" 的工作区，用于：
打开终端，先切换到你的项目目录，再启动 Claude Code。这样 Claude 才能读取你的项目文件，提供针对性的帮助：
启动后，你会看到 Claude Code 的欢迎界面，包括当前会话信息、最近的对话记录和最新更新说明：
在输入框中输入 /help 可以查看所有可用功能：
输入 /resume 可以恢复之前中断的对话：
在输入框中直接输入 /，会弹出所有可用命令的补全列表：
详细的凭据管理信息可参考官方文档的 Credential Management 部分。
进入项目目录启动 Claude Code 后，可以先让它分析你的代码库：
Claude 会自动读取项目文件，并给出项目概要。
Claude Code 会根据需要自动读取文件——你不需要手动把文件内容复制粘贴到对话中，它会自己找到需要的上下文。
也可以直接问 Claude 关于它自己能做什么：
Claude 可以访问自己的文档，能够准确回答关于自身功能和特性的问题。
下面让 Claude Code 实际编写代码。我们创建一个测试目录，让它在 test.py 文件中添加一个 Hello World 函数：
Claude Code 会展示建议的代码修改，并在执行前请求你的确认，选择 yes 后按回车即可应用：
每次代码修改，Claude Code 都会按以下流程执行：
你可以逐个审批每处修改，也可以在当前会话中开启"全部接受"模式批量确认。