前言
作为 Anthropic 公司推出的命令行AI编程助手，Claude Code凭借其强大的代码理解与生成能力、超长上下文支持以及独特的设计理念，正在改变开发者的工作方式。它不仅是一个代码生成器，更是一个能理解你的本地环境、执行实际任务并协同完成复杂工作的AI伙伴。本文将带你从零开始，全面掌握 Claude Code 的各个方面。
1. Claude Code 简介与核心概念
Claude Code 是一个运行在终端中的交互式命令行工具，直接与开发环境集成，无需额外服务器或 IDE 插件。用户通过自然语言描述任务，Claude 即可理解代码库上下文并执行操作（如编辑文件、运行测试、处理Git流程等）。
官方文档：https://code.claude.com/docs/zh-CN/overview
其主要特点包括：
• 本地环境集成：直接读取你的文件，熟悉项目结构和编码规范
• 任务执行能力：能运行测试、执行lint检查、读写文件，甚至帮你管理Git提交
• 复杂工作协同：从多文件大规模重构到一步步规划实现新功能
2. 下载与安装
2.1 系统要求
操作系统：macOS 10.15+, Ubuntu 20.04+/Debian 10+, 或 Windows 10/11 或 WSL4
硬件：4GB RAM最低，8GB+ 推荐
软件：
• Node.js 18+（仅npm安装需要）
• Git（Git官网：https://git-scm.com/downloads/win）
2.2 安装步骤
在2.0.31版本中，Anthropic提供了安装包原生安装以替代Node.js安装，以提供更稳定的更新
macOS/Linux安装方法：
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell：
irm https://claude.ai/install.ps1 | iex
Windows CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Windows WSL：
# 在PowerShell（管理员模式）中运行 wsl --install # 安装特定发行版（推荐Ubuntu） wsl --install -d Ubuntu # 在WSL中更新系统并安装必要工具 sudo apt update && sudo apt upgrade -y sudo apt install -y curl wget git build-essential # 安装Node.js curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs # 安装Claude Code npm install -g @anthropic-ai/claude-code
NPM安装方法：
# 全局安装 npm install -g @anthropic-ai/claude-code # 验证安装 claude --version
3. 配置与认证
3.1 首次认证
安装完成后，运行以下命令启动认证流程：
cd /path/to/your/project # 启动Claude Code claude
Claude Code 需要账户才能使用。当您首次使用 claude 命令启动交互式会话时，您需要登录：
# 按照提示使用您的账户登录 /login
3.2 API密钥配置（使用原生Anthropic服务）
如果你使用 Anthropic 官方服务，需要设置API密钥：
Windows CMD：
:: 临时设置（仅当前会话有效） set ANTHROPIC_API_KEY=your_api_key_here :: 永久设置 setx ANTHROPIC_API_KEY "your_api_key_here"
Windows PowerShell：
# 临时设置
$env:ANTHROPIC_API_KEY = "your_api_key_here"
# 永久设置
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY","your_api_key_here","User")Linux/macOS：
# 临时设置 export ANTHROPIC_API_KEY="your_api_key_here" # 永久设置（添加到shell配置文件） echo 'export ANTHROPIC_API_KEY="your_api_key_here"' >> ~/.bashrc source ~/.bashrc
3.3 配置国产模型API（替代方案）
如果你希望使用国产模型作为Claude Code的替代，可以配置相应的环境变量：
1、以DeepSeek为例：
set ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic set ANTHROPIC_AUTH_TOKEN="你的API密钥" set ANTHROPIC_MODEL=deepseek-chat set ANTHROPIC_SMALL_FAST_MODEL=deepseek-chat
2、以智谱为例：
set ANTHROPIC_BASE_URL "https://open.bigmodel.cn/api/anthropic" set ANTHROPIC_AUTH_TOKEN "your-api-key" set ANTHROPIC_MODEL "glm-4.6" set ANTHROPIC_SMALL_FAST_MODEL "glm-4.6"
3.4 配置文件设置
Claude Code还支持通过配置文件进行设置：
• Windows：C:\Users\用户名\.claude\settings.json
• Linux/Mac：~/.claude/settings.json
示例配置文件结构：
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.example.com/v1",
"ANTHROPIC_AUTH_TOKEN": "<YOUR_API_KEY>",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
"ANTHROPIC_MODEL": "example-model",
"ANTHROPIC_SMALL_FAST_MODEL": "example-model",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "example-model",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "example-model",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "example-model"
}
}如果使用 VSCode 插件可配置.claude/config.json以跳过VSCode插件的登录
{
"primaryApiKey": "anything"
}4. 基础命令详解
4.1 常用命令
# 启动交互模式 claude # 运行一次性查询，然后退出 claude -p "你的问题或指令" # 在当前目录中继续最近的对话 claude -c # 恢复之前的对话 claude -r # 创建 Git 提交 claude commit # 清除对话历史 /clear # 显示可用命令 /help # 退出 Claude Code exit 或 Ctrl+C
4.2 会话管理命令
# claude update claude update # 查看和修改配置设置 claude config # MCP服务器管理 claude mcp list # 列出MCP服务器 claude mcp add # 添加MCP服务器 claude mcp remove # 移除MCP服务器
5. 会话内命令
在Claude交互会话中，可以直接使用以下命令：
| 命令 | 功能 | 使用场景 |
| /agents | 配置/设置子代理 | 可以处理特定类型的任务，提高工作效率 |
| /clear | 清理会话历史 | 优化性能，释放内存 |
| /compact | 压缩会话数据 | 减少Token占用，控制成本 |
| /config | 查看或修改配置 | 调整工具行为（如API密钥） |
| /cost | 查看Token使用情况 | 监控资源消耗 |
| /help | 查看帮助文档 | 新手入门首选 |
| /init | 初始化项目配置 | 新项目首次使用时 |
| /memory | 设置项目记忆 | 避免重复输入关键信息 |
| /review | 请求代码审查 | 提交前的质量检查 |
| /bug | 提交问题报告 | 遇到错误时反馈给Anthropic |
| /doctor | 系统诊断检查 | 排查权限/网络问题 |
| /terminal-setup | 设置键绑定 | 改善多行输入体验 |
6. 记忆系统详解
Claude Code的记忆系统是其核心功能之一，允许AI在不同会话间保持上下文一致性。
6.1 CLAUDE.md 文件
CLAUDE.md 是Claude Code的核心配置文件，它会被自动读取并加入到上下文中。当 Claude 工作时，它可能会保存以下内容：
• 项目模式：构建命令、测试约定、代码样式偏好
• 调试见解：棘手问题的解决方案、常见错误原因
• 架构笔记：关键文件、模块关系、重要抽象
• 您的偏好：沟通风格、工作流习惯、工具选择
使用以下命令为您的代码库引导 CLAUDE.md：
# 使用/init命令自动生成 /init # 或者手动创建并填充内容 touch CLAUDE.md
对于较大的项目，您可以使用 .claude/rules/ 目录将说明组织到多个文件中。这允许团队维护专注的、组织良好的规则文件，而不是一个大的 CLAUDE.md。
在您的项目的 .claude/rules/ 目录中放置 markdown 文件：
# 基本结构 your-project/ ├── .claude/ │ ├── CLAUDE.md # 主项目说明 │ └── rules/ │ ├── code-style.md # 代码样式指南 │ ├── testing.md # 测试约定 │ └── security.md # 安全要求 │ └── frontend/ │ ├── react.md │ └── styles.md │ └── backend/ │ ├── api.md │ └── database.md └──── general.md # 所有 .md 文件都会被递归发现。
6.2 记忆文件位置
CLAUDE.md 文件可以放置在多个位置：
• 项目根目录：./CLAUDE.md（推荐，可提交到git）
• 项目本地：./CLAUDE.local.md（不提交到git）
• 全局配置：~/.claude/CLAUDE.md
父目录和子目录中也会被自动读取
6.3 记忆管理命令
# 打开并编辑当前项目的持久记忆文件 /memory
这将打开 CLAUDE.md 文件，您可以在此添加或修改Claude的 "长期记忆" 内容。
7. 扩展 Claude Code
Claude Code 结合了一个能够推理代码的模型和内置工具，用于文件操作、搜索、执行和网络访问。内置工具涵盖了大多数编码任务。涵盖扩展层：您添加的功能，用于自定义 Claude 的知识、将其连接到外部服务并自动化工作流。
扩展插入代理循环的不同部分：
• CLAUDE.md 添加 Claude 每个会话都能看到的持久上下文
• Skills 添加可重用的知识和可调用的工作流
• MCP 将 Claude 连接到外部服务和工具
• Subagents 在隔离的上下文中运行自己的循环，返回摘要
• Agent teams 协调多个独立会话，具有共享任务和点对点消息传递
• Hooks 完全在循环外运行作为确定性脚本
• Plugins 和 marketplaces 打包和分发这些功能
Skills 是最灵活的扩展。Skill 是一个包含知识、工作流或说明的 markdown 文件。您可以使用斜杠命令（如 /deploy）调用 skills，或者 Claude 可以在相关时自动加载它们。Skills 可以在您当前的对话中运行，也可以通过 subagents 在隔离的上下文中运行。
功能范围从 Claude 每个会话都能看到的始终开启的上下文，到您或 Claude 可以调用的按需功能，再到在特定事件上运行的后台自动化。下表显示了可用的功能以及何时使用每个功能。
| 功能 | 作用 | 何时使用 | 示例 |
| CLAUDE.md | 每次对话加载的持久上下文 | 项目约定、“始终执行 X”规则 | ”使用 pnpm，而不是 npm。在提交前运行测试“ |
| Skill | Claude 可以使用的说明、知识和工作流 | 可重用内容、参考文档、可重复任务 | /review 运行您的代码审查清单；带有端点模式的 API 文档 skill |
| Subagent | 返回摘要结果的隔离执行上下文 | 上下文隔离、并行任务、专门工作者 | 读取许多文件但仅返回关键发现的研究任务 |
| Agent teams | 协调多个独立的 Claude Code 会话 | 并行研究、新功能开发、使用竞争假设进行调试 | 生成审查者同时检查安全性、性能和测试 |
| MCP | 连接到外部服务 | 外部数据或操作 | 查询您的数据库、发布到 Slack、控制浏览器 |
| Hook | 在事件上运行的确定性脚本 | 可预测的自动化，不涉及 LLM | 每次文件编辑后运行 ESLint |
Plugins 是打包层。Plugin 将 skills、hooks、subagents 和 MCP servers 捆绑到单个可安装单元中。Plugin skills 是命名空间的（如 /my-plugin:review），因此多个 plugins 可以共存。当您想在多个存储库中重用相同的设置或通过 marketplace 分发给他人时，使用 plugins。
8. 高级使用技巧
8.1 权限管理
Claude Code默认采用保守的权限策略。你可以通过以下方式管理权限：
# 使用/permissions命令管理权限 > /permissions # 或者通过命令行参数 claude --allowedTools Edit,Bash(git commit:*)
8.2 上下文管理策略
由于Claude Code的上下文窗口有限，且上下文过长会导致幻觉严重，需要合理管理上下文信息：
• 使用 @ 引用文件：请参考@PRD.MD 的结构
• 在任务切换时使用 /clear 清空上次任务信息
• 长时间会话定期压缩上下文：/compact
• 必要时从历史会话恢复：/resume
• 将重要信息通过 # <context> 记录到CLAUDE.md中
8.3 成本控制策略
# 查看token使用统计 /cost # 设置使用提醒 claude config set --global preferredNotifChannel terminal_bell
8.4 声音提示设置
启用任务完成时的声音提示：
claude config set --global preferredNotifChannel terminal_bell
安装塞尔达音效提示（任务完成时有特别提示）：
npm install -g zelda-claude-code@latest
9. 故障排除与常见问题
9.1 安装问题
Node.js版本过低：确保使用 Node.js 18+ 版本
权限问题：在Linux/macOS上尝试使用 sudo 安装全局包
9.2 认证问题
浏览器无法打开：使用 claude auth login --manual 进行手动认证
API密钥无效：检查环境变量设置是否正确
9.3 性能问题
响应缓慢：检查网络连接，或尝试使用更小的模
高token消耗：定期使用 /compact 压缩会话，使用 /clear 清理不必要上下文
结语
Claude Code 作为一款强大的AI编程助手，正在重新定义开发者与代码的交互方式。通过本文的详细介绍，相信你已经对Claude Code的安装、配置、基本使用和高级技巧有了全面了解。现在就开始使用Claude Code，体验AI辅助编程的强大能力吧！
