官方安装、登录与第一次启动
视频讲解配合文字步骤,建议打开 Claude Code,并准备一个不含敏感资料的练习目录。
read · plan · build · verify
这一章你会完成什么跟着视频操作,再用下方文字版快速复查关键步骤。
这一期,我们完成 Claude Code 的官方安装、登录和第一次启动。
安装前准备
Claude Code 的核心入口是终端。macOS 可以使用“终端”,Windows 可以使用 PowerShell、CMD,或者 WSL。
Windows 原生使用时,官方建议安装 Git for Windows,这样 Claude Code 可以使用 Bash 工具。使用 WSL 时不需要另外依赖 Git for Windows。
官方推荐安装方式
macOS、Linux 和 WSL 可以运行:
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell 可以运行:
irm https://claude.ai/install.ps1 | iex
Windows 也可以通过 WinGet 安装:
winget install Anthropic.ClaudeCode
macOS 还可以使用 Homebrew:
brew install --cask claude-code
安装方式可能继续更新,所以录制教程前要再看一次官方文档。不要从陌生网盘下载安装包。
第一次启动
先创建练习目录:
mkdir claude-code-test
cd claude-code-test
然后启动:
claude
第一次运行会提示登录。按照浏览器页面完成账号授权,再返回终端。
登录方式和可用套餐会变化,以你当前界面和官方页面为准,不要死记截图里的套餐名称。
确认安装状态
可以使用:
claude --version
如果遇到安装或配置问题,也可以运行:
claude doctor
进入 Claude Code 后,先发送:
请告诉我当前工作目录是什么,并列出第一层文件。不要修改任何内容。
常见问题
命令找不到:关闭并重新打开终端,再检查安装是否成功、命令路径是否生效。
PowerShell 报 && 相关错误:你可能执行了 CMD 版本的命令。PowerShell 和 CMD 的安装命令不要混用。
登录页面打不开:先检查网络、系统时间和浏览器,再重新运行登录流程。
本期总结
官方安装的核心流程是:选择正确的系统命令、完成安装、进入练习目录、运行 claude、登录并确认当前目录。
本期作业:完成官方安装,并让 Claude Code 只汇报练习目录内容。