Claude Code

Claude Code 文档中心

欢迎使用 Claude Code 中文文档！本文档将帮助您快速掌握 Claude Code 的使用方法，让您的编程工作更加高效。

提示：Claude Code 是 Anthropic 推出的 AI 编程助手，当前版本基于 claude-opus-4-20250514 模型。

快速开始

只需几个简单步骤，即可开始使用 Claude Code 提升您的编程效率。

系统要求

  • 终端或命令提示符
  • Node.js 14.0 或更高版本
  • Git 仓库（推荐）
  • 支持 Windows、macOS 和 Linux

快速上手

  1. 在项目目录中打开终端
  2. 运行 claude 命令
  3. 开始与 Claude Code 对话

示例：第一次使用

$ claude
Claude> 你好！我是 Claude Code，您的 AI 编程助手。

您: 这个项目是做什么的？
Claude> 让我查看一下项目结构...

[Claude 分析项目并提供详细说明]

安装指南

通过 npm 安装（推荐）

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

验证安装

claude --version

配置 API 密钥

首次使用时，Claude Code 会提示您输入 API 密钥：

  1. 访问 Anthropic 控制台获取 API 密钥
  2. 运行 claude 并按提示输入密钥
  3. 密钥将安全存储在本地
注意：请妥善保管您的 API 密钥，不要将其提交到版本控制系统中。

基础用法

启动模式

1. 交互模式（默认）

$ claude

进入交互式会话，可以持续对话。

2. 单次任务模式

$ claude "修复这个文件中的语法错误"

执行单个任务后退出。

3. Git 提交模式

$ claude commit

自动生成 Git 提交信息。

常用命令

命令 说明
/help 显示帮助信息
/memory 编辑项目记忆
/clear 清除对话历史
/save 保存当前会话
exit 退出 Claude Code

探索项目

常用探索命令

  • "这个项目使用了哪些技术？"
  • "主入口文件在哪里？"
  • "项目的架构是怎样的？"
  • "有哪些主要的功能模块？"

内存管理（CLAUDE.md）

Claude Code 使用 CLAUDE.md 文件来存储项目特定的指令和偏好设置。

内存文件类型

1. 项目内存（./CLAUDE.md）

  • 存储在项目根目录
  • 团队共享的项目规范
  • 包含编码标准、架构说明等

2. 用户内存（~/.claude/CLAUDE.md）

  • 存储在用户主目录
  • 个人偏好设置
  • 适用于所有项目

CLAUDE.md 示例

# 项目规范

## 编码标准
- 使用 2 空格缩进
- 使用 TypeScript 进行类型检查
- 遵循 ESLint 规则

## 架构说明
- 前端使用 React + TypeScript
- 后端使用 Node.js + Express
- 数据库使用 PostgreSQL

## 重要说明
- 不要修改 config/ 目录下的文件
- 所有 API 端点都需要认证
- 测试覆盖率必须达到 80% 以上

@imports/code-style.md
@imports/api-design.md

内存管理技巧

快速添加内存：在对话中使用 # 前缀可以快速添加内存。
例如：# 所有组件使用函数式写法

导入其他文件

使用 @path/to/file 语法导入其他配置文件：

@../../shared/team-standards.md
@~/.claude/personal-prefs.md

常见工作流

1. 错误修复

工作流程

  1. 分享错误信息
  2. Claude 分析问题原因
  3. 获取修复建议
  4. 应用修改
您: 我遇到了这个错误：TypeError: Cannot read property 'name' of undefined

Claude: 让我查看相关代码...
[分析代码]
我发现问题出在第 42 行，对象可能为空。建议添加空值检查...

2. 代码重构

  • 识别需要改进的代码
  • 获取现代化建议
  • 保持功能不变的同时改进代码质量

3. 测试编写

示例对话

您: 帮我为 UserService 类编写单元测试

Claude: 我来查看 UserService 的实现...
[分析代码]
我将创建全面的测试套件，包括：
- 正常情况测试
- 边界条件测试
- 错误处理测试

4. 文档生成

  • 查找未文档化的函数
  • 生成 JSDoc 或其他格式的文档
  • 创建 README 文件
  • 生成 API 文档

5. 代码审查

Claude Code 可以帮助您：

  • 检查代码质量
  • 发现潜在问题
  • 提供改进建议
  • 确保符合编码规范

高级功能

扩展思考模式

对于复杂问题，Claude Code 会进行深入分析：

您: 如何优化这个算法的性能？

Claude: 让我仔细分析这个算法...
[扩展思考过程]
基于分析，我建议以下优化方案...

会话恢复

使用 --resume 参数恢复之前的会话：

$ claude --resume

并行会话

使用 Git worktree 创建并行开发环境：

$ git worktree add ../feature-branch
$ cd ../feature-branch
$ claude

图像分析

Claude Code 支持分析截图和图像：

  • 粘贴截图直接分析
  • 理解 UI 设计
  • 调试视觉问题

自定义命令

在 CLAUDE.md 中定义自定义工作流：

# 自定义命令

## /review
执行完整的代码审查流程

## /deploy
检查部署前的所有要求

结构化数据处理

通过管道传递数据：

$ cat data.json | claude "分析这些数据并生成报告"

命令参考

Claude Code CLI 选项

选项 说明
--version 显示版本信息
--help 显示帮助信息
--resume 恢复上次会话
--no-memory 不加载 CLAUDE.md
--debug 启用调试模式

交互模式命令

命令 快捷键 说明
/help - 显示可用命令
/memory Ctrl+M 编辑项目记忆
/clear Ctrl+L 清除屏幕
/save Ctrl+S 保存会话
exit Ctrl+C 退出程序

常见问题

Q: Claude Code 支持哪些编程语言？

A: Claude Code 支持几乎所有主流编程语言，包括但不限于：

  • JavaScript/TypeScript
  • Python
  • Java
  • C/C++
  • Go
  • Rust
  • Ruby
  • PHP
  • Swift
  • 更多...

Q: 如何处理大型项目？

A: 对于大型项目，建议：

  1. 使用详细的 CLAUDE.md 文件描述项目结构
  2. 分模块处理，每次专注一个特定功能
  3. 使用 @文件路径 引用特定文件
  4. 定期清理对话历史以保持性能

Q: Claude Code 会修改我的代码吗？

A: Claude Code 遵循以下原则：

  • 在修改前会先展示将要进行的更改
  • 需要您的确认才会应用修改
  • 所有修改都可以通过版本控制系统回滚
  • 建议在使用前提交当前更改

Q: 如何提高 Claude Code 的效果？

最佳实践：
  1. 提供清晰、具体的指令
  2. 包含相关的错误信息或代码片段
  3. 使用 CLAUDE.md 记录项目规范
  4. 将复杂任务分解为小步骤
  5. 让 Claude 先探索代码再进行修改

Q: 遇到问题如何获取帮助？

A: 您可以通过以下方式获取帮助：

  • 使用 /help 命令查看内置帮助
  • 访问本地文档：本地文档中心
  • 联系技术支持：support@aiweber.com
  • 加入社区讨论