Claude Code - 功能详解
基础交互
1. 交互模式
Claude Code 提供两种主要交互方式:
bash
# 启动交互模式
claude
# 以初始查询启动
claude "解释这个项目"
# 运行单个命令并退出
claude -p "这个函数做什么?"
# 处理管道内容
cat logs.txt | claude -p "分析这些错误"2. 恢复对话
bash
# 恢复最近的对话
claude --continue
# 显示对话选择器
claude --resume对话选择器会显示:
- 对话开始时间
- 初始提示或对话摘要
- 消息数量
常用斜杠命令
| 命令 | 说明 |
|---|---|
/help | 显示帮助信息 |
/quit | 退出 Claude Code |
/clear | 清空当前对话 |
/compact | 压缩上下文以节省额度 |
/ide | 手动指定 IDE |
/init | 创建 CLAUDE.md 记忆文件 |
/vim | 启用 Vim 模式 |
/config | 打开配置 |
/auth | 配置认证信息 |
高级功能
1. 处理图像
支持多种方式输入图像:
- 拖放图像到 Claude Code 窗口(macOS)
- 复制图像并使用 Ctrl+V 粘贴(macOS)
- 提供图像路径
bash
> 分析这个图像:/path/to/your/image.png
> 这是错误的截图。是什么导致了它?
> 生成 CSS 以匹配这个设计模型2. 深入思考
对于复杂问题,可以要求深入思考:
bash
> 我需要使用 OAuth2 为我们的 API 实现一个新的身份验证系统。深入思考在我们的代码库中实现这一点的最佳方法。
> 思考这种方法中潜在的安全漏洞
> 更深入地思考我们应该处理的边缘情况注意:深入思考会消耗更多额度。
3. 压缩上下文
长上下文会消耗更多点数,使用压缩命令节省额度:
bash
/compact [instructions]4. 快速记忆
使用 # 快速添加记忆:
bash
# 始终使用描述性变量名系统会提示你选择存储到哪个记忆文件。
记忆管理
创建 CLAUDE.md
bash
> /init这会创建一个 CLAUDE.md 文件,用于存储:
- 常用命令(构建、测试、lint)
- 代码风格偏好和命名约定
- 重要架构模式
- 项目特定信息
记忆文件说明
MEMORY.md:总是加载到对话上下文中(前 200 行)- 其他主题文件:如
debugging.md、patterns.md
Git 操作
Claude Code 支持使用自然语言操作 Git:
bash
> 提交我的更改
> 创建一个 pr
> 哪个提交在去年十二月添加了 markdown 测试?
> 在 main 分支上变基并解决任何合并冲突Git 工作树
使用工作树创建隔离的编码环境:
bash
# 创建带有新分支的工作树
git worktree add ../project-feature-a -b feature-a
# 在工作树中运行 Claude Code
cd ../project-feature-a
claude
# 列出所有工作树
git worktree list
# 移除工作树
git worktree remove ../project-feature-a快捷键
终端中的换行
- 快速转义:输入
\后按 Enter - 键盘快捷键:Option+Enter(或配置后的 Shift+Enter)
Vim 模式
启用 Vim 键绑定:
bash
> /vim支持的功能:
- 模式切换:Esc(到 NORMAL),i/I,a/A,o/O(到 INSERT)
- 导航:h/j/k/l,w/e/b,0/$/^,gg/G
- 编辑:x,dw/de/db/dd/D,cw/ce/cb/cc/C,.(重复)
模型切换
推荐使用 Claude 4 Sonnet(默认),计费倍率仅为 Opus 的 1/5。
如需切换模型,请查阅官方文档。
常见报错
| 错误码 | 说明 | 解决方法 |
|---|---|---|
| 400 | 请求格式或内容有问题 | 检查请求参数 |
| 401 | API 密钥有问题 | 检查 API Key 配置 |
| 403 | 没有使用权限 | 检查账号权限 |
| 404 | 未找到请求的资源 | 检查请求路径 |
| 413 | 请求超过最大字节数 | 使用 /compact 压缩 |
| 429 | 达到速率限制 | 稍后重试 |
| 500 | 系统内部错误 | 稍后重试 |
| 529 | API 暂时过载 | 稍后重试 |
实用技巧
1. 识别未文档化的代码
bash
> 在 auth 模块中查找没有适当 JSDoc 注释的函数2. 生成文档
bash
> 为 auth.js 中未文档化的函数添加 JSDoc 注释3. 理解陌生代码
bash
> 支付处理系统做什么?
> 查找用户权限在哪里被检查
> 解释缓存层是如何工作的4. 智能编辑代码
bash
> 为注册表单添加输入验证
> 重构日志记录器以使用新的 API
> 修复工作队列中的竞态条件5. 测试和调试
bash
> 运行 auth 模块的测试并修复失败
> 查找并修复安全漏洞
> 解释为什么这个测试失败了