大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



The Complete Guide — 2026 Edition

涵盖：安装配置 · 交互模式 · 全部命令 · MCP集成 · Hooks自动化 · 子代理 · CLAUDE.md ·

---

1. 概述
2. 安装与认证
3. 交互模式详解
4. 完整命令参考
5. 会话内斜杠命令
6. 键盘快捷键
7. CLAUDE.md 项目配置文件
8. MCP 集成
9. Hooks 自动化系统
10. Skills 自定义技能
11. 子代理系统
12. 典型使用场景
13. 高级配置与环境变量
14. 费用与订阅说明
15. 企业与团队使用
16. 常见问题与故障排除

---

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，它不是普通的聊天机器人，而是一个真正的代理系统（Agentic System）。它能够读取你的代码库、执行 Shell 命令、修改文件、管理 Git 工作流，并通过 MCP 协议连接外部服务。

📊 数据参考：截至 2026 年 2 月，GitHub 上 4% 的公开提交（约 13.5 万次/天）由 Claude Code 生成，Anthropic 内部 90% 的代码为 AI 编写。

1.1 核心架构：三层系统

理解 Claude Code 的架构是高效使用的关键：

GPT plus 代充 只需 145┌─────────────────────────────────────────────────────────┐ │ CLAUDE CODE LAYERS │ ├─────────────────────────────────────────────────────────┤ │ EXTENSION LAYER (扩展层) │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ MCP │ │ Hooks │ │ Skills │ │ Plugins │ │ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ ├─────────────────────────────────────────────────────────┤ │ DELEGATION LAYER (委托层) │ │ ┌─────────────────────────────────────────────────┐ │ │ │ Subagents（最多 10 个并行） │ │ │ └─────────────────────────────────────────────────┘ │ ├─────────────────────────────────────────────────────────┤ │ CORE LAYER (核心层) │ │ ┌─────────────────────────────────────────────────┐ │ │ │ 主对话上下文（200K token / Opus 1M token） │ │ │ └─────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────┘ 

1.2 五大核心系统

掌握以下五个系统，Claude Code 将成为你的生产力倍增器：

1. 配置层级（Configuration Hierarchy）：控制整体行为
2. 权限系统（Permission System）：管控所有操作
3. Hook 系统（Hook System）：确定性自动化
4. MCP 协议（MCP Protocol）：扩展外部能力
5. 子代理系统（Subagent System）：处理复杂多步骤任务

1.3 支持的使用界面

• 终端 CLI（主要界面）
• Web 界面（claude.ai/code）
• 桌面应用
• VS Code 和 JetBrains IDE 插件
• Slack 集成（通过 @Claude 触发）
• CI/CD 集成（GitHub Actions、GitLab）

---

2.1 系统要求

• Node.js 18+（推荐 LTS 版本）
• macOS、Linux 或 Windows（需安装 Git for Windows）
• 付费 Claude 订阅（Pro、Max、Team 或 Enterprise）或 Anthropic API Key

2.2 安装方式

方式一：npm 安装（通用）

npm install -g @anthropic-ai/claude-code 

方式二：Homebrew（macOS 推荐）

GPT plus 代充 只需 145brew install claude-code # 手动更新：brew upgrade claude-code 

方式三：WinGet（Windows）

winget install Anthropic.ClaudeCode # 手动更新：winget upgrade Anthropic.ClaudeCode 

注意：npm 安装会自动后台更新；Homebrew 和 WinGet 安装需要手动运行更新命令。

2.3 认证登录

GPT plus 代充 只需 145# 启动后会自动提示登录，或手动执行： claude auth login

# 查看当前登录状态 claude auth status

# 退出登录 claude auth logout

支持三种认证方式：Claude 订阅账号（浏览器 OAuth）、Anthropic Console API Key（预付费额度）、企业云提供商（Amazon Bedrock / Google Vertex AI / Microsoft Foundry）。

2.4 验证安装

# 查看版本号 claude –version

# 在任意项目目录启动 cd /your/project claude

---

3.1 交互式 REPL 模式

