Claude命令行完全指南:终端中的AI编程助手
Claude Code支持创建自定义斜杠命令,将常用任务封装成一键命令,大幅节省时间。
引言
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会逐渐"学习"你的项目规范和偏好,成为真正懂你的开发伙伴。
更多推荐



所有评论(0)