Claude Code CLI 完全学习指南

从零开始掌握 Claude Code 命令行工具

项目简介

Claude Code 是 Anthropic 官方提供的命令行工具，让你直接在终端中使用 Claude 进行代码编写、调试、文件操作等。

本项目提供：

• 📚 完整文档 - CLI 参数、斜杠命令、配置文件等
• 🎮 互动游戏 - 25 关卡模拟终端学习（Vue 3 版本）
• 🔍 模糊搜索 - 快速查找任何命令
• 📋 速查表 - 常用命令快速参考

---

在线学习工具

工具	描述	技术栈	状态
Web 学习游戏	25 关卡互动学习	Vue 3 + Naive UI	✅ 推荐
原版游戏	Vanilla JS 实现	原生 JS	⚠️ 已废弃

---

快速开始

安装 Claude Code

# macOS
brew install --cask claude-code

# Linux
curl -fsSL https://claude.ai/install.sh | bash

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

运行学习游戏

cd web-game-vue
npm install
npm run dev
# 访问 http://localhost:8000

---

CLI 基础命令

# 启动交互式会话
claude

# 快速提问（非交互）
claude "解释这段代码"
claude -p "列出当前目录文件"

# 继续上次对话
claude -c

# 恢复特定会话
claude -r [session-id]

---

文档目录

章节	描述
CLI 参数	命令行启动参数完整参考
内置命令	斜杠命令（/help, /clear 等）
文件引用语法	@文件 和 #选择 语法
MCP 服务器	MCP 配置和管理
插件系统	插件安装和管理
速查表	常用命令快速参考
工作流示例	实用工作流示例

---

会话内命令

在 Claude Code 交互式会话中可用的命令：

命令	功能
/help	显示帮助信息
/clear	清除当前对话上下文
/commit	创建 Git 提交
/tasks	查看任务列表
/exit 或 Ctrl+D	退出会话

---

项目结构

claude-code-guide/
├── README.md              # 本文件
├── STATUS.md              # 项目状态追踪
├── web-game-vue/          # Vue 3 互动学习游戏（推荐）
│   ├── PROJECT.md         # 项目详细文档
│   ├── src/
│   │   ├── views/        # 页面组件
│   │   ├── components/   # SearchBox, TerminalComponent 等
│   │   └── data/         # 游戏数据和搜索数据
│   └── package.json
├── scripts/               # 工具脚本
│   ├── shell/            # Shell 脚本
│   └── python/           # Python 工具
├── docs/                  # 统一文档目录
│   ├── cli-arguments.md  # CLI 参数参考
│   ├── commands/         # 内置命令文档
│   ├── cheatsheet.md     # 速查表
│   └── examples.md       # 工作流示例
├── tests/                 # 测试文件
├── archive/               # 归档内容
│   └── web-game/         # 原版游戏（已废弃）
└── .claude/               # Claude Code 配置
    ├── agents/           # Agent 定义
    ├── hooks/            # 事件钩子
    └── skills/           # 自定义 Skills

---

核心概念

文件引用

# 引用单个文件
@src/main.py 解释这个文件

# 引用多个文件
@src/main.py @src/utils.py 它们如何协作

# 选择特定行
@src/main.py:15-30 这段代码做什么

# 使用 IDE 选择
# 先在 IDE 中选中代码，然后问：
解释 #selection 是什么意思

模型选择

# 使用别名
claude --model sonnet   # Claude 3.5 Sonnet
claude --model opus     # Claude 3 Opus
claude --model haiku    # Claude 3.5 Haiku

工具权限

Claude Code 在执行危险操作前会请求权限：

• Bash - 运行 shell 命令
• Write - 创建新文件
• Edit - 修改现有文件
• Network - 网络请求

---

参考资源

• 官方文档
• GitHub 仓库
• 发布页面

---

本项目

• GitHub: https://github.com/raven1997s/claude-code-guide
• 许可证: MIT

---

更新日志

• 2025-12-31: 目录重组，创建 scripts/, docs/, archive/, tests/ 目录，清理 .claude/skills-official/
• 2025-12-30: Vue 3 版本上线，修复所有搜索功能问题
• 初始版本: 原版 Vanilla JS 实现（已废弃）