无标签

发布日期: 2025-12-24

文章字数: 5.7k

阅读时长: 24 分

阅读次数:

Claude Code CLI 完整使用指南

Claude Code - 专业的 AI 辅助编程命令行工具

快速开始

安装

# 安装稳定版
claude install stable

# 安装最新版
claude install latest

# 安装特定版本
claude install 1.0.0

基本使用

# 启动交互式会话（默认）
claude

# 直接提问并退出（非交互模式）
claude -p "帮我分析这个代码文件"

# 继续上一次对话
claude -c

# 查看帮助信息
claude --help

第一个示例

# 让 Claude 帮你创建一个 Python 脚本
claude -p "创建一个读取 CSV 文件的 Python 脚本"

# 在当前项目目录中启动交互式会话
claude

核心概念

1. 交互式会话模式

默认模式，适合复杂的开发任务：

claude

特点：

持续的对话上下文
多轮交互
工作区权限管理
会话可恢复

2. 非交互模式（Print Mode）

适合脚本化和批量处理：

# 基本用法
claude -p "你的问题"

# 指定输出格式
claude -p "分析代码" --output-format json

# 管道操作
echo "重构这个函数" | claude -p

特点：

一次性执行
可输出 JSON 格式
适合集成到 CI/CD
跳过工作区信任对话框（仅在可信目录使用）

3. 会话持久化

# 继续上一次会话
claude -c
# 或
claude --continue

# 恢复指定会话
claude -r <session-id>

# 使用会话选择器
claude --resume

# 搜索并恢复会话
claude --resume "代码审查"

4. 工作区与权限

Claude Code 使用工作区概念管理文件访问权限：

首次访问目录：会弹出信任对话框
权限模式：可通过 --permission-mode 配置
工具白名单：使用 --allowed-tools 限制可用工具

命令详解

mcp - MCP 服务器配置管理

MCP（Model Context Protocol）服务器让 Claude 能够访问外部服务和 API。

可用子命令

# 查看 MCP 帮助
claude mcp --help

# 列出所有 MCP 服务器
claude mcp list

# 获取特定服务器详情
claude mcp get <name>

# 添加 HTTP 服务器
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# 添加 SSE 服务器
claude mcp add --transport sse asana https://mcp.asana.com/sse

# 添加 stdio 服务器（带环境变量）
claude mcp add --transport stdio airtable --env AIRTABLE_API_KEY=YOUR_KEY -- npx -y airtable-mcp-server

# 使用 JSON 字符串添加服务器
claude mcp add-json <name> <json>

# 从 Claude Desktop 导入服务器配置
claude mcp add-from-claude-desktop

# 删除 MCP 服务器
claude mcp remove <name>

# 重置项目范围的服务器选择
claude mcp reset-project-choices

# 启动 Claude Code MCP 服务器
claude mcp serve

配置示例

# 从配置文件加载 MCP 服务器
claude --mcp-config ./mcp-servers.json

# 从多个配置文件加载
claude --mcp-config ./server1.json ./server2.json

# 使用 JSON 字符串配置
claude --mcp-config '{"name":"my-server","command":"node","args":["./server.js"]}'

# 严格模式：仅使用 --mcp-config 指定的服务器
claude --strict-mcp-config --mcp-config ./my-server.json

传输类型说明

MCP 服务器支持三种传输类型：

HTTP 传输 - 通过 HTTP 端点连接
SSE 传输 - 通过 Server-Sent Events 连接
stdio 传输 - 通过标准输入输出连接（本地进程）

实际使用示例：

# HTTP 服务器示例（Sentry）
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# SSE 服务器示例（Asana）
claude mcp add --transport sse asana https://mcp.asana.com/sse

# stdio 服务器示例（Airtable，带环境变量）
claude mcp add --transport stdio airtable --env AIRTABLE_API_KEY=your_key -- npx -y airtable-mcp-server

# stdio 服务器示例（本地 Node.js 服务器）
claude mcp add --transport stdio my-server -- node /path/to/server.js

