Claude Code 命令行完全指南：从高效交互到自动化工作流

[1 Claude Code 是什么](#1 Claude Code 是什么)
- [1.1 安装与首次配置](#1.1 安装与首次配置)
[2 核心命令与交互模式](#2 核心命令与交互模式)
- [2.1 交互式对话](#2.1 交互式对话)
- [2.2 单次执行模式](#2.2 单次执行模式)
- [2.3 文件与上下文管理](#2.3 文件与上下文管理)
- [2.4 会话控制](#2.4 会话控制)
[3 进阶使用技巧](#3 进阶使用技巧)
- [3.1 利用 Shell 权限分级实现安全自动化](#3.1 利用 Shell 权限分级实现安全自动化)
- [3.2 自定义斜杠命令（Custom Slash Commands）](#3.2 自定义斜杠命令（Custom Slash Commands）)
- [3.3 MCP 工具集成](#3.3 MCP 工具集成)
- [3.4 管道与组合](#3.4 管道与组合)
[4 实战工作流](#4 实战工作流)
- [4.1 代码审查自动化](#4.1 代码审查自动化)
- [4.2 交互式重构](#4.2 交互式重构)
- [4.3 测试生成与补全](#4.3 测试生成与补全)
[5 最佳实践与常见陷阱](#5 最佳实践与常见陷阱)
- [5.1 Token 经济性管理](#5.1 Token 经济性管理)
- [5.2 版本控制习惯](#5.2 版本控制习惯)
- [5.3 持续更新](#5.3 持续更新)

1 Claude Code 是什么

Claude Code 是 Anthropic 推出的官方命令行开发助手工具，将 Claude 的代码理解、生成与推理能力直接嵌入终端。它不只是"命令行版 ChatGPT"，更是一个能够读取项目文件、执行 Shell 命令、编辑代码、管理 Git 提交的智能编程代理。相比网页版或 IDE 插件，CLI 版本的最大优势在于：完全键盘驱动、高度可脚本化、轻松嵌入 CI/CD 流水线，以及可以对整个代码仓库进行深度上下文分析。

1.1 安装与首次配置

1.1.1 安装方式

推荐使用 npm 全局安装：

bash 复制代码

npm install -g @anthropic-ai/claude-code

安装完成后，在终端输入 claude 即可进入交互界面。首次运行会要求通过浏览器或 API Key 完成 Anthropic 账号认证。对于无浏览器的服务器环境，可以提前设置环境变量：

bash 复制代码

export ANTHROPIC_API_KEY=sk-ant-...

随后执行 claude 时会直接使用该密钥。

1.1.2 基础配置优化

安装后建议立刻执行 claude config 进入配置界面，按需调整：

默认模型（如 claude-sonnet-4-20250514）
是否允许自动执行 Shell 命令（权限控制）
主题与编辑器偏好

有经验的用户可直接修改 ~/.claude.json，例如为特定项目设置系统提示词：

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 中，使用 -p（print）模式非交互式执行：

bash 复制代码

claude -p "检查 src/ 下所有 Python 文件的类型注解完整性，输出不完整的文件列表"

配合 --output-format json 可以得到结构化输出，方便下游工具解析：

bash 复制代码

claude -p "列出项目中的 TODO 注释并归类" --output-format json > todos.json

2.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 中配置：

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：

markdown 复制代码

请对当前分支的改动进行代码审查，按照以下维度打分（1-10）：
- 逻辑正确性
- 可读性
- 性能隐患
- 安全性
输出表格并给出改进建议。

然后在 Claude Code 中输入 /review，它会读取该模板并结合 git diff 执行。这相当于将你的常用审查标准固化为可复用指令，团队统一使用能大幅提升代码质量的一致性。

3.3 MCP 工具集成

Claude Code 原生支持 Model Context Protocol (MCP)，可以连接外部工具如数据库、Jira、文件系统搜索等。配置方式：

bash 复制代码

claude mcp add --transport stdio myserver -- /path/to/server

或直接在 ~/.claude.json 的 mcpServers 字段添加服务器。一个高效实践是部署一个只读的 PostgreSQL MCP 服务器，让 Claude 直接查询数据库 Schema 和样例数据，生成准确的数据迁移脚本或 ORM 模型定义，彻底杜绝"凭空想象表结构"的问题。

3.4 管道与组合

Claude Code 的标准输入输出完全遵循 Unix 哲学，可以轻松与其它命令组合：

bash 复制代码

# 将日志输入 Claude 进行根因分析
tail -n 100 /var/log/app.log | claude -p "分析这些日志，找出错误原因并给出修复建议"

# 对 git diff 内容进行自动 commit message 生成
git diff HEAD~1 | claude -p "根据变更生成一条 Conventional Commits 格式的提交信息"

这种管道能力让 Claude Code 成为脚本工具链中的一等公民，而非孤立的聊天界面。

4 实战工作流

4.1 代码审查自动化

在 Pull Request 触发时运行：

bash 复制代码

claude -p "$(cat <<EOF
你是一个严格的代码审查者。以下是 PR 的完整 diff:
$(git diff origin/main...HEAD)
请输出：
1. 高风险问题（必须修改）
2. 建议改进（可读性/性能）
3. 测试覆盖是否充分
使用中文回答。
EOF
)" --output-format json > review-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 协作的最强阵地。