最常用的使用方式，启动一个持续的对话式编程会话：

GPT plus 代充 只需 145# 进入交互模式 claude

# 在指定目录启动 claude –cwd /path/to/project

# 携带初始提示启动 claude “解释一下这个项目的架构”

3.2 一次性执行模式（Print Mode）

适合脚本和自动化，执行完毕后直接退出：

# -p 或 –print 标志 claude -p “列出所有 TODO 注释”

# 管道传入代码进行审查 cat main.py | claude -p “审查这段代码”

# 输出为 JSON 格式（适合自动化解析） claude -p “分析代码质量” –output-format json

# 流式输出 JSON claude -p “分析依赖关系” –output-format stream-json

3.3 继续会话模式

GPT plus 代充 只需 145# 继续上次对话 claude –continue

# 在会话内用斜杠命令恢复 /resume

# 通过 Session ID 恢复（远程会话） claude –teleport <session-id>

3.4 计划模式（Plan Mode）

让 Claude 在执行前先制定计划，不立即修改文件。适合复杂任务的安全验证：

# 在会话中切换到计划模式 /plan

# 或按 Shift+Tab 键循环切换模式

3.5 自动执行模式

GPT plus 代充 只需 145# 跳过权限提示（仅用于可信容器环境！） claude –dangerously-skip-permissions

# 结合一次性模式使用（CI/CD 场景） claude -p “运行测试并修复失败” –dangerously-skip-permissions

⚠️ 安全警告：–dangerously-skip-permissions 仅应在隔离的容器环境中使用，切勿在本地开发机器上无监督使用！

---

4.1 基础 CLI 命令

4.2 常用启动标志（CLI Flags）

会话控制

模型与模式控制

输出控制

系统提示控制

权限控制

---

5.1 项目管理

5.2 信息与状态

5.3 模式与模型控制

5.4 功能管理

5.5 集成与扩展

5.6 内存管理

使用 # 前缀快速向 CLAUDE.md 添加记忆：

# 本项目使用 2 空格缩进

测试框架为 Jest，运行命令是 npm test

API 文档在 docs/api.md

使用 @ 符号引用文件：

GPT plus 代充 只需 145# 引用具体文件 @src/utils/helper.ts 帮我添加单元测试

引用目录

@docs/ 生成 API 概览文档

---

6.1 基本操作

6.2 模式切换

6.3 文件与图片操作

macOS 注意：粘贴图片请使用 Ctrl+V 而非 Cmd+V，Cmd+V 在 Claude Code 中不起作用。

6.4 Shell 命令直通

在会话中使用 ! 前缀直接执行 Shell 命令，绕过 Claude 的对话处理（节省 token）：

! git status ! npm test ! ls -la 

---

CLAUDE.md 是 Claude Code 的核心配置文件，告诉 Claude 项目的规范、约定和重要信息。每次会话开始时自动加载。

7.1 文件位置与优先级

7.2 **实践模板

GPT plus 代充 只需 145# 项目概述 这是一个 Next.js + TypeScript 全栈应用。

技术栈

• 前端：Next.js 14, React, Tailwind CSS
• 后端：Node.js, Express, PostgreSQL
• 测试：Jest, React Testing Library

代码规范

• 使用 2 空格缩进
• 文件命名：camelCase（JS/TS），kebab-case（CSS）
• 组件命名：PascalCase
• 禁止使用 any 类型

常用命令

• 开发：npm run dev
• 测试：npm test
• 构建：npm run build
• Lint：npm run lint

重要目录

• src/components：UI 组件
• src/lib：工具函数
• src/api：API 路由
• docs/：项目文档

禁止事项

• 不要修改 package-lock.json
• 不要直接向 main 分支提交
• 数据库迁移需提前告知

  ---

MCP 是 Claude Code 的外部能力扩展协议，让 Claude 能连接数据库、GitHub、Sentry 等 3000+ 种外部服务。

8.1 添加 MCP 服务器

# 添加 MCP 服务器（全局） claude mcp add <名称> <命令>

