Claude Code 知识库
约 3 分钟
来源:官方文档 更新:2026-02-22
一、概述
Claude Code 是一个 AI 编程助手,可以读取代码库、编辑文件、运行命令,并集成到开发工具中。
支持的平台
| 平台 | 说明 |
|---|---|
| Terminal | 命令行完整功能 |
| VS Code | 内联 diff、@提及、计划审查 |
| Desktop App | 独立桌面应用 |
| Web | 浏览器直接运行 |
| JetBrains | IntelliJ IDEA、PyCharm 等 |
| Chrome | 浏览器扩展 |
二、安装
macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell
irm https://claude.ai/install.ps1 | iexHomebrew
brew install --cask claude-code三、CLI 命令参考
| 命令 | 说明 | 示例 |
|---|---|---|
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 |
常用 CLI 参数
| 参数 | 说明 | 示例 |
|---|---|---|
--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.* | 仅当前机器 |
优先级(从高到低)
- Managed(最高)
- 命令行参数
- Local
- Project
- User(最低)
配置文件位置
| 功能 | 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
CLAUDE.md 是项目根目录的 Markdown 文件,Claude Code 在每个会话开始时读取。
用途
- 设置编码标准
- 架构决策
- 首选库
- 审查清单
示例结构
# 项目名称
## 概述
项目描述...
## 编码规范
- 使用 TypeScript
- 函数不超过 50 行
## 构建命令
- `npm run dev` - 开发
- `npm run build` - 构建
## 测试
- 运行 `npm test`六、Hooks 钩子
Hooks 是 Claude Code 生命周期中特定点自动执行的命令或提示。
Hook 事件
| 事件 | 触发时机 |
|---|---|
SessionStart | 会话开始或恢复 |
UserPromptSubmit | 提交提示后、处理前 |
PreToolUse | 工具调用前(可阻止) |
PermissionRequest | 权限对话框出现 |
PostToolUse | 工具调用成功后 |
PostToolUseFailure | 工具调用失败后 |
Stop | Claude 响应完成 |
SessionEnd | 会话结束 |
配置示例
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": ".claude/hooks/block-rm.sh",
"timeout": 10
}
]
Hook 返回决策
{
"hookSpecificOutput": {
"hookEventName": "PreToolUse",
"permissionDecision": "deny",
"permissionDecisionReason": "Destructive command blocked"
}
}七、子代理 (Subagents)
子代理是专门的 AI 助手,处理特定类型的任务。
内置子代理
| 子代理 | 模型 | 用途 |
|---|---|---|
| Explore | Haiku | 只读搜索和分析代码库 |
| Plan | 继承 | 计划模式下的研究 |
| General-purpose | 继承 | 复杂多步骤任务 |
创建子代理
/agents或手动创建 Markdown 文件:
---
name: code-reviewer
description: 代码审查代理,检查代码质量问题
model: sonnet
tools:
- Read
- Glob
- Grep
---
# 系统提示
你是一个代码审查代理...八、MCP (Model Context Protocol)
MCP 是连接 AI 工具和外部数据源的开放标准。
配置 MCP 服务器
claude mcp或在 ~/.claude.json 中配置:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed"]
}
}
}九、Skills 自定义命令
创建自定义斜杠命令。
创建技能
/claude-code skill create review-pr使用技能
/review-pr十、Agent Teams 团队模式
多个 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 -c恢复指定会话
claude -r session-name "继续完成任务"十二、常见问题
Q: 如何跳过权限提示?
claude --dangerously-skip-permissionsQ: 如何限制工具访问?
claude --disallowedTools "Write Edit"Q: 如何使用第三方模型?
配置 settings.json 中的 model 和 API 端点。
Q: 如何让 CLAUDE.md 跨设备同步?
将 .claude/ 目录加入版本控制。
持续更新...