Claude Code 安装使用与配置教程

2.2.1 npm 安装命令

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

安装完成后验证是否安装成功。

claude --version

2.2.2 启动 Claude Code

1. 在项目根目录下启动 Claude Code

• 打开 CMD，进入到项目目录，在命令行输入：claude
• 配置主题模式：可以上下切换模式，回车键为确认。

2. 安全配置

╭──────────────────────────╮
│ ✻ Welcome to Claude Code │
╰──────────────────────────╯

Security notes:
1. Claude can make mistakes
   You should always review Claude's responses, especially when
   running code.
2. Due to prompt injection risks, only use it with code you trust
   For more details see:
   https://docs.anthropic.com/s/claude-code-security

Press Enter to continue…

• 默认选择第一个，然后回车键确认即可。
• 上下键可以切换选项，如果是非项目目录，请选择第二个退出。

3. Claude Code 简单入门

Claude 是完全通过终端进行交互的，其中内置了多种工具，比如文件操作、搜索等。可以理解自然语言并转化为相应的命令执行。

# 在项目根目录启动 claude
# 或者在某个目录指定特定任务
claude "帮我分析这个项目的结构"

语言设置

在启动目录，创建文件夹 .claude，在 .claude 文件夹中创建文件 config.json。

{
  "model": "claude-3-5-sonnet-20241022",
  "max_tokens": 4000,
  "temperature": 0.7,
  "auto_approve": false,
  "git_integration": true,
  "excluded_files": [
    "node_modules/**",
    ".git/**",
    "*.log",
    "dist/**"
  ],
  "language_preferences": {
    "documentation": "zh-CN",
    "code_comments": "zh-CN"
  }
}

4. Claude Code 自然语言输入

在使用 Claude Code 时，可通过多种操作方式提升使用效率与功能覆盖度 —— 除了基础的对话式问答，还能输入内置命令、执行 shell 命令、调用编译器运行代码等，满足不同使用场景需求。

初次使用 Claude Code 时，可先从自然语言交互入手：Claude 内置丰富工具集，能够通过理解自然语言指令自动调用对应工具完成操作。以下为两个基础测试任务，帮助快速熟悉核心能力：

1. 读取当前工作目录下的项目文件，并自动生成一份结构化的项目分析报告；
2. 基于自然语言需求，从零搭建一个简单的项目（包含文件创建、代码编写等完整流程）。

复杂项目会消耗巨量 token，且由于并非使用的原生 Claude 模型，所以效果并不优秀。

生成一份项目分析报告

报告生成成功：

优化项目某个功能

注解删除成功：

5. Claude Code 的命令行输入

Claude Code 作为 Anthropic 面向开发者的终端 AI 编码工具，核心交互方式为斜杠命令（Slash Commands），通过 / 前缀唤起命令面板，可精准控制 AI 行为、管理项目上下文，结合自然语言指令实现高效开发协作。

1. /add-dir – 绑定工作目录

/add-dir <你的工作目录路径>

定义与语法：/add-dir 是纯目录绑定命令，参数支持绝对 / 相对路径，执行后仅将指定目录设为 Claude Code 的工作空间，不会自动生成 CLAUDE.md，也无任何初始化分析行为。

2. /init – 执行项目初始化

/init

定义与语法：/init 是无参数命令，必须在 /add-dir 绑定目录后执行，执行后会扫描已绑定的工作目录，生成 CLAUDE.md 文档（包含项目结构、依赖等），这是 AI 建立项目上下文的核心操作。

使用场景：绑定目录后必须执行 /init，才能让 AI 生成 "项目手册"；若仅执行 /add-dir 不执行 /init，AI 无法理解项目结构，仅能读取单个文件，无法进行项目级分析。

3. /help – 查看命令列表

/help

定义与语法：/help 为无参数命令，执行后会列出 Claude Code 支持的所有斜杠命令，并简要说明每个命令的核心功能，是快速查阅命令用法的基础指令。

4. /clear – 清除对话历史

/clear

定义与语法：/clear 无参数，执行后会清空当前会话的所有对话历史，Claude Code 将遗忘此前的所有交互内容，但不会退出工具界面，相当于开启全新的会话环境。

5. /compact – 压缩对话内容

/compact [instructions]

定义与语法：/compact [ instructions ] 支持可选的 "指令" 参数，执行后会自动总结压缩当前对话历史，并将摘要作为新对话的初始上下文；附加参数可指定压缩侧重点，例如 /compact "保留尚未解决的问题" 会让总结优先保留未解决的问题内容。

使用场景：当会话长度接近模型上下文长度上限时，/compact 可释放大量上下文令牌，是延续长对话的核心指令；它既能保留对话核心信息，又不会像 /clear 那样完全清空历史，适合在不中断长任务讨论的前提下，优化上下文占用空间。

6. /memory – 编辑会话记忆文件

/memory

