前置准备与系统要求

系统要求

Claude Code 对硬件的要求很低。所有 AI 推理都在 Anthropic 的服务器上运行，你的电脑只是运行一个轻量级的 CLI 客户端。不需要 GPU。

账户与定价

Claude Code 不支持免费账户。你需要以下任一付费方案：

如果你只是偶尔使用，Console 按量付费可能更划算。Sonnet 4.6 的价格是每百万输入 token $3.00、输出 $15.00，一次重度编程会话的 API 成本约 $0.50 ~ $2.00。

安装 Claude Code

推荐方式：原生安装器

2026 年官方推荐的安装方式。零依赖、无需 Node.js、后台自动更新。

macOS / Linux：

curl-fsSLhttps://claude.ai/install.sh|sh

Windows（PowerShell）：

irmhttps://claude.ai/install.ps1|iex

安装完成后，打开一个新的终端窗口让 PATH 生效，然后验证安装：

claude--version# 查看版本号claudedoctor# 检查安装健康状态claudewhoami# 查看认证信息

备选方式：Homebrew（macOS）

brewinstall--cask claude-code

注意：Homebrew 不会自动更新，需要手动 brew upgrade claude-code。

备选方式：npm

npminstall-g @anthropic-ai/claude-code

npm 方式已不再推荐，但仍可用，适合锁定特定版本的场景。需要 Node.js 18.0+。遇到权限错误时不要用 sudo，应使用 nvm 管理 Node.js。

首次使用与认证

在你的项目根目录下打开终端，输入：

claude

首次运行会自动打开浏览器引导登录。凭证保存在 ~/.claude/ 目录下，后续无需重复登录。

如果在远程服务器上（无浏览器），Claude Code 会提供一个 URL，可在其他设备上完成认证。

进入会话后，试试这些入门指令来熟悉工具：

这个项目是做什么的？帮我找到所有的 API 端点，列出每个端点的功能当前代码里有哪些明显的安全隐患？

Claude 会自动扫描代码库、理解项目结构，然后给出全面的回答。

核心配置：CLAUDE.md

CLAUDE.md 是 Claude Code 最重要的配置机制。放在项目根目录下，Claude 每次启动时自动读取。你可以把它理解为给 AI 助手写的一份「员工手册」。

快速生成

/init

Claude 会分析代码库，自动生成一份适合你项目的 CLAUDE.md。

应该写什么

# 项目概述 这是一个基于 Next.js 14 的电商平台，使用 TypeScript 编写。 # 技术栈 - 前端：Next.js 14 + React 18 + Tailwind CSS - 后端：Next.js API Routes + Prisma ORM - 数据库：PostgreSQL # 编码规范 - 使用函数式组件和 React Hooks，不使用 class 组件 - 所有组件使用 TypeScript 严格模式 - CSS 统一使用 Tailwind，不写自定义 CSS 文件 - 提交信息使用 Conventional Commits 格式 # 常用命令 - 开发服务器：npm run dev - 运行测试：npm test - 类型检查：npx tsc --noEmit # 注意事项 - 所有数据库查询使用 Prisma，不要写原始 SQL - API 路由必须做参数验证 - 敏感信息存放在 .env.local，不要硬编码

配置层级

Claude Code 按层级读取多个 CLAUDE.md 文件：

• ~/.claude/CLAUDE.md → 全局配置，对所有项目生效

• 项目根目录/CLAUDE.md → 项目级配置

• 子目录/CLAUDE.md → 特定目录的额外规则

子目录的规则会补充（而非覆盖）上级规则。

斜杠命令完全指南

在 Claude Code 中输入 / 可以看到所有可用命令。以下是最重要的内置命令：

会话管理

开发工具

/compact 是长会话的救星。当 Claude 开始「遗忘」之前的内容时，它能压缩历史记录释放上下文。还可以加聚焦提示：/compact 保留关于认证模块重构的上下文

Plan Mode（计划模式）

这是 Claude Code 最强大的功能之一，尤其适合复杂任务。

分析问题 — 读取相关文件，追踪依赖关系，识别影响范围

制定计划 — 列出要修改的文件、修改顺序和原因

展示推理 — 你能看到 Claude 的完整思考路径

等待批准 — 不会在你确认前执行任何操作

适用场景：

• 跨多个文件的大规模重构

• 添加涉及路由、控制器、模型和测试的新功能

• 在不熟悉的代码库中理解修改的影响范围

• 学习——通过阅读 Claude 的推理过程来理解代码库

/plan将认证模块从 session cookies 迁移到 JWT tokens

日常开发工作流

写代码

给注册表单添加邮箱验证功能，包括格式检查和重复检查

Claude 会自动找到相关文件，规划修改方案，展示 diff，等你确认后再应用。

修 Bug

用户反馈在移动端登录表单无法提交。我怀疑是表单验证的问题。表单在 src/components/Login.jsx

写测试

给 auth 模块写测试，运行测试，修复失败的用例

Git 操作

用描述性的 commit message 提交我的更改创建一个新分支，实现用户评论功能，然后提交 PR

高效提示的技巧

核心原则：说清楚目标，让 Claude 来规划实现方式。

让代码更好

重构这个组件以提高可维护性： - 提取逻辑为自定义 hooks - 添加 TypeScript 类型 - 编写单元测试

先检查文件，然后看第 42 行， 然后修改条件判断...