# 添加到项目（.claude/mcp.json） claude mcp add –scope project <名称> <命令>

# 示例：添加 GitHub MCP claude mcp add github npx @modelcontextprotocol/server-github

# 示例：添加 PostgreSQL MCP claude mcp add postgres npx @modelcontextprotocol/server-postgres postgresql://localhost/mydb

8.2 管理 MCP 服务器

8.3 常用 MCP 服务器推荐

8.4 MCP 配置文件示例

GPT plus 代充 只需 145// .claude/mcp.json { “mcpServers”: {

"github": { "command": "npx", "args": ["@modelcontextprotocol/server-github"], "env": { "GITHUB_TOKEN": "your-token-here" } }, "postgres": { "command": "npx", "args": [ "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb" ] } 

} }

---

Hooks 在 Claude Code 生命周期的特定节点自动执行 Shell 命令。与提示词不同，Hooks 保证每次都执行，不受模型行为影响。

💡 核心原则：对于必须每次执行的操作（代码格式化、安全检查、Lint），用 Hooks 而不是提示词。

9.1 Hook 触发事件

9.2 Hooks 配置文件示例

在 .claude/settings.json 中配置（推荐使用 /hooks 命令交互式配置）：

GPT plus 代充 只需 145{ “hooks”: {

"PostToolUse": [ { "matcher": "Write(*.py)", "hooks": [{ "type": "command", "command": "python -m black "$file"" }] }, { "matcher": "Write(*.ts)|Edit(*.ts)", "hooks": [{ "type": "command", "command": "npx prettier --write "$file"" }] } ], "PreToolUse": [ { "matcher": "Bash", "hooks": [{ "type": "command", "command": "echo "执行命令：$command"" }] } ] 

} }

9.3 实用 Hook 示例

Python 文件自动格式化（Black + isort）

GPT plus 代充 只需 145“PostToolUse”: [{ “matcher”: “Write(.py)|Edit(.py)”, “hooks”: [

{ "type": "command", "command": "python -m black "$file"" }, { "type": "command", "command": "python -m isort "$file"" } 

] }]

TypeScript 类型检查

GPT plus 代充 只需 145“PostToolUse”: [{ “matcher”: “Write(.ts)|Write(.tsx)”, “hooks”: [{

"type": "command", "command": "npx tsc --noEmit --skipLibCheck 2>&1 | head -20" 

}] }]

提交前安全检查

GPT plus 代充 只需 145“PreToolUse”: [{ “matcher”: “Bash(git commit*)”, “hooks”: [{

"type": "command", "command": "npm audit --audit-level moderate" 

}] }]

---

Skills 是打包为 SKILL.md 文件的指令集，让 Claude 知道如何处理特定类型的任务。Claude 可以根据你的请求自动激活相关 Skills，也可以直接调用。

10.1 Skills 目录结构

GPT plus 代充 只需 145your-project/ ├── .claude/ │ ├── CLAUDE.md │ ├── skills/ │ │ ├── security-review.md # 项目级 Skill │ │ └── deploy.md │ └── commands/ # 旧版命令（仍兼容） └── …

~/.claude/skills/ # 全局 Skill（所有项目可用）

└── git-commit.md 

10.2 创建自定义 Skill

GPT plus 代充 只需 145— name: security-review description: 对代码库进行安全审查。当被要求审查安全性、查找漏洞时触发。

allowed-tools: [Read, Grep, Glob]

安全审查：$ARGUMENTS

检查清单

1. 身份认证与授权

• 检查密码策略
• 验证 JWT token 校验逻辑
• 审查访问控制

2. 输入验证

• SQL 注入风险
• XSS 漏洞
• 路径遍历攻击

3. 敏感数据

• 硬编码密钥或凭证
• 日志中的敏感信息

  10.3 使用 Skills

  # 自动触发（根据描述匹配） > 帮我审查 src/auth.ts 的安全性

# 直接调用 > /security-review src/auth.ts

# 带参数调用 > /fix-issue 123

10.4 带动态上下文的 Skill

