Claude Code 入门指南

什么是 Claude Code？

Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手。它直接在终端中运行，能够理解你的代码库、编辑文件、执行命令，帮助你高效完成软件开发任务。

快速开始

安装

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

安装完成后，在项目目录中运行：

claude

即可启动交互式会话。

基本工作流

1. 启动会话：在项目根目录运行 claude
2. 提出需求：用自然语言描述你想要完成的任务
3. 审查结果：Claude Code 会展示它将要做的更改，你可以批准或拒绝
4. 迭代调整：继续对话，进一步完善代码

核心功能

1. 代码编辑

Claude Code 可以直接读取、编辑项目文件。你可以要求它：

• 修复 bug
• 添加新功能
• 重构代码
• 编写测试
• 撰写文档

2. 命令执行

无需离开对话即可运行 shell 命令：

• 运行测试
• 安装依赖
• 执行构建
• 查看 git 状态

3. 代码库理解

Claude Code 会扫描你的项目结构，理解代码之间的关系，因此可以跨文件进行上下文感知的修改。

常用命令

权限模式

Claude Code 支持灵活的权限控制：

• 自动模式：自动执行非破坏性操作
• 需审批模式：执行前需要你确认
• 禁止模式：不允许执行

你可以根据需要设置不同工具（如 Bash、文件编辑）的权限级别。

使用技巧

明确描述需求

提供清晰的上下文和期望的结果，有助于 Claude Code 给出更准确的实现。

分步进行

复杂任务可以拆解为多个步骤，逐步完成，方便在每个阶段进行审查和调整。

利用记忆功能

Claude Code 可以记住你的偏好和工作习惯，减少重复说明。

检查生成的代码

始终审查 AI 生成的代码，确保它符合项目标准和安全要求。

高级功能

Hooks（钩子）

Hooks 是 Claude Code 的自动化框架，允许你在特定事件发生时执行自定义脚本，例如：

• 在工具调用前/后执行验证
• 自动运行 linter 或格式化工具
• 集成项目特定的工作流

自定义命令

你可以通过配置文件添加自己的斜杠命令，扩展 Claude Code 的功能。

MCP 服务器

通过 MCP（Model Context Protocol）服务器，Claude Code 可以与其他工具和服务集成，如数据库、API、文件系统等。

最佳实践

1. 使用版本控制：让 Claude Code 在 git 仓库中工作，便于追踪更改
2. 编写测试：要求 Claude Code 同时编写测试用例
3. 渐进式采用：从小任务开始，逐步探索更复杂的使用场景
4. 提供反馈：告诉 Claude Code 哪些做得好，哪些需要改进

限制与注意事项

• Claude Code 是一个辅助工具，不能替代开发者的判断
• 敏感信息（如 API 密钥）不应直接暴露在对话中
• 生成的代码应经过 review 后再合并到生产环境

总结

Claude Code 将 AI 编程助手的能力带到了终端中，为开发者提供了一种高效、灵活的编码方式。无论是快速原型开发、重构现有代码，还是学习新框架，它都能成为得力的助手。