请参考:
AI - Claude Code概述,安装,配置(一)

一、基础命令详解

1.1、启动命令

# 启动交互式会话
claude
# 运行一次性查询并退出
claude -p "你的问题或指令"
# 从文件输入内容
cat file | claude -p "处理这个文件"
# 跳过权限检查(谨慎使用)
claude --dangerously-skip-permissions
# 恢复上次对话
claude --continue
# 查看会话列表
claude --resume

1.2、会话管理命令

# 更新到最新版本
claude update
# 查看和修改配置设置
claude config
# MCP服务器管理
claude mcp list # 列出MCP服务器
claude mcp add # 添加MCP服务器
claude mcp remove # 移除MCP服务器
# 代理配置
claude /agents # 配置/设置子代理:cite[4]

1.3、快捷键

通用控制

Ctrl+C: 取消当前输入或生成
Ctrl+D: 退出Claude Code会话
Ctrl+L: 清除终端屏幕
Up/Down: 浏览命令历史
Esc + Esc: 编辑上一条消息

多行输入

\ + Enter: 适用于所有终端
Option+Enter: macOS默认
Shift+Enter: 执行/terminal-setup后可用

二、会话内命令

在Claude交互会话中,可以直接使用以下命令:

命令 功能 使用场景
/clear 清理会话历史 优化性能,释放内存
/compact 压缩会话数据 减少Token占用,控制成本
/config 查看或修改配置 调整工具行为(如API密钥)
/cost 查看Token使用情况 监控资源消耗
/help 查看帮助文档 新手入门首选
/init 初始化项目配置 新项目首次使用时
/memory 设置项目记忆 避免重复输入关键信息
/review 请求代码审查 提交前的质量检查
/bug 提交问题报告 遇到错误时反馈给Anthropic
/doctor 系统诊断检查 排查权限/网络问题
/terminal-setup 设置键绑定 改善多行输入体验

2.1、CLI参考

Claude Code提供丰富的命令行选项来自定义其行为:

基础 CLI 命令
命令 描述 示例
claude 启动交互式 REPL(读取-求值-输出循环) claude
claude "query" 带初始提示启动 REPL claude "explain this project"
claude -p "query" 通过 SDK 查询后退出 claude -p "explain this function"
claude -c 继续最近的对话 claude -c
claude update 更新到最新版本 claude update
重要 CLI 标志
标志 描述 示例
--allowedTools 允许的工具列表 --allowedTools "Bash(git log:*)" "Read"
--verbose 启用详细日志 claude --verbose
--model 设置使用的模型 claude --model claude-sonnet-4
--permission-mode 指定权限模式 claude --permission-mode plan
--dangerously-skip-permissions 跳过权限提示(谨慎使用) claude --dangerously-skip-permissions

2.2、交互式模式

Vim模式

启用vim风格编辑:

/vim

模式切换

Esc: 进入NORMAL模式
i: 在光标前插入
a: 在光标后插入
o: 在下方新建行

导航(NORMAL模式)

h/j/k/l: 左/下/上/右移动
w: 下一个单词
0: 行首
$: 行尾
gg: 文本开头
G: 文本结尾

2.3、斜杠命令

基础命令
命令 描述 示例
/help 显示帮助信息 /help
/clear 清除对话历史 /clear
/config 管理配置 /config
/permissions 管理权限 /permissions
/vim 启用 vim 模式 /vim
高级命令
命令 描述 功能
/init 初始化项目 自动生成 CLAUDE.md 文件
/terminal-setup 设置终端 配置键盘快捷键
/project<command> 项目特定命令 运行项目自定义命令
自定义斜杠命令

创建步骤:

  1. 在 .claude/commands/ 目录创建 Markdown 文件

  2. 文件名即为命令名

  3. 内容为命令模板,可使用 $ARGUMENTS 占位符

三、Think模式完全指南

Think 模式是Claude Code的一个强大功能,要求Claude对复杂问题进行更深入的分析。当面对复杂问题时,Claude会进入"思考"状态,进行更深入、更结构化的推理。

使用示例:

> 深入思考我们身份验证流程中的边缘情况
> 思考如何构建新的支付服务

Think模式的特点:

  • 更深入的分析:Claude会多步推理,考虑各种可能性和边缘情况
  • 结构化输出:思考结果通常以有条理的方式呈现
  • 复杂问题解决:特别适用于架构设计、系统优化等复杂任务

四、记忆系统详解

Claude Code的记忆系统是其核心功能之一,允许AI在不同会话间保持上下文一致性。

4.1、CLAUDE.md 文件

CLAUDE.md 是Claude Code的核心配置文件,它会被自动读取并加入到上下文中。这个文件应该包含:

  • 项目基础信息和架构说明
  • 常用命令和构建脚本
  • 代码规范和约定
  • 测试指南
  • 开发环境配置
  • 其他必要的上下文信息

创建方法:

# 使用/init命令自动生成
claude
> /init
# 或者手动创建并填充内容
touch CLAUDE.md

4.2、记忆文件位置

CLAUDE.md 文件可以放置在多个位置:

  1. 项目根目录:./CLAUDE.md(推荐,可提交到git)
  2. 项目本地:./CLAUDE.local.md(不提交到git)
  3. 全局配置:~/.claude/CLAUDE.md
  4. 父目录和子目录中也会被自动读取

