Complete Claude Code Guide: From Installation to Advanced Usage

Complete Claude Code Guide: From Installation to Advanced Usage

A comprehensive tutorial covering everything you need to know about Claude Code - from basic installation and setup to advanced features like MCP integration, automation, and security best practices.

课 3 2025-07-03 08:02

Claude 代码命令完整参考

Claude Code 命令完整参考

本综合参考指南涵盖了所有可用的 Claude Code 命令,从基本的命令行界面 (CLI) 操作到高级功能和隐藏命令。无论您是初学者还是高级用户,本指南都将帮助您掌握 Claude Code 丰富的命令集。

命令类别

Claude Code 命令分为以下几类: - CLI 命令:用于启动和配置 Claude Code 的终端命令。 - 交互式命令:在 Claude Code 会话中使用的斜杠命令。 - 配置命令:用于管理设置和首选项的命令。 - MCP 命令:用于管理模型上下文协议 (Model Context Protocol, MCP) 服务器的命令。 - 会话管理:用于处理对话和内存的命令。

CLI 命令

核心命令

启动 Claude Code

命令 描述 示例
claude 启动交互式 REPL claude
claude "query" 带初始提示的 REPL claude "help debug this"
claude -p "query" 一次性查询(打印模式) claude -p "explain function"

会话管理

命令 描述 示例
claude -c 继续上次会话 claude -c
claude -r <id> 恢复特定会话 claude -r abc123
claude --resume <name> 恢复命名会话 claude --resume project-review

配置管理

命令 描述 示例
claude config 交互式配置 claude config
claude config list 列出所有设置 claude config list
claude config get <键> 获取特定值 claude config get model
claude config set <键> <值> 设置值 claude config set model sonnet

CLI 标志与选项

基本标志

标志 简称 描述 示例
--print -p 打印响应,非交互模式 claude -p "help"
--continue -c 加载最近的对话 claude -c
--help -h 显示帮助信息 claude --help
--version -v 显示版本 claude --version

输出控制标志

标志 选项 描述 示例
--output-format text, json, stream-json 控制响应格式 claude -p "help" --output-format json
--json - JSON 输出的简写 claude -p "analyze" --json
--verbose - 启用详细日志 claude --verbose

安全与权限标志

标志 风险级别 描述 示例
--allowedTools <工具> 白名单特定工具 claude --allowedTools "Edit,View"
--disallowedTools <工具> 黑名单特定工具 claude --disallowedTools "Bash"
--dangerously-skip-permissions 极高 跳过所有权限提示 claude --dangerously-skip-permissions

高级标志

标志 用途 示例 备注
--add-dir <路径> 添加工作目录 claude --add-dir ../lib ../src
--model <模型> 设置特定模型 claude --model sonnet
--mcp-debug 启用 MCP 调试 claude --mcp-debug

交互式命令(斜杠命令)

这些命令在 Claude Code 的交互模式下使用:

系统命令

命令 用途 描述
/help 显示所有斜杠命令 列出可用的交互式命令
/clear 清除当前对话 开始新的对话
/exit 安全退出 Claude 正确关闭 Claude Code
/bug 报告问题 打开问题报告界面

诊断命令

命令 用途 描述
/doctor 完成健康检查 运行全面的系统诊断
/status 系统信息 显示当前状态和配置
/cost 令牌使用统计 显示当前会话成本
/sessions 列出所有会话 显示所有可用的对话会话

配置命令

命令 用途 描述
/config 配置菜单 打开交互式配置
/permissions 管理工具访问 配置工具权限
/memory 编辑内存文件 访问和编辑项目内存

MCP 命令

命令 用途 描述
/mcp MCP 服务器管理 交互式 MCP 配置
/mcp list 列出已配置服务器 显示所有已配置的 MCP 服务器
/mcp status 检查服务器状态 显示 MCP 服务器健康状况

配置命令

全局配置

# 查看所有配置
claude config list

# 获取特定设置
claude config get model
claude config get allowedTools
claude config get outputFormat

# 设置配置值
claude config set model claude-sonnet-4
claude config set verbose true
claude config set outputFormat text

