**Claude Code** 是 Anthropic 推出的 AI 编程助手 CLI 工具运行在你的终端中可以帮你编写代码、调试、搜索代码库、代码审查等。## 目录1. [安装与环境配置](#1-安装与环境配置)2. [基本交互方式](#2-基本交互方式)3. [斜杠命令 (Slash Commands)](#3-斜杠命令-slash-commands)4. [内置工具详解](#4-内置工具详解)5. [技能系统 (Skills)](#5-技能系统-skills)6. [权限管理](#6-权限管理)7. [设置与配置文件](#7-设置与配置文件)8. [工作区与项目](#8-工作区与项目)9. [高级功能](#9-高级功能)10. [实用技巧](#10-实用技巧)## 1. 安装与环境配置### 1.1 安装 Claude CodeWindows (PowerShell):irm https://claude.ai/install.ps1 | iexmacOS / Linux:curl -fsSL https://claude.ai/install.sh | bashnpm 安装:npm install -g anthropic-ai/claude-code### 1.2 首次启动claude首次启动会引导你完成认证需要 Anthropic API Key 或登录 Anthropic 账号。### 1.3 更新claude --update## 2. 基本交互方式### 2.1 直接对话在终端中启动 claude 后直接在提示符下输入你的需求即可 帮我写一个 Python 脚本读取 CSV 文件并计算每列的平均值### 2.2 在指定目录下工作cd /path/to/your/projectclaudeClaude Code 会自动感知当前目录作为工作区。### 2.3 单次执行模式不进入交互式 REPL直接执行一次任务claude 解释这个项目是做什么的claude -p 列出所有 TODO 注释 # -p 表示非交互模式### 2.4 管道模式cat error.log | claude 分析这些错误日志找出原因git diff | claude 审查这些改动## 3. 斜杠命令 (Slash Commands)在 Claude Code 交互界面中输入 / 可以看到所有可用命令/help 显示帮助信息/clear 清空当前对话/compact 压缩对话上下文以节省 token/config 查看和修改配置/cost 查看当前会话的 token 消耗/doctor 诊断安装问题/init 为当前项目生成 CLAUDE.md 文档/theme 切换主题dark/light/model 切换使用的模型/permissions 管理权限设置/mcp 管理 MCP 服务器/add-dir 添加额外的工作目录/ide 查看 IDE 集成状态/statusline 配置状态栏显示/upgrade 升级 Claude Code/logout 登出账号/bug 报告 bug/feedback 发送反馈## 4. 内置工具详解Claude Code 有一个强大的工具集它能自动选择合适的工具来完成任务。你不需要记住这些工具Claude 会自动调用。### 4.1 文件操作Read 读取文件内容支持 PDF、图片、Jupyter NotebookWrite 创建或覆写文件Edit 精确替换文件中的文本Glob 按通配符模式查找文件如 **/*.jsGrep 在文件内容中搜索正则表达式### 4.2 执行操作Bash 执行 shell 命令示例用法你可以直接说- 读取 src/main.py 文件- 查找所有包含 TODO 的文件- 用 glob 找一下所有 .ts 文件- 运行 npm test### 4.3 智能代理 (Agent)Claude 可以启动子代理来处理复杂任务你可以说- 用 agent 去搜索代码库中的认证逻辑- 启动一个 explore agent 去查看整个项目的结构### 4.4 网络工具WebSearch 在网络上搜索信息WebFetch 抓取网页内容并转换为 Markdown示例- 搜索一下 React 18 的新特性- 查看这个 GitHub issue 的内容## 5. 技能系统 (Skills)技能是专门化的功能模块。使用 /技能名 来调用### 5.1 可用技能/init 为代码库生成 CLAUDE.md 文档/code-review 代码审查查找 bug、简化建议/simplify 简化代码重组、优化、去重/review 审查 Pull Request/security-review 安全审查/deep-research 深度网络调研多源搜索验证报告/run 启动并驱动应用验证改动/verify 验证代码改动是否按预期工作/loop 定时循环执行任务如每 5 分钟检查部署状态/claude-api Claude API 参考文档/update-config 修改 settings.json 配置/fewer-permission-prompts 自动分析并减少权限提示### 5.2 使用示例# 审查当前改动/code-review# 给 PR 添加评论/code-review --comment# 深度研究/deep-research Python 异步编程的最佳实践是什么# 定时检查/loop 5m /verify## 6. 权限管理Claude Code 在执行某些操作前会请求你的许可。### 6.1 权限级别Allow — 允许本次执行Deny — 拒绝本次执行Always Allow — 总是允许此类操作Always Deny — 总是拒绝此类操作### 6.2 管理权限使用 /permissions 命令查看和管理所有权限规则。权限配置存储在- 项目级: .claude/settings.json- 用户级: ~/.claude/settings.json### 6.3 减少权限弹窗如果觉得权限弹窗太多可以运行/fewer-permission-prompts## 7. 设置与配置文件### 7.1 配置文件位置settings.json 项目 .claude/ 或 ~/.claude/ 权限、钩子、环境变量CLAUDE.md 项目根目录 项目文档Claude 每次启动都会读取keybindings.json ~/.claude/ 键盘快捷键scheduled_tasks.json .claude/ 定时任务MEMORY.md 项目 .claude/memory/ 持久化记忆### 7.2 CLAUDE.mdCLAUDE.md 是一个关键文件它告诉 Claude Code 关于你项目的所有重要信息。使用 /init 自动生成/init你也可以手动创建和维护它内容包括- 项目架构说明- 常用命令- 编码规范- 项目特定注意事项### 7.3 钩子 (Hooks)在 settings.json 中配置可以在特定事件触发时自动执行操作{hooks: {PreToolUse: [{matcher: Bash,hook: echo 即将执行命令}]}}## 8. 工作区与项目### 8.1 多目录工作区# 添加额外目录/add-dir /path/to/another/project### 8.2 Git 集成Claude Code 自动感知 Git 仓库- 自动检测当前分支- 可以在工作树 (worktree) 中隔离工作- 支持 gh CLI 进行 GitHub 操作### 8.3 IDE 集成Claude Code 可以与 VS Code 和 JetBrains IDE 集成/ide## 9. 高级功能### 9.1 计划模式 (Plan Mode)对于复杂任务Claude 会先制定计划再执行- 先探索代码库- 设计实施方案- 等你确认后再编写代码你也可以主动要求 帮我实现用户认证功能先制定计划### 9.2 后台任务耗时命令可以放到后台运行# Claude 会自动将长时间任务放到后台 运行完整的测试套件# 你可以在测试运行时继续其他工作### 9.3 定时任务/loop 10m 检查 CI 状态### 9.4 MCP 服务器Model Context Protocol 允许 Claude 连接外部工具/mcp### 9.5 Token 预算控制你可以在消息后追加 token 预算来限制消耗 全面审查代码库中的安全问题 50k 深入分析所有 API 端点 200k### 9.6 记忆系统Claude Code 有持久化记忆功能存储在 .claude/memory/ 目录。你可以说- 记住这个项目使用 PostgreSQL 数据库- 记住我喜欢用 TypeScript 而不是 JavaScript## 10. 实用技巧### 10.1 有效的提问方式好的提问 在 src/services/auth.ts 中实现 JWT 令牌刷新逻辑使用现有的 apiClient 参考 src/utils/token.ts 中的 token 存储方式不太好的提问 加个登录技巧- 明确指定文件路径- 引用现有代码作为参考- 描述预期行为- 分步骤处理大任务### 10.2 高效的文件操作# 不用手动 grep 找出所有调用 deprecatedFunction 的地方并替换为 newFunction# 不用手动 find 找到所有没有测试文件的 .ts 模块### 10.3 代码审查流程# 1. 审查当前未提交的改动/code-review# 2. 审查特定文件 审查 src/auth/ 目录下的所有文件# 3. 审查 PRgh pr checkout 42/review### 10.4 调试技巧# 粘贴错误信息 我在运行 npm run build 时遇到这个错误 [粘贴错误日志] 帮我分析和修复# 让 Claude 添加调试日志 在 router.ts 的关键位置添加 console.log 来追踪请求流### 10.5 学习代码库# 快速了解项目/init# 提问 这个项目的入口文件是什么 认证系统是怎么工作的画个流程图 有哪些 API 端点### 10.6 节省 Token# 清理上下文/compact# 查看消耗/cost# 切换更便宜的模型/model claude-sonnet-4-6### 10.7 快捷键参考CtrlC 中断当前操作CtrlD 退出 Claude CodeCtrlR 搜索历史命令↑/↓ 浏览历史命令Tab 自动补全路径可以在 ~/.claude/keybindings.json 中自定义快捷键。## 附录 A: 常见问题Q: Claude Code 和 GitHub Copilot 有什么区别A: Claude Code 是完整的终端内 AI 编程助手不仅能补全代码还能理解整个项目、执行命令、管理文件、进行代码审查等。Copilot 更侧重于编辑器内的代码补全。Q: 如何控制花费A: 使用 /cost 查看消耗使用 50k 等 token 预算限制或切换到更便宜的模型。Q: Claude Code 能访问网络吗A: 可以。它可以使用 WebSearch 和 WebFetch 工具访问网络需你授权。Q: 我的代码安全吗A: Claude Code 在本地运行代码不会上传到 Anthropic 服务器存储。每次对话的上下文会发送到 API 进行处理。详见 Anthropic 的隐私政策。## 附录 B: 快速参考卡# 最常用的命令claude # 启动交互式 REPLclaude 任务描述 # 单次执行claude -p 任务 # 非交互模式git diff | claude 审查 # 管道模式# 最常用的斜杠命令/init # 生成项目文档/code-review # 代码审查/clear # 清空对话/compact # 压缩上下文/cost # 查看消耗/help # 帮助# 实用技巧 读取 src/main.py # 读文件 搜索所有 TODO 注释 # 搜索 运行 npm test # 执行命令 这个项目的架构是什么样的 # 理解项目 审查我的改动 或 /code-review # 代码审查本教程基于 Claude Code 2026 年版本编写功能可能随版本更新而变化。使用 /help 查看最新文档。