快速开始

欢迎使用 Claude Code！本教程将带你在 10 分钟内完成安装，并完成第一个 AI 辅助编程任务。

前置条件

• 打开一个终端（命令行窗口）
• 有一个代码项目可以操作
• Claude 订阅方案（Pro、Max、Teams 或 Enterprise），或者 Anthropic Console 账户

本教程介绍终端 CLI 的使用方式。Claude Code 也支持 VS Code 扩展、桌面应用、JetBrains 插件，以及 GitHub Actions 等 CI/CD 集成。

第一步：安装 Claude Code

根据你的操作系统选择安装方式：

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

Windows 用户需要先安装 Git for Windows。

Homebrew（macOS）

brew install --cask claude-code

Homebrew 安装不会自动更新，需要定期运行 brew upgrade claude-code。

WinGet（Windows）

winget install Anthropic.ClaudeCode

原生安装方式（推荐）会在后台自动更新，始终保持最新版本。

第二步：登录账户

首次运行时需要登录：

claude
# 首次运行会提示登录

也可以用登录命令：

/login
# 按提示完成登录流程

支持以下账户类型：

• Claude Pro / Max / Teams / Enterprise（推荐）
• Claude Console（API 用量付费模式）
• Amazon Bedrock、Google Vertex AI、Microsoft Foundry（企业云服务商）

登录后凭据会保存在本地，下次启动无需重新登录。如需切换账户，使用 /login 命令。

第三步：启动第一个会话

进入任意项目目录，启动 Claude Code：

cd /path/to/your/project
claude

看到欢迎界面后，输入 /help 查看可用命令，输入 /resume 继续上次的对话。

第四步：探索代码库

先让 Claude 了解你的项目：

这个项目是做什么的？

Claude 会分析你的文件并给出摘要。你也可以问更具体的问题：

这个项目用了哪些技术栈？
主要入口文件在哪里？
解释一下目录结构

Claude Code 会自动读取项目文件，不需要手动指定上下文。

第五步：做第一次代码修改

让 Claude 做一个简单的改动：

在主文件里添加一个 hello world 函数

Claude Code 会：

1. 找到合适的文件
2. 展示建议的改动
3. 等待你确认
4. 执行编辑

Claude Code 修改文件前始终会先询问你的确认。你可以逐条批准，或者开启"全部接受"模式。

第六步：用自然语言操作 Git

Claude Code 让 Git 操作变成对话：

我改了哪些文件？
用描述性的提交信息提交这些改动

更复杂的 Git 操作：

创建一个叫 feature/quickstart 的新分支
查看最近 5 条提交记录
帮我解决 merge 冲突

第七步：修 bug 和添加功能

用自然语言描述你要做什么：

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

或者修复已有的问题：

有个 bug：用户可以提交空表单，帮我修掉它

Claude Code 会：

• 找到相关代码
• 理解上下文
• 实现解决方案
• 如果有测试，运行测试验证

第八步：更多常用操作

重构代码

把 authentication 模块从回调函数重构成 async/await 风格

写测试

给 calculator 函数写单元测试

更新文档

更新 README，添加安装说明

代码审查

审查我的改动并给出改进建议

像对待一个靠谱的同事一样和 Claude 交流。描述你想实现什么，它会帮你搞定。

常用命令速查

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

完整命令列表见 CLI 参考。

新手提示

提示要具体

不要说：修复 bug

要说：修复登录页面的 bug：用户输入错误密码后看到空白页面

分步骤描述任务

1. 为用户资料创建新的数据库表
2. 创建用于获取和更新用户资料的 API 接口
3. 搭建让用户查看和编辑自己信息的页面

先让 Claude 探索再动手

分析一下数据库 schema

快捷键

• 按 ? 查看所有快捷键
• 按 Tab 补全命令
• 按 ↑ 查看命令历史
• 输入 / 查看所有命令和 Skills

下一步

• Claude Code 工作原理 - 了解 AI 代理循环和内置工具
• 最佳实践 - 如何写出高质量提示词
• 常见工作流 - 常见任务的操作示例
• 扩展 Claude Code - 用 CLAUDE.md、Skills、Hooks 和 MCP 定制你的工作流

获取帮助

• 在 Claude Code 内：输入 /help 或问"如何..."
• 社区：加入 Discord 交流技巧和获取支持