Claude Code 完全指南:从安装到高级工作流的实战手册

项目速览

属性	详情
项目	claude-howto
GitHub	github.com/luongnv89/claude-howto
Stars	6,701+
定位	Claude Code 学习指南与模板库
核心价值	15 分钟上手 → 周末精通

什么是 Claude Code

Claude Code 是 Anthropic 推出的官方 CLI 工具，将 Claude 的能力直接注入终端。它不是简单的聊天界面，而是一个完整的 Agentic Coding 环境。

核心特性

• 上下文感知：自动读取项目文件、Git 历史、环境变量
• 工具调用：内置 Bash、文件编辑、代码搜索等工具
• 权限分级：从严格确认到完全自动化的权限模式
• 子 Agent：可并行启动多个任务 Agent 处理复杂工作
• 跨平台：支持 Desktop App、CLI、JetBrains 插件、Chrome 扩展

安装与配置

快速安装

# macOS / Linuxbrew install claude-code# 或通过 npmnpm install -g @anthropic-ai/claude-code# 验证安装claude --version

登录与初始化

# 启动交互式会话claude# 或使用 print 模式（非交互式）claude -p "分析这个函数的复杂度"

配置文件层级

Claude Code 使用 JSON 配置文件，按优先级加载：

1. 项目级：./.claude/settings.json
2. 用户级：~/.claude/settings.json
3. 系统默认

{  "model": "claude-sonnet-4-20250514",  "permissionMode": "acceptReadOnly",  "tools": ["Bash", "Read", "Edit"],  "autoApproveTools": ["Read"]}

核心命令详解

会话内斜杠命令

命令	功能	使用场景
`/config`	交互式配置	动态调整设置
`/clear`	清空上下文	长会话重置
`/cost`	查看费用统计	成本控制
`/memory`	管理长期记忆	跨会话知识
`/desktop`	切换到 Desktop App	需要可视化对比
`/loop`	循环执行提示词	定时轮询任务

CLI 参数

# Print 模式（脚本化使用）claude -p "重构这段代码" --path ./src# 指定模型claude --model claude-opus-4-20250514# 限制工具claude --tools "Read,Edit"# 自动批准特定工具claude --auto-approve-tools "Bash(git:*)"# 预算控制claude --max-cost 5.00# 输出 JSONclaude -p "分析代码" --output-json --schema schema.json

权限模式深度解析

Claude Code 提供四级权限控制：

模式	说明	适用场景
`acceptReadOnly`	只读操作自动批准，修改需确认	日常开发（推荐）
`acceptSuggestions`	代码建议自动批准，执行需确认	代码审查
`requireApproval`	所有操作需确认	敏感项目
`bypassPermissions`	完全自动化（慎用）	CI/CD 脚本

# 启动时指定权限模式claude --permission-mode acceptReadOnly# 会话中切换/config permission-mode

Agent 与子 Agent

子 Agent 工作流

Claude Code 支持启动多个子 Agent 并行处理任务：

用户: 分析这个项目的所有 API 端点Claude: 启动 5 个子 Agent 分别分析不同模块...       [Agent 1] 分析 auth 模块       [Agent 2] 分析 user 模块       [Agent 3] 分析 order 模块       ...       汇总结果返回给用户

配置子 Agent

{  "teammates": {    "display": "auto",    "layout": "split"  }}

实战工作流

工作流 1：代码重构

# 1. 进入项目目录cd my-project# 2. 启动 Claude Codeclaude# 3. 自然语言描述需求> 将 utils.js 中的回调函数重构为 async/await# 4. Claude 分析、生成 diff、等待确认# 5. 确认后自动应用修改

工作流 2：Bug 修复

# 使用 print 模式集成到脚本claude -p "分析最近的错误日志，找出潜在 bug" \  --path ./logs \  --tools "Read,Bash(grep:*)"

工作流 3：批量文档生成

# 并行处理多个文件claude -p "为 src/components 下的每个组件生成 JSDoc 注释" \  --auto-approve-tools "Edit" \  --max-cost 2.00

高级功能

Scheduled Tasks（定时任务）

• Cloud 任务：Anthropic 托管，电脑关机也运行
• Desktop 任务：本地运行，可访问本地文件和工具

# 设置定时任务claude schedule --name "daily-report" --cron "0 9 * * *"

Hooks 与 Plugins

• Hooks：本地 shell 命令自动化
• Plugins：连接外部服务（CI/CD、项目管理等）

{  "hooks": {    "pre-session": "npm run lint",    "post-edit": "npm test"  }}

MCP 集成

Model Context Protocol 支持：

# 加载 MCP 配置claude --mcp-config ./mcp-servers.json

最佳实践

1. 成本控制

# 设置单次会话预算claude --max-cost 5.00# 监控实时费用/cost

2. 上下文管理

• 使用 /clear 重置长会话
• 利用 /memory 存储跨会话知识
• 通过 --path 限制工作目录

3. 安全建议

• 生产环境使用 acceptReadOnly 模式
• 敏感操作添加 --require-approval
• 定期审查 ~/.claude/ 目录权限

4. 团队协作

• 将 .claude/settings.json 纳入版本控制
• 共享常用 Hooks 和 Plugins
• 建立团队 Prompt 模板库

学习资源

资源	链接	说明
官方文档	code.claude.com/docs	完整参考手册
快速入门	code.claude.com/docs/en/quickstart	8 步上手
命令参考	code.claude.com/docs/en/cli-reference	CLI 完整文档
最佳实践	code.claude.com/docs/en/best-practices	官方建议

项目价值评估

为什么值得 6,701 Star

1. 填补文档空白：官方文档分散，此项目系统整理
2. 实战导向：提供大量 copy-paste 模板
3. 持续更新：跟进 Claude Code 新特性
4. 社区驱动：Issue 和 PR 活跃

适用人群

• ✅ 想提升效率的开发者
• ✅ 探索 AI 辅助编程的团队
• ✅ 需要自动化工作流的技术负责人
• ⚠️ 对 CLI 不熟悉的用户需要适应期

快速开始命令

# 安装npm install -g @anthropic-ai/claude-code# 首次运行claude# 尝试一个任务claude -p "解释当前目录的项目结构"

本文基于 claude-howto 项目及官方文档整理，技术内容以 Anthropic 官方为准。