Claude Code 快速入门

安装 Claude Code，配置项目，运行第一个会话。

安装 Claude Code

Claude Code 是一个在终端中运行的 CLI 工具。

macOS / Linux（推荐）：

curl -fsSL https://claude.ai/install.sh | bash

Windows（PowerShell）：

irm https://claude.ai/install.ps1 | iex

通过 npm（需要 Node.js 18+）：

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

需要 Pro、Max、Team、Enterprise 或 Console 任一账户来完成认证。免费版 Claude.ai 不包含 Claude Code。也可以通过 Amazon Bedrock↗、Google Vertex AI↗ 或 Microsoft Foundry↗ 接入自家 provider。

首次运行

进入任意项目目录，输入 claude 启动交互会话：

cd my-project
claude

首次运行时，Claude 会打开浏览器窗口进行身份验证。之后，它会分析你的项目结构并开始交互对话。试试这些命令：

给我一个这个代码库的概览
@src/index.ts 是做什么的？

配置 CLAUDE.md

在项目根目录创建 CLAUDE.md 文件，为 Claude 提供持久化上下文。你可以自动生成：

/init

或手动创建基础配置：

# Project: MyApp

## 构建与测试

- npm run dev # 启动开发服务器
- npm test # 运行测试
- npm run lint # 代码检查

## 架构

- React 18 + TypeScript 前端
- Express API 位于 /api/v1
- PostgreSQL 通过 Prisma ORM 访问

## 编码规范

- 使用 hooks 的函数式组件
- 命名导出，文件名使用 kebab-case
- 测试文件放在 __tests__/ 目录

保持简洁。对每一行都问自己：如果删掉这行，Claude 会犯错吗？ 如果不会，就删掉。查看 CLAUDE.md 深度指南 了解高级用法。

添加第一个 Skill

可复用工作流优先创建 skill，不要不断膨胀 CLAUDE.md：

---
name: review
description: Use when reviewing current changes before a commit or PR.
---

检查当前更改：
- 潜在的 bug 和边界情况
- 安全漏洞
- 性能问题
给出带文件路径的具体修复建议。

Skills 会自动发现，并且只在相关时加载。完整模式见 Skills。

理解权限系统

Claude Code 使用分层权限系统。Shift + Tab 在默认三个模式之间循环：

• default — Claude 在每次写入或 shell 命令前都会询问。
• acceptEdits — 文件编辑及常见文件系统命令自动通过。
• plan — Claude 通过读文件和跑 shell 探索，但不会修改源码。

另外三种模式（auto、dontAsk、bypassPermissions）需要显式开启 —— 见 权限与安全。

在启动时直接指定模式：

claude --permission-mode plan          # 只读探索
claude --permission-mode acceptEdits   # 自动批准编辑

完整说明包括按命令的允许/拒绝规则，详见 权限与安全。

会话命名与恢复

为需要稍后返回的会话命名：

claude --name "auth-refactor"    # 启动时设置名称（简写：-n）

之后通过名称或列表恢复：

claude --resume "auth-refactor"  # 按名称恢复（简写：-r）
claude --continue                # 恢复最近的会话（简写：-c）

如果想安全实验，创建隔离的并行 worktree：

claude --worktree

用 /memory 查看持久上下文，用 /agents 管理 subagents。

延伸阅读

• 键盘快捷键 — 掌握 CLI 快捷操作
• CLAUDE.md 与记忆 — 高级上下文配置
• Claude Code 架构 — 理解完整 harness
• 计划模式 — 安全的只读探索