Claude Code 使用指南：从安装到实战，一篇就够（2026）

Claude Code 是什么

Claude Code 是 Anthropic 推出的一个 AI 编程 Agent，直接运行在你的终端里。

它不是 VS Code 插件，不是网页聊天框，而是一个命令行工具。你在终端里跟它对话，它能读你的代码、改你的文件、跑你的命令、修你的 bug。

和 GitHub Copilot 那种”补全几行代码”的工具不同，Claude Code 是真正的 Agent——它能理解整个代码仓库的上下文，自主规划和执行多步骤的开发任务。

安装

前置条件

Node.js 18+
一个 Claude 账号（Pro、Max、Team 或 Enterprise 订阅）

安装命令

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

安装完成后，在任意项目目录下运行：

claude

首次启动会引导你登录 Claude 账号，完成认证后就可以开始使用了。

验证安装

claude --version

基本用法

交互模式

直接运行 claude 进入交互式对话：

cd your-project
claude

进入后你就可以用自然语言跟它对话了，比如：

“帮我看看这个项目的整体架构”
“src/utils/auth.ts 里的 token 刷新逻辑有 bug，帮我修一下”
“给这个 API 加上分页功能”

单次命令模式

不想进入交互模式？可以直接传入提示词：

claude "解释一下这个项目的目录结构"

管道模式

Claude Code 支持 Unix 管道，可以把其他命令的输出喂给它：

cat error.log | claude "分析这个报错日志，找出根本原因"
git diff | claude "review 这些改动，有没有潜在问题"
npm test 2>&1 | claude "测试挂了，帮我分析原因并修复"

核心命令

斜杠命令

在交互模式下，这些斜杠命令非常实用：

命令	作用
`/help`	查看帮助信息
`/compact`	压缩上下文，释放 token 空间
`/clear`	清空当前对话
`/cost`	查看当前会话的 token 用量和费用
`/doctor`	诊断 Claude Code 的配置和健康状态
`/init`	在当前项目生成 CLAUDE.md 文件
`/login`	切换账号或重新登录
`/logout`	退出登录
`/model`	切换模型（Opus / Sonnet / Haiku）
`/permissions`	查看和管理工具权限
`/review`	对当前 git diff 做代码审查
`/terminal-setup`	配置终端集成（Shift+Enter 换行等）

CLI 参数

# 指定模型
claude --model claude-sonnet-4-6

# 继续上次的对话
claude --continue

# 从最近的对话列表中选择恢复
claude --resume

# 非交互模式，输出纯文本（适合脚本集成）
claude -p "你的提示词"

# 指定输出格式
claude -p "你的提示词" --output-format json

# 允许所有工具权限（无需逐个确认）
claude --dangerously-skip-permissions

CLAUDE.md —— 给 Claude Code 的”入职手册”

这是 Claude Code 最强大的特性之一。在项目根目录创建一个 CLAUDE.md 文件，Claude Code 每次启动都会自动读取。

为什么需要 CLAUDE.md

没有 CLAUDE.md，Claude Code 每次都要重新理解你的项目。有了它，Claude Code 一启动就知道：

项目用什么技术栈
怎么构建、测试、部署
代码规范是什么
有哪些需要注意的坑

怎么写

运行 /init 可以自动生成一个基础版本，但我建议手动写，内容更精准。一个好的 CLAUDE.md 应该包含：

# CLAUDE.md

## 项目概述

简要描述项目是什么、用了什么技术栈。

## 常用命令

列出构建、测试、lint、部署等命令。

## 架构说明

项目目录结构、核心模块、数据流向。

## 编码规范

缩进、命名、格式化等约定。

## 注意事项

已知的坑、特殊约定、不要碰的文件等。

实际例子

以我的 monorepo 项目为例，CLAUDE.md 里写了这些：

# CLAUDE.md

## Project Overview

x-vq is a private frontend monorepo using Lerna + Nx.

## Commands

| Command         | Purpose                            |
| --------------- | ---------------------------------- |
| `npm run build` | Build all packages                 |
| `npm run test`  | Test all packages                  |
| `npm run lint`  | Full pipeline: build → lint → test |