定义与语法：/memory 无参数，执行后会直接打开并编辑当前项目的持久记忆文件 CLAUDE.md，支持查看、添加、删除或修改文件内容，直接调整 Claude Code 的"长期记忆"。

使用场景：初始化项目后，若发现 CLAUDE.md 遗漏关键信息（如业务术语、架构要点），可通过 /memory 命令补充；也可修改文件中的代码风格、协作规则等内容，更新后执行 /clear 重启会话，Claude Code 会依据更新后的文件理解项目，减少认知偏差。

7. /status – 会话状态检查

/status

定义与语法：/status 无参数，属于只读命令，执行后会展示当前 Claude Code 会话的核心状态信息，包括绑定的工作目录、登录账户、使用的模型版本等，不会修改任何系统设置。

使用场景：切换工作目录或模型版本后，执行 /status 可验证配置是否生效；当 Claude Code 行为异常时，该命令是排查问题的起点，可快速确认是否存在目录指向错误、模型加载失败、记忆文件未读取等问题。

8. /cost – 令牌与费用统计

/cost

定义与语法：/cost 无参数，执行后会统计当前会话的令牌使用情况，包括提示词和回答分别消耗的 token 数量，以及基于用量预估的 API 费用，是掌控使用成本的核心指令。

使用场景：使用按量计费的 API 密钥或免费额度时，执行 /cost 可实时掌握 token 消耗和费用预估；在长会话或密集代码生成场景中，定期检查 /cost 能及时发现用量飙升问题，通过精简提问、压缩上下文等方式节约开销；结束工作时，也可通过该命令核对当日用量是否在预算范围内。

9. /config – 查看或修改配置

/config

定义与语法：/config 为交互式配置命令，执行后会展示配置菜单，支持可视化修改 Claude Code 的各项参数；也可通过子命令直接设置，例如 /config set autocompact off 可关闭自动压缩功能。

使用场景：可根据个人使用习惯定制工具行为，例如开启/关闭自动压缩、切换主题配色、启用/禁用待办事项功能、打开 verbose 调试模式等；/config 相当于 Claude Code 的个性化控制面板，能适配不同开发者的使用偏好和场景需求。

10. /model – 切换 AI 模型版本

/model [model_name]

定义与语法：/model [model_name] 支持可选的模型名称参数，不带参数时会显示当前使用的模型及可选模型列表，指定参数则可直接切换模型（常用模型包括 Sonnet 系列、Opus 系列等）。

11. /doctor – 环境健康检查

/doctor

定义与语法：/doctor 无参数，执行后会自动检查 Claude Code 的运行环境，验证 API 连通性、账户有效性、必需依赖的安装状态、文件权限配置等，并输出详细的健康检查报告。

使用场景：当 Claude Code 出现异常行为（如无法读取文件）时，/doctor 是首要的排查工具；检查报告会明确标注问题项（如"API 凭据无效"），可根据报告针对性修复问题，快速恢复正常。

6. Claude Code 进阶技巧

善用以上斜杠命令，不仅能在对应场景提升效率，还能相互配合，形成连贯顺畅的开发工作流。下面以一个真实开发场景为例，展示如何组合使用命令完成一整套复杂任务：

**场景：**接手一个新项目，需要先熟悉代码结构，再开发新功能，最后完成代码优化与后续提交流程。使用 Claude Code 可按以下流程高效协作：

**1. 初始化项目记忆：**进入项目目录并启动 Claude Code 后，先执行 /init 生成 CLAUDE.md 项目指南，让 AI 快速建立对项目的整体认知。随后通过自然语言指令让 AI 梳理项目概况，Claude 即可基于这份记忆文件给出清晰的代码库解读。

**2. 切换模型适配复杂任务：**若默认模型在理解复杂架构时表现不足，可使用 /model opus 切换到能力更强的模型，使其更精准地分析深层逻辑与代码结构。

**3. 编写代码与上下文管理：**在 AI 协助下编写新功能代码，Claude 可直接在终端提出修改建议并完成编辑。当对话内容过长时，使用 /compact "保留新功能相关讨论" 压缩上下文，让 AI 始终聚焦当前任务。单个模块修改完成后，执行 /clear 清空历史，再开始下一个模块的开发，避免旧上下文干扰新逻辑。

**4. 完善代码功能：**在基础实现完成后，继续通过指令补充边界处理、异常判断、参数校验等细节，让功能更健壮、逻辑更完整。

**5. 代码性能分析与优化：**让 Claude 对已实现代码进行耗时、复杂度与资源占用分析，针对性提出优化方案，包括算法改进、冗余逻辑删减、并发安全优化等，提升代码运行效率与稳定性。

可以看出，Claude Code 的斜杠命令与自然语言指令相结合，能够覆盖从环境准备、项目理解、编码调试，到功能完善、性能优化的完整开发流程。灵活组合各类命令，将重复繁琐的操作交给 AI 处理，开发者可以更专注于核心业务与高层设计，真正实现高效的人机协作编程。

项目实战：

1. 提出问题

2. 提出解决方案