快速开始

从零开始,5 分钟运行你的第一个 Claude Code 会话。

1. 安装

Claude Code 是一个 npm 包,可以直接通过 npx 运行,也可以全局安装:

# 方式一:直接使用 npx(无需安装)
$ npx @anthropic-ai/claude-code

# 方式二:全局安装
$ npm install -g @anthropic-ai/claude-code
$ claude

需要 Node.js 18+ 和有效的 Anthropic API 密钥。

2. 配置 API 密钥

Claude Code 需要 Anthropic API 密钥。设置方式:

# 通过环境变量设置
$ export ANTHROPIC_API_KEY=your-api-key-here

# 或在首次运行时交互式输入
$ claude
> API key not found. Please enter it: ••••••••

提示:密钥会安全存储在本地,不会上传到任何服务器。

3. 开始对话

在项目目录下运行 claude,然后直接输入你的需求:

$ claude

> 这个项目是做什么的?

Claude: 让我先看看项目结构...
• 读取 package.json
• 扫描 src/ 目录
• 分析项目结构


这是一个 Next.js 项目,使用了 Tailwind CSS 和 TypeScript...

4. 常用操作

编辑文件

直接告诉 Claude 要修改什么,它会自动定位并编辑文件。

> 把首页的标题改成 "Hello World"

搜索代码

用自然语言描述你要找的代码,Claude 会搜索并定位。

> 哪里处理了用户登录逻辑?

执行命令

Claude 可以运行终端命令,如 npm install、git diff 等。

> 帮我跑一下测试

多文件修改

复杂任务会自动分解到多个文件中执行。

> 把所有 API 调用改成 axios

5. 快捷键

快捷键功能
Ctrl+C中断当前操作
Ctrl+D退出 Claude Code
↑ / ↓浏览历史命令
Tab自动补全
/help查看帮助信息

下一步:学习 命令系统,了解更多强大功能。