用户反馈仪表盘加载很慢， 请调查性能问题并提出优化方案

模型选择策略

使用 /model 命令切换，或在启动时指定：

claude--model opus

Skills（技能系统）

Skills 允许你通过 Markdown 文件教会 Claude 处理特定任务。它们是 Claude Code 的扩展系统。

创建自定义 Skill

在 ~/.claude/skills/ 下创建目录和 SKILL.md 文件：

# 文件路径：~/.claude/skills/explain-code/SKILL.md --- name: explain-code description: 用可视化图表和类比来解释代码 command: /explain --- 解释代码时，始终包含以下步骤： 1. **先做类比**：将代码比作日常生活中的事物 2. **画一张图**：用 ASCII 字符画展示流程 3. **逐步讲解**：解释每一步发生了什么 4. **指出陷阱**：常见的错误或误解是什么？

项目级技能

将技能放在 .claude/skills/ 目录中并提交到 Git，团队所有成员自动获得相同命令。

# .claude/skills/tdd/SKILL.md --- name: TDD Workflow description: 严格的测试驱动开发流程 command: /tdd --- 按照严格的 TDD 流程工作： 1. 先写一个失败的测试，运行，确认失败 2. 编写最少量代码让测试通过 3. 运行测试，确认通过 4. 重构代码，再次运行测试

旧版的 .claude/commands/ 仍然可用，但官方推荐使用 .claude/skills/，因为它支持附带模板文件、前置配置等更多功能。用 /skills 可以列出所有可用技能。

Hooks（钩子自动化）

Hooks 让你在 Claude 执行特定操作时自动运行 shell 命令。与提示词不同，Hooks 保证执行——不管模型怎么想。

{"hooks": {"PostToolUse": [{"matcher": "Write(*.py)",         "hooks": [{"type": "command",           "command": "python -m black $file"}]},       {"matcher": "Write(*.ts)",         "hooks": [{"type": "command",           "command": "npx prettier --write $file"}]}]}}

效果：每当 Claude 写入 .py 文件时自动运行 Black 格式化，写入 .ts 文件时自动运行 Prettier。

你也可以在会话中输入 /hooks，通过交互式菜单配置，比手动编辑 JSON 更方便。

MCP（模型上下文协议）

MCP 是一个开源标准协议，让 Claude Code 连接到外部工具和数据源。配置 MCP 后，Claude Code 从编程助手升级为集成式开发平台。

添加 MCP 服务器

# GitHub 集成claude mcp add github -- npx -y @modelcontextprotocol/server-github # PostgreSQL 数据库claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres # HTTP 远程服务（如 Notion）claude mcp add notion --transport http https://mcp.notion.com/mcp# 查看已配置的服务器claude mcp list

实际应用

查看 JIRA 上 ENG-4521 的需求描述，实现它并创建 PR检查 Sentry 上最近的错误日志，找到根因并修复根据 Slack 里发的最新 Figma 设计图，更新邮件模板

过去需要在多个工具间反复切换的工作，现在一句话搞定。

权限管理

Claude Code 采用权限审批机制——默认每次文件修改和命令执行都需要你确认。

权限模式

# 自动接受文件编辑（仍需确认命令执行）claude--permission-mode acceptEdits # 跳过所有权限检查（谨慎使用！）claude--dangerously-skip-permissions

精细控制

{"permissions": {"allowedTools": ["Read", "Write", "Bash(git *)"],     "deny": ["Read(./.env)",       "Read(./.env.*)",       "Write(./production.config.*)"]}}

允许读写文件和运行 Git 命令，但禁止读取 .env 和修改生产配置。

IDE 与 CI/CD 集成

VS Code / Cursor

Claude Code 提供 VS Code 扩展，支持内联差异视图、@ 文件引用、计划审查和对话历史。在扩展市场搜索「Claude Code」安装，然后 Cmd+Shift+P 打开命令面板，选择 "Claude Code: Open in New Tab"。

自动代码审查

运行 /install-github-app，Claude 会自动对每个 PR 进行审查。它会在项目中添加 claude-code-review.yml 配置文件，你可以自定义审查重点。

非交互式模式（CI 集成）

claude-p"检查这个 PR 的安全风险"< diff.txt

快捷键速查

如果你只是想跑 git status，用 !git status 比让 Claude 帮你跑要快得多，也不消耗 AI token。

常见问题排查

claude命令找不到？

打开新终端窗口。如果仍然找不到：

echo'export PATH="$HOME/.local/bin:$PATH"'>> ~/.zshrc source ~/.zshrc

Windows 上 MCP 服务器连接失败？

原生 Windows（非 WSL）需要加 cmd /c 包装器：

claude mcp add my-server --cmd /c npx -y @some/package

遇到速率限制？

使用 /compact 压缩上下文减少 token 消耗，或升级到 Max 方案获取更高限额。也可以用 /model 切换到更轻量的模型（如 Haiku）来处理简单任务。

如何在团队中标准化？

将 CLAUDE.md、.claude/skills/ 和 .claude/settings.json 提交到 Git。新成员克隆项目后自动获得所有配置。

最佳实践总结

学习 Claude Code 最好的方式就是在真实项目中使用它。从一个小任务开始，端到端地完成，然后逐步探索更复杂的工作流。

AI 工具再强大，也是为人服务的。保持你的工程判断力，审查每一个修改，理解每一行代码。

📖 官方文档 →