Claude Code 知识库
约 3 分钟
来源:官方文档 更新:2026-02-22
Claude Code 是一个 AI 编程助手,可以读取代码库、编辑文件、运行命令,并集成到开发工具中。
| 平台 | 说明 |
|---|---|
| Terminal | 命令行完整功能 |
| VS Code | 内联 diff、@提及、计划审查 |
| Desktop App | 独立桌面应用 |
| Web | 浏览器直接运行 |
| JetBrains | IntelliJ IDEA、PyCharm 等 |
| Chrome | 浏览器扩展 |
curl -fsSL https://claude.ai/install.sh | bashirm https://claude.ai/install.ps1 | iexbrew install --cask claude-code| 命令 | 说明 | 示例 |
|---|---|---|
claude | 启动交互式会话 | claude |
claude "query" | 带初始提示启动 | claude "explain this project" |
claude -p "query" | 查询后退出 | claude -p "explain this function" |
claude -c | 继续当前目录最近会话 | claude -c |
claude -r "session" "query" | 恢复指定会话 | claude -r "auth-refactor" "Finish this PR" |
claude update | 更新到最新版本 | claude update |
claude agents | 列出所有子代理 | claude agents |
claude mcp | 配置 MCP 服务器 | claude mcp |
| 参数 | 说明 | 示例 |
|---|---|---|
--dangerously-skip-permissions | 跳过所有权限提示 | claude --dangerously-skip-permissions |
--allowedTools | 允许的工具 | claude --allowedTools "Bash(git:*) Read" |
--disallowedTools | 禁止的工具 | claude --disallowedTools "Write Edit" |
--add-dir | 允许访问的目录 | claude --add-dir ../apps |
--append-system-prompt | 追加系统提示 | claude --append-system-prompt "Always use TypeScript" |
--debug | 调试模式 | claude --debug "api,hooks" |
--model | 指定模型 | claude --model opus |
--agent | 指定子代理 | claude --agent my-agent |
| 作用域 | 位置 | 作用范围 |
|---|---|---|
| Managed | 系统级 managed-settings.json | 机器上所有用户 |
| User | ~/.claude/ | 跨所有项目 |
| Project | .claude/ 在仓库中 | 协作者共享 |
| Local | .claude/*.local.* | 仅当前机器 |
| 功能 | User | Project | Local |
|---|---|---|---|
| Settings | ~/.claude/settings.json | .claude/settings.json | .claude/settings.local.json |
| Subagents | ~/.claude/agents/ | .claude/agents/ | - |
| MCP | ~/.claude.json | .mcp.json | ~/.claude.json |
| CLAUDE.md | ~/.claude/CLAUDE.md | CLAUDE.md | CLAUDE.local.md |
CLAUDE.md 是项目根目录的 Markdown 文件,Claude Code 在每个会话开始时读取。
# 项目名称
## 概述
项目描述...
## 编码规范
- 使用 TypeScript
- 函数不超过 50 行
## 构建命令
- `npm run dev` - 开发
- `npm run build` - 构建
## 测试
- 运行 `npm test`Hooks 是 Claude Code 生命周期中特定点自动执行的命令或提示。
| 事件 | 触发时机 |
|---|---|
SessionStart | 会话开始或恢复 |
UserPromptSubmit | 提交提示后、处理前 |
PreToolUse | 工具调用前(可阻止) |
PermissionRequest | 权限对话框出现 |
PostToolUse | 工具调用成功后 |
PostToolUseFailure | 工具调用失败后 |
Stop | Claude 响应完成 |
SessionEnd | 会话结束 |
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": ".claude/hooks/block-rm.sh",
"timeout": 10
}
]
{
"hookSpecificOutput": {
"hookEventName": "PreToolUse",
"permissionDecision": "deny",
"permissionDecisionReason": "Destructive command blocked"
}
}子代理是专门的 AI 助手,处理特定类型的任务。
| 子代理 | 模型 | 用途 |
|---|---|---|
| Explore | Haiku | 只读搜索和分析代码库 |
| Plan | 继承 | 计划模式下的研究 |
| General-purpose | 继承 | 复杂多步骤任务 |
/agents或手动创建 Markdown 文件:
---
name: code-reviewer
description: 代码审查代理,检查代码质量问题
model: sonnet
tools:
- Read
- Glob
- Grep
---
# 系统提示
你是一个代码审查代理...MCP 是连接 AI 工具和外部数据源的开放标准。
claude mcp或在 ~/.claude.json 中配置:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed"]
}
}
}创建自定义斜杠命令。
/claude-code skill create review-pr/review-pr多个 Claude Code 代理并行工作。
claude --agent-teams| 选项 | 说明 |
|---|---|
--teammate-mode auto | 自动分配任务 |
--teammate-mode in-process | 进程内运行 |
--teammate-mode tmux | tmux 隔离运行 |
cat logs.txt | claude -p "分析这些日志"
git diff main | claude -p "review these changes"claude -p "translate new strings into French and raise a PR"git diff main --name-only | claude -p "review these files for security"claude -cclaude -r session-name "继续完成任务"claude --dangerously-skip-permissionsclaude --disallowedTools "Write Edit"配置 settings.json 中的 model 和 API 端点。
将 .claude/ 目录加入版本控制。
持续更新...