Claude Code 官方命令行工具完全指南

Posted on Jan 10, 2026

引言

Claude Code 是什么？

Claude Code 是 Anthropic 开发的官方命令行工具，它将 Claude 的智能代码能力无缝融入开发环境。您可以在终端中直接与 AI 协作，完成编码、调试、代码审查、文档撰写等各类开发任务。

核心能力一览

智能代码助手：读取、编辑、创建文件，理解代码逻辑
项目智能感知：通过上下文理解完整项目结构和依赖关系
多工具集成：内置 Bash、Git、文件操作等实用工具
分层代理架构：支持Sub-agents处理特定类型的复杂任务
MCP 扩展系统：通过MCP协议集成外部工具和数据源
Skills工作流：定义可复用的任务流程

典型应用场景

快速原型开发和 MVP 实现
遗留代码重构与现代化改造
Bug诊断和修复
单元测试和集成测试生成
技术文档和技术规范编写
代码质量审查和优化建议
技术栈升级和迁移

快速入门

环境准备与安装

系统要求

Node.js 18.0.0 或更高版本
npm 或 pnpm 包管理器
可访问互联网（用于 API 调用）

安装步骤

在 Terminal 或命令提示符中执行：

# 标准安装
npm install -g @anthropic-ai/claude-code

# 国内用户推荐使用镜像加速
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

权限说明：如遇权限问题，请以管理员身份运行终端。

验证安装结果

claude --version

正常显示版本号即表示安装成功。

首次配置

1. API 密钥配置

# 交互式配置（推荐）
claude auth login

# 或手动配置，查看配置文件路径
claude config path
# Windows: %USERPROFILE%\\.claude\\config.json
# macOS/Linux: ~/.claude/config.json

2. 基础配置示例

{
  "apiKey": "sk-ant-xxxxxxxxxxxxxxxx",
  "model": "claude-3-5-sonnet-20241022",
  "maxTokens": 100000,
  "temperature": 0.3
}

保持更新

# 自动更新到最新版本
claude update

# 或通过 npm 更新
npm update -g @anthropic-ai/claude-code

开始您的第一个会话

启动交互模式

# 在当前目录启动
claude

# 指定项目目录
claude --cwd /path/to/your-project

# YOLO模式
claude --dangerously-skip-permissions

实用命令演示

# 生成代码
> 创建一个验证身份证格式的 JavaScript 函数

# 代码分析
> 解释 src/api/auth.js 中的认证实现逻辑

# 代码重构
> 将 components/DataTable.jsx 的类组件转换为函数式组件

Claude Code 核心架构解析

工具系统深度剖析

Claude 通过以下工具与您的开发环境交互：

1. 文件操作工具集

Read：获取文件内容，支持大文件分块读取
Write：创建新文件，自动处理路径和编码
Edit：智能修改现有文件，支持多位置同时编辑
Glob：通过 Glob 模式匹配和查找文件
Glob：通过 Grep 搜索内容

应用示例：

> 分析项目的 package.json，列出所有生产依赖及其最新版本
# Claude 会读取、解析文件，并调用网络工具获取版本信息

2. Shell 命令工具

Bash 执行：运行任意 shell 命令
进程管理：启动、监控、终止后台进程

> 安装项目依赖并启动开发服务器
# 依次执行：npm install、npm run dev

3. Git 工作流集成

智能识别 Git 仓库状态
自动生成合理的提交信息
支持分支管理、合并、PR 创建

> 为登录功能创建feature/01_login，包含合理的提交历史

4. 代码智能感知（LSP）

goToDefinition：快速定位函数、类、变量的定义位置
findReferences：查找代码中所有使用该符号的位置
hover：显示类型信息、文档注释
documentSymbol：列出指定文件中的重要符号

5. 网络资源工具

WebFetch：读取在线文档、API 参考
WebSearch：查找技术解决方案、库文档

智能代理系统（Agents）

主代理（Main Agent）

与用户直接对话
任务分析和拆分给子代理
结果汇总和呈现子代理结果
对话状态管理

专业子代理（执行者）

代理类型	职责范围	权限级别
探索代理（general-purpose）	代码库探索、文件查找、模式匹配	全工具访问
规划代理（Explore）	架构设计、实施方案制定、风险评估	全工具访问
通用代理（Plan）	复杂多步骤任务、代码分析、问题解决	全工具访问
指南代理（claude-code-guide）	Claude Code 使用指导、最佳实践建议	受限工具集

