Claude Code 使用指南

Claude Code 是由 Anthropic 开发的一款智能编码工具，目前处于 Beta 研究预览阶段。它集成在您的终端中，能够理解您的代码库，并通过自然语言指令帮助您更快地编写代码。Claude Code 无需额外的服务器或复杂配置，直接与您的开发环境协作，从而简化工作流程。

以下是 Claude Code 的核心功能和使用指南。

开始之前

系统要求

在安装 Claude Code 之前，请确保您的系统满足以下条件：

• 操作系统 ：macOS 10.15+、Ubuntu 20.04+/Debian 10+，或通过 WSL 支持 Windows
• 硬件 ：至少 4GB 内存
• 软件 ：
• Node.js 18+
• git 2.23+（可选）
• GitHub 或 GitLab CLI（用于 PR 工作流，可选）
• ripgrep（rg，用于增强文件搜索，可选）
• 网络 ：需要互联网连接以完成认证和 AI 处理

安装与认证

按照以下步骤安装并启动 Claude Code：

1. 安装 Claude Code
   在终端运行命令：

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

2. 进入项目目录

   cd 您的项目目录
   

3. 启动 Claude Code
   运行命令：

   claude
   

4. 完成认证
   根据提示完成一次性 OAuth 认证，您需要在 console.anthropic.com ^[1] 上拥有有效的计费账户。

核心功能与工作流程

Claude Code 直接在终端运行，能够理解项目上下文并执行实际操作，无需手动添加文件到上下文——它会根据需要自行探索您的代码库。默认使用的是 claude-3-7-sonnet-20250219 模型。

主要功能

• 编辑文件与修复 Bug ：跨代码库修改文件或修复问题
• 解答代码问题 ：解释代码架构和逻辑
• 执行测试与命令 ：运行测试、修复 linting 问题等
• Git 操作 ：搜索历史记录、解决合并冲突、创建提交和 PR

安全与隐私设计

Claude Code 的架构确保：

• 直接 API 连接 ：您的请求直接发送至 Anthropic API，无中间服务器
• 本地运行 ：在您的终端中操作
• 上下文感知 ：理解整个项目结构
• 执行操作 ：直接编辑文件或创建提交

从提问到解决方案，只需几秒

示例操作

1. 询问代码库问题

   $ claude
   > 我们的认证系统是如何工作的？
   

2. 一键创建提交

   $ claude commit
   

3. 修复多文件问题

   $ claude "修复 auth 模块中的类型错误"
   

初始化项目

对于首次使用者，建议：

1. 运行 claude 启动工具
2. 尝试简单命令，如 summarize this project （总结项目）
3. 使用 /init 生成 CLAUDE.md 项目指南
4. 让 Claude 将 CLAUDE.md 提交到您的仓库

常见任务使用指南

理解陌生代码

• > 这个支付处理系统是做什么的？
• > 用户权限检查在哪里实现的？
• > 缓存层的工作原理是什么？

自动化 Git 操作

• > 提交我的更改
• > 创建一个 PR
• > 去年12月哪个提交添加了 markdown 测试？
• > 在 main 分支上变基并解决合并冲突

智能编辑代码

• > 为注册表单添加输入验证
• > 将日志记录器重构为新 API
• > 修复工作队列中的竞争条件

测试与调试

• > 运行 auth 模块的测试并修复失败
• > 查找并修复安全漏洞
• > 解释这个测试为什么失败

深入思考复杂问题

对于复杂任务，可明确要求 Claude 深度思考：

• > 思考如何设计新的支付服务架构
• > 认真分析认证流程中的边缘情况

控制 Claude Code

命令行接口（CLI）命令

斜杠命令

在会话中控制 Claude 行为：

• /bug ：报告 Bug（将对话发送给 Anthropic）
• /clear ：清除对话历史
• /compact ：压缩对话以节省上下文空间
• /init ：初始化项目并生成 CLAUDE.md
• /pr_comments ：查看 PR 评论
• /review ：请求代码审查

权限与安全管理

权限层级

Claude Code 使用分级权限系统，确保功能与安全平衡：

• 只读操作 （如文件读取）：无需批准
• 命令执行 （如 Bash 命令）：需要批准，可选择“不再询问”
• 文件修改 （如编辑文件）：每次会话需批准

可用工具

防止提示注入

Claude Code 提供以下安全措施：

• 权限系统 ：敏感操作需明确批准
• 上下文分析 ：检测潜在恶意指令
• 输入清理 ：防止命令注入
• 命令黑名单 ：禁止高危命令（如 curl 、 wget ）

最佳实践 ：

• 检查建议命令后再批准
• 避免直接处理不受信任的内容
• 对关键文件变更进行验证

网络配置

Claude Code 需要访问以下地址：

• api.anthropic.com
• statsig.anthropic.com
• sentry.io
  在容器化环境中使用时，请将这些 URL 添加到白名单。

优化终端设置

支持的 Shell

• Bash
• Zsh（暂不支持 Fish）

换行设置

• 快速换行：输入 \ 后按 Enter
• 快捷键：配置后使用 Option+Enter（或 Shift+Enter）

通知设置

• 终端铃声通知 ：

  claude config set --global preferredNotifChannel terminal_bell
  

• iTerm2 系统通知 ：在 iTerm2 设置中启用“Silence bell”和“Send notification when idle”。

处理大输入

• 避免直接粘贴长内容
• 将内容写入文件后让 Claude 读取

成本管理

费用概览

• 日常使用：每位开发者约 $5-10/天
• 高强度使用：可能超过 $100/小时

跟踪成本

• 使用 /cost 查看当前会话用量
• 退出时查看成本总结
• 在 Anthropic Console 查看历史使用情况

降低token消耗

• 使用 /compact 压缩对话
• 提出具体问题，避免模糊请求
• 将复杂任务拆分为小步骤

Claude Code 实践示例

基于 Anthropic 官网内容，提供使用 Claude Code 的实用示例和模式，帮助您将其高效融入开发工作流程。包含清晰的步骤、示例命令和最佳实践，让您充分发挥 Claude Code 的潜力。

目录

• 快速理解新代码库
• 高效修复 Bug
• 重构代码
• 处理测试
• 创建拉取请求 (PR)
• 处理文档
• 使用高级 Git 工作流程
• 处理图像
• 设置项目记忆
• 将 Claude 用作类 Unix 工具
• 设置模型上下文协议 (MCP)

快速理解新代码库

获取代码库快速概览

适用场景 ：刚加入新项目，需要快速了解代码结构。

1. 进入项目根目录

   $ cd /path/to/project
   

2. 启动 Claude Code

   $ claude
   

3. 请求高层概览

   > 给我这个代码库的概览
   

4. 深入了解具体组件