plugin - 插件管理

管理 Claude Code 的插件扩展。

可用子命令

# 查看插件帮助
claude plugin --help

# 验证插件或市场清单
claude plugin validate <path>

# 管理插件市场
claude plugin marketplace

# 安装插件（支持从特定市场安装）
claude plugin install <plugin>
claude plugin install <plugin>@<marketplace>
# 简写形式
claude plugin i <plugin>

# 卸载插件
claude plugin uninstall <plugin>
# 或
claude plugin remove <plugin>

# 启用已禁用的插件
claude plugin enable <plugin>

# 禁用已启用的插件
claude plugin disable <plugin>

# 更新插件到最新版本（需要重启）
claude plugin update [plugin]

插件市场管理

# 管理插件市场
claude plugin marketplace

# 从默认市场安装插件
claude plugin install my-plugin

# 从特定市场安装插件
claude plugin install my-plugin@custom-marketplace

# 验证插件清单
claude plugin validate ./path/to/plugin

插件启用/禁用

# 启用已禁用的插件
claude plugin enable my-plugin

# 禁用已启用的插件
claude plugin disable my-plugin

setup-token - 设置认证令牌

配置长期认证令牌（需要 Claude 订阅）。

# 启动令牌设置向导
claude setup-token

# 设置后可在会话中使用
# 令牌会保存在配置文件中，无需每次输入

doctor - 健康检查

检查 Claude Code 自动更新器的健康状态。

# 运行健康检查
claude doctor

# 检查项目可能包括：
# - 配置文件状态
# - 安装完整性
# - 网络连接
# - 认证状态

update - 更新检查

检查并安装更新。

# 检查更新
claude update

# 如果有更新，会自动安装最新版本

install - 安装原生版本

安装 Claude Code 原生构建版本。

基本用法

# 安装稳定版（默认）
claude install

# 明确指定稳定版
claude install stable

# 安装最新预发布版
claude install latest

# 安装特定版本
claude install 1.2.0

# 强制重新安装
claude install --force

# 查看安装选项
claude install --help

选项参考

输出格式选项

控制输出格式和行为的选项。

`-p, --print`

非交互模式，打印响应后退出。

# 基本用法
claude -p "解释这段代码"

# 管道输入
cat main.py | claude -p "添加注释"

# 结合其他选项
claude -p "分析代码" --output-format json > result.json

注意事项：

跳过工作区信任对话框，仅在可信目录使用
适合脚本化和自动化

`--output-format <format>`

指定输出格式（仅配合 --print 使用）。

可选值：

text - 纯文本（默认）
json - JSON 格式（单个结果）
stream-json - 实时流式 JSON

# JSON 输出
claude -p "分析项目结构" --output-format json

# 流式 JSON（实时流式输出）
claude -p "长任务处理" --output-format stream-json

# 保存到文件
claude -p "生成代码" --output-format json > output.json

`--json-schema <schema>`

JSON Schema 验证，确保输出符合指定结构。

# 使用 JSON Schema
claude -p "提取 API 信息" --output-format json \
  --json-schema '{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}},"required":["name","version"]}'

# 复杂 Schema 示例
claude -p "分析依赖" --output-format json \
  --json-schema '{
    "type": "array",
    "items": {
      "type": "object",
      "properties": {
        "name": {"type": "string"},
        "version": {"type": "string"},
        "license": {"type": "string"}
      }
    }
  }'

`--include-partial-messages`

包含部分消息块（仅配合 --print 和 --output-format=stream-json）。

# 实时接收部分消息
claude -p "生成大量代码" \
  --output-format stream-json \
  --include-partial-messages

`--input-format <format>`

输入格式（仅配合 --print 使用）。

可选值：

text - 纯文本（默认）
stream-json - 实时流式 JSON 输入

# 流式输入处理
cat input.json | claude -p --input-format stream-json \
  --output-format json

`--replay-user-messages`

重新发送来自 stdin 的用户消息（配合流式输入输出）。

