快速开始
从零开始,5 分钟运行你的第一个 Claude Code 会话。
1. 安装
Claude Code 是一个 npm 包,可以直接通过 npx 运行,也可以全局安装:
# 方式一:直接使用 npx(无需安装)
$ npx @anthropic-ai/claude-code
# 方式二:全局安装
$ npm install -g @anthropic-ai/claude-code
$ claude
$ 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: ••••••••
$ 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...
> 这个项目是做什么的?
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 | 查看帮助信息 |
下一步:学习 命令系统,了解更多强大功能。