在正式安装之前,我们先了解一下 Claude Code 可以怎么用。
三种使用方式对比:
我的建议:
目前 Claude Code 的桌面版也发布了,下载地址: https://claude.com/download 。
本教程将以 CLI 使用方式为主,因为它最稳定、最通用,也最接近 Claude Code 的设计初衷。
安装 Claude Code CLI(命令行工具)
前置准备
在安装之前,你需要确保:
1、你有一个 Claude 账号,当然现在国内很多厂家(DeepSeek/Minimax/GLM)已经适配,后文会介绍怎么切换。
你的电脑有命令行工具
使用官方脚本安装
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
安装完成后,验证一下:
claude --version
如果显示版本号,说明安装成功!
使用 npm 安装
你的电脑需要安装了 Node.js,在命令行输入:
node --version
如果显示版本号(比如 v18.17.0 ),说明已安装。如果没有,去 nodejs.org 下载安装。
安装 Claude Code
打开命令行,输入以下命令:
npm install -g @anthropic-ai/claude-code
等待安装完成(可能需要几分钟)。
安装完成后,验证一下:
如果显示版本号,说明安装成功!
常见安装问题与解决
问题 1:提示 npm command not found
原因: 你的电脑没有安装 Node.js
解决: 去 nodejs.org 下载安装,然后重新执行安装命令
问题 2:提示 permission denied
原因: 没有管理员权限
解决(Mac/Linux): 在命令前加 sudo
sudo npm install -g @anthropic-ai/claude-code
解决(Windows): 以管理员身份运行 PowerShell
题 3:安装很慢或者卡住
原因: 网络问题
解决: 使用国内镜像源
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
登录 Claude Code
首次登录流程
当你第一次启动 Claude Code 时,需要登录账号:
claude
启动后,系统会提示你登录,在 Claude Code 界面中输入:
/login
然后按照提示完成登录。
支持的账号类型
你可以使用以下任意一种账号类型登录:
1、Claude 订阅账号(推荐)
2、Claude Console 账号
注意:
自动创建工作区(Console 账号)
当你首次使用 Claude Console 账号认证 Claude Code 时,系统会自动创建一个名为 "Claude Code" 的工作区。
这个工作区用于:
启动第一次会话
在项目目录中启动
打开终端,进入你的项目目录,然后启动 Claude Code:
cd /path/to/your/project claude
欢迎界面
启动后,你会看到 Claude Code 的欢迎界面,包括:
查看帮助
输入以下命令查看可用功能:
/help
或者恢复之前的对话:
/resume
输入 / 会列出可用的命令:
凭据管理
登录后,你的凭据会保存在系统中,下次无需重复登录。
详细的凭据管理信息可以查看官方文档的 Credential Management 部分。
提出第一个问题
理解项目
让我们从了解代码库开始,试试这些命令:
what does this project do?
Claude 会分析你的文件并提供项目概要。
更多项目相关问题
你还可以问更具体的问题:
what technologies does this project use?
> where is the main entry point?
> explain the folder structure
询问 Claude Code 的能力
你也可以问 Claude 关于它自己的问题:
> what can Claude Code do?
> how do I use slash commands in Claude Code?
> can Claude Code work with Docker?
重要特性:
进行第一次代码修改
简单的编码任务
现在让 Claude Code 实际编写代码。
试试这个简单任务,在 test.py 文件(没有要创建下)中添加 hello world 函数:
cd runoob-test # 进入测试目录 claude # 启用 claude
在窗口中,输入以下内容:
> 在 test.py 文件中添加 hello world 函数
输出如下,选择 yes 回车就可以了:
Claude Code 的工作流程
Claude Code 会:
重要提示:
使用 Git 功能
对话式 Git 操作
Claude Code 让 Git 操作变得像对话一样简单:
查看修改
> what files have I changed?
提交更改
> commit my changes with a descriptive message
更复杂的 Git 操作
你还可以执行更复杂的 Git 任务:
创建分支
> create a new branch called feature/quickstart
查看提交历史
解决合并冲突
修复 Bug 或添加功能
添加新功能
用自然语言描述你想要的功能:
> show me the last 5 commits
> help me resolve merge conflicts
修复现有问题
描述 Bug 并让 Claude 修复:
> add input validation to the user registration form
> there's a bug where users can submit empty forms - fix it
Claude Code 的处理流程
其他常见工作流
代码重构
> refactor the authentication module to use async/await instead of callbacks
编写测试
> write unit tests for the calculator functions
更新文档
> review my changes and suggest improvements
代码审查
使用建议
Claude Code 是你的 AI 结对编程伙伴
常用命令速查表
命令行命令
交互模式内命令