GPT plus 代充 只需 145— name: pr-summary description: 总结 PR 的变更内容

allowed-tools: Bash(gh *)

PR 上下文

• 变更差异：!`gh pr diff`
• PR 评论：!`gh pr view –comments`
• 变更文件：!`gh pr diff –name-only`

任务

基于以上内容，生成一份清晰的 PR 摘要…

注：!`command` 语法会在发给 Claude 前先执行命令，将输出注入上下文。

---

子代理是 Claude Code 的并行任务执行系统。每个子代理拥有独立的干净上下文，专注于特定任务，完成后将结果摘要返回主对话。最多支持 10 个并行子代理。

11.1 内置子代理类型

11.2 使用子代理

# 自然语言触发（Claude 自动判断是否使用子代理） > 并行重构 src/ 下所有模块，为每个模块添加类型注解

# 命令行定义子代理 claude –agents ‘[{“name”:“explorer”,“model”:“claude-haiku-4-5”,“type”:“Explore”}]’

# 在 Skill 中定义 fork 上下文（隔离子代理）

name: deep-research context: fork

agent: Explore

深度研究 $ARGUMENTS：...

11.3 子代理**实践

• 将探索/搜索任务路由到 Haiku（便宜快速），复杂推理任务保留给 Opus
• 对每个子代理设定清晰、单一的目标
• 用 context: fork 隔离不需要对话历史的任务
• 子代理只返回摘要，不会污染主对话上下文
• 并行化互不依赖的任务（如同时分析多个模块）

---

12.1 代码理解与分析

GPT plus 代充 只需 145# 理解项目结构 > 给我一个项目整体架构概览 > 解释 src/auth 目录的作用和工作原理 > 这个函数的时间复杂度是多少？

# 依赖分析 > 找出所有未使用的 npm 依赖 > 哪些模块依赖了 utils/legacy.ts？

12.2 编写与修改代码

# 功能实现 > 实现一个带有速率限制的 JWT 认证中间件 > 为 UserService 添加缓存层，使用 Redis

# 重构 > 将 src/utils.js 中所有回调函数改为 async/await > 提取 Dashboard 组件中重复的逻辑

# Bug 修复 > 找出并修复内存泄漏 > 这个边界情况会导致崩溃，请修复

12.3 测试与质量

GPT plus 代充 只需 145# 生成测试 > 为 @src/services/payment.ts 生成完整的单元测试 > 添加覆盖边界情况和错误路径的测试用例

# 代码审查 > 审查最新的变更，关注性能和安全性 > 这段代码有什么潜在问题？

# 运行测试 > 运行测试套件，修复所有失败的测试

12.4 Git 工作流

# 提交管理 > 创建一个语义化的 commit message > 审查暂存的变更并提交

# PR 操作 > 总结本次 PR 的所有变更 > 根据 PR 评论修改代码

# 代码历史 > 解释最近 10 次提交做了什么 > 找出引入 Bug X 的提交

12.5 文档生成

GPT plus 代充 只需 145# API 文档 > 为所有公开 API 端点生成 OpenAPI 文档 > 更新 README 中的使用示例

# 代码注释 > 为 @src/core/ 下所有公开函数添加 JSDoc 注释 > 给这个复杂算法添加中文注释

12.6 CI/CD 与自动化

# 非交互式 CI/CD 使用示例 claude -p “审查这个 PR 的代码质量和安全性”  –output-format json  –allowedTools “Read,Grep,Glob”  –max-turns 10

# 自动化代码分析脚本 result=\((claude -p "分析代码并返回质量分数" --output-format json) score=\)(echo $result | jq ‘.content[0].text’)

12.7 数据库操作（通过 MCP）

GPT plus 代充 只需 145# 配置 PostgreSQL MCP 后： > 查询过去 7 天注册的新用户数量 > 找出执行时间超过 1 秒的慢查询 > 根据这个需求文档生成数据库迁移脚本 

---

13.1 目录结构**实践

