Claude Code CLI 操作指南Claude Code 是 Anthropic 推出的命令行 AI 编程助手支持直接在终端中与 Claude 交互进行代码编写、调试、重构等操作。目录安装与环境配置基本使用斜杠命令 (Slash Commands)快捷键会话管理权限系统IDE 集成MCP 服务器Hooks 钩子系统配置文件详解高级功能常见问题与技巧1. 安装与环境配置1.1 系统要求操作系统: macOS、Linux、Windows (通过 WSL 或 Git Bash)Node.js: v18 或更高版本网络: 需要稳定的互联网连接1.2 安装方式方式一npm 全局安装推荐npminstall-ganthropic-ai/claude-code方式二直接运行无需安装npx anthropic-ai/claude-code方式三通过包管理器安装# Homebrew (macOS)brewinstallclaude-code# Scoop (Windows)scoopinstallclaude-code1.3 初始配置首次运行后执行以下步骤# 1. 启动 Claude Codeclaude# 2. 按照终端提示完成登录认证会打开浏览器# 3. 登录成功后返回终端即可开始使用1.4 环境变量变量名说明ANTHROPIC_API_KEY自定义 API 密钥优先级高于登录认证ANTHROPIC_BASE_URL自定义 API 端点地址CLAUDE_CODE_CONFIG_DIR配置文件目录默认~/.claude2. 基本使用2.1 启动# 在当前目录启动claude# 在指定目录启动claude /path/to/project# 直接带问题启动claude-p解释这个项目的结构# 非交互模式直接获取答案后退出claude-p这个项目中哪些函数处理用户认证# 管道模式将内容传入 Claude 分析caterror.log|claude-p分析这些错误日志gitdiff|claude-p审查这些代码变更2.2 常用命令行参数# 基本参数-p,--prompttext# 直接执行一次性提示后退出-c,--continue# 继续上一次会话-r,--resume[session_id]# 恢复指定会话--modelmodel# 指定模型--verbose# 详细输出模式--version# 显示版本号--help# 显示帮助信息# 工作区参数--add-dirdir# 添加额外的工作目录--allowedToolstools# 限制允许的工具--disallowedToolstools# 禁止的工具2.3 基本交互 帮我修复 log 模块中的索引越界错误 # 输入自然语言指令 /add-file src/main.py # 斜杠命令Claude 会自动读取项目文件理解代码上下文执行搜索、编辑、运行命令等操作展示修改内容等待你的确认根据权限设置3. 斜杠命令 (Slash Commands)在对话中输入/可以调出命令菜单。以下是完整列表3.1 会话控制命令说明/clear清空当前会话历史/compact压缩会话上下文自动总结/context查看当前上下文窗口使用情况/cost查看当前会话的 token 使用量和费用3.2 模型控制命令说明/model查看或切换当前模型/fast切换快速模式/debug切换调试模式3.3 权限控制命令说明/login重新登录 / 切换账户/logout登出当前账户/permissions管理工具权限设置3.4 任务与自动化命令说明/tasks查看当前后台任务/loop设置循环执行任务/cron管理定时任务3.5 代码审查与质量命令说明/code-review代码审查/security-review安全审查/simplify代码简化 / 重构/review审查 GitHub Pull Request/verify验证代码变更是否正确/run启动项目并验证变更3.6 配置与管理命令说明/config打开配置菜单/init为当前项目初始化 CLAUDE.md/setup重新运行初始设置/statusline配置状态栏显示/doctor诊断系统问题/update检查更新/upgrade升级到最新版本/workspace管理工作区目录3.7 其他功能命令说明/bug提交 Bug 报告/print打印当前对话/export导出对话记录/help显示帮助信息/resume查看可恢复的会话列表/memory管理记忆功能/stats查看使用统计4. 快捷键快捷键功能Enter发送消息Shift Enter换行多行输入Ctrl C中断当前操作Ctrl D退出 Claude CodeCtrl L清屏 (等同于/clear)Ctrl R搜索命令历史Ctrl U清除当前行Ctrl A跳到行首Ctrl E跳到行尾Ctrl K删除从光标到行尾↑ / ↓浏览历史命令Esc退出多行输入 / 取消操作Tab自动补全文件和目录5. 会话管理5.1 会话生命周期# 启动新会话claude# 继续上一次会话claude-c# 恢复指定 ID 的会话claude-rsession-id# 在一次性的非交互模式下执行claude-p创建一个 TODO 应用5.2 会话存储所有会话自动保存在~/.claude/projects/目录下按项目组织。# 查看所有会话ls~/.claude/projects/# 查看当前会话 ID/claude sessionid# 在当前会话中输入5.3 上下文管理Claude 的上下文窗口有上限当对话过长时会自动汇总。你可以使用/compact提前压缩上下文使用/context查看当前使用量使用/clear清空对话重新开始6. 权限系统Claude Code 使用多层权限机制来保护你的系统安全。6.1 权限模式模式说明默认模式每次执行工具前询问确认Allowlist 模式特定操作自动允许其他询问Plan 模式先制定计划确认后再执行6.2 权限配置层级全局设置 ~/.claude/settings.json (对所有项目生效) 项目设置 .claude/settings.json (对当前项目生效) 本地设置 .claude/settings.local.json (本地覆盖不提交到 Git)6.3 配置权限示例{permissions:{allow:[Bash(npm test),Bash(npm run *),Bash(git diff),Bash(git status),Read,Grep],deny:[Bash(rm -rf *),Bash(curl *)]}}7. IDE 集成Claude Code 支持集成到主流 IDE 中提供可视化交互体验。7.1 VS Code 集成# 在 VS Code 终端中使用 Claude Codecode --install-extension anthropic.claude-code安装后在 VS Code 中使用CtrlShiftP→ 输入 “Claude Code” 调出命令面板在侧边栏查看 Claude 对话面板选中代码后右键 → “Ask Claude”7.2 JetBrains (IntelliJ / WebStorm / PyCharm 等)在 JetBrains 市场中搜索并安装 Claude Code 插件。7.3 终端复用器集成# Tmux 中使用tmux new-session-sdev# 在一个 pane 中运行 claude另一个 pane 中运行你的服务# 或使用 Claude Code 内置的 tmux 集成claude--tmux8. MCP 服务器MCP (Model Context Protocol) 让 Claude 可以连接各类外部工具和数据源。8.1 什么是 MCPMCP 是 Anthropic 推出的开放协议允许 AI 模型通过标准化接口访问本地文件系统数据库API 服务第三方工具如 GitHub、Slack、Jira 等8.2 配置 MCP 服务器在~/.claude/claude_desktop_config.json或项目中的.claude/mcp.json配置{mcpServers:{filesystem:{command:npx,args:[-y,anthropic/mcp-server-filesystem,/path/to/allowed/dir]},github:{command:npx,args:[-y,anthropic/mcp-server-github],env:{GITHUB_TOKEN:your-token}},postgres:{command:npx,args:[-y,anthropic/mcp-server-postgres],env:{DATABASE_URL:postgresql://localhost/mydb}}}}8.3 常用 MCP 服务器服务器功能anthropic/mcp-server-filesystem安全访问文件系统anthropic/mcp-server-githubGitHub 仓库操作anthropic/mcp-server-postgresPostgreSQL 数据库anthropic/mcp-server-puppeteer浏览器自动化anthropic/mcp-server-slackSlack 消息和频道管理8.4 管理 MCP 服务器# 列出当前 MCP 服务器/mcp list# 在 Claude 对话中输入# 查看 MCP 服务器状态/mcp status9. Hooks 钩子系统Hooks 允许你在特定事件发生时自动执行自定义操作。9.1 支持的 Hook 事件事件触发时机PreToolUse工具执行前PostToolUse工具执行后Notification收到通知时StopClaude 停止响应时SubagentStop子代理停止时PreCompact上下文压缩前SessionStart会话开始时SessionEnd会话结束时9.2 配置 Hooks在settings.json中配置{hooks:{PostToolUse:[{matcher:Write,command:echo File was written: $FILE_PATH},{matcher:Edit,command:prettier --write $FILE_PATH}],PreToolUse:[{matcher:Bash(git push *),command:npm test}]}}9.3 Hook 实用场景{hooks:{PostToolUse:[{matcher:Write|Edit,command:npx prettier --write $FILE_PATH},{matcher:Write,command:git add $FILE_PATH}],SessionStart:[{command:echo Claude session started at $(date)}]}}10. 配置文件详解10.1 配置文件结构~/.claude/ ├── settings.json # 全局设置 ├── settings.local.json # 本地设置不提交 ├── credentials.json # 认证凭据 ├── keybindings.json # 自定义快捷键 ├── scheduled_tasks.json # 定时任务 ├── mcp.json # MCP 服务器配置 ├── CLAUDE.md # 全局 Clau 指令 ├── memory/ # 记忆存储 │ ├── MEMORY.md │ └── *.md └── projects/ └── project-hash/ └── session-id.jsonl # 会话记录10.2 项目级配置your-project/ ├── .claude/ │ ├── settings.json # 项目级设置 │ ├── settings.local.json # 项目本地设置 │ └── CLAUDE.md # 项目指令优先级高于 /CLAUDE.md └── CLAUDE.md # 备选项目指令位置10.3 CLAUDE.md 格式CLAUDE.md 是项目的系统提示文件用于告诉 Claude 关于项目的特殊规则和上下文# CLAUDE.md for MyProject ## 项目概述 这是一个使用 React TypeScript 构建的电商平台前端。 ## 技术栈 - React 18, TypeScript 5 - 状态管理Zustand - API 通信TanStack Query - 样式Tailwind CSS ## 编码规范 - 使用函数式组件禁止 class 组件 - 所有组件必须有 TypeScript 类型定义 - 使用 named export不使用 default export - 组件文件名使用 PascalCase ## 测试要求 - 单元测试覆盖率不低于 80% - 组件测试使用 React Testing Library - E2E 测试使用 Playwright ## 注意事项 - API 基础 URL 在 .env 文件中配置 - 不要直接修改 /api 目录自动生成10.4 settings.json 完整配置项{model:claude-sonnet-4-6,theme:dark,permissions:{allow:[Read,Grep],deny:[Bash(rm *)]},hooks:{},env:{NODE_ENV:development},statusLine:{type:model,autoRefresh:true},autoCompact:true,compactThreshold:0.8}11. 高级功能11.1 工作区管理# 添加额外的目录到工作区/add-dir /path/to/library# 查看工作区/workspace# 在对话中引用不同目录的文件比较 /src/utils 和 /lib/utils 中的实现11.2 后台任务# Claude 可以启动后台任务如运行测试服务器启动开发服务器并在后台运行# 查看后台任务/tasks# 停止后台任务/tasks stoptask-id11.3 定时任务 (Cron)# 创建定时任务每天早上 9 点运行测试并向我报告# 管理定时任务/cron list /cron deleteid11.4 循环任务 (Loop)# 每 5 分钟检查一次部署状态/loop 5m 检查部署状态# 使用 /loop 自动执行周期性任务/loop 30m /code-review11.5 管道与管道模式# 将命令输出传给 Claudenpmtest21|claude-p分析测试失败的原因# 将文件内容传给 Claudecatsrc/app.ts|claude-p检查这段代码的 bug# 结合 git 使用gitlog--oneline-20|claude-p为这些 commit 写一份 changelog11.6 自定义斜杠命令你可以在配置文件中添加自定义命令别名{customCommands:{review:/code-review,test:运行完整测试套件并报告结果}}11.7 Plan Mode计划模式计划模式让 Claude 在执行大型修改前先展示计划等你确认后再实施 /plan 重构用户认证模块Claude 会分析现有代码生成重构计划列出受影响的文件等你确认后才开始执行11.8 Memory记忆功能Claude Code 可以记住你告诉它的事项 /memory 记住我们使用 pnpm 而不是 npm /memory 记住API 密钥储存在 .env.local 中 /memory list # 查看所有记忆 /memory delete id # 删除指定记忆记忆文件储存在~/.claude/memory/目录中。11.9 多模型支持# 查看可用模型/model# 切换模型在对话中/model claude-sonnet-4-6# 启动时指定模型claude--modelclaude-fable-5# 可用模型及其特点# claude-fable-5 - 最强大适合复杂推理# claude-sonnet-4-6 - 平衡性能与速度默认# claude-haiku-4-5 - 最快适合简单任务12. 常见问题与技巧12.1 实用技巧技巧 1使用 CLAUDE.md 提效在项目根目录创建CLAUDE.md写入项目信息。每次启动 Claude 都会自动读取减少重复解释。技巧 2善用管道模式# 批量审查findsrc-name*.ts|xargscat|claude-p审查这些 TypeScript 文件的类型安全# 日志分析tail-fapp.log|claude-p实时监控并报告异常技巧 3会话复用# 完成一个任务后使用 -c 继续而不是重新开始claude-c技巧 4权限优化为频繁使用的命令配置自动允许减少确认操作{permissions:{allow:[Bash(git status),Bash(git diff),Bash(npm test),Bash(npm run lint)]}}12.2 故障排除问题解决方案无法登录运行claude --reauth或rm ~/.claude/credentials.json重试响应缓慢使用/fast切换快速模式或切换到 Haiku 模型上下文溢出使用/compact或/clear将大文件添加到.claudeignore权限拒绝检查settings.json中的 deny 列表工具执行失败确认 Node.js 版本 ≥18检查/doctor诊断输出乱码问题Windows 下建议使用 Windows Terminal 而非 cmd.exe12.3 .claudeignore 文件类似于.gitignore用于排除不需要 Claude 关注的文件# 排除 node_modules node_modules/ # 排除构建产物 dist/ build/ .next/ # 排除大型文件 *.zip *.tar.gz *.mp4 # 排除特定目录 coverage/ __pycache__/12.4 安全建议不要在敏感目录启动避免在/etc、~/.ssh等目录中使用使用 .claudeignore排除包含机密的文件审查权限设置确保 deny 列表覆盖危险操作定期检查会话记录确认没有意外暴露敏感信息使用 .env.local将 API 密钥放在.env.local并加入.gitignore12.5 团队最佳实践将 CLAUDE.md 纳入版本控制团队成员共享项目上下文统一 settings.json将项目级权限和 hooks 提交到仓库使用 settings.local.json个人偏好设置不放仓库编写 Hook 脚本统一团队的代码格式化和检查流程持续更新 CLAUDE.md项目架构变更时及时更新附录快速参考卡片# 启动与退出claude# 启动交互式会话claude-p提示# 单次执行claude-c# 继续上次会话Ctrl D# 退出# 会话中常用命令/clear# 清空上下文/compact# 压缩上下文/context# 查看上下文使用量/model# 查看/切换模型/fast# 快速模式开关/permissions# 权限管理/help# 帮助# 编辑与执行/add-dirpath# 添加工作目录/tasks# 后台任务/code-review# 代码审查/init# 初始化 CLAUDE.md# 配置/config# 打开配置菜单/doctor# 诊断问题/update# 检查更新提示: 本文档基于 Claude Code 最新版本编写。使用/help命令可以随时在终端中查看最新的帮助信息。官方文档: https://docs.anthropic.com/en/docs/claude-code反馈与支持: 在 Claude Code 中使用/bug提交问题或访问 https://github.com/anthropics/claude-code