实战指南
约 10 分钟

快速入门指南

欢迎使用 Claude Code!本指南将在几分钟内让你上手 AI 驱动的编程辅助。

开始之前

确保你已准备好:

打开终端或命令提示符
准备好一个代码项目
拥有 Claude 订阅(Pro、Max、Teams 或 Enterprise)或 Claude Console 账户

第一步:安装 Claude Code

选择适合你的安装方式:

推荐

原生安装(推荐)

macOS / Linux / WSL:

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

Windows PowerShell:

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

Homebrew

brew install --cask claude-code

NPM(需要 Node.js 18+)

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

第二步:登录账户

Claude Code 需要账户才能使用。首次使用时需要登录:

claude

# 首次使用时会提示登录

/login

# 按提示登录你的账户

支持的账户类型:

Claude Pro、Max、Teams 或 Enterprise(推荐)
Claude Console(API 访问,预付费额度)

提示:登录后,你的凭证会保存在系统中,无需再次登录。首次使用 Claude Console 账户认证时, 会自动创建名为"Claude Code"的工作区,用于集中管理和追踪使用成本。

第三步:启动第一次会话

在任何项目目录中打开终端并启动 Claude Code:

cd /path/to/your/project
claude

你会看到 Claude Code 欢迎屏幕,显示会话信息、最近的对话和最新更新。 输入 /help 查看可用命令, 或输入 /resume 继续之前的对话。

第四步:提出第一个问题

让我们从了解你的代码库开始。尝试以下命令:

> 这个项目是做什么的?

Claude 会分析文件并提供摘要

> 这个项目使用了哪些技术?

获取技术栈信息

> 主入口点在哪里?

找到应用的入口文件

> 解释一下文件夹结构

了解项目组织方式

你也可以询问 Claude 关于它自己的能力:

> Claude Code 能做什么?> 如何在 Claude Code 中使用斜杠命令?> Claude Code 可以和 Docker 一起工作吗?

第五步:做出第一次代码变更

现在让 Claude Code 做一些实际的编程工作。尝试一个简单任务:

> 在主文件中添加 hello world 函数

Claude Code 会:

找到合适的文件
显示提议的变更
请求你的批准
进行编辑

注意:Claude Code 在修改文件前总是会请求许可。你可以批准单个变更,或者为会话启用"全部接受"模式。

第六步:使用 Git 操作

Claude Code 让 Git 操作变得像对话一样简单:

> 我修改了哪些文件?

查看当前变更

> 提交我的变更并写一个描述性的提交信息

创建 Git 提交

> 创建一个名为 feature/quickstart 的新分支

创建并切换分支

> 显示最近 5 次提交

查看提交历史

> 帮我解决合并冲突

处理冲突

第七步:修复 Bug 或添加功能

Claude 擅长调试和功能实现。用自然语言描述你想要的:

添加功能

> 为用户注册表单添加输入验证

修复 Bug

> 有一个 bug,用户可以提交空表单 - 修复它

Claude Code 会:

📍定位相关代码
🧠理解上下文
💡实现解决方案

第八步:尝试其他常见工作流程

有很多与 Claude 一起工作的方式:

重构代码

> 将认证模块重构为使用 async/await 而不是回调

编写测试

> 为计算器函数编写单元测试

更新文档

> 更新 README 添加安装说明

代码审查

> 审查我的变更并提出改进建议

记住:Claude Code 是你的 AI 结对程序员。像和有用的同事交流一样与它对话 - 描述你想要实现的目标,它会帮你达成。

常用命令

命令作用示例
claude启动交互模式claude
claude "task"运行一次性任务claude "修复构建错误"
claude -p "query"运行一次性查询后退出claude -p "解释这个函数"
claude -c继续当前目录最近的对话claude -c
claude -r恢复之前的对话claude -r
claude commit创建 Git 提交claude commit
/clear清除对话历史> /clear
/help显示可用命令> /help
exit 或 Ctrl+C退出 Claude Code> exit

新手专业技巧

具体明确你的请求

❌ 不要这样

修复这个 bug

✓ 试试这样

修复登录 bug,用户输入错误凭证后看到空白屏幕

使用分步指示

创建用户配置文件数据库表
创建获取和更新用户配置的 API 端点
构建网页让用户查看和编辑信息

让 Claude 先探索

分析数据库架构
构建仪表板显示英国客户最常退回的产品

使用快捷键节省时间

按 ? 查看所有键盘快捷键
使用 Tab 进行命令补全
按 ↑ 查看命令历史
输入 / 查看所有斜杠命令

下一步

现在你已经掌握了基础知识,探索更多高级功能:

常见工作流程

常见任务的分步指南

CLI 参考

掌握所有命令和选项

配置

自定义 Claude Code 工作流

Web 版 Claude Code

在云端异步运行任务

获取帮助

在 Claude Code 中:输入 /help 或询问"如何..."
文档:你正在这里!浏览其他指南
社区:加入 Discord 获取提示和支持