Claude命令行完全指南：终端中的AI编程助手

2401_89369057

2359人浏览 · 2026-03-19 18:13:19

2401_89369057 · 2026-03-19 18:13:19 发布

引言
Claude Code是Anthropic公司推出的命令行界面工具，让Claude AI直接融入你的日常开发工作流。它不是一个聊天窗口，也不是新的IDE，而是运行在你熟悉的终端环境中，能理解项目结构、执行操作并提出建议的智能助手。本文将全面梳理Claude的命令行命令，帮助你把这个强大的AI工具变成开发中的得力伙伴。

一、安装与基础启动命令

在使用Claude命令行之前，首先需要完成安装。Claude Code支持多种安装方式：

系统	安装命令	说明
macOS/Linux	`curl -fsSL https://claude.ai/install.sh \| bash`	官方安装脚本
Windows PowerShell	`irm https://claude.ai/install.ps1 \| iex`	官方安装脚本
已有Node.js	`npm install -g @anthropic-ai/claude-code`	需要Node.js 18+

安装完成后，可以通过以下命令验证是否成功：

bash

claude --version

核心启动命令：

命令	示例	说明
`claude`	`claude`	启动标准交互式REPL环境
`claude "prompt"`	`claude "解释这个文件的功能"`	启动时直接携带特定问题
`claude -p "query"`	`claude -p "检查错误"`	打印响应后退出，非交互模式，适合脚本
`claude -c` / `--continue`	`claude -c`	继续当前目录中最近的一次对话
`claude -r "session_id"`	`claude -r "abc123" "完成这个PR"`	通过会话ID恢复特定对话
`claude --resume`	`claude --resume`	恢复最后一次会话

二、启动参数与配置标志

Claude Code提供了丰富的启动参数，让你可以根据需求定制行为：

标志	功能描述	示例用法
`--add-dir`	添加额外的工作目录供Claude访问	`claude --add-dir ../lib ../apps`
`--model`	指定当前会话使用的模型	`claude --model opus`
`--verbose`	启用详细日志记录	`claude --verbose`
`--dangerously-skip-permissions`	跳过所有权限检查	`claude --dangerously-skip-permissions`（仅限隔离环境）
`--output-format json`	输出JSON格式	`claude -p "查询" --output-format json`
`--max-turns N`	限制代理循环次数	`claude --max-turns 10`
`claude config`	配置偏好设置	`claude config set theme dark`

管道模式示例：

bash

cat logs.txt | claude -p "解释这些日志中的错误"

这种非交互模式非常适合处理管道内容，将文件内容直接传递给Claude进行分析。

三、内置斜杠命令（Slash Commands）

在交互式会话中，斜杠命令是控制Claude Code行为的主要方式。以下是最常用的内置命令：

命令	功能描述	使用场景
`/help`	显示所有可用命令	任何时候想查看命令列表
`/init`	创建`CLAUDE.md`记忆文件	首次在项目中使用
`/clear`	清除当前对话	切换话题时
`/compact [指令]`	压缩对话历史，释放上下文窗口	长会话时保持响应质量
`/cost`	显示当前会话的token消耗和费用	定期检查使用量
`/context`	手动添加文件或目录到上下文	处理Claude未自动浏览的文件
`/model`	切换模型	根据任务复杂度调整
`/memory`	编辑`CLAUDE.md`文件	更新项目约定和偏好
`/rewind`	撤销上一次对话及文件更改	当AI走错方向时
`/doctor`	诊断安装和环境问题	遇到异常行为时
`/plan`	激活计划模式	复杂多文件任务
`/status`	查看会话状态和token消耗	监控会话健康度
`/permissions`	查看或修改工具权限	调整安全级别
`/login` / `/logout`	管理认证	首次使用或切换账户
`/exit`	退出会话	结束工作
`/vim`	启用Vim编辑模式	习惯Vim操作的开发者
`/terminal-setup`	配置终端快捷键	在iTerm2或VS Code中安装Shift+Enter绑定
`/review`	发起代码审查	需要AI审核代码时
`/usage`	查看使用情况	监控额度

实用技巧：当压缩对话时，可以使用/compact focus on auth errors from the last two commits这样的指令，让摘要保留最重要的信息。

四、自定义斜杠命令

Claude Code支持创建自定义斜杠命令，将常用任务封装成一键命令，大幅节省时间。

存放位置

项目级命令：.claude/commands/目录
用户级命令：~/.claude/commands/目录

基本格式

创建一个Markdown文件，例如.claude/commands/refactor.md：

markdown

重构选中的代码以提高可读性。遵循我们的风格指南。

高级用法（带前置元数据）

markdown

---
allowed-tools: Read, Grep, Glob
description: 安全扫描
model: opus
---

扫描代码库中的密钥、SQL注入和XSS风险。

调用方式：/refactor 或 /security-scan

参数传递

使用$ARGUMENTS占位符捕获所有输入参数：

markdown

创建一篇文章，标题为 $ARGUMENTS：
1. 生成符合kebab-case格式的文件名
2. 使用Hugo命令创建新内容

调用：/posts:new 介绍Claude Code，介绍Claude Code会自动替换$ARGUMENTS

进阶：集成Bash命令

markdown

---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
description: 创建git提交
---

## 上下文
- 当前git状态：!`git status`
- 当前git差异：!`git diff HEAD`
- 当前分支：!`git branch --show-current`

## 任务
基于上述更改，创建单个git提交。

使用!前缀可以让AI在执行指令前先获取环境信息。

五、权限与配置命令

权限配置的核心目标是在自动化效率与系统安全之间找到平衡。

权限级别

级别	行为	适用场景
suggest	显示差异但不应用	代码审查
auto-edit	直接应用文件编辑	日常开发
full-auto	编辑+执行命令	自动化脚本
plan	执行前提出计划	复杂重构

配置文件

手动编辑项目级.claude/settings.json或用户级~/.claude.json：

json

{
  "skipPermissions": false,
  "allowedTools": ["read", "write"],
  "allowCommands": ["node ./scripts/setup.js"],
  "denyCommands": ["rm -rf /", "curl http://*"]
}

skipPermissions：是否跳过逐步确认
allowedTools：允许使用的工具清单
allowCommands/denyCommands：命令白名单/黑名单

管理命令

命令	功能
`/permissions`	添加或删除允许的工具
`claude mcp`	进入模型上下文协议服务器配置
`claude update`	将工具更新到最新版本

六、记忆文件（CLAUDE.md）

CLAUDE.md是Claude Code在不同会话中保留项目约定、编码风格的记忆文件。

记忆类型

项目级：项目根目录下的CLAUDE.md
用户级：~/.claude/CLAUDE.md
企业级：全局配置

创建与管理

/init：自动分析代码库结构，创建初始CLAUDE.md
/memory：在默认编辑器中打开CLAUDE.md进行编辑
在交互窗口中输入#即可触发记忆创建

示例内容

markdown

*** Workspace Structure
- All code is in `src`
- There is a dolt database running in `db`. Running `dolt sql` in that directory will connect to it.
- The `bin` directory is first in your path.

*** Removing Directories and Files
- When you suggest `rm` or `rm -rf` you must request permission and specify the full path.

*** Laws
- You may not injure a human being...

一个配置良好的CLAUDE.md文件能使重构任务的响应相关性提高25%。

七、快捷键与操作技巧

常用快捷键

快捷键	功能
`Ctrl+C`	取消当前输入或生成/退出
`Ctrl+D`	发送EOF信号安全退出
`Ctrl+L`	清屏（不删除对话历史）
`Tab`	切换扩展思考模式
`Shift+Tab` 或 `Alt+M`	切换权限模式
`Ctrl+R`	反向搜索历史命令
`↑` / `↓`	浏览历史命令
`Enter`	发送消息
`Escape`	取消当前编辑

多行输入

在行尾输入\加回车（或Shift+Enter）
macOS用户：Option+Enter

后台任务管理

在指令前加上!前缀进入Bash模式，运行耗时命令：

text

! npm test

如果任务运行时间较长，按Ctrl+B将其移至后台。AI会获得一个任务ID，并在任务完成后通过工具检索输出。

八、第三方扩展命令

社区为Claude Code开发了丰富的扩展命令集。例如@paulduvall/claude-dev-toolkit提供了58个AI驱动的自定义命令。

安装

bash

npm install -g @paulduvall/claude-dev-toolkit

常用扩展命令

命令	功能
`/xhelp`	列出所有可用命令
`/xtest`	智能测试运行器，带覆盖率分析
`/xquality`	代码质量检查（格式化、lint、类型检查）
`/xgit`	自动化的git工作流，AI生成提交信息
`/xdebug`	AI驱动的调试助手
`/xsecurity`	全面的漏洞扫描
`/xrefactor`	智能代码重构和坏味道检测
`/xarchitecture`	系统设计和架构分析
`/xdocs`	文档生成和维护
`/xpipeline`	CI/CD流水线优化

九、最佳实践工作流

Explore → Plan → Code 工作流

这是Anthropic推荐的与Claude Code交互的方法，能将迭代次数减少40%：

阶段	目标	示例命令
探索	理解代码	`claude "分析认证模块的结构，涉及哪些文件和依赖？"`
计划	规划步骤	`claude "提出从JWT迁移到服务器端会话的计划，列出要修改的文件和步骤顺序"`
编码	逐步实现	`claude "实施计划的第1步：创建会话中间件"`

有效提示的结构

一个有效的提示包含三个要素：上下文、意图、约束。

提示类型	结构	示例
❌ 模糊提示	"修复这个bug"	-
✅ 结构化提示	"LoginForm组件在邮箱包含+时崩溃。修复lib/validators.ts中的验证正则表达式，并为这种情况添加单元测试"	指定了目标文件、问题和约束

成本管理

一个45分钟的重构会话成本在$0.20到$0.80之间
主动与Claude交互时，每小时约花费$10
定期运行/cost监控使用情况

安全提示

使用--dangerously-skip-permissions时，最好在没有互联网访问的容器中使用，如Docker Dev Containers
通过allowedTools和denyCommands限制Claude的操作范围
定期使用/doctor检查环境健康度
在CLAUDE.md中明确删除目录和文件时需要请求权限并指定完整路径

结语
Claude Code将AI的强大能力带入了终端环境，让开发者可以在不离开命令行的情况下获得智能编程帮助。通过掌握本文介绍的命令和技巧，你可以将这个工具从一个简单的聊天窗口转变为深入代码逻辑、感知环境状态、并能自动化执行复杂任务的超级终端助手。随着使用的深入，Claude会逐渐"学习"你的项目规范和偏好，成为真正懂你的开发伙伴。