【Claude Code 终端命令】技术解析与汇总：从基础用法到高级实战

文章目录

• Claude Code 终端命令技术解析与汇总：从基础用法到高级实战
• • 一、引言
  • 二、安装与环境准备
  • • 2.1 安装
    • 2.2 环境变量配置
  • 三、CLI 核心参数全景
  • • 3.1 启动方式一览
    • 3.2 完整 CLI 参数表
    • • 3.2.1 对话控制参数
      • 3.2.2 模型与上下文参数
      • 3.2.3 工具与权限参数
      • 3.2.4 MCP 与扩展参数
      • 3.2.5 通用参数
    • 3.3 输出格式详解
    • • 3.3.1 `–output-format text`（默认）
      • 3.3.2 `–output-format json`
      • 3.3.3 `–output-format stream-json`
  • 四、子命令体系
  • • 4.1 `claude config` — 配置管理
    • 4.2 `claude mcp` — MCP 服务器管理
    • 4.3 `claude doctor` — 健康诊断
    • 4.4 `claude update` — 版本更新
  • 五、交互式模式斜杠命令（Slash Commands）
  • • 5.1 会话管理
    • 5.2 AI 行为控制
    • 5.3 帮助与信息
    • 5.4 开发工具集成
    • 5.5 项目技能（自定义 Slash Commands）
  • 六、Shell 直通机制（`!` 前缀）
  • 七、权限控制体系
  • • 7.1 权限分级模型
    • 7.2 通过 settings.json 配置权限白名单
    • 7.3 CI/CD 场景：跳过权限提示
  • 八、Hooks 自动化机制
  • • 8.1 支持的事件类型
    • 8.2 配置示例
    • 8.3 Hook 脚本的 I/O 协议
    • 8.4 实战：自动 Lint + 通知
  • 九、MCP 集成实战
  • • 9.1 MCP 工作原理
    • 9.2 常用 MCP 服务器速查
    • 9.3 在 MCP 配置文件中统一管理
  • 十、非交互模式与脚本集成
  • • 10.1 基础管道用法
    • 10.2 stream-json 实时处理
    • 10.3 多轮对话脚本
    • 10.4 CI/CD 集成示例
  • 十一、多 Agent 并发模式
  • 十二、CLAUDE.md 项目配置文件
  • 十三、调试与问题排查
  • • 13.1 常用调试命令
    • 13.2 常见问题排查
  • 十四、命令速查卡
  • 十五、总结

Claude Code 终端命令技术解析与汇总：从基础用法到高级实战

亲爱的朋友们，创作不容易，若对您有帮助的话，请点赞收藏加关注哦，您的关注是我持续创作的动力，谢谢大家！有问题请私信或联系邮箱：jasonai.fn@gmail.com

一、引言

2024 年末，Anthropic 正式推出 Claude Code——一款深度集成于终端的 AI 编程助手 CLI，其核心理念是「让 AI 直接置身于开发者的工作流之中，而非另开一个浏览器标签页」。与 ChatGPT、Cursor 等以 GUI 为主的产品不同，Claude Code 全程运行在命令行，可直接读写文件、执行 Shell 命令、操作 Git，并通过 MCP（Model Context Protocol）协议无限扩展上下文来源。

截至 2026 年 6 月，Claude Code 已成为 AI 编程工具中命令行生态最完整的产品之一，支持：

• 交互式对话 与 非交互式管道调用 两种模式
• 斜杠命令（Slash Commands）、Shell 直通（!前缀）、Vim 模式
• Hooks 自动化、MCP 服务器、多 Agent 并发
• 精细化权限控制与沙箱安全机制

本文将系统梳理 Claude Code 的全量终端命令，涵盖 CLI 参数、交互式斜杠命令、配置体系、MCP 集成和 Hooks 机制，并给出生产级实战示例。

二、安装与环境准备

2.1 安装

# 全局安装（需 Node.js 18+）
npm install -g @anthropic-ai/claude-code

# 验证安装
claude –version

# 健康检查（检测 API Key、网络、权限配置）
claude doctor

2.2 环境变量配置

# 写入 .zshrc / .bashrc
export ANTHROPIC_API_KEY="sk-ant-api03-…"
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=16000

三、CLI 核心参数全景

3.1 启动方式一览

