Claude Code 初学者必看指南

你好！欢迎来到 Claude Code 的世界。Claude Code 是 Anthropic 推出的一款AI 编程助手，它直接集成在终端（Terminal）中，让你无需离开命令行就能完成代码编写、调试、重构、文档生成等开发任务。本指南将带你从零开始，快速上手 Claude Code。

1. 什么是 Claude Code？

Claude Code 是 Anthropic 基于 Claude 大语言模型打造的终端原生 AI 编程助手。与传统的 IDE 插件不同，它直接在命令行中运行，能够：

• 理解整个代码仓库：读取项目结构、文件内容，给出上下文相关的建议
• 执行终端命令：直接运行测试、构建、部署等命令
• 读写文件：创建、修改、删除项目中的文件
• 多文件协作：同时理解和修改多个相关文件
• Git 集成：自动生成 commit 信息、创建 PR 等

简单来说，Claude Code 就像一位精通你整个项目的资深工程师，随时在终端里待命。

2. 安装与配置

2.1 前置要求

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

• 操作系统：macOS 10.15+ 或 Linux（Ubuntu 18.04+/Debian 10+/CentOS 7+）
• Node.js：版本 18.0 或更高
• npm：随 Node.js 一起安装
• Anthropic API Key：从 console.anthropic.com 获取

2.2 安装步骤

打开终端，执行以下命令：

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

安装完成后，需要配置 API Key：

# 方式一：环境变量
export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxx

# 方式二：写入配置文件（推荐）
claude config set apiKey sk-ant-xxxxxxxxxxxxx

2.3 首次启动

在项目目录中运行：

cd your-project
claude

首次启动时，Claude Code 会扫描项目结构并建立索引。之后你就可以在交互式终端中与 Claude 对话了。

3. 核心功能详解

3.1 代码问答与解释

你可以直接向 Claude 提问关于代码的任何问题：

> 这个项目的架构是什么样的？
> 解释一下 src/utils/auth.ts 中的认证流程
> 这段代码有什么潜在的性能问题？

Claude 会读取相关文件，结合项目上下文给出详细解答。

3.2 代码生成与修改

Claude Code 可以直接创建和修改文件：

> 创建一个 RESTful API 路由，支持用户 CRUD 操作
> 给 UserService 类添加缓存功能
> 重构这个函数，使其更符合单一职责原则

3.3 终端命令执行

Claude 可以直接在终端中执行命令：

> 运行测试并告诉我哪些失败了
> 帮我安装 lodash 库
> 检查代码风格问题并自动修复

执行前 Claude 会先展示将要运行的命令，等待你的确认。

3.4 Git 工作流集成

> 帮我写一个 commit message
> 创建 PR，包含变更摘要
> 查看当前分支的改动并生成 changelog

4. 实用技巧

4.1 使用 /compact 模式

在长对话中，使用 /compact 命令可以压缩上下文，节省 token：

> /compact

4.2 指定文件范围

使用 @ 符号指定要关注的文件：

> 帮我优化 @src/utils/helpers.ts 中的性能
> 解释 @package.json 中的依赖关系

4.3 使用会话历史

Claude Code 会保存你的会话历史，使用 /history 查看：

> /history

4.4 自定义系统提示

在项目根目录创建 .claude.md 文件，写入自定义指令：

# .claude.md

## 项目规范
- 使用 TypeScript 严格模式
- 遵循 ESLint 规则
- 单元测试覆盖率不低于 80%

## 代码风格
- 使用箭头函数而非 function 关键字
- 使用 const 而非 let
- 使用模板字符串拼接

Claude 会在每次对话中自动加载这些指令。

5. 实际场景示例

场景一：调试 Bug

> 用户反馈登录接口返回 500 错误，帮我排查原因

Claude 会：

1. 读取登录接口代码
2. 检查相关日志
3. 定位到错误原因（如数据库连接失败）
4. 给出修复方案并自动修改代码

场景二：添加新功能

> 给博客系统添加标签云功能，标签按文章数量排序

Claude 会：

1. 分析现有数据模型
2. 创建标签相关的数据库迁移
3. 编写 API 接口
4. 生成前端组件
5. 更新路由配置

场景三：代码审查

> 审查 src/controllers/user.ts 中的代码变更

Claude 会逐行分析代码，指出潜在问题、安全漏洞和优化建议。

6. 常见问题

Q1: Claude Code 和 GitHub Copilot 有什么区别？

Claude Code 更侧重于理解整个项目上下文和执行复杂任务（如多文件修改、命令执行），而 Copilot 更擅长行内代码补全。两者可以互补使用。

Q2: 如何处理敏感信息？

不要在对话中粘贴 API Key、密码等敏感信息。Claude Code 会记录对话日志，请确保日志不包含敏感数据。

Q3: 费用如何计算？

Claude Code 使用 Anthropic API，按 token 计费。建议设置使用限额：

claude config set maxCost 5.00

Q4: 支持哪些编程语言？

Claude Code 支持所有主流编程语言，包括但不限于：JavaScript/TypeScript、Python、Java、Go、Rust、Ruby、PHP、C/C++、Swift、Kotlin 等。

7. 总结与下一步

Claude Code 是一款强大的 AI 编程助手，它能显著提升开发效率。建议你：

1. 从小任务开始：先尝试代码解释、单文件修改等简单任务
2. 逐步深入：熟悉后再尝试多文件重构、架构设计等复杂任务
3. 善用 .claude.md：通过自定义指令让 Claude 更了解你的项目规范
4. 保持安全意识：审查 Claude 生成的代码，不要盲目信任

现在，打开终端输入 claude，开始你的 AI 辅助编程之旅吧！