# 消息确认回显
cat input.json | claude -p \
  --input-format stream-json \
  --output-format stream-json \
  --replay-user-messages

调试选项

用于调试和问题排查。

`-d, --debug [filter]`

启用调试模式，支持类别过滤。

# 启用所有调试信息
claude -d

# 指定调试类别
claude -d "api,hooks"

# 排除特定类别
claude -d "!statsig,!file"

# 组合使用
claude -d "api,!network"

常见调试类别：

api - API 调用
hooks - 钩子执行
statsig - 统计分析
file - 文件操作
network - 网络请求

`--verbose`

覆盖详细模式设置。

# 启用详细输出
claude --verbose

# 结合其他选项
claude --verbose -p "详细分析"

`--mcp-debug`

已弃用，请使用 --debug 代替。

# 旧方式（不推荐）
claude --mcp-debug

# 新方式
claude -d mcp

会话管理选项

控制和恢复会话的选项。

`-c, --continue`

继续最近的会话。

# 继续上一次会话
claude -c
# 或
claude --continue

# 继续会话并执行新任务
claude -c "继续优化代码"

`-r, --resume [value]`

恢复指定会话，或打开交互式选择器。

# 打开会话选择器
claude -r

# 搜索并选择会话
claude -r "代码审查"

# 恢复指定 session-id
claude -r abc123-def456-ghi789

`--fork-session`

创建新会话 ID 而不是重用原会话（配合 --resume 或 --continue）。

# 恢复会话但创建新分支
claude -r --fork-session

# 继续会话但创建新分支
claude -c --fork-session

`--no-session-persistence`

禁用会话持久化（仅配合 --print）。

# 一次性执行，不保存会话
claude -p "临时任务" --no-session-persistence

`--session-id <uuid>`

使用指定的会话 ID。

# 使用特定会话 ID
claude --session-id 550e8400-e29b-41d4-a716-446655440000

# 生成并使用新会话 ID
uuidgen | xargs -I {} claude --session-id {}

工具权限选项

控制工具访问权限的选项。

`--allowedTools, --allowed-tools <tools...>`

允许的工具列表（逗号或空格分隔）。

# 允许特定工具
claude --allowed-tools Bash,Edit,Read

# 使用逗号分隔
claude --allowed-tools "Bash,Edit,Read"

# 使用模式匹配
claude --allowed-tools "Bash(git:*)" "Edit"

# 仅允许文件操作
claude --allowed-tools Read,Write,Edit

# 非交互模式示例
claude -p "检查 Git 状态" \
  --allowed-tools "Bash(git:status)" \
  --print

`--tools <tools...>`

指定可用工具集（仅 --print 模式）。

# 使用所有默认工具
claude -p "任务" --tools default

# 禁用所有工具
claude -p "纯文本任务" --tools ""

# 指定特定工具
claude -p "任务" --tools "Bash,Edit,Read"

`--disallowedTools, --disallowed-tools <tools...>`

拒绝的工具列表（逗号或空格分隔）。

# 禁用危险工具
claude --disallowed-tools "Bash(rm:*),Bash(dd:*)"

# 禁用网络操作
claude --disallowed-tools "Bash(curl:*),Bash(wget:*)"

# 禁止编辑特定文件
claude --disallowed-tools "Edit(*.config)"

`--dangerously-skip-permissions`

绕过所有权限检查（仅推荐用于无网络访问的沙箱环境）。

# 危险：跳过所有权限检查
claude --dangerously-skip-permissions

# ⚠️ 谨慎使用
# 仅在完全隔离的环境中使用

`--allow-dangerously-skip-permissions`

启用跳过权限检查的选项，但默认不启用。

# 启用该功能但默认不激活
claude --allow-dangerously-skip-permissions

# 后续可通过其他方式激活

模型配置选项

控制 AI 模型行为的选项。

`--model <model>`

指定会话使用的模型。

# 使用模型别名
claude --model sonnet
claude --model opus
claude --model haiku

