技术文摘

Claude Code v2.1完全教程：从安装到Agent Teams，25个命令+60+斜杠命令详解

📅 2026-05-29 17:14 · 👁 5 次阅读 · 📝 2,671 字 · ⏱ 约 9 分钟读完

Claude Code是Anthropic推出的命令行AI编程助手，通过自然语言对话实现代码编写、调试和重构。它不是普通的聊天机器人，而是能进入项目、围绕文件、命令、测试和Git工作流协助完成任务的Agentic Coding工具。

核心能力一览

能力说明通俗理解 代码读写读取、创建、编辑项目中的任意文件像一个能直接改代码的高级Copilot Shell执行运行git、npm、docker等任意终端命令你不用手动输命令了，它帮你跑 代码搜索内置ripgrep，秒搜整个代码库比IDE全局搜索还快还准 上下文理解自动读取CLAUDE.md，记住项目规范它能"记住"你的项目约定 MCP扩展连接数据库、API、浏览器等外部工具像USB接口一样插上就能用 Agent Teams多实例平行协作一个当架构师，一个当测试员

5分钟快速上手

安装

# macOS
brew install claude-code

# npm
npm install -g @anthropic-ai/claude-code

# Windows
winget install anthropic.claude-code

启动

# 在项目目录下启动
cd your-project
claude

# 第一次使用会要求登录Anthropic账户

模型选择

输入 /model 切换模型。按任务难度分层：

  • 常规开发：Sonnet 4.5（平衡、快速）
  • 复杂重构：Opus 4.6（推理最强）
  • 文档/轻量任务：Haiku（最快最便宜）

25个CLI命令速查

claude                    # 交互模式启动
claude "做xxx"            # 一次性执行任务
claude -p "做xxx"         # 非交互模式（输出到stdout）
claude --resume           # 恢复上次会话
claude --resume --last    # 从断点继续
claude model              # 切换模型
claude config             # 查看/修改配置
claude permissions        # 查看权限设置
claude cost               # 查看Token消耗
claude clear              # 清除会话历史
claude mcp                # 管理MCP服务器
claude memory             # 管理项目记忆
claudecompact             # 压缩上下文

60+斜杠命令（按场景分类）

会话管理

/help          # 帮助文档
/cost          # 当前会话Token消耗
/model         # 切换模型
/memory        # 管理CLAUDE.md项目记忆
/permissions   # 查看和修改权限
/compact       # 压缩上下文（节省Token）
/clear         # 清除会话
/history       # 查看历史会话

代码操作

/init          # 初始化项目（创建CLAUDE.md）
/review        # 审查当前修改
/fix           # 修复代码问题
/test          # 运行测试
/build         # 构建项目
/format        # 格式化代码

Git操作

/git status    # 查看状态
/git diff      # 查看差异
/git commit    # 提交
/git log       # 查看日志

权限模式（5级安全控制）

  • Ask：每次操作前询问（最安全，适合新手）
  • Auto：读取自动批准，写入需确认（推荐）
  • Full Auto：全自动执行（仅限可信任务）
  • Bypass Permissions：跳过所有权限检查（CI/CD用）
  • Plan Mode：只规划不执行（高风险任务先确认）

MCP工具扩展：让AI连接外部世界

MCP（Model Context Protocol）是Anthropic推出的开放协议，让AI模型调用外部工具和服务。

# 添加MCP服务器
claude mcp add github -- npx -y @anthropic-ai/mcp-github
claude mcp add postgres -- npx -y @anthropic-ai/mcp-postgres postgresql://localhost/mydb
claude mcp add puppeteer -- npx -y @anthropic-ai/mcp-puppeteer

Agent Teams：一人即团队

多个Claude Code实例并行协作：一个主Agent负责规划和协调，多个子Agent分别处理前端、后端、测试、文档。适合大型重构、多模块同步开发。

# 实例1：主架构师
claude "重构认证模块，拆分为JWT和OAuth两个子模块"

# 实例2：并行处理前端
claude "更新前端登录组件，适配新的认证API"

# 实例3：并行写测试
claude "为新的认证模块编写单元测试"

CLAUDE.md：项目记忆文件

在项目根目录创建CLAUDE.md，Claude Code每次会话自动读取。包含：代码规范、架构约定、测试要求、部署流程。相当于给AI一份项目入职手册。

常见问题排查

  • 报错"Permission denied"：运行 /permissions 检查权限设置
  • 上下文不够用：运行 /compact 压缩，或分步执行任务
  • 回复太慢：切换到Sonnet或Haiku模型
  • 改错了想回退：Git checkout 恢复，或用 /git diff 查看变更

最佳实践

  1. 先规划后执行：用Plan Mode确认AI理解正确再动工
  2. 分步执行：不要一句话让它做完整个功能
  3. 定期Review：每做完一轮查看diff，不要等全部完成
  4. 善用CLAUDE.md：把项目约定写进去，减少重复说明
  5. 搭配Cursor使用：Cursor做日常编辑，Claude Code做复杂任务