# 设置全局设置
claude config set -g model claude-sonnet-4
claude config set -g allowedTools "Edit,View"

项目配置

# 项目特定设置(在项目目录中)
claude config set systemPrompt "You are a senior developer"
claude config set allowedTools "Edit,View,Bash(git:*)"

# 从文件导入配置
claude config import config.json

# 导出当前配置
claude config export > my-config.json

MCP 命令

服务器管理

# 交互式 MCP 设置
claude mcp

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

# 添加新服务器
claude mcp add git "git-mcp-server"
claude mcp add postgres "postgres-mcp-server --host localhost"

# 移除服务器
claude mcp remove git

# 检查服务器状态
claude mcp status
claude mcp status git

# 重启服务器
claude mcp restart git
claude mcp restart --all

# 调试 MCP 问题
claude mcp debug
claude mcp logs git

服务器配置

# 使用环境变量添加服务器
claude mcp add github "github-mcp-server" --env GITHUB_TOKEN=token

# 使用特定参数添加服务器
claude mcp add db "postgres-mcp-server" --args "--host localhost --port 5432"

# 测试服务器连接
claude mcp test git
claude mcp test --all

权限命令

工具权限模式

# 允许特定工具
claude --allowedTools "Edit,View"

# 允许工具类别
claude --allowedTools "Edit,View,Bash"

# 范围权限(仅限 Git 操作)
claude --allowedTools "Bash(git:*)"

# 多个范围
claude --allowedTools "Bash(git:*),Bash(npm:*)"

# MCP 工具权限
claude --allowedTools "mcp__git__*"
claude --allowedTools "mcp__postgres__query,mcp__postgres__schema"

# 组合权限
claude --allowedTools "Edit,View,mcp__git__*,Bash(npm:*)"

安全级别

# 限制模式(最安全)
claude --allowedTools "View"

# 开发模式
claude --allowedTools "Edit,View,Bash(git:*)"

# 完全开发访问
claude --allowedTools "Edit,View,Bash,mcp__*"

# 危险模式(仅在容器中使用)
claude --dangerously-skip-permissions

会话管理命令

会话操作

# 列出所有会话
claude sessions list

# 恢复特定会话
claude --resume session-name
claude -r session-id

# 创建命名会话
claude --session my-project "Start working on authentication"

# 继续上次会话
claude -c

# 清除会话历史
claude sessions clear
claude sessions clear --before "2024-01-01"

# 导出会话
claude sessions export session-id > session.json

# 导入会话
claude sessions import session.json

内存管理

# 查看项目内存
claude /memory view

# 编辑项目内存
claude /memory edit

# 清除项目内存
claude /memory clear

# 设置项目上下文
claude /memory set "This is a React TypeScript project"

# 添加到项目内存
claude /memory add "Use ESLint for code style"

环境变量命令

设置环境变量

# 核心配置
export ANTHROPIC_API_KEY="sk-your-key-here"
export ANTHROPIC_MODEL="claude-sonnet-4"
export ANTHROPIC_BASE_URL="https://api.anthropic.com"

# 性能设置
export MAX_THINKING_TOKENS=50000
export DISABLE_NON_ESSENTIAL_MODEL_CALLS=1

# 隐私设置
export DISABLE_TELEMETRY=1
export DISABLE_ERROR_REPORTING=1

# 云服务提供商设置
export CLAUDE_CODE_USE_BEDROCK=1
export CLAUDE_CODE_USE_VERTEX=1

# 网络设置
export HTTP_PROXY="http://proxy.company.com:8080"
export HTTPS_PROXY="https://proxy.company.com:8443"
export NO_PROXY="localhost,127.0.0.1,*.company.com"

高级命令模式

管道和自动化

# 将内容通过管道传递给 Claude
cat file.py | claude -p "review this code"
git diff | claude -p "explain these changes"
npm test 2>&1 | claude -p "fix these test failures"

# 链式命令
claude -p "analyze logs" < app.log && echo "Analysis complete"

# 保存输出
claude -p "generate documentation" > docs.md
claude -p "create README" --output-format json > readme.json