代理协作模式

快捷键触发：Ctrl+B - 将当前任务委派给最适合的子代理

工作流程示例：

# 用户输入复杂需求
> 找出项目中所有未处理的 Promise 和可能的内存泄漏

# 按下 Ctrl+B，主代理：
# 1. 分析任务需求
# 2. 选择探索代理处理
# 3. 探索代理在后台执行：
#    - 全局搜索 async/await 用法
#    - 检查 .then()/.catch() 模式
#    - 分析事件监听器清理
#    - 检查定时器管理
# 4. 返回结构化的分析报告
# 5. 主代理呈现摘要和建议

计划模式（Plan Mode）工作机制

面对复杂任务时，Claude 会进入结构化的问题解决模式：

触发条件检测 → 代码库探索 → 方案设计 → 用户确认 → 分步执行

# 用户请求
> 在现有 Vue 项目中集成 TypeScript

# Claude 进入计划模式：
1. 📋 **探索阶段**
   - 扫描项目结构
   - 分析现有配置
   - 识别依赖关系

2. 🏗️ **设计阶段**
   - 制定迁移路线图
   - 评估风险点
   - 准备回滚方案

3. ✅ **确认阶段**
   [Claude 显示详细计划]
   > 计划包含以下步骤：
   > 1. 安装 TypeScript 和类型定义
   > 2. 配置 tsconfig.json
   > 3. 逐步转换 .js 文件为 .ts
   > 4. 更新构建配置
   > 确认执行此计划？[Y/n]

4. 🔨 **执行阶段**
   - 按批准的计划分步执行
   - 每步完成后验证
   - 遇到问题自动调整

高效的上下文管理策略

上下文管理是优化 Claude Code 体验的关键。合理管理上下文可以显著提升响应速度、减少token消耗、减少低 API 成本。

策略一：卸载静态信息（Offload）

将稳定的项目信息从动态对话中分离出来。

CLAUDE.md - 项目智能名片

在项目根目录创建 CLAUDE.md，作为 Claude 的"项目入职手册"：


# 项目：电商后台管理系统

## 🎯 核心目标
为中小电商提供完整的商品、订单、用户管理后台。

## 🛠️ 技术架构
- **前端框架**: Vue 3 + Composition API + TypeScript
- **构建工具**: Vite 5
- **状态管理**: Pinia（已弃用 Vuex）
- **UI 组件库**: Element Plus 2.3+
- **路由管理**: Vue Router 4（使用历史模式）
- **HTTP 客户端**: Axios（统一封装在 @/api）
- **工具函数库**: Lodash-es、dayjs、@/utils

## 📁 项目结构


src/
├── api/           # API 请求封装（按模块组织）
├── assets/        # 静态资源
├── components/    # 通用组件
│   ├── common/    # 全局通用组件
│   └── business/  # 业务组件
├── composables/   # Composition 函数
├── layouts/       # 布局组件
├── router/        # 路由配置
├── store/         # Pinia Store 模块
├── styles/        # 全局样式（使用 SCSS）
├── types/         # TypeScript 类型定义
├── utils/         # 工具函数
└── views/         # 页面视图


## 📝 编码规范
### 命名约定
- 组件：PascalCase（如 `UserProfileCard.vue`）
- 组合函数：camelCase，前缀 `use`（如 `usePagination`）
- 工具函数：camelCase，按功能分组
- CSS 类名：BEM 规范

### 代码风格
- 使用 ES2022+ 特性（可选链、空值合并）
- 优先使用 Composition API
- TypeScript 严格模式启用
- 禁用 `any` 类型，使用精确类型

### 文件组织
- 单文件组件不超过 400 行
- 复杂组件拆分为子组件
- 工具函数按领域分组

## 🔧 开发工作流
### 环境变量

VITE_API_BASE=/api          # API 基础路径
VITE_APP_TITLE=电商管理后台   # 应用标题


### 常用命令

pnpm dev        # 开发服务器
pnpm build      # 生产构建
pnpm preview    # 构建预览
pnpm lint       # 代码检查
pnpm type-check # 类型检查
pnpm test:unit  # 单元测试

⚠️ 注意事项

权限系统：@/permission 处理路由守卫和按钮权限
错误处理：统一错误处理在 @/utils/errorHandler