快速开始

Claude Code 是 Anthropic 推出的 AI 编程助手，通过命令行工具让你用自然语言完成编程任务。要使用 Claude Code，首先需要安装并登录，然后即可在项目目录中启动会话，通过对话方式探索代码库、修改代码、操作 Git 以及修复 bug。具体使用方法包括：1) 通过 curl 或包管理器安装；2) 使用 claude 命令登录并启动；3) 输入自然语言指令（如“添加一个函数”或“提交代码”）让 AI 执行操作。本教程将带你从零开始，在10分钟内完成安装并实践第一个任务，涵盖 macOS、Linux、Windows 等多种系统。

欢迎使用 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 提供两个 cask：claude-code 跟随稳定发布频道（通常滞后约一周，跳过有严重问题的版本）；claude-code@latest 跟随最新版本，新版发布后立即更新。

WinGet（Windows）

winget install Anthropic.ClaudeCode

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

第二步：登录账户

首次运行时需要登录：

claude
# 首次运行会提示登录

也可以用登录命令：

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

支持以下账户类型：

• Claude Pro / Max / Teams / Enterprise（推荐）
• Claude Console（API 用量付费模式，首次登录会自动创建专属 "Claude Code" 工作区用于集中计费）
• Amazon Bedrock、Google Vertex AI、Microsoft Foundry（企业云服务商）

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

第三步：启动第一个会话

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

cd /path/to/your/project
claude

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

第四步：探索代码库

先让 Claude 了解你的项目：

这个项目是做什么的？

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

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

也可以直接问 Claude Code 自身的能力：

Claude Code 能做什么？
怎么创建自定义 Skills？
Claude Code 能配合 Docker 使用吗？

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 交流技巧和获取支持

常见问题

Q: Claude Code 是什么，怎么使用？

Claude Code 是 Anthropic 开发的 AI 编程命令行工具。使用方法是：先安装（如运行 curl -fsSL https://claude.ai/install.sh | bash），然后登录账户，在项目目录中运行 claude 启动会话，即可用自然语言指挥 AI 编写、修改、提交代码。

Q: Claude Code 使用教程有哪些关键步骤？

关键步骤包括：1) 安装 Claude Code；2) 登录 Claude 订阅或 API 账户；3) 在项目中启动会话；4) 让 AI 探索代码库；5) 用自然语言指示代码修改；6) 使用对话操作 Git。整个过程无需手动编码，通过对话完成。

Q: Claude Code 如何安装和开始使用？

支持多种安装方式：macOS/Linux 用 curl 脚本，Windows 用 PowerShell 脚本，也可通过 Homebrew 或 WinGet 安装。安装后运行 claude 命令登录，进入项目目录再次运行 claude 即可开始使用。

Q: Claudecode 怎么用？能做什么？

Claude Code 主要用于 AI 辅助编程：可以分析项目结构、根据描述修改代码、编写测试、重构代码、操作 Git（提交、分支、解决冲突）、修复 bug 以及更新文档。你只需要用自然语言描述任务，AI 会理解并执行。

Q: Claude Code 使用方法有什么技巧？

技巧包括：提示要具体（例如说明文件或功能）；复杂任务分步骤描述；先让 AI 探索项目再提修改要求；使用 /help 查看命令；修改前 AI 会请求确认，可逐条审核。像与同事对话一样清晰描述需求即可。