# 使用完整模型名称
claude --model claude-sonnet-4-5-20250929
claude --model claude-opus-4-5-20251101

# 非交互模式
claude -p "快速任务" --model haiku --print

常用模型别名：

sonnet - 平衡性能和速度
opus - 最高质量
haiku - 最快响应

`--fallback-model <model>`

启用默认模型过载时的自动降级（仅 --print 模式）。

# 设置备用模型
claude -p "重要任务" \
  --model opus \
  --fallback-model sonnet \
  --print

# 当 opus 过载时自动降级到 sonnet

`--agent <agent>`

指定会话使用的代理（覆盖 ‘agent’ 设置）。

# 使用特定代理
claude --agent code-reviewer

# 配合自定义代理
claude --agents '{"reviewer":{"description":"Reviews code","prompt":"你是代码审查专家"}}' \
  --agent reviewer

`--agents <json>`

定义自定义代理的 JSON 对象。

# 定义多个代理
claude --agents '{
  "reviewer": {
    "description": "Reviews code for bugs and style issues",
    "prompt": "You are a code reviewer. Focus on clarity and correctness."
  },
  "optimizer": {
    "description": "Optimizes code for performance",
    "prompt": "You are a performance optimization expert."
  }
}'

# 使用自定义代理
claude --agent reviewer

MCP 配置选项

MCP（Model Context Protocol）相关配置。

`--mcp-config <configs...>`

从 JSON 文件或字符串加载 MCP 服务器（空格分隔）。

# 从文件加载
claude --mcp-config ./servers/server1.json

# 从多个文件加载
claude --mcp-config ./server1.json ./server2.json

# 从 JSON 字符串加载
claude --mcp-config '{"name":"my-server","command":"node","args":["./server.js"]}'

# 混合使用
claude --mcp-config ./config.json '{"name":"temp-server","command":"python"}'

配置文件格式示例 (server.json)：

{
  "name": "my-server",
  "command": "node",
  "args": ["./server.js"],
  "env": {
    "API_KEY": "your-key"
  }
}

`--strict-mcp-config`

仅使用 --mcp-config 指定的 MCP 服务器，忽略其他配置。

# 严格模式：仅使用指定的服务器
claude --strict-mcp-config \
  --mcp-config ./my-server.json

# 不加载其他已配置的 MCP 服务器

系统提示词选项

控制系统提示词的选项。

`--system-prompt <prompt>`

使用自定义系统提示词。

# 完全自定义系统提示词
claude --system-prompt "你是一个 Rust 专家" \
  -p "帮我优化这段代码"

# 设置角色和任务
claude --system-prompt "你是代码审查专家，专注于安全性和性能" \
  -p "审查这个文件"

`--append-system-prompt <prompt>`

追加系统提示词到默认提示词。

# 追加额外指令
claude --append-system-prompt "始终包含单元测试" \
  -p "创建一个函数"

# 追加格式要求
claude --append-system-prompt "所有代码必须包含详细注释" \
  -p "实现快速排序"

权限模式选项

控制权限检查行为。

`--permission-mode <mode>`

指定会话的权限模式。

可选值：

default - 默认权限模式
acceptEdits - 自动接受编辑
bypassPermissions - 绕过权限检查
delegate - 委托权限决策
dontAsk - 不询问权限
plan - 计划模式

# 自动接受编辑
claude --permission-mode acceptEdits

# 绕过权限检查（谨慎使用）
claude --permission-mode bypassPermissions

# 委托模式
claude --permission-mode delegate

# 不询问模式
claude --permission-mode dontAsk

# 计划模式
claude --permission-mode plan

# 配合非交互模式
claude -p "批量重构" \
  --permission-mode acceptEdits \
  --print

设置和配置选项

`--settings <file-or-json>`

从文件或 JSON 字符串加载额外设置。

# 从文件加载
claude --settings ./my-settings.json

# 从 JSON 字符串加载
claude --settings '{"model":"sonnet","temperature":0.7}'

