Claude Code 使用指南

安装 Claude Code#

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

安装完成后怎么启动#

先进入你的项目目录：

cd your-project

然后直接启动：

claude

第一次运行时，Claude Code 会引导你完成登录。
如果你想显式执行登录，也可以用：

claude auth login

登录完成后，建议先确认版本：

claude --version

官方当前支持的登录来源主要有：

• Anthropic Console
• Claude.ai 账号
• Amazon Bedrock
• Google Vertex AI

系统要求#

根据官方当前文档，Claude Code 的基础要求大致是：

• macOS 10.15+
• Ubuntu 20.04+ / Debian 10+
• Windows 10+（WSL 或 Git for Windows）
• 至少 4GB 内存
• Node.js 18+
• 需要联网
• 最好使用 Bash、Zsh 或 Fish

如果你是 Linux 或 macOS 用户，直接终端安装最顺。
如果你是 Windows 用户，优先用 WSL 会省很多兼容性问题。

最基础的使用方式#

1. 进入项目后直接对话#

claude

接着在交互界面里直接提任务，比如：

先解释这个项目的目录结构

或者：

修复首页搜索框在移动端换行错位的问题

2. 启动时就带上任务#

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

3. 非交互模式#

如果你只想跑一次然后退出，可以用：

claude -p "解释 src/utils/request.ts 的作用"

这个模式很适合脚本化、CI 或快速查询。

常见使用场景#

比如解释代码：

claude "解释 src/components/Header.tsx 的职责和调用关系"

比如修 bug：

claude "修复评论组件在深色模式下按钮颜色错误的问题"

比如补测试：

claude "给 userService 增加单元测试，并运行测试确认通过"

比如处理日志或管道输入：

cat logs.txt | claude -p "总结这份日志里的主要错误"

常用 CLI 命令#

启动交互式会话#

claude

带初始提示启动#

claude "explain this project"

非交互执行后退出#

claude -p "explain this function"

继续当前目录最近一次会话#

claude -c

恢复指定会话#

claude -r "auth-refactor" "继续完成这个 PR"

查看登录状态#

claude auth status

更新 Claude Code#

claude update

管理 MCP#

claude mcp

查看子代理#

claude agents

交互模式里怎么用#

Claude Code 的强项在于它会在同一个终端会话里持续保留上下文。
常见工作流一般是：

1. 先让它分析问题
2. 再让它给出修改计划
3. 然后让它直接改代码
4. 最后要求它运行检查或测试

例如：

先阅读这个仓库，然后告诉我最值得先改的 3 个问题

然后继续：

修复第一个问题，只修改必要文件，完成后运行 npm run check

这种方式比直接说“帮我优化一下”稳定很多。

常用 Slash Commands#

Claude Code 的交互界面支持大量 slash commands。比较常用的有：

• /help 查看帮助
• /compact 压缩上下文，适合长会话
• /config 查看或修改配置
• /memory 管理 CLAUDE.md 和记忆文件
• /model 切换模型
• /permissions 查看或修改权限
• /review 发起代码审查
• /clear 清空当前对话
• /mcp 管理 MCP 连接
• /init 初始化项目记忆和说明文件
• /vim 进入 vim 风格输入模式

如果已经和 Claude Code 聊了很久，优先记住 /compact。
它对控制上下文膨胀非常有用。

配置文件怎么写#

Claude Code 的配置核心是 settings.json。

常见位置有：

• 用户级：~/.claude/settings.json
• 项目级共享：.claude/settings.json
• 项目级本地：.claude/settings.local.json

项目级配置适合团队共享规则；本地配置适合个人偏好，不建议提交到仓库。

例如，一个很实用的权限限制配置可以写成这样：

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)",
      "Read(./build)"
    ]
  }
}

这个配置的作用是：让 Claude Code 直接看不到敏感文件，避免误读到密钥和环境变量。

CLAUDE.md 很重要#

Claude Code 会自动读取 CLAUDE.md，它是长期稳定工作流的核心。

常见位置：

• 项目级：./CLAUDE.md 或 ./.claude/CLAUDE.md
• 用户级：~/.claude/CLAUDE.md

适合写进去的内容包括：

• 构建命令
• 测试命令
• 命名规范
• 代码风格
• 项目架构说明
• 不允许修改的目录

你也可以直接让 Claude Code 生成一个起始版本：

/init

官方文档说明，/init 会根据当前项目自动生成初版 CLAUDE.md，然后你再手工补充更细的规则。

自定义 Slash Commands#

Claude Code 官方当前的可复用命令体系，核心是 custom slash commands。

个人命令目录#

~/.claude/commands/

项目命令目录#

.claude/commands/

一个最小例子可以这样写：

---
description: 用图解方式解释代码
argument-hint: [file]
---

先用一个类比解释这个文件，再画一个 ASCII 图，最后分步骤讲清楚：$ARGUMENTS

假设文件名是：

.claude/commands/explain-code.md

那你在会话里就可以直接执行：

/explain-code src/auth/login.ts

这套方式很适合沉淀高频动作，比如：

• /review-api
• /check-performance
• /summarize-diff

Subagents 怎么用#

如果希望 Claude 在复杂任务里自动分工，可以再配 subagents。

常见位置：

• 项目级：.claude/agents/
• 用户级：~/.claude/agents/

官方推荐的最快方式不是手写，而是先在会话里执行：

/agents

然后通过交互界面创建一个子代理。
比如可以单独做一个 code-reviewer，只负责审查安全性、可维护性和回归风险。