Claude Code 新手入门指南

约 1955 字大约 7 分钟...

Claude Code 是由 Anthropic 公司推出的一款革命性的 AI 编程助手，它能够直接在你的命令行终端中理解整个代码库、进行跨文件编辑，并像一个经验丰富的开发伙伴一样协助你完成编程任务。无论你是想要重构代码、生成测试、调试问题，还是学习新的编程概念，Claude Code 都能在终端中为你提供智能化的帮助。本指南将带你一步步完成安装、配置，并开始你的第一次 AI 编程体验。

第一步：准备工作和快速安装

在开始之前，请确保你的电脑已经安装了以下必需软件：

Node.js: 版本 18 或更高
ripgrep: 一款高效的文件内容搜索工具

你可以通过包管理器安装 ripgrep：

# macOS
brew install ripgrep

# Windows (with Chocolatey)
choco install ripgrep

# Debian/Ubuntu
sudo apt-get install ripgrep

安装 Claude Code

打开你的终端（Windows 用户使用 PowerShell，macOS/Linux 用户使用 Terminal），运行以下命令：

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

验证安装

安装完成后，运行以下命令验证 Claude Code 是否正确安装：

claude --help

如果你看到一长串帮助信息，恭喜你！Claude Code 已经成功安装。

第二步：获取访问权限

Claude Code 需要 Anthropic 的付费订阅才能使用。你有以下几种选择：

个人用户选项

Claude Pro 订阅（推荐新手）
- 费用：每月 $20（年付可享受折扣）
- 访问 claude.ai 注册并订阅 Pro 计划
- 订阅后即可在终端使用 Claude Code
Claude Max 订阅（适合重度用户）
- 费用：每月 $100 起
- 提供更高的使用限额和更长的输出长度

团队和企业用户

如果你是团队或企业用户，可以通过 Anthropic Console 设置 API 访问，按实际使用量付费。

第三步：首次登录和认证

完成订阅后，让我们进行首次登录：

在终端运行以下命令启动 Claude Code：
```
claude
```
首次运行时，Claude Code 会引导你完成登录流程。按照屏幕提示操作：
- 它会打开你的默认浏览器
- 使用你的 Anthropic 账户登录
- 授权 Claude Code 访问你的账户
登录成功后，你会看到一个友好的欢迎界面，这意味着一切准备就绪！

第四步：开始你的第一次 AI 编程对话

现在让我们开始第一次真正的 AI 编程体验：

基础交互模式

在终端运行：

claude

你会进入一个交互式聊天界面。试试这些简单的命令：

询问代码解释：请解释这个项目的结构
请求代码生成：帮我写一个计算斐波那契数列的 Python 函数
代码审查：请审查这个文件中的代码质量

一次性命令模式

如果你只想执行一个快速任务，可以使用：

claude -p "你的问题或请求"

例如：

claude -p "解释这个 main.js 文件的功能"

第五步：让 Claude 了解你的项目

Claude Code 的强大之处在于它能理解你的整个项目。通过创建 CLAUDE.md 文件，你可以为 Claude 提供项目的"长期记忆"。

自动生成项目上下文

在你的项目根目录中，启动 Claude Code：
```
claude
```
运行初始化命令：
```
/init
```
Claude 会分析你的项目并自动生成一个 CLAUDE.md 文件，包含：
- 项目结构概述
- 主要技术栈
- 编码规范建议
- 关键文件说明

自定义项目规则

你可以编辑 CLAUDE.md 文件来添加你的团队规范：

# MyProject 开发指南

## 技术栈

- 前端：React + TypeScript
- 后端：Node.js + Express
- 数据库：PostgreSQL

## 编码规范

- 使用 ESLint 和 Prettier
- 所有函数必须有 JSDoc 注释
- 优先使用函数式编程风格

## 测试要求

- 新功能必须包含单元测试
- 测试覆盖率不低于 80%

多层级上下文加载机制

Claude Code 会智能地从多个位置加载 CLAUDE.md 文件，并将它们合并，这对于大型项目或 monorepo 特别有用：

用户主目录：~/.claude/CLAUDE.md 中的规则会应用于所有项目。
父目录：自动加载所有父目录中的 CLAUDE.md 文件。
项目根目录：最常见的位置，可以命名为 CLAUDE.md (建议提交到版本控制) 或 CLAUDE.local.md (用于本地配置，应添加到 .gitignore)。
子目录：当处理子目录中的文件时，会按需加载该子目录下的 CLAUDE.md。

第六步：掌握常用命令

交互模式中的斜杠命令

在 Claude Code 的交互模式中，你可以使用这些特殊命令：

/clear：清空当前对话历史
/compact：压缩长对话以节省上下文空间
/review：对指定文件或 PR 进行代码审查
/init：分析项目并生成 CLAUDE.md 文件

命令行选项

claude -c：继续上一次的对话会话
claude -r <session-id>：恢复指定的历史会话
claude --model sonnet：指定使用的 AI 模型（sonnet、opus、haiku）
claude --output-format json：以 JSON 格式输出结果
claude --dangerously-skip-permissions：跳过所有操作权限确认，适合在受信任的自动化脚本中使用（请谨慎！）。

第七步：高级配置

对于进阶用户，可以通过在用户主目录创建 ~/.claude.json 文件来进行高级配置，例如预先批准或禁止某些工具的执行，以减少交互时的授权提示。

{
  "permissions": {
    "allow": {
      "run_shell_command": true, // 总是允许执行 shell 命令
      "read_file": true // 总是允许读取文件
    },
    "deny": {
      "write_file": false // 禁止写入文件
    }
  }
}