Claude Code 命令行完全指南从高效交互到自动化工作流1 Claude Code 是什么1.1 安装与首次配置2 核心命令与交互模式2.1 交互式对话2.2 单次执行模式2.3 文件与上下文管理2.4 会话控制3 进阶使用技巧3.1 利用 Shell 权限分级实现安全自动化3.2 自定义斜杠命令Custom Slash Commands3.3 MCP 工具集成3.4 管道与组合4 实战工作流4.1 代码审查自动化4.2 交互式重构4.3 测试生成与补全5 最佳实践与常见陷阱5.1 Token 经济性管理5.2 版本控制习惯5.3 持续更新1 Claude Code 是什么Claude Code 是 Anthropic 推出的官方命令行开发助手工具将 Claude 的代码理解、生成与推理能力直接嵌入终端。它不只是“命令行版 ChatGPT”更是一个能够读取项目文件、执行 Shell 命令、编辑代码、管理 Git 提交的智能编程代理。相比网页版或 IDE 插件CLI 版本的最大优势在于完全键盘驱动、高度可脚本化、轻松嵌入 CI/CD 流水线以及可以对整个代码仓库进行深度上下文分析。1.1 安装与首次配置1.1.1 安装方式推荐使用 npm 全局安装npminstall-ganthropic-ai/claude-code安装完成后在终端输入claude即可进入交互界面。首次运行会要求通过浏览器或 API Key 完成 Anthropic 账号认证。对于无浏览器的服务器环境可以提前设置环境变量exportANTHROPIC_API_KEYsk-ant-...随后执行claude时会直接使用该密钥。1.1.2 基础配置优化安装后建议立刻执行claude config进入配置界面按需调整默认模型如claude-sonnet-4-20250514是否允许自动执行 Shell 命令权限控制主题与编辑器偏好有经验的用户可直接修改~/.claude.json例如为特定项目设置系统提示词{projects:{/home/user/myapp:{systemPrompt:你是一个 Rust 后端专家回答简洁优先使用异步写法。}}}这样每次在该目录下启动 Claude Code都会自动加载定制指令。2 核心命令与交互模式2.1 交互式对话直接输入claude进入 REPL 循环。此时你可以像聊天一样提问但 Claude Code 的真正威力在于它能“看见”你的项目。尝试问“解释src/auth.rs的认证流程用流程图描述”Claude 会自动读取相关文件并给出分析。如果它需要查看更多文件会主动执行View命令你只需按y批准。2.2 单次执行模式在脚本或 CI 中使用-pprint模式非交互式执行claude-p检查 src/ 下所有 Python 文件的类型注解完整性输出不完整的文件列表配合--output-format json可以得到结构化输出方便下游工具解析claude-p列出项目中的 TODO 注释并归类--output-format jsontodos.json2.3 文件与上下文管理Claude Code 启动时会自动索引当前目录的文件结构。你可以通过符号快速引用文件 src/db/models.py 把 User 表的时间字段改为带时区的 datetime也可以拖入多个文件路径或使用通配符表达式如src/**/*.rs批量加载上下文。对于大型项目建议用.claudeignore文件排除node_modules、target等目录避免消耗过多 Token。2.4 会话控制claude --resume恢复上一次会话/clear清空当前对话历史保留文件上下文claude --session-name review-20250607创建命名会话方便在多个任务间切换经验技巧每次重构任务开启新会话避免历史对话污染模型的判断而在调试复杂 Bug 时使用--resume让模型记住已排查过的路径效率更高。3 进阶使用技巧3.1 利用 Shell 权限分级实现安全自动化Claude Code 提供了精细的权限控制可在~/.claude.json中配置permissions:{allow:[Bash(git:*),Bash(npm:run:test),Bash(cargo:check,clippy)],deny:[Bash(rm:*),Bash(sudo:*)]}这样在非交互模式下 Claude 也能自动执行git status、npm run test等安全操作而高危命令依然需要手动确认。推荐在 CI 中使用只读权限加白名单脚本实现自动代码审查。3.2 自定义斜杠命令Custom Slash Commands在项目根目录创建.claude/commands/文件夹放置.md文件即可定义/命令。例如创建.claude/commands/review.md请对当前分支的改动进行代码审查按照以下维度打分1-10 - 逻辑正确性 - 可读性 - 性能隐患 - 安全性 输出表格并给出改进建议。然后在 Claude Code 中输入/review它会读取该模板并结合git diff执行。这相当于将你的常用审查标准固化为可复用指令团队统一使用能大幅提升代码质量的一致性。3.3 MCP 工具集成Claude Code 原生支持 Model Context Protocol (MCP)可以连接外部工具如数据库、Jira、文件系统搜索等。配置方式claude mcpadd--transportstdio myserver -- /path/to/server或直接在~/.claude.json的mcpServers字段添加服务器。一个高效实践是部署一个只读的 PostgreSQL MCP 服务器让 Claude 直接查询数据库 Schema 和样例数据生成准确的数据迁移脚本或 ORM 模型定义彻底杜绝“凭空想象表结构”的问题。3.4 管道与组合Claude Code 的标准输入输出完全遵循 Unix 哲学可以轻松与其它命令组合# 将日志输入 Claude 进行根因分析tail-n100/var/log/app.log|claude-p分析这些日志找出错误原因并给出修复建议# 对 git diff 内容进行自动 commit message 生成gitdiffHEAD~1|claude-p根据变更生成一条 Conventional Commits 格式的提交信息这种管道能力让 Claude Code 成为脚本工具链中的一等公民而非孤立的聊天界面。4 实战工作流4.1 代码审查自动化在 Pull Request 触发时运行claude-p$(catEOF 你是一个严格的代码审查者。以下是 PR 的完整 diff:$(gitdifforigin/main...HEAD)请输出 1. 高风险问题必须修改 2. 建议改进可读性/性能 3. 测试覆盖是否充分 使用中文回答。 EOF)--output-format jsonreview-result.json解析 JSON 后自动将审查意见贴到 PR 评论实现 7×24 自动 Review。4.2 交互式重构对于复杂重构先用交互模式探索 src/old_module/ 把这个模块拆成三个子模块分别处理输入、转换、输出。先列出计划。审阅计划然后说“执行”Claude 会自动创建新文件、移动代码、更新mod.rs并运行测试验证。整个过程中你可以随时打断修正方向就像和一个资深工程师结对编程。4.3 测试生成与补全 src/services/order.rs 为 OrderService 的所有公共方法生成单元测试使用 mockall 模拟依赖覆盖正常路径和两个异常路径Claude 会读取现有代码风格生成符合项目规范的测试代码并写入文件。之后只需运行cargo test或pytest确认通过率通常能一次达到 80% 以上的覆盖率补充。5 最佳实践与常见陷阱5.1 Token 经济性管理使用.claudeignore排除无关文件避免索引巨型目录对话过长时主动/clear否则回答质量会因上下文稀释而下降单次执行模式尽量给出精确的文件范围src/auth/*.ts而非整个项目5.2 版本控制习惯在让 Claude Code 执行大规模修改前务必git stash或创建新分支。尽管它支持撤销但 Git 才是最可靠的保护网。建议在提交前总是用git diff审查变更模型有时会做出意料之外但逻辑自洽的修改。5.3 持续更新Claude Code 迭代极快新功能和模型能力每月都在提升。保持npm update -g anthropic-ai/claude-code的习惯并关注官方的 Changelog。同时社区会涌现新的 MCP 服务器与斜杠命令模板定期收集融入自己的工作流能让你的开发效率持续进化。结语Claude Code 的命令行版本远不止是一个对话客户端它是一个可编程、可集成、可定制的智能开发平台。从单次问答到自动化流水线从个人提效到团队标准化掌握这些命令与技巧你将真正拥有一个 24 小时待命的 AI 编程搭档。开始动手尝试让终端成为你与 Claude 协作的最强阵地。
Claude Code 命令行完全指南：从高效交互到自动化工作流
发布时间：2026/6/8 6:55:28
Claude Code 命令行完全指南从高效交互到自动化工作流1 Claude Code 是什么1.1 安装与首次配置2 核心命令与交互模式2.1 交互式对话2.2 单次执行模式2.3 文件与上下文管理2.4 会话控制3 进阶使用技巧3.1 利用 Shell 权限分级实现安全自动化3.2 自定义斜杠命令Custom Slash Commands3.3 MCP 工具集成3.4 管道与组合4 实战工作流4.1 代码审查自动化4.2 交互式重构4.3 测试生成与补全5 最佳实践与常见陷阱5.1 Token 经济性管理5.2 版本控制习惯5.3 持续更新1 Claude Code 是什么Claude Code 是 Anthropic 推出的官方命令行开发助手工具将 Claude 的代码理解、生成与推理能力直接嵌入终端。它不只是“命令行版 ChatGPT”更是一个能够读取项目文件、执行 Shell 命令、编辑代码、管理 Git 提交的智能编程代理。相比网页版或 IDE 插件CLI 版本的最大优势在于完全键盘驱动、高度可脚本化、轻松嵌入 CI/CD 流水线以及可以对整个代码仓库进行深度上下文分析。1.1 安装与首次配置1.1.1 安装方式推荐使用 npm 全局安装npminstall-ganthropic-ai/claude-code安装完成后在终端输入claude即可进入交互界面。首次运行会要求通过浏览器或 API Key 完成 Anthropic 账号认证。对于无浏览器的服务器环境可以提前设置环境变量exportANTHROPIC_API_KEYsk-ant-...随后执行claude时会直接使用该密钥。1.1.2 基础配置优化安装后建议立刻执行claude config进入配置界面按需调整默认模型如claude-sonnet-4-20250514是否允许自动执行 Shell 命令权限控制主题与编辑器偏好有经验的用户可直接修改~/.claude.json例如为特定项目设置系统提示词{projects:{/home/user/myapp:{systemPrompt:你是一个 Rust 后端专家回答简洁优先使用异步写法。}}}这样每次在该目录下启动 Claude Code都会自动加载定制指令。2 核心命令与交互模式2.1 交互式对话直接输入claude进入 REPL 循环。此时你可以像聊天一样提问但 Claude Code 的真正威力在于它能“看见”你的项目。尝试问“解释src/auth.rs的认证流程用流程图描述”Claude 会自动读取相关文件并给出分析。如果它需要查看更多文件会主动执行View命令你只需按y批准。2.2 单次执行模式在脚本或 CI 中使用-pprint模式非交互式执行claude-p检查 src/ 下所有 Python 文件的类型注解完整性输出不完整的文件列表配合--output-format json可以得到结构化输出方便下游工具解析claude-p列出项目中的 TODO 注释并归类--output-format jsontodos.json2.3 文件与上下文管理Claude Code 启动时会自动索引当前目录的文件结构。你可以通过符号快速引用文件 src/db/models.py 把 User 表的时间字段改为带时区的 datetime也可以拖入多个文件路径或使用通配符表达式如src/**/*.rs批量加载上下文。对于大型项目建议用.claudeignore文件排除node_modules、target等目录避免消耗过多 Token。2.4 会话控制claude --resume恢复上一次会话/clear清空当前对话历史保留文件上下文claude --session-name review-20250607创建命名会话方便在多个任务间切换经验技巧每次重构任务开启新会话避免历史对话污染模型的判断而在调试复杂 Bug 时使用--resume让模型记住已排查过的路径效率更高。3 进阶使用技巧3.1 利用 Shell 权限分级实现安全自动化Claude Code 提供了精细的权限控制可在~/.claude.json中配置permissions:{allow:[Bash(git:*),Bash(npm:run:test),Bash(cargo:check,clippy)],deny:[Bash(rm:*),Bash(sudo:*)]}这样在非交互模式下 Claude 也能自动执行git status、npm run test等安全操作而高危命令依然需要手动确认。推荐在 CI 中使用只读权限加白名单脚本实现自动代码审查。3.2 自定义斜杠命令Custom Slash Commands在项目根目录创建.claude/commands/文件夹放置.md文件即可定义/命令。例如创建.claude/commands/review.md请对当前分支的改动进行代码审查按照以下维度打分1-10 - 逻辑正确性 - 可读性 - 性能隐患 - 安全性 输出表格并给出改进建议。然后在 Claude Code 中输入/review它会读取该模板并结合git diff执行。这相当于将你的常用审查标准固化为可复用指令团队统一使用能大幅提升代码质量的一致性。3.3 MCP 工具集成Claude Code 原生支持 Model Context Protocol (MCP)可以连接外部工具如数据库、Jira、文件系统搜索等。配置方式claude mcpadd--transportstdio myserver -- /path/to/server或直接在~/.claude.json的mcpServers字段添加服务器。一个高效实践是部署一个只读的 PostgreSQL MCP 服务器让 Claude 直接查询数据库 Schema 和样例数据生成准确的数据迁移脚本或 ORM 模型定义彻底杜绝“凭空想象表结构”的问题。3.4 管道与组合Claude Code 的标准输入输出完全遵循 Unix 哲学可以轻松与其它命令组合# 将日志输入 Claude 进行根因分析tail-n100/var/log/app.log|claude-p分析这些日志找出错误原因并给出修复建议# 对 git diff 内容进行自动 commit message 生成gitdiffHEAD~1|claude-p根据变更生成一条 Conventional Commits 格式的提交信息这种管道能力让 Claude Code 成为脚本工具链中的一等公民而非孤立的聊天界面。4 实战工作流4.1 代码审查自动化在 Pull Request 触发时运行claude-p$(catEOF 你是一个严格的代码审查者。以下是 PR 的完整 diff:$(gitdifforigin/main...HEAD)请输出 1. 高风险问题必须修改 2. 建议改进可读性/性能 3. 测试覆盖是否充分 使用中文回答。 EOF)--output-format jsonreview-result.json解析 JSON 后自动将审查意见贴到 PR 评论实现 7×24 自动 Review。4.2 交互式重构对于复杂重构先用交互模式探索 src/old_module/ 把这个模块拆成三个子模块分别处理输入、转换、输出。先列出计划。审阅计划然后说“执行”Claude 会自动创建新文件、移动代码、更新mod.rs并运行测试验证。整个过程中你可以随时打断修正方向就像和一个资深工程师结对编程。4.3 测试生成与补全 src/services/order.rs 为 OrderService 的所有公共方法生成单元测试使用 mockall 模拟依赖覆盖正常路径和两个异常路径Claude 会读取现有代码风格生成符合项目规范的测试代码并写入文件。之后只需运行cargo test或pytest确认通过率通常能一次达到 80% 以上的覆盖率补充。5 最佳实践与常见陷阱5.1 Token 经济性管理使用.claudeignore排除无关文件避免索引巨型目录对话过长时主动/clear否则回答质量会因上下文稀释而下降单次执行模式尽量给出精确的文件范围src/auth/*.ts而非整个项目5.2 版本控制习惯在让 Claude Code 执行大规模修改前务必git stash或创建新分支。尽管它支持撤销但 Git 才是最可靠的保护网。建议在提交前总是用git diff审查变更模型有时会做出意料之外但逻辑自洽的修改。5.3 持续更新Claude Code 迭代极快新功能和模型能力每月都在提升。保持npm update -g anthropic-ai/claude-code的习惯并关注官方的 Changelog。同时社区会涌现新的 MCP 服务器与斜杠命令模板定期收集融入自己的工作流能让你的开发效率持续进化。结语Claude Code 的命令行版本远不止是一个对话客户端它是一个可编程、可集成、可定制的智能开发平台。从单次问答到自动化流水线从个人提效到团队标准化掌握这些命令与技巧你将真正拥有一个 24 小时待命的 AI 编程搭档。开始动手尝试让终端成为你与 Claude 协作的最强阵地。
