Claude Code 从零到精通：多Agent协作开发完全教程-第二章：Claude Code 安装与入门
第二章：Claude Code 安装与入门
2.1 安装 Claude Code
📖 官方安装文档：https://docs.anthropic.com/en/docs/claude-code/quickstart
方式一：官方脚本安装（推荐，支持自动更新）
macOS / Linux / WSL：
Bash
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell：
PowerShell
irm https://claude.ai/install.ps1 | iex
方式二：Homebrew 安装（macOS）
Bash
brew install --cask claude-code
方式三：npm 安装（备选，环境兼容性最好）
⚠️ 官方脚本安装可能因为网络环境、权限问题、代理配置等原因失败。如果你遇到安装卡住或报错，可以直接用 npm 安装，效果完全一样。
前提：已安装 Node.js v18+。
📖 如果你是零基础，安装过程中遇到任何问题，推荐阅读这篇保姆级教程：小白如何从0到1安装上Claude Code，涵盖环境准备、常见报错解决等。
Bash
npm install -g @anthropic-ai/claude-code
安装完成后，终端输入 claude 即可启动。
方式四：WinGet 安装（Windows）
PowerShell
winget install Anthropic.ClaudeCode
💡 安装方式对比：
方式 自动更新 适用场景
官方脚本 ✅ 自动 网络畅通时首选
npm ❌ 需手动 npm update -g @anthropic-ai/claude-code 官方脚本装不上时用
Homebrew ❌ 需手动 brew upgrade claude-code macOS 用户习惯 brew
WinGet ❌ 需手动 winget upgrade Windows 用户
2.2 登录账号
Bash
claude # 首次使用会提示登录
/login # 在会话中切换账号
支持的账号类型：
•Claude Pro/Max/Teams/Enterprise（推荐，Max 计划可用 Opus 模型）
•Claude Console（API 按量付费）
•Amazon Bedrock / Google Vertex AI（企业云服务商）
2.3 第一次使用
Bash
cd /path/to/your/project # 进入你的项目目录
claude # 启动 Claude Code
试试这些命令：
Plaintext
这个项目是做什么的？ # 让 Claude 分析项目
这个项目用了哪些技术栈？ # 了解技术栈
帮我解释一下 src/ 目录结构 # 理解项目结构
2.4 核心命令速查表
命令 作用 示例
claude 启动交互模式 claude
claude "任务" 执行一次性任务 claude "修复构建错误"
claude -p "查询" 单次查询后退出 claude -p "解释这个函数"
claude -c 继续最近会话 claude -c
claude -r 恢复历史会话 claude -r
/clear 清空上下文 任务切换时使用
/compact 压缩上下文 /compact 保留API变更
/help 查看帮助 /help
Esc 停止当前操作 发现方向错误时按
Esc + Esc 打开回滚菜单 恢复到之前的状态
2.5 工具生态全景
Plaintext
┌──────────────────────────────────────────────────────────┐
│ Claude Code 工具生态全景 │
├──────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ CLAUDE.md │ │ Skills │ │ Plugins │ │
│ │ 项目规范 │ │ 技能/工作流│ │ 插件集合 │ │
│ │ .claude/md │ │ .claude/ │ │ 社区市场 │ │
│ │ │ │ skills/ │ │ │ │
│ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │
│ │ │ │ │
│ ┌──────┴──────┐ ┌──────┴──────┐ ┌──────┴──────┐ │
│ │ Hooks │ │ Subagents │ │ MCP Servers │ │
│ │ 事件钩子 │ │ 子Agent │ │ 外部工具 │ │
│ │ settings │ │ .claude/ │ │ settings │ │
│ │ .json │ │ agents/ │ │ .json │ │
│ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │
│ │ │ │ │
│ └────────────────┼────────────────┘ │
│ │ │
│ ┌───────┴───────┐ │
│ │ Agent Teams │ │
│ │ 多Agent协作 │ │
│ │ 团队开发模式 │ │
│ └───────────────┘ │
│ │
└──────────────────────────────────────────────────────────┘
2.6 设置指令白名单 — 告别反复确认
刚开始用 Claude Code 你会发现，它每次读文件、改文件、跑命令都要弹窗问你"是否允许"。频繁确认非常打断心流。通过设置权限白名单，你可以让常用操作自动放行。
方式一：交互式添加（最简单）
在 Claude Code 中运行：
Plaintext
/permissions
会打开权限管理界面，你可以直接添加允许的工具和命令。
或者，当 Claude 弹出确认时，选择 "Always allow"（始终允许），该操作会被自动加入白名单。
方式二：编辑 settings.json（推荐，一次配齐）
编辑项目级配置 .claude/settings.json（仅当前项目生效）：
JSON
{
"permissions": {
"allow": [
"Bash(git *)",
"Bash(npm test)",
"Bash(npm run *)",
"Bash(npx *)",
"Bash(node *)",
"Bash(ls *)",
"Bash(cat *)",
"Bash(mkdir *)",
"Bash(cp *)",
"Read",
"Write",
"Edit",
"Glob",
"Grep"
],
"deny": [
"Bash(rm -rf *)",
"Bash(sudo *)"
]
}
}
或编辑全局配置 ~/.claude/settings.json（所有项目生效）。
白名单语法说明
语法 含义 示例
Read 允许读取任意文件 不再弹确认
Edit 允许编辑任意文件 不再弹确认
Write 允许创建新文件 不再弹确认
Bash(命令 ) 允许匹配的 bash 命令 Bash(git ) 允许所有 git 命令
Bash(精确命令) 允许特定命令 Bash(npm test) 只允许 npm test
WebFetch 允许抓取网页 不再弹确认
deny 列表优先级高于 allow，用于拦截危险操作。
方式三：命令行参数（临时生效）
启动时指定白名单，仅本次会话有效：
Bash
claude --allowedTools "Edit,Bash(git *),Bash(npm test)"
适合批量脚本或 CI 场景。
方式四：直接跳过所有权限（谨慎使用）
Bash
claude --dangerously-skip-permissions
⚠️ 这会跳过所有权限检查，Claude 可以执行任意命令。仅建议在容器/沙箱环境中使用，或搭配 OpenClaw 做无人值守任务时使用。
推荐的白名单配置
日常开发（安全 + 高效）：
JSON
{
"permissions": {
"allow": [
"Read", "Edit", "Write", "Glob", "Grep",
"Bash(git *)",
"Bash(npm )", "Bash(npx )", "Bash(node *)",
"Bash(ls )", "Bash(cat )", "Bash(mkdir *)",
"Bash(python )", "Bash(pip )",
"Bash(cargo )", "Bash(go )"
],
"deny": [
"Bash(rm -rf /)",
"Bash(sudo *)",
"Bash(chmod 777 *)"
]
}
}
无人值守模式（搭配 OpenClaw 使用）：
JSON
{
"permissions": {
"allow": [
"Read", "Edit", "Write", "Glob", "Grep",
"Bash(*)"
],
"deny": [
"Bash(rm -rf /)",
"Bash(sudo rm *)",
"Bash(:(){ :|:& };:)"
]
}
}
💡 小技巧：你也可以直接跟 Claude Code 说"帮我配置权限白名单，允许所有 git、npm、文件读写操作，但禁止 rm -rf 和 sudo"，它会帮你生成 settings.json。
让 Claude Code 帮你配置白名单（推荐）
很多同学看到上面的 JSON 配置可能会头疼——其实你根本不需要手写。配置好 Claude Code 之后，很多事情都可以直接让它帮你完成，白名单配置就是一个典型例子。
直接用自然语言告诉 Claude Code 你想要什么，它会帮你生成并写入配置文件：
示例对话：
Plaintext
👤 你：帮我配置权限白名单，我是前端开发，常用 git、npm、pnpm、node，
需要读写文件权限，但禁止删除根目录和 sudo
🤖 Claude Code：好的，我来帮你配置 .claude/settings.json...
（自动创建文件并写入合适的 allow/deny 规则）
Plaintext
👤 你：我要跑 Python 项目，帮我把 python、pip、pytest 的命令都加到白名单里
🤖 Claude Code：已更新 settings.json，新增了 Python 相关命令的白名单...
Plaintext
👤 你：把 docker 和 docker-compose 命令也加到白名单
🤖 Claude Code：已添加 Bash(docker ) 和 Bash(docker-compose ) 到 allow 列表...
核心理念：Claude Code 不仅是写代码的工具，它也是配置自身的最佳助手。当你学会配置好 Claude Code 后，后续的环境搭建、插件安装、权限调整、CLAUDE.md 编写……这些统统可以用自然语言让它帮你完成。不要手动去改配置文件，告诉 Claude Code 你要什么，让它来做。
这种"用 AI 配置 AI"的思路贯穿整个 Claude Code 的使用过程：
你想做的事 直接告诉 Claude Code
配置权限白名单 "帮我配置白名单，允许 git 和 npm 命令"
创建 CLAUDE.md "帮我生成项目的 CLAUDE.md 规范文件"
安装 MCP 服务器 "帮我安装 Playwright MCP"
安装插件/Skills "帮我安装 superpowers 插件"
配置 Hooks "帮我配置一个 pre-commit hook 自动跑 lint"
初始化项目结构 "帮我创建一个 React + TypeScript 项目"
配置 Git "帮我初始化 git 仓库并做第一次提交"
🎯 记住这个原则：当你不知道怎么配置时，先问 Claude Code。 它既是工具，也是你的配置向导。