Claude Code CLI 完整使用指南

Claude Code 是 Anthropic 官方提供的命令行界面工具,让开发者能够在终端中直接与 Claude AI 进行交互。本文将详细介绍 Claude Code CLI 的所有命令和使用方法。

简介

Claude Code CLI 是一个强大的开发工具,它将 Claude AI 的能力直接集成到命令行环境中,为开发者提供智能代码辅助、项目管理、文档生成等功能。

安装与登录

安装 Claude Code CLI

1
2
3
4
5
# 使用 npm 安装
npm install -g @anthropic-ai/claude-code

# 或者使用 yarn
yarn global add @anthropic-ai/claude-code

登录账户

1
2
3
4
5
# 登录 Anthropic 账户
/login

# 登出账户
/logout

核心命令详解

目录与项目管理

/add-dir - 添加工作目录

1
/add-dir

添加一个新的工作目录到 Claude Code 的管理范围中,让 AI 能够理解和操作指定目录下的代码。

/init - 初始化项目文档

1
/init

在当前项目中创建一个新的 CLAUDE.md 文件,包含代码库的文档信息,帮助 Claude 更好地理解项目结构和上下文。

对话管理

/clear (reset, new) - 清除对话历史

1
/clear

清除当前的对话历史并释放上下文空间,开始一个全新的对话会话。

/compact - 压缩对话历史

1
2
3
/compact
# 或者带自定义摘要指令
/compact [summarization instructions]

清除对话历史但在上下文中保留摘要信息,可以自定义摘要的生成方式。

/rewind (checkpoint) - 恢复到之前的状态

1
/rewind

将代码和/或对话恢复到之前的某个时间点,支持创建和管理检查点。

/resume - 恢复对话

1
/resume

恢复之前的对话会话,继续之前的工作。

配置与定制

/config (theme) - 配置面板

1
/config

打开配置面板,允许用户自定义各种设置选项。

/model - 设置AI模型

1
/model

设置 Claude Code 使用的 AI 模型,支持在不同模型间切换。

/output-style - 设置输出样式

1
/output-style

直接设置或从选择菜单中选择输出样式,定制 Claude 的回复格式。

/output-style:new - 创建自定义输出样式

1
/output-style:new

创建一个新的自定义输出样式,完全按照个人喜好定制 Claude 的显示效果。

/permissions (allowed-tools) - 管理工具权限

1
/permissions

管理允许和拒绝的工具权限规则,控制 Claude 可以使用的工具范围。

/statusline - 状态栏设置

1
/statusline

设置 Claude Code 的状态栏用户界面,显示当前状态信息。

/vim - Vim模式切换

1
/vim

在 Vim 编辑模式和普通编辑模式之间切换。

系统与状态

/status - 显示状态信息

1
/status

显示 Claude Code 的详细状态,包括版本号、当前模型、账户信息、API 连接状态和工具状态。

/context - 可视化上下文使用

1
/context

以彩色网格的形式可视化当前上下文的使用情况,帮助了解剩余的对话容量。

/cost - 显示会话成本

1
/cost

显示当前会话的总成本和持续时间,帮助监控 API 使用情况。

/usage - 显示计划使用限制

1
/usage

显示当前计划的使用限制和已使用量,了解账户的配额情况。

/doctor - 诊断安装

1
/doctor

诊断并验证 Claude Code 的安装和设置,检查是否有配置问题。

/upgrade - 升级到高级版

1
/upgrade

升级到 Max 计划以获得更高的速率限制和更多 Opus 访问权限。

开发与集成

/agents - 管理代理配置

1
/agents

管理代理配置,设置和自定义各种 AI 代理的行为。

/hooks - 管理钩子配置

1
/hooks

管理工具事件的钩子配置,在特定事件发生时执行自定义操作。

/ide - IDE集成管理

1
/ide

管理 IDE 集成并显示状态,将 Claude Code 与各种代码编辑器集成。

/install-github-app - 安装GitHub应用

1
/install-github-app

为仓库设置 Claude GitHub Actions,实现自动化工作流。

/mcp - 管理MCP服务器

1
/mcp

管理 MCP (Model Context Protocol) 服务器,扩展 Claude Code 的功能。

/plugin (plugins) - 管理插件

1
/plugin

管理 Claude Code 插件,安装和配置各种扩展功能。

/terminal-setup - 终端设置

1
/terminal-setup

安装 Shift+Enter 键绑定用于换行,改善终端中的输入体验。

任务与背景管理

/bashes - 管理后台任务

1
/bashes

列出和管理后台运行的任务,支持查看和控制长时间运行的命令。

/todos - 列出待办事项

1
/todos

列出当前的待办事项,跟踪和管理任务进度。

代码审查与安全

/review - 审查拉取请求

1
/review

对 GitHub 拉取请求进行代码审查,提供智能化的代码分析。

/security-review - 安全审查

1
/security-review

对当前分支上的待更改进行完整的安全审查,识别潜在的安全问题。

/pr-comments - 获取PR评论

1
/pr-comments

从 GitHub 拉取请求中获取评论信息。

数据与导出

/export - 导出对话

1
/export

将当前对话导出到文件或剪贴板,方便保存和分享。

/memory - 编辑记忆文件

1
/memory

编辑 Claude 的记忆文件,存储长期信息和偏好设置。

帮助与反馈

/help - 显示帮助信息

1
/help

显示帮助信息和所有可用命令的说明。

/feedback (bug) - 提交反馈

1
/feedback

提交关于 Claude Code 的反馈或报告错误。

/release-notes - 查看发布说明

1
/release-notes

查看最新版本的发布说明和更新内容。

其他命令

/exit (quit) - 退出程序

1
2
3
/exit
# 或
/quit

退出 Claude Code REPL 环境。

/migrate-installer - 迁移安装

1
/migrate-installer

从全局 npm 安装迁移到本地安装。

使用技巧

1. 高效的上下文管理

  • 使用 /compact 在长对话中保持重要信息
  • 定期使用 /clear 释放上下文空间
  • 使用 /context 监控上下文使用情况

2. 工作流程优化

  • 使用 /init 为项目创建文档
  • 配置 /hooks 自动化常见任务
  • 利用 /agents 创建专门的工作助手

3. 成本控制

  • 使用 /cost/usage 监控 API 使用
  • 合理使用模型选择功能
  • 优化对话长度以控制成本

4. 集成开发环境

  • 配置 /ide 与你喜欢的编辑器集成
  • 使用 /terminal-setup 改善终端体验
  • 通过 /install-github-app 实现 CI/CD 集成

最佳实践

  1. 项目初始化:开始新项目时使用 /init 创建项目文档
  2. 定期检查:使用 /doctor 定期检查系统状态
  3. 权限管理:通过 /permissions 合理配置工具权限
  4. 备份重要对话:使用 /export 保存重要的对话内容
  5. 保持更新:定期使用 /release-notes 了解新功能

总结

Claude Code CLI 是一个功能强大的开发工具,通过这些命令,开发者可以大大提高编程效率,实现智能化的代码开发和项目管理。掌握这些命令的使用方法,将帮助你在开发过程中充分利用 AI 的能力,创造更好的编程体验。

无论是日常的代码编写、项目管理,还是复杂的代码审查和安全检查,Claude Code CLI 都能提供相应的功能支持。建议根据实际需求选择合适的命令,逐步将其集成到你的开发工作流中。