Claude 使用指南
面向新手的 Claude（模型）与 Claude Code（终端工具）快速上手文档。
目录
1. Claude 是什么
Claude 是 Anthropic 推出的大语言模型（LLM）系列，擅长代码编写、文本分析、推理与工具调用等任务。
| 模型 | 定位 |
|---|---|
| Claude Opus | 能力最强，适合复杂推理与高难度任务 |
| Claude Sonnet | 能力与速度均衡，日常开发首选 |
| Claude Haiku | 速度快、成本低，适合轻量任务 |
Claude 可以通过多种方式使用：
- 网页版：claude.ai（对话、项目、Artifacts）
- Claude Code：命令行 / 终端里的编程助手（本指南重点）
- API：通过 Anthropic API 集成到自己的应用
- IDE 插件：VS Code、JetBrains 等
2. Claude Code 是什么
Claude Code 是 Anthropic 官方的终端工具，把 Claude 直接放进你的命令行，可以直接：
- 阅读、理解和解释代码
- 编写 / 修改文件
- 运行命令、跑测试
- 调试、重构、代码审查
- 与 Git 等工具协作
你输入自然语言需求，它会自己调用工具（读文件、改文件、执行命令）来完成，而不是只给你一段复制粘贴的代码。
3. 快速上手
安装
bash
# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
# Windows（PowerShell）
irm https://claude.ai/install.ps1 | iex
# 或用 npm
npm install -g @anthropic-ai/claude-code启动
bash
cd 你的项目目录
claude启动后进入交互式对话界面，直接输入需求即可。
第一次对话
> 帮我解释一下这个项目的结构
> 修复 src/utils.js 里的那个 bug
> 给这个函数加上单元测试4. 常用命令
在 Claude Code 会话中，以 / 开头输入这些命令：
| 命令 | 作用 |
|---|---|
/help |
查看帮助 |
/clear |
清空当前对话上下文 |
/config |
打开配置（模型、主题、权限等） |
/model |
切换当前使用的模型 |
/context |
查看当前上下文 token 用量 |
/compact |
手动压缩对话上下文 |
/cost |
查看本次会话的 token / 费用 |
/status |
查看会话状态 |
/permissions |
管理工具权限 |
/skills |
查看可用技能（skill） |
/memory |
管理持久记忆 |
/init |
生成项目的 CLAUDE.md 说明文件 |
/review |
审查改动（代码审查） |
/simplify |
简化 / 重构改动代码 |
/vim |
切换 vim 编辑模式 |
注：不同版本命令可能有差异，以
claude --help或/help输出为准。
终端前缀 !
在 Claude Code 的输入框里，用 ! 前缀可以在当前会话中直接运行 shell 命令，输出会留在对话里，例如：
! git status
! npm run test5. 常用使用场景
5.1 阅读与理解代码
> 帮我梳理这个项目的目录结构和核心模块
> 解释 src/api/client.js 里这段逻辑在做什么5.2 写新功能
> 在 routes 里加一个 /users 的 REST 接口，包含 GET 和 POST
> 给登录页加表单校验和错误提示5.3 调试
> 这个报错是什么原因？"TypeError: x is not a function"
> 测试偶发失败，帮我定位一下5.4 重构与审查
> /review
> 把这段重复逻辑抽成一个公共函数5.5 生成文档
> 根据这个项目的代码生成一份 README
> 给这个函数写中文注释6. 配置与调优
配置文件位置
- 用户级：
~/.claude/settings.json - 项目级：
.claude/settings.json - 本地（不提交）：
.claude/settings.local.json
常用环境变量
| 变量 | 作用 |
|---|---|
CLAUDE_CODE_MAX_OUTPUT_TOKENS |
限制单次回复的最大 token 数 |
CLAUDE_CODE_MAX_CONTEXT_TOKENS |
限制上下文窗口大小，触发压缩 |
ANTHROPIC_MODEL / CLAUDE_MODEL |
指定使用的模型 |
ANTHROPIC_SMALL_FAST_MODEL |
后台/工具类任务用的小模型 |
在 settings.json 中持久化：
json
{
"env": {
"CLAUDE_CODE_MAX_OUTPUT_TOKENS": "8000"
}
}环境变量在会话启动时读取，改动后需重启 Claude Code。
权限控制
Claude Code 执行工具（读文件、改文件、跑命令等）时会请求权限。可以在 /permissions 或 settings.json 的 permissions 里配置允许 / 拒绝规则，减少重复弹窗。
7. 小技巧
- 提供上下文：把关键文件路径或直接引用代码，回答会更准。
- 用
/init：先在项目里生成CLAUDE.md，记录项目结构、命令和约定，Claude 每次启动都会读取，效率更高。 - 善用
/compact：对话变长后手动压缩，避免上下文爆掉。 - 分步来：复杂任务拆成小步，逐步确认，比一次性大需求更稳。
- 让它验证：让 Claude 改完代码后自己跑测试 / 运行，确认结果，而不是只看代码。
- 安全边界：删除文件、外部提交、对外发布等难以回退的操作，先让它说清楚再确认执行。
参考
- 官方文档：https://code.claude.com/docs
- 设置说明：https://code.claude.com/docs/en/settings
- Claude 模型信息：https://docs.anthropic.com