## Monorepo Rules

- Install deps: `npm i <pkg> -w <sub-package>`
- Run scripts: `npm run <script> -w <sub-package>`
- Never cd into sub-packages to install or run.

有了这个文件，Claude Code 就知道这是个 monorepo，知道不能 cd 进子包装依赖，知道怎么跑构建和测试。省去了每次都要解释一遍的麻烦。

CLAUDE.md 的层级

Claude Code 会读取多个位置的 CLAUDE.md，优先级从低到高：

~/.claude/CLAUDE.md —— 全局配置，所有项目生效
项目根目录的 CLAUDE.md —— 项目级配置
子目录中的 CLAUDE.md —— 更细粒度的配置
.claude/CLAUDE.md —— 项目级，但不提交到 git（适合个人偏好）

权限系统

Claude Code 在执行文件操作和 shell 命令时会请求权限。你可以选择：

Allow once：本次允许
Allow always：永久允许这个操作
Deny：拒绝

也可以通过 /permissions 命令统一管理，或者在 .claude/settings.json 中配置：

{
  "permissions": {
    "allow": ["Bash(npm run build)", "Bash(npm run test)", "Bash(git *)"],
    "deny": ["Bash(rm -rf *)"]
  }
}

Plan Mode（规划模式）

面对复杂任务时，你可以让 Claude Code 先规划再执行：

帮我把这个 Express 项目迁移到 Fastify，先列个计划

Claude Code 会进入 Plan Mode，列出：

需要修改哪些文件
每一步具体做什么
可能的风险点

你确认后它才开始执行。这对大型重构特别有用——先看计划，不满意可以调整，避免它一顿操作猛如虎结果方向跑偏。

实战技巧

1. 让它先读再改

不要上来就说”改这个文件”。先让它理解上下文：

先看看 src/services/payment.ts 的实现，然后帮我加上退款功能

2. 善用 /compact

对话长了之后 token 会爆。用 /compact 压缩上下文，Claude Code 会保留关键信息，释放空间。

3. 用 git diff 做 Code Review

/review

或者在命令行：

git diff main | claude "review 这些改动"

4. 调试闭环

Claude Code 最爽的用法之一——让它自己跑测试、看报错、修 bug：

跑一下测试，如果有失败的就修复

它会自己执行测试命令，分析失败原因，修改代码，再跑测试，直到全部通过。

5. 用 —continue 保持上下文

中途退出了？用 claude --continue 继续上次的对话，不用重新解释背景。

6. 多模型切换

日常开发用 Sonnet 就够了，速度快、够聪明。遇到复杂架构问题再切 Opus：

/model claude-opus-4-6

和 IDE 集成

Claude Code 虽然是命令行工具，但也可以和主流 IDE 配合使用：

VS Code：安装 Claude Code 扩展，在编辑器内直接使用
JetBrains：通过 Terminal 面板使用
Vim/Neovim：天然适配，终端就是你的 IDE

不管用什么编辑器，核心工作流都是一样的：在终端里跟 Claude Code 对话，它直接修改你的文件，你在编辑器里实时看到变化。

定价

Claude Code 不单独收费，它包含在 Claude 的订阅计划中：

Pro（$20/月）：可以使用，有用量限制
Max（$100 或 $200/月）：大幅提升用量上限
Team / Enterprise：团队和企业级用量

也可以通过 API key 使用，按 token 计费。

Claude Code 系列完全地图

这个博客有一整套 Claude Code 的指南，按学习路径整理在下面。看到感兴趣的就跳过去。

快速上手

配置体系

日常命令（访问量最高的一批）

进阶能力

观测与复盘

效率技巧

集成实战

写在最后

Claude Code 改变了我的开发方式。以前写代码是”我写，AI 辅助”，现在是”我描述需求，AI 执行，我 review”。

它不是万能的，复杂的架构决策还是需要人来做。但那些重复性的编码工作、繁琐的重构、看不完的报错日志——交给 Claude Code 就对了。

如果你是程序员，强烈建议试一试。装上之后，在你的项目里跑一个 claude，随便问它点什么，你会感受到那种”哦，原来 AI 编程是这么回事”的冲击。