本指南旨在为人类开发者和 AI 代理提供全面参考。所有功能均已根据官方文档进行验证。
[官方] 标签表示功能来源于 docs.claude.com。 [社区] 标签表示在实践中观察到的模式。 [实验性] 标签表示尚未完全验证的概念。 什么是 Claude Code? Claude Code 是一款在终端中运行的 AI 编程助理。它能够理解您的代码库、直接编辑文件、运行命令,并通过自然语言对话帮助您更快地编程。
核心能力 💬 自然语言接口:在您的终端中直接对话。 📝 文件编辑与命令执行:直接修改文件和执行 Shell 命令。 🔍 项目全局上下文感知:理解整个项目的结构。 🔗 外部集成:通过 MCP (模型上下文协议) 连接外部数据源。 🤖 可扩展性:通过技能 (Skills)、钩子 (Hooks) 和插件 (Plugins) 进行扩展。 🛡️ 沙箱执行:为安全操作提供沙箱环境。 安装 通过 npm 全局安装:
npm install -g @anthropic-ai/claude-code 验证安装:
claude --version 官方文档位于 docs.claude.com/en/docs/claude-code/overview。
快速参考 核心命令 [官方] # 启动 Claude Code claude # 启动交互式会话 claude -p "任务描述" # 打印模式 (非交互式) claude --continue # 继续上一次的会话 claude --resume <id> # 恢复指定的会话 # 会话管理 /help # 显示可用命令 /exit # 结束会话 /compact # 减少上下文大小 /microcompact # 智能上下文清理 [新功能] # 后台任务 /bashes # 列出后台进程 /kill <id> # 停止指定的后台进程 # 发现 /commands # 列出所有斜杠命令 /hooks # 显示已配置的钩子 /skills # 列出可用的技能 (Skills) [新功能] /plugin # 管理插件 CLI 标志参考 [官方] # 输出控制 claude -p, --print "任务" # 打印模式:非交互式,打印结果后退出 claude --output-format json # 输出格式:json, markdown, 或 text claude --no-color # 禁用彩色输出 # 会话管理 claude --continue # 从上一次会话继续 claude --resume <session-id># 通过 ID 恢复指定会话 claude --list-sessions # 列出所有可用会话 # 调试与日志 claude --debug # 启用调试模式,输出详细日志 claude --log-level <level> # 设置日志级别:error, warn, info, debug, trace # 模型与配置 claude --model <model-name> # 指定使用的模型 claude --config <path> # 使用自定义配置文件 # 沙箱 (macOS/Linux) claude --sandbox # 启用沙箱模式以增强安全性 claude --no-sandbox # 禁用沙箱模式 常用组合 # 执行一次性任务并以 JSON 格式输出 claude --print "分析这段代码" --output-format json # 使用自定义配置启动调试会话 claude --debug --config .claude/custom-settings.json # 使用特定模型恢复会话 claude --resume abc123 --model claude-opus-4 # 在 CI/CD 环境中非交互式运行,无颜色输出 claude --print "运行测试" --no-color --output-format json 核心概念 1. 工作原理 [官方] Claude Code 通过终端中的对话界面工作:
...