Claude Code 基础使用指南

前言

本指南将帮助你掌握 Claude Code 的日常使用技巧，从基础的交互模式到高级的命令操作，让你能够充分发挥这款 AI 编程助手的能力。

前置要求： 已完成 Claude Code 的安装和配置

启动选项

常用启动参数

# 恢复最近会话
claude -c
claude --continue

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

# 详细输出模式
claude --verbose

# 跳过权限确认（谨慎使用）
claude --dangerously-skip-permissions

参数说明

| 参数 | 简写 | 说明 | |------|------|------| | --continue | -c | 恢复最近的会话 | | --model | -m | 指定使用的 AI 模型 | | --verbose | 无 | 显示详细的执行日志 | | --project | 无 | 指定项目目录 |

核心命令

基础控制命令

/help - 查看帮助

显示所有可用命令的列表和说明。

/help

/exit - 退出

退出交互模式，返回命令行。

/exit

或使用快捷键：

macOS/Linux: Ctrl + D
Windows: Ctrl + Z 然后回车

/compact - 压缩对话

压缩对话历史，保留关键信息，节省 Token 使用。

/compact

# 指定保留内容
/compact 保留关于数据库设计的讨论

上下文管理

/context - 查看上下文使用

可视化显示当前 Token 使用情况。

/context

/model - 切换模型

在会话中切换不同的 AI 模型。

# 打开模型选择菜单
/model

# 直接切换到指定模型
/model claude-opus-4-6

模型对比：

| 模型 | 速度 | 能力 | 成本 | 适用场景 | |------|------|------|------|---------| | Haiku | 最快 | 基础 | 最低 | 简单任务 | | Sonnet | 中等 | 强大 | 中等 | 日常开发 | | Opus | 较慢 | 最强 | 最高 | 复杂任务 |

会话管理

/resume - 恢复会话

恢复之前的对话会话。

# 显示会话列表
/resume

# 命令行快速恢复
claude -c

/export - 导出对话

将当前对话导出为文本文件。

# 打开导出对话框
/export

# 导出到指定文件
/export ./notes/session.txt

/rename - 重命名会话

为当前会话设置一个有意义的名称。

/rename auth-module-implementation

项目配置

/init - 初始化项目

分析项目结构并创建配置文件。

/init

/memory - 编辑记忆

打开 CLAUDE.md 配置文件进行编辑。

/memory

快速添加记忆：

# 使用 # 前缀快速添加
# 本项目使用 TypeScript
# API 响应必须包含 code 字段

诊断命令

/doctor - 系统诊断

检查 Claude Code 的健康状态。

/doctor

/status - 查看状态

显示版本、模型、账户等完整状态信息。

/status

高级功能

Checkpoint 和 Rewind

Checkpoint 是 Claude Code 的重要功能，类似游戏存档，可以随时回退代码和对话状态。

使用 Rewind

方法一：快捷键

快速按两次 Escape 键打开 Rewind 菜单。

[按 Esc + Esc]

方法二：命令

/rewind

恢复选项

| 选项 | 效果 | 适用场景 | |------|------|---------| | 仅恢复对话 | 保留代码，重置对话 | AI 理解错误 | | 仅恢复代码 | 保留对话，回退代码 | 代码修改错误 | | 同时恢复 | 代码和对话都回退 | 完全重来 |

Extended Thinking

让 Claude 进行深度思考，展示详细的分析过程。

启用方式

方法一：Tab 键

在交互模式中按 Tab 键切换。

方法二：关键词触发

# 基础思考
think about this problem

# 深度思考
think hard about the architecture

# 全面分析
ultrathink this critical decision

思考级别

| 关键词 | Token 预算 | 适用场景 | |--------|-----------|---------| | think | ~1,500 | 一般问题 | | think hard | ~3,000 | 复杂问题 | | ultrathink | ~16,000 | 关键决策 |

权限管理

权限模式

按 Shift + Tab 可以在不同权限模式间切换：