批量操作

# 处理多个文件
for file in *.py; do
  claude -p "review $file for security issues" < "$file"
done

# 自动化代码审查
git diff HEAD~1 | claude -p "review changes and suggest improvements"

# 文档生成
find . -name "*.js" -exec claude -p "document this function" {} \;

复杂工作流

# 开发工作流
claude --add-dir src test \
  --allowedTools "Edit,View,Bash(git:*),mcp__*" \
  "Start code review session"

# 数据库分析
claude --allowedTools "mcp__postgres__*,View" \
  "Analyze database performance issues"

# 安全审计
claude --allowedTools "View,mcp__git__*" \
  "Perform security audit of recent commits"

故障排除命令

诊断命令

# 健康检查
claude /doctor

# 版本信息
claude --version
claude /status

# 配置检查
claude config list
claude config get allowedTools
claude config get model

# MCP 诊断
claude mcp status
claude mcp list
claude --mcp-debug

# 网络诊断
curl -I https://api.anthropic.com
ping api.anthropic.com

重置命令

# 重置配置
claude config reset
claude config set --reset

# 清除会话
claude sessions clear --all

# 重启 MCP 服务器
claude mcp restart --all

# 清除缓存
claude cache clear

# 彻底重置(终极手段)
rm ~/.claude.json
claude config

隐藏与高级命令

高级用户命令

# 绕过所有安全检查(危险)
claude --dangerously-skip-permissions --no-safety-checks

# 强制使用特定模型
claude --model claude-3-opus --force-model

# 启用所有标志的调试模式
claude --verbose --debug --mcp-debug --trace-all

# 性能模式
claude --fast-mode --disable-thinking --no-context-window-management

# 实验性功能
claude --experimental-features --enable-all-tools

开发命令

# 开发模式
claude --dev-mode --unsafe-tools --experimental

# 测试模式
claude --test-mode --mock-api --dry-run

# 性能分析
claude --profile --timing --memory-usage

# API 调试
claude --log-api-calls --show-tokens --cost-tracking

命令组合与工作流程

日常开发工作流

# 早会
claude -c --add-dir . "Show me what I was working on yesterday"

# 代码审查
claude --allowedTools "View,mcp__git__*" "Review latest commits"

# 功能开发
claude --allowedTools "Edit,View,Bash(git:*)" "Help implement user authentication"

# 一天结束
claude "Summarize today's work and plan tomorrow"

项目设置工作流

# 初步项目设置
claude --add-dir . --allowedTools "Edit,View,Bash(npm:*)" \
  "Set up new React TypeScript project"

# 配置 MCP
claude mcp add git "git-mcp-server"
claude mcp add postgres "postgres-mcp-server"

# 设置项目内存
claude /memory set "React TypeScript project with PostgreSQL"

调试工作流

# 错误分析
tail -f app.log | claude -p "monitor for errors and suggest fixes"

# 性能调试
claude --allowedTools "View,mcp__*" "Analyze database slow queries"

# 测试调试
npm test 2>&1 | claude -p "fix failing tests"

快速参考卡片

最常用命令

# 启动 Claude
claude                          # 交互模式
claude "问题"                   # 带初始提示
claude -p "问题"                # 打印模式

# 会话
claude -c                       # 继续上次会话
claude --resume 名称            # 恢复命名会话

# 配置
claude config                   # 交互式配置
claude /doctor                  # 健康检查

# MCP
claude mcp                      # MCP 管理
claude /mcp                     # 会话内 MCP

# 帮助
claude --help                   # CLI 帮助
claude /help                    # 交互式帮助

基本标志

--allowedTools "Edit,View"      # 安全权限
--dangerously-skip-permissions  # 危险模式
--output-format json            # JSON 输出
--verbose                       # 调试模式
--add-dir path                  # 添加目录

本命令参考提供了 Claude Code 功能的全面概述。请记住,始终从安全权限开始,并根据需要逐步扩大访问权限。使用 /doctor 命令进行故障排除,使用 /help 在 Claude Code 会话中快速获取帮助。