# 1. 交互式模式（最常用）
claude

# 2. 单轮对话（直接传入 Prompt）
claude "帮我解释这个函数的作用"

# 3. 管道输入
cat error.log | claude "分析这段报错，给出修复建议"
echo "重构这个类" | claude -p –

# 4. 继续上次会话
claude –continue
claude -c

# 5. 恢复指定历史会话
claude –resume
claude -r

3.2 完整 CLI 参数表

3.2.1 对话控制参数

3.2.2 模型与上下文参数

3.2.3 工具与权限参数

3.2.4 MCP 与扩展参数

3.2.5 通用参数

3.3 输出格式详解

3.3.1 –output-format text（默认）

直接输出 AI 的文本响应，适合人工阅读。

3.3.2 –output-format json

等待对话结束后，输出一个完整 JSON 对象：

{
"type": "result",
"subtype": "success",
"session_id": "sess_abc123",
"result": "函数 `parseUser` 的作用是…",
"cost_usd": 0.0023,
"duration_ms": 1420,
"num_turns": 1,
"is_error": false
}

3.3.3 –output-format stream-json

逐行输出 JSONL 事件流，适合管道集成与实时处理：

{"type":"system","subtype":"init","session_id":"sess_abc123","model":"claude-opus-4-8","tools":["Bash","Read","Edit"]}
{"type":"assistant","message":{"role":"assistant","content":[{"type":"text","text":"正在分析文件…"}]}}
{"type":"tool_use","name":"Read","input":{"file_path":"/app/main.go"}}
{"type":"tool_result","name":"Read","output":"package main\\n…"}
{"type":"result","subtype":"success","result":"该文件实现了…","cost_usd":0.0031}

四、子命令体系

4.1 claude config — 配置管理

# 查看所有配置项
claude config list

# 读取单个配置值
claude config get model
claude config get theme

# 写入配置值（全局）
claude config set model claude-opus-4-8
claude config set theme dark

# 写入配置值（仅当前项目）
claude config set –project preferredNotifications false

# 删除配置项（恢复默认）
claude config delete model

常用配置项一览：

4.2 claude mcp — MCP 服务器管理

# 列出已配置的 MCP 服务器
claude mcp list

# 添加 stdio 类型 MCP 服务器
claude mcp add filesystem \\
-t stdio \\
— npx -y @modelcontextprotocol/server-filesystem /Users/me/projects

# 添加 SSE 类型 MCP 服务器（远程）
claude mcp add my-remote-server \\
-t sse \\
–url https://my-mcp-server.internal/sse \\
–header "Authorization: Bearer ${TOKEN}"

# 添加 HTTP 类型 MCP 服务器
claude mcp add my-api \\
-t http \\
–url https://api.example.com/mcp

# 删除 MCP 服务器
claude mcp remove filesystem

# 查看 MCP 服务器详情
claude mcp get filesystem

# 启动 MCP Inspector（调试单个服务器）
claude mcp serve filesystem

MCP 作用域（–scope）：

4.3 claude doctor — 健康诊断

claude doctor

输出示例：

✓ Claude Code 版本: 1.9.2
✓ Node.js 版本: v22.14.0
✓ API Key 已配置
✓ 网络连通性: api.anthropic.com (200ms)
✓ 权限配置有效
⚠ 可选: 终端集成未配置（运行 /terminal-setup 以启用状态栏）

4.4 claude update — 版本更新

# 检查并更新到最新版本
claude update

# 查看发行日志
claude –changelog

五、交互式模式斜杠命令（Slash Commands）

进入交互式模式（直接运行 claude）后，可使用以下斜杠命令：

5.1 会话管理

5.2 AI 行为控制

5.3 帮助与信息

5.4 开发工具集成

5.5 项目技能（自定义 Slash Commands）

Claude Code 支持将自定义脚本注册为斜杠命令，存放于：

.claude/commands/ # 项目级（团队共享）
~/.claude/commands/ # 用户级（个人全局）

示例：创建 /deploy 命令

# .claude/commands/deploy.md
运行以下检查后部署到 staging 环境：
1. 执行 npm test
2. 检查是否有未提交的更改
3. 运行 npm run build
4. 执行 ./scripts/deploy.sh staging
如有任何步骤失败，立即停止并报告原因。

使用时直接输入 /deploy 即可触发。