your-project/ ├── .claude/ │ ├── CLAUDE.md # 项目配置（提交到 Git） │ ├── CLAUDE.local.md # 本地个人配置（加入 .gitignore） │ ├── settings.json # Hooks、权限等配置（提交） │ ├── settings.local.json # 本地配置覆盖（不提交） │ ├── skills/ # 项目级 Skills │ └── mcp.json # MCP 服务器配置 │ ~/.claude/ # 全局配置 ├── CLAUDE.md ├── settings.json └── skills/ 

13.2 重要环境变量

13.3 模型选择策略

GPT plus 代充 只需 145# 会话中切换模型 /model claude-opus-4-6 /model claude-haiku-4-5

# 命令行指定模型 claude –model claude-opus-4-6 “重构整个认证系统”

13.4 权限管理

# 查看当前权限 /permissions

# 允许特定工具 claude –allowedTools “Read,Write,Edit,Bash(git *)”

# 仅允许只读操作（安全审查场景） claude –allowedTools “Read,Grep,Glob”

# settings.json 中的权限配置 { “permissions”: {

GPT plus 代充 只需 145"allow": ["Read", "Write", "Edit", "Bash(git *)"], "deny": ["Bash(rm -rf *)"] 

} }

---

14.1 订阅方案

14.2 模型定价参考（API Key 模式）

14.3 费用查看与控制

# 查看本次会话费用 /cost

# 查看详细状态（含 token 使用量） /status

# 压缩上下文以节省 token /compact

💰 省钱技巧：使用子代理将探索任务路由到 Haiku 模型；定期使用 /compact 压缩上下文；在 CI/CD 中用 –max-turns 限制最大轮次。

---

15.1 GitHub Actions 集成

GPT plus 代充 只需 145# .github/workflows/claude-review.yml name: Claude Code Review on: [pull_request]

jobs: review:

runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Claude Code Review run: | npm install -g @anthropic-ai/claude-code claude -p "审查这个 PR，关注安全和代码质量" --allowedTools "Read,Grep,Glob" --output-format json --max-turns 20 env: ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }} 

15.2 Slack 集成使用

1. 在 Slack App Marketplace 安装 Claude 应用
2. 在频道或线程中 @Claude 触发
3. Claude 分析消息上下文，自动启动 Claude Code 会话
4. 进度更新实时发回 Slack 线程
5. 完成后提供 PR 链接和变更摘要

15.3 团队配置标准化

GPT plus 代充 只需 145# 团队统一使用 .claude/CLAUDE.md 和 .claude/settings.json # 提交到 Git，确保所有成员配置一致

# 创建团队 Skills 库 mkdir -p .claude/skills

# 使用 /init 为新成员快速初始化 claude > /init

15.4 企业云提供商配置

# Amazon Bedrock export ANTHROPIC_BEDROCK_AWS_REGION=us-east-1 claude –model anthropic.claude-sonnet-4-6-v1

# Google Vertex AI export CLAUDE_CODE_USE_VERTEX=1 export ANTHROPIC_VERTEX_PROJECT_ID=your-project

# Microsoft Foundry export ANTHROPIC_FOUNDRY_ENDPOINT=https://...

---

16.1 常见问题速查

16.2 诊断命令

GPT plus 代充 只需 145# 环境诊断 /doctor

# 查看版本信息 claude –version

# 检查认证 claude auth status

# 查看 MCP 状态 claude mcp status

# 查看上下文使用情况 /context

16.3 实用技巧

• 使用 @文件名 引用文件，比描述文件路径更准确
• 复杂任务先用 /plan 制定计划，确认后再执行
• 大型重构先在单个文件测试，确认效果后再推广
• Escape 键停止 Claude，而不是 Ctrl+C（Ctrl+C 是完全退出）
• 双击 Escape 查看历史消息并跳转
• # 前缀快速添加规范到 CLAUDE.md，无需手动编辑文件
• 在 .gitignore 中添加 .claude/CLAUDE.local.md 和 .claude/settings.local.json
• 开启 Vim 模式可大幅提升终端编辑效率

---

更新日期：2026年3月 · Claude Code 完整使用指南