| 模式 | 行为 | 适用场景 | |------|------|---------| | plan | 只分析不修改 | 代码审查 | | acceptEdits | 自动接受文件编辑 | 信任项目 | | bypassPermissions | 跳过所有确认 | 隔离环境 |

配置权限

在配置文件中精确控制允许的操作：

{
  "permissions": {
    "allow": ["Read", "Grep", "Glob", "Edit"]
  }
}

| 快捷键 | 作用 | |--------|------| | Ctrl + C | 取消当前操作 | | Ctrl + D | 退出 Claude Code | | Ctrl + L | 清除终端屏幕 | | Ctrl + R | 搜索历史命令 | | Esc + Esc | 打开 Rewind 菜单 | | Tab | 切换 Extended Thinking | | Shift + Tab | 切换权限模式 |

多行输入

| 方法 | 快捷键 | |------|--------| | 反斜杠换行 | \ + Enter | | macOS | Option + Enter | | 控制序列 | Ctrl + J |

最佳实践

日常工作流程

# 1. 恢复昨天的会话
claude -c

# 2. 检查状态
/status

# 3. 开始工作
# 描述今天的任务

# 4. 定期检查 Token 使用
/context

# 5. Token 使用过多时压缩
/compact

# 6. 完成后导出对话
/export ~/docs/session.txt

# 7. 重命名会话
/rename feature-implementation

Token 优化技巧

简洁描述需求 - 避免冗长的说明
定期压缩对话 - 使用 /compact 命令
完成任务后清空 - 使用 /clear 命令
选择合适模型 - 简单任务用 Sonnet，复杂任务用 Opus
避免过度使用 Extended Thinking - 只在需要时启用

模型选择策略

# 简单查询 - Haiku
/model claude-haiku-4-5-20251001
# 这个函数做什么？

# 日常开发 - Sonnet（推荐）
/model claude-sonnet-4-6
# 重构这个模块

# 关键决策 - Opus
/model claude-opus-4-6
# ultrathink 设计系统架构

配置别名

macOS/Linux (添加到 ~/.zshrc 或 ~/.bashrc):

# 快速启动
alias cc="claude"

# 恢复会话
alias cr="claude -c"

# 使用 Opus
alias cco="claude --model claude-opus-4-6"

Windows PowerShell (添加到 $PROFILE):

function cc { claude }
function cr { claude -c }
function cco { claude --model claude-opus-4-6 }

常见问题

启动问题

Q: 提示 "command not found"

检查 PATH 环境变量配置，确保 Claude Code 安装目录在 PATH 中。

# macOS/Linux
echo $PATH | grep claude

# Windows
echo %PATH% | findstr claude

认证问题

Q: 认证失败

检查 API Key 配置：

# 查看环境变量
echo $ANTHROPIC_API_KEY

# 重新设置
export ANTHROPIC_API_KEY="your-key"

性能问题

Q: 响应很慢

检查 Token 使用：/context
压缩对话：/compact
切换到更快的模型：/model claude-sonnet-4-6

回退问题

Q: 如何撤销修改

使用 Rewind 功能：

# 快捷键
[按 Esc + Esc]

# 或命令
/rewind

进阶技巧

批量处理

使用单次执行模式批量处理文件：

for file in *.js; do
  claude -p "添加 JSDoc 注释到 $file" > "${file%.js}-doc.js"
done

CI/CD 集成

在 GitHub Actions 中使用：

- name: Code Review
  run: |
    claude -p "审查代码变更"
  env:
    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

远程服务器使用

通过 SSH 在远程服务器上使用：

# SSH 连接
ssh user@server

# 使用 Claude Code
claude

三种使用模式 - 交互、单次执行、打印模式
核心命令 - 基础控制、上下文管理、会话管理
高级功能 - Checkpoint/Rewind、Extended Thinking
最佳实践 - 工作流程、Token 优化、模型选择

下一步学习：

Commands 系统 - 自定义命令
MCP 集成 - 连接外部工具
Hooks 系统 - 自动化工作流
Skills 定制 - 创建专业技能包

参考资源

更新日期： 2026年4月29日
适用版本： Claude Code v2.1.92+

Claude Code 基础使用指南

分享这篇文章