# 配合其他选项
claude --settings ./config.json \
  --permission-mode acceptEdits

`--setting-sources <sources>`

指定要加载的设置源（逗号分隔）。

可选值：

user - 用户设置
project - 项目设置
local - 本地设置

# 只加载用户设置
claude --setting-sources user

# 加载用户和项目设置
claude --setting-sources user,project

# 加载所有设置（默认）
claude --setting-sources user,project,local

# 只加载项目设置
claude --setting-sources project

`--plugin-dir <paths...>`

仅为此会话从指定目录加载插件（可重复）。

# 从单个目录加载插件
claude --plugin-dir ./custom-plugins

# 从多个目录加载
claude --plugin-dir ./plugins1 ./plugins2

# 配合主会话
claude --plugin-dir ~/.claude/plugins \
  -p "使用自定义插件"

Beta 和测试选项

`--betas <betas...>`

在 API 请求中包含 Beta 标头（仅 API 密钥用户）。

# 启用单个 Beta 功能
claude --betas new-feature

# 启用多个 Beta 功能
claude --betas feature1,feature2

# API 密钥用户专用
# 用于测试实验性功能

IDE 集成选项

`--ide`

启动时自动连接到 IDE（如果有恰好一个有效 IDE）。

# 自动连接 IDE
claude --ide

# 配合其他选项
claude --ide -c "继续调试"

`--no-chrome`

禁用 Chrome 集成。

# 禁用 Chrome 集成
claude --no-chrome

`--chrome`

启用 Chrome 集成。

# 启用 Chrome 集成
claude --chrome

目录和会话选项

`--add-dir <directories...>`

允许工具访问的额外目录（可重复）。

# 添加单个目录
claude --add-dir /path/to/project

# 添加多个目录
claude --add-dir ./src ./tests ./docs

# 配合工作区
claude --add-dir ~/projects/shared \
  -p "访问共享目录"

其他选项

`--max-budget-usd <amount>`

API 调用的最大美元金额（仅 --print 模式）。

# 设置预算限制
claude -p "大型分析任务" \
  --max-budget-usd 5.00 \
  --print

# 限制成本
claude -p "生成大量代码" \
  --model opus \
  --max-budget-usd 10.00 \
  --print

`--disable-slash-commands`

禁用所有斜杠命令。

# 禁用斜杠命令
claude --disable-slash-commands

# 防止意外触发斜杠命令

`-v, --version`

输出版本号。

# 查看版本
claude -v
# 或
claude --version

`-h, --help`

显示帮助信息。

# 主帮助
claude --help

# 子命令帮助
claude mcp --help
claude plugin --help

使用场景与示例

场景 1：代码审查

# 交互式审查
claude --agent reviewer
> 请审查 src/main.py 文件

# 非交互式批量审查
claude -p "审查 src/ 目录下的所有 Python 文件" \
  --allowed-tools "Read,Grep" \
  --print

# 使用 JSON 输出集成到 CI/CD
claude -p "审查代码并输出问题" \
  --output-format json \
  --json-schema '{
    "type": "array",
    "items": {
      "type": "object",
      "properties": {
        "file": {"type": "string"},
        "line": {"type": "integer"},
        "issue": {"type": "string"},
        "severity": {"type": "string"}
      }
    }
  }' \
  > review-results.json

场景 2：批量代码生成

# 生成多个文件
claude -p "为以下模块创建单元测试：auth, user, payment" \
  --allowed-tools "Write,Read" \
  --print

# 使用流式输出监控进度
claude -p "生成完整的 API 文档" \
  --output-format stream-json \
  --include-partial-messages \
  --print

场景 3：CI/CD 集成

#!/bin/bash
# ci-integration.sh

# 1. 代码风格检查
echo "检查代码风格..."
claude -p "检查 src/ 目录的代码风格" \
  --output-format json \
  --allowed-tools "Read,Grep" \
  > style-check.json

# 2. 运行测试
echo "运行测试..."
claude -p "分析测试覆盖率报告" \
  --input-format text \
  --output-format json \
  < coverage.txt \
  > test-analysis.json