4.3、记忆管理命令

# 打开并编辑当前项目的持久记忆文件
/memory

这将打开 CLAUDE.md 文件,您可以在此添加或修改Claude的 "长期记忆" 内容。

五、MCP (Model Context Protocol) 集成

MCP允许Claude与外部工具和数据源集成,极大地扩展了其功能:

5.1、MySQL集成

# 添加MySQL数据库连接
claude mcp add mcp_server_mysql npx @benborla29/mcp-server-mysql `
-e MYSQL_HOST="主机地址" `
-e MYSQL_PORT="端口" `
-e MYSQL_USER="用户名" `
-e MYSQL_PASS="密码" `
-e MYSQL_DB="数据库名" `
-e ALLOW_INSERT_OPERATION="true" `
-e ALLOW_UPDATE_OPERATION="true" `
-e ALLOW_DELETE_OPERATION="true"

5.2、Playwright集成(网页自动化)

# 添加Playwright支持
claude mcp add playwright npx '@playwright/mcp@latest'

5.3、Deep Graph MCP集成

Deep Graph 是一款MCP(模块化协作程序),可为 Claude Code 提供用于理解完整代码库的高级工具。它为 Claude Code 新增了6款工具,使其能够以更高级的方式读取代码、执行语义搜索和节点搜索,极大增强Claude对项目整体上下文的理解能力。

安装方法:

claude mcp add "Deep-Graph-MCP" npx -- -y mcp-code-graph@latest YOUR_CODEGPT_API_KEY CODEGPT_ORG_ID CODEGPT_GRAPH_ID

六、高级使用技巧

6.1、IDE集成

  • Claude Code 支持 VSCode 与 JetBrains
  • 在 VSCode 内置终端唤起 Claude Code,插件将 自动安装
  • JetBrains 用户需手动下载插件。
  • 使用 /ide 命令测试连接。

6.2、权限管理

Claude Code默认采用保守的权限策略。你可以通过以下方式管理权限:

# 使用/permissions命令管理权限
> /permissions
# 或者通过命令行参数
claude --allowedTools Edit,Bash(git commit:*)

6.3、上下文管理策略

由于Claude Code的上下文窗口有限,且上下文过长会导致幻觉严重,需要合理管理上下文信息:

  • 使用 @ 引用文件:请参考@PRD.MD 的结构
  • 在任务切换时使用 /clear 清空上次任务信息
  • 长时间会话定期压缩上下文:/compact
  • 必要时从历史会话恢复:/resume
  • 将重要信息通过 # <context> 记录到CLAUDE.md中

6.4、成本控制策略

# 查看token使用统计
/cost
# 设置使用提醒
claude config set --global preferredNotifChannel terminal_bell

6.5、声音提示设置

启用任务完成时的声音提示:

claude config set --global preferredNotifChannel terminal_bell

安装塞尔达音效提示(任务完成时有特别提示):

npm install -g zelda-claude-code@latest

6.6、Git高级操作

  • 支持使用自然语言操作Git,如:> 提交我的更改> 创建一个 pr
  • 使用 Git工作树 (git worktree add ...) 创建隔离的编码环境。

七、最佳实践与工作流程

7.1、典型工作流程

  • 探索阶段 - 了解现有代码
  • 计划阶段 - 使用扩展思考
  • 编码阶段 - 实现功能
  • 提交阶段 - 代码审查与提交

7.2、测试驱动开发流程

# 1. 编写测试
"请基于期望的输入输出编写测试,确保测试会失败"
# 2. 运行测试确认失败
"运行测试确认失败,不要编写实现代码"
# 3. 提交测试
"请提交测试代码"
# 4. 实现功能
"请编写代码使测试通过,不要修改测试"
# 5. 提交实现
"请提交实现代码"

7.3、UI开发流程

# 1. 提供设计图
# 拖拽图片到Claude Code界面
# 2. 实现UI
"请按照设计图实现界面"
# 3. 截图对比
"请截图当前实现,与设计图对比并改进"
# 4. 迭代优化
"请继续优化,直到效果满意"

八、故障排除与常见问题

8.1、安装问题

  • Node.js版本过低:确保使用 Node.js 18+ 版本
  • 权限问题:在Linux/macOS上尝试使用 sudo 安装全局包

8.2、认证问题

  • 浏览器无法打开:使用 claude auth login --manual 进行手动认证
  • API密钥无效:检查环境变量设置是否正确

8.3、性能问题

  • 响应缓慢:检查网络连接,或尝试使用更小的模
  • 高token消耗:定期使用 /compact 压缩会话,使用 /clear 清理不必要上下文

结语

总的来说,我非常推荐你阅读 Anthropic 官方的文章:《Claude Code:面向代理式编程的最佳实践》(https://www.anthropic.com/engineering/claude-code-best-practices。本文中提到的许多技巧都来自那篇文章,对于想要充分发挥 Claude Code 或任何编程代理能力的人来说,这篇文章几乎是必读的参考资料

参考文章

https://www.cnblogs.com/wzzkaifa/p/19079594

https://blog.csdn.net/xianyu120/article/details/149406466

https://blog.csdn.net/weixin_46618804/article/details/155272318

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