六、Shell 直通机制（! 前缀）

在交互式模式中，以 ! 开头的输入会被直接发送到系统 Shell 执行，结果显示在对话中：

# 在交互模式内执行 Shell 命令
! ls -la
! git status
! npm test
! docker ps
! gcloud auth login # 需要交互时，建议用这种方式

这与让 AI 帮你执行命令不同——! 命令不经过 AI 解释，直接由用户 Shell 执行，结果直接输出到终端，并可作为后续对话的上下文。

七、权限控制体系

7.1 权限分级模型

Claude Code 采用「最小权限原则」，工具调用分为三类：

自动允许（Auto-approved）
├── 读取文件（Read）
├── 列出目录（LS）
└── Glob 搜索

需要用户确认（User-approved）
├── 写入/编辑文件（Write、Edit）
├── 执行 Shell 命令（Bash）
├── 网络请求（WebFetch、WebSearch）
└── 删除操作

不可撤销操作（Irreversible — 特别警示）
├── rm -rf 类删除
├── git push –force
└── 数据库 DROP 操作

7.2 通过 settings.json 配置权限白名单

项目级（.claude/settings.json）或全局（~/.claude/settings.json）：

{
"permissions": {
"allow": [
"Bash(npm test)",
"Bash(npm run *)",
"Bash(git status)",
"Bash(git diff*)",
"Read(**)",
"Edit(src/**)",
"WebSearch"
],
"deny": [
"Bash(rm -rf *)",
"Bash(git push –force*)"
]
}
}

权限规则语法：

7.3 CI/CD 场景：跳过权限提示

# 非交互式 CI 环境，跳过所有权限提示
claude -p –dangerously-skip-permissions \\
"检查代码风格，修复所有 ESLint 错误，提交"

安全警示：–dangerously-skip-permissions 会使 Claude 在无任何人工审核的情况下执行所有操作，仅限在受控 CI 环境（沙箱容器、隔离 VM）中使用。

八、Hooks 自动化机制

Hooks 是 Claude Code 最强大但最少被使用的特性——它允许在特定事件发生时自动执行用户定义的 Shell 脚本，从 AI 外部对其行为施加约束。

8.1 支持的事件类型

8.2 配置示例

.claude/settings.json：

{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "python3 /scripts/validate_command.py"
}
]
}
],
"PostToolUse": [
{
"matcher": "Edit",
"hooks": [
{
"type": "command",
"command": "npm run lint — –fix $CLAUDE_TOOL_INPUT_FILE_PATH"
}
]
}
],
"Stop": [
{
"matcher": "*",
"hooks": [
{
"type": "command",
"command": "osascript -e 'display notification \\"Claude 已完成任务\\" with title \\"Claude Code\\"'"
}
]
}
]
}
}

8.3 Hook 脚本的 I/O 协议

Hook 脚本通过 stdin 接收 JSON 事件数据，并通过 stdout 返回 JSON 控制响应：

输入（stdin）：

{
"session_id": "sess_abc123",
"hook_event_name": "PreToolUse",
"tool_name": "Bash",
"tool_input": {
"command": "rm -rf ./build",
"description": "清理构建目录"
}
}

输出（stdout）控制 AI 行为：

{
"action": "block",
"message": "禁止删除 build 目录，请使用 npm run clean"
}

8.4 实战：自动 Lint + 通知

#!/usr/bin/env python3
# scripts/post_edit_hook.py
import json, sys, subprocess

data = json.load(sys.stdin)
if data.get("tool_name") == "Edit":
filepath = data["tool_input"].get("file_path", "")
if filepath.endswith((".ts", ".tsx", ".js")):
result = subprocess.run(
["npx", "eslint", "–fix", filepath],
capture_output=True, text=True
)
if result.returncode != 0:
print(json.dumps({
"action": "block",
"message": f"ESLint 修复失败:\\n{result.stderr}"
}))
sys.exit(0)

print(json.dumps({"action": "allow"}))

九、MCP 集成实战

9.1 MCP 工作原理

Claude Code ←→ MCP Client ←→ MCP Server ←→ 外部系统
├── 文件系统
├── 数据库
├── GitHub API
├── Jira
└── 自定义服务

MCP 服务器通过三种传输方式连接：

9.2 常用 MCP 服务器速查