# 3. 生成变更日志
echo "生成变更日志..."
claude -p "基于 git log 生成变更日志" \
  --allowed-tools "Bash(git:*)" \
  --print \
  > CHANGELOG.md

场景 4：MCP 服务器集成

# 配置数据库 MCP 服务器
claude --mcp-config '{
  "name": "postgres",
  "command": "npx",
  "args": ["@modelcontextprotocol/server-postgres"],
  "env": {
    "DATABASE_URL": "postgresql://localhost/mydb"
  }
}' -p "查询用户表"

# 使用多个 MCP 服务器
claude \
  --mcp-config ./postgres-server.json \
  --mcp-config ./filesystem-server.json \
  -p "从数据库读取用户数据并保存到文件系统"

# 严格模式：仅使用指定服务器
claude --strict-mcp-config \
  --mcp-config ./my-server.json \
  -p "执行自定义任务"

场景 5：会话恢复与分支

# 场景：中断的编码任务
claude
> 开始实现用户认证功能...
# [会话中断]

# 恢复会话
claude -c

# 或从特定会话恢复
claude -r "用户认证"

# 创建分支会话尝试不同方案
claude -r --fork-session
> 让我们尝试使用 JWT 而不是 Session

场景 6：成本控制

# 设置预算限制
claude -p "分析大型代码库" \
  --model haiku \
  --fallback-model sonnet \
  --max-budget-usd 3.00 \
  --print

# 为不同任务设置不同预算
claude -p "简单任务" --model haiku --max-budget-usd 0.50 --print
claude -p "复杂任务" --model opus --max-budget-usd 10.00 --print

场景 7：多模型策略

# 快速原型使用 haiku
claude -p "创建基本结构" \
  --model haiku \
  --print

# 优化使用 sonnet
claude -p "优化代码性能" \
  --model sonnet \
  --print

# 最终审查使用 opus
claude -p "深度代码审查" \
  --model opus \
  --print

场景 8：自定义代理工作流

# 定义工作流代理
claude --agents '{
  "analyzer": {
    "description": "分析代码结构和依赖",
    "prompt": "你是代码分析专家"
  },
  "optimizer": {
    "description": "优化代码性能",
    "prompt": "你是性能优化专家"
  },
  "tester": {
    "description": "生成测试用例",
    "prompt": "你是测试专家"
  }
}'

# 执行工作流
claude --agent analyzer -p "分析项目结构" --print
claude --agent optimizer -p "优化瓶颈代码" --print
claude --agent tester -p "生成集成测试" --print

高级用法

自定义系统提示词

# 完全自定义
claude --system-prompt "你是 Rust 专家，专注于性能和安全性" \
  -p "实现并发数据结构"

# 追加到默认提示词
claude --append-system-prompt "所有代码必须包含文档注释和单元测试" \
  -p "创建二叉搜索树"

工具权限精细控制

# 允许特定 Git 命令
claude --allowed-tools "Bash(git:status),Bash(git:log),Bash(git:diff)"

# 禁止危险操作
claude --disallowed-tools "Bash(rm:*),Bash(dd:*)"

# 组合使用
claude \
  --allowed-tools "Bash(git:*),Read,Edit" \
  --disallowed-tools "Bash(git:push)" \
  -p "审查代码但不推送"

多源设置加载

# 优先级：local > project > user
claude --setting-sources project,local

# 仅项目设置
claude --setting-sources project

# 自定义设置覆盖
claude \
  --settings ./override.json \
  --setting-sources user,project

流式数据处理

# 实时流式输入输出
cat large-dataset.json | claude -p \
  --input-format stream-json \
  --output-format stream-json \
  --replay-user-messages \
  > processed-output.json

# 监控流式处理
claude -p "处理大规模数据" \
  --output-format stream-json \
  --include-partial-messages \
  --print

调试复杂问题

# 启用特定类别调试
claude -d "api,hooks" -p "调试 MCP 连接"

# 排除噪音
claude -d "!statsig,!file" -p "专注 API 调用"

# 详细模式
claude --verbose -d "all" -p "完整调试信息"

故障排除

常见问题

1. MCP 服务器连接失败

# 启用 MCP 调试
claude -d "mcp" --mcp-config ./server.json -p "测试连接"

# 检查服务器配置
claude mcp list

# 验证配置文件格式
cat ./server.json | jq .

2. 权限被拒绝

# 查看当前权限模式
claude --permission-mode default -p "检查权限"

# 临时绕过（仅可信环境）
claude --permission-mode bypassPermissions -p "任务"

# 允许特定工具
claude --allowed-tools "Read,Edit" -p "受限任务"

3. 会话无法恢复

# 列出可用会话
claude -r

# 检查会话 ID
claude --session-id <your-uuid> -p "测试"

# 使用 fork 创建新分支
claude -c --fork-session

4. 模型过载

# 设置备用模型
claude -p "重要任务" \
  --model opus \
  --fallback-model sonnet \
  --print

# 直接使用备用模型
claude -p "任务" --model sonnet --print

5. 插件加载失败

# 检查插件目录
claude --plugin-dir ./custom-plugins -p "测试插件"

# 列出已安装插件
claude plugin list

# 重新安装插件
claude plugin install <plugin-name> --reinstall

调试技巧

# 1. 启用详细输出
claude --verbose -d "all" -p "调试任务"

# 2. 检查配置
claude --settings ~/.claude/settings.json -p "验证配置"

# 3. 测试工具权限
claude --allowed-tools "Bash(echo:*)" -p "echo 'test'"

# 4. 检查 MCP 配置
claude mcp list
claude -d "mcp" -p "测试 MCP"

# 5. 运行健康检查
claude doctor

最佳实践

1. 性能优化

# 简单任务使用轻量级模型
claude -p "小任务" --model haiku --print

# 设置预算避免超支
claude -p "任务" --max-budget-usd 5.00 --print

# 使用备用模型确保可用性
claude -p "关键任务" \
  --model opus \
  --fallback-model sonnet \
  --print

2. 安全性

# 限制工具权限
claude --allowed-tools "Read,Grep" -p "只读任务"

# 禁用危险操作
claude --disallowed-tools "Bash(rm:*),Bash(dd:*)" -p "安全任务"

# 在可信环境使用 -p
claude -p "任务" --print  # 跳过信任对话框，确保目录可信

3. 自动化集成

# 使用 JSON 输出便于解析
claude -p "任务" --output-format json --print

# 使用 JSON Schema 确保输出格式
claude -p "任务" \
  --output-format json \
  --json-schema '{"type":"object","properties":{"result":{"type":"string"}}}' \
  --print

4. 会话管理

# 使用有意义的会话便于恢复
claude  # 在会话中专注于单个任务

# 定期保存重要会话
claude -r "重要任务"

# 使用 fork 尝试不同方案
claude -c --fork-session

附录

快速参考卡片

# 基本使用
claude                    # 交互式会话
claude -p "任务"          # 非交互模式
claude -c                 # 继续上一次会话
claude -r [id]            # 恢复会话

# 常用选项
--model <name>            # 指定模型
--output-format json      # JSON 输出
--allowed-tools <list>    # 工具白名单
--mcp-config <file>       # MCP 配置
-d <filter>               # 调试模式
--verbose                 # 详细输出
--permission-mode <mode>  # 权限模式

# 常用命令
claude mcp list           # 列出 MCP 服务器
claude plugin list        # 列出插件
claude doctor             # 健康检查
claude update             # 更新检查
claude install stable     # 安装稳定版

版本信息

本文档基于 Claude Code CLI 的当前版本编写。使用 claude --version 查看安装的版本。

文档更新日志

2025-12-24

修正内容：

✅ 更新 mcp 命令文档，添加所有实际子命令（serve, get, add-json, add-from-claude-desktop, reset-project-choices）
✅ 修正 add 命令的参数格式（add [options] <name> <commandOrUrl> [args...]）
✅ 添加 --transport 选项说明（支持 http、sse、stdio）
✅ 添加实际 MCP 服务器配置示例（Sentry HTTP、Asana SSE、Airtable stdio）
✅ 更新 plugin 命令文档，添加所有子命令（validate, marketplace, enable, disable）
✅ 修正插件安装命令格式（支持 plugin@marketplace 格式）
✅ 添加 --force 选项到 install 命令
✅ 添加 plan 到 --permission-mode 可选值

验证方法：
所有命令和选项均已通过实际 claude --help 和子命令帮助验证。

最后更新: 2025-12-25

huhuhuhr

https://blog.huhuhuhr.top/2025/12/24/claude-docs/

本博客所有文章除特別声明外，均采用 CC BY 4.0 许可协议。转载请注明来源 huhuhuhr !

无标签

测试智能部署脚本

2026-01-12 开发

测试

tmp-record

2025-12-09 huhuhuhr

claude docs

Claude Code CLI 完整使用指南

目录

快速开始

安装

基本使用

第一个示例

核心概念

1. 交互式会话模式

2. 非交互模式（Print Mode）

3. 会话持久化

4. 工作区与权限

命令详解

mcp - MCP 服务器配置管理

可用子命令

配置示例

传输类型说明

plugin - 插件管理

可用子命令

插件市场管理

插件启用/禁用

setup-token - 设置认证令牌

doctor - 健康检查

update - 更新检查

install - 安装原生版本

基本用法

选项参考

输出格式选项

-p, --print

--output-format <format>

--json-schema <schema>

--include-partial-messages

--input-format <format>

--replay-user-messages

调试选项

-d, --debug [filter]

--verbose

--mcp-debug

会话管理选项

-c, --continue

-r, --resume [value]

--fork-session

--no-session-persistence

--session-id <uuid>

工具权限选项

--allowedTools, --allowed-tools <tools...>

--tools <tools...>

--disallowedTools, --disallowed-tools <tools...>

--dangerously-skip-permissions

--allow-dangerously-skip-permissions

模型配置选项

--model <model>

--fallback-model <model>

--agent <agent>

--agents <json>

MCP 配置选项

--mcp-config <configs...>

--strict-mcp-config

系统提示词选项

--system-prompt <prompt>

--append-system-prompt <prompt>

权限模式选项

--permission-mode <mode>

设置和配置选项

--settings <file-or-json>

--setting-sources <sources>

--plugin-dir <paths...>

Beta 和测试选项

--betas <betas...>

IDE 集成选项

--ide

--no-chrome

--chrome

目录和会话选项

--add-dir <directories...>

其他选项

--max-budget-usd <amount>

--disable-slash-commands

-v, --version

-h, --help

`-p, --print`

`--output-format <format>`

`--json-schema <schema>`

`--include-partial-messages`

`--input-format <format>`

`--replay-user-messages`

`-d, --debug [filter]`

`--verbose`

`--mcp-debug`

`-c, --continue`

`-r, --resume [value]`

`--fork-session`

`--no-session-persistence`

`--session-id <uuid>`

`--allowedTools, --allowed-tools <tools...>`

`--tools <tools...>`

`--disallowedTools, --disallowed-tools <tools...>`

`--dangerously-skip-permissions`

`--allow-dangerously-skip-permissions`

`--model <model>`

`--fallback-model <model>`

`--agent <agent>`

`--agents <json>`

`--mcp-config <configs...>`

`--strict-mcp-config`

`--system-prompt <prompt>`

`--append-system-prompt <prompt>`

`--permission-mode <mode>`

`--settings <file-or-json>`

`--setting-sources <sources>`

`--plugin-dir <paths...>`

`--betas <betas...>`

`--ide`

`--no-chrome`

`--chrome`

`--add-dir <directories...>`

`--max-budget-usd <amount>`

`--disable-slash-commands`

`-v, --version`

`-h, --help`