# 文件系统访问
claude mcp add fs -t stdio — \\
npx -y @modelcontextprotocol/server-filesystem ~/projects

# GitHub 集成（需 GITHUB_TOKEN）
claude mcp add github -t stdio — \\
npx -y @modelcontextprotocol/server-github

# PostgreSQL 数据库
claude mcp add postgres -t stdio — \\
npx -y @modelcontextprotocol/server-postgres \\
"postgresql://user:pass@localhost:5432/mydb"

# Puppeteer 浏览器自动化
claude mcp add puppeteer -t stdio — \\
npx -y @modelcontextprotocol/server-puppeteer

# Slack 集成
claude mcp add slack -t stdio — \\
npx -y @modelcontextprotocol/server-slack

# Sequential Thinking（增强推理）
claude mcp add thinking -t stdio — \\
npx -y @modelcontextprotocol/server-sequential-thinking

9.3 在 MCP 配置文件中统一管理

.claude/mcp.json（项目内统一配置）：

{
"mcpServers": {
"filesystem": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
},
"github": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "${GITHUB_TOKEN}"
}
},
"jira": {
"type": "http",
"url": "https://your-jira-mcp.internal/mcp",
"headers": {
"Authorization": "Bearer ${JIRA_TOKEN}"
}
}
}
}

启动时指定：

claude –mcp-config .claude/mcp.json

十、非交互模式与脚本集成

10.1 基础管道用法

# 分析文件并输出 JSON
claude -p –output-format json \\
"分析 src/api/auth.ts 的安全性，输出 JSON 格式的问题列表"

# 处理 git diff
git diff HEAD~1 | claude -p \\
"为这次 diff 生成符合 Conventional Commits 规范的提交信息"

# 批量处理文件
for f in src/**/*.test.ts; do
claude -p "检查 $f 的测试覆盖率，找出缺失的边界用例" >> test_report.md
done

10.2 stream-json 实时处理

# 实时处理 AI 响应流
claude -p –output-format stream-json \\
"帮我重构这个函数" | while IFS= read -r line; do
type=$(echo "$line" | jq -r '.type // empty')
case "$type" in
"tool_use")
tool=$(echo "$line" | jq -r '.name')
echo "[工具调用] $tool"
;;
"result")
cost=$(echo "$line" | jq -r '.cost_usd')
echo "[完成] 费用: \\$$cost"
;;
esac
done

10.3 多轮对话脚本

# 控制最大对话轮数
claude -p –max-turns 5 \\
"分析项目依赖，找出安全漏洞，生成修复 PR"

# 通过 session_id 在不同脚本间共享上下文
SESSION=$(claude -p –output-format json "初始化代码审查" | jq -r '.session_id')
claude –resume "$SESSION" -p "继续分析第二个模块"

10.4 CI/CD 集成示例

GitHub Actions：

# .github/workflows/ai-review.yml
name: AI Code Review
on:
pull_request:
types: [opened, synchronize]

jobs:
ai-review:
runs-on: ubuntu–latest
steps:
– uses: actions/checkout@v4
with:
fetch-depth: 0

– name: Install Claude Code
run: npm install –g @anthropic–ai/claude–code

– name: Run AI Review
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
run: |
git diff origin/main…HEAD | claude -p \\
–dangerously-skip-permissions \\
–output-format json \\
"审查这个 PR 的代码变更，重点关注：安全漏洞、性能问题、代码规范。
输出 JSON，格式：{issues: [{severity, file, line, message}]}" \\
> review.json
cat review.json

十一、多 Agent 并发模式

Claude Code 支持在一次会话中启动多个并行子 Agent，适合大型任务的分而治之：

主 Agent
├── 子 Agent 1：前端代码审查（隔离 worktree）
├── 子 Agent 2：后端 API 测试（隔离 worktree）
└── 子 Agent 3：文档更新

在交互模式中，AI 会自动根据任务复杂度决定是否启动子 Agent。用户也可在提示中显式引导：

claude "对这个仓库做全面审查：
– 并行分析前端（src/frontend）和后端（src/api）的代码质量
– 每个部分独立完成，最后汇总报告"

子 Agent 默认在 Git Worktree 中运行，彼此文件系统隔离，避免并发写冲突。

十二、CLAUDE.md 项目配置文件

CLAUDE.md 是 Claude Code 的项目知识库，每次启动时自动载入上下文：

# 项目名称：MyApp

## 技术栈
– 后端：Go 1.23 + Gin
– 前端：React 18 + TypeScript
– 数据库：PostgreSQL 16
– 部署：Kubernetes + Helm

## 开发规范
– 提交信息遵循 Conventional Commits
– 测试覆盖率不低于 80%
– API 变更必须同步更新 OpenAPI spec

## 常用命令
– `make test`：运行所有测试
– `make lint`：代码风格检查
– `make build`：构建 Docker 镜像

## 注意事项
– 不要直接修改 generated/ 目录下的文件
– 数据库迁移必须通过 migrations/ 目录
– 生产环境配置在 infra/helm/values-prod.yaml

CLAUDE.md 查找顺序：

十三、调试与问题排查

13.1 常用调试命令

# 查看详细工具调用过程
claude –verbose "帮我修复 bug"

# 开启 debug 日志（输出到 stderr）
claude –debug "…"

# 检查 MCP 服务器连通性
claude mcp list
claude mcp get <server-name>

# 查看当前配置
claude config list

# 运行健康检查
claude doctor

13.2 常见问题排查

十四、命令速查卡

┌─────────────────────────────────────────────────────────────────┐
│ Claude Code 终端命令速查卡 │
├─────────────────────────────────────────────────────────────────┤
│ 启动与模式 │
│ claude 交互式模式 │
│ claude "prompt" 单轮对话 │
│ claude -p "prompt" 非交互输出（管道友好） │
│ claude -c 继续上次会话 │
│ claude -r 恢复历史会话 │
├─────────────────────────────────────────────────────────────────┤
│ 模型与输出 │
│ –model <id> 指定模型 │
│ –output-format json JSON 输出 │
│ –output-format stream-json JSONL 流式输出 │
│ –verbose 显示工具调用链路 │
│ –max-turns <n> 限制对话轮数（-p 模式） │
├─────────────────────────────────────────────────────────────────┤
│ 权限控制 │
│ –allowedTools <list> 工具白名单 │
│ –disallowedTools <list> 工具黑名单 │
│ –dangerously-skip-perms 跳过所有权限提示（CI 专用） │
├─────────────────────────────────────────────────────────────────┤
│ 交互模式斜杠命令 │
│ /clear 清除对话 /cost 查看费用 │
│ /compact 压缩上下文 /model 切换模型 │
│ /permissions 权限管理 /memory 编辑记忆 │
│ /think 扩展思考 /vim Vim 模式 │
│ /help 帮助信息 /exit 退出 │
├─────────────────────────────────────────────────────────────────┤
│ 子命令 │
│ claude config list/get/set/delete 配置管理 │
│ claude mcp list/add/remove/get MCP 服务器管理 │
│ claude doctor 健康检查 │
│ claude update 版本更新 │
└─────────────────────────────────────────────────────────────────┘

十五、总结

Claude Code 的终端命令体系可以用三个层次来理解：

第一层——日常交互：claude、-c/-r 续话、交互模式的 /clear、/cost、/model，这些命令解决了 90% 的日常使用场景。

第二层——工程集成：-p、–output-format stream-json、–max-turns、权限白名单配置、CLAUDE.md 项目文档，这些特性让 Claude Code 成为可嵌入 CI/CD 流水线的工程级工具。

第三层——平台扩展：MCP 服务器、Hooks 自动化、多 Agent 并发、自定义斜杠命令，这些机制让 Claude Code 从「AI 助手」进化为「可编程的 AI 基础设施」。

随着 Claude 4 系列模型能力的持续提升，以及 MCP 协议生态的快速壮大，以终端为核心的 AI 编程范式将成为专业开发者工作流的重要组成部分。掌握这套命令体系，是驾驭 AI 编程工具的关键一步。

参考资源

• Claude Code 官方文档：https://docs.anthropic.com/claude-code
• MCP 协议规范：https://modelcontextprotocol.io
• Claude Code GitHub：https://github.com/anthropics/claude-code

亲爱的朋友们，创作不容易，若对您有帮助的话，请点赞收藏加关注哦，您的关注是我持续创作的动力，谢谢大家！有问题请私信或联系邮箱：jasonai.fn@gmail.com