Claude Code 使用指南

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 概述

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

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

1.1 核心架构：三层系统

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

┌─────────────────────────────────────────────────────────┐
│                    CLAUDE CODE LAYERS                    │
├─────────────────────────────────────────────────────────┤
│  EXTENSION LAYER  (扩展层)                               │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐    │
│  │   MCP   │  │  Hooks  │  │ Skills  │  │ Plugins │    │
│  └─────────┘  └─────────┘  └─────────┘  └─────────┘    │
├─────────────────────────────────────────────────────────┤
│  DELEGATION LAYER  (委托层)                              │
│  ┌─────────────────────────────────────────────────┐    │
│  │         Subagents（最多 10 个并行）              │    │
│  └─────────────────────────────────────────────────┘    │
├─────────────────────────────────────────────────────────┤
│  CORE LAYER  (核心层)                                    │
│  ┌─────────────────────────────────────────────────┐    │
│  │    主对话上下文（200K token / Opus 1M token）    │    │
│  └─────────────────────────────────────────────────┘    │
└─────────────────────────────────────────────────────────┘
层级 说明
核心层 主对话上下文，每个 token 计费，上下文满后质量下降
委托层 子代理拥有独立干净的上下文，完成任务后只返回摘要，不污染主对话
扩展层 MCP 连接外部服务，Hooks 保证确定性执行，Skills 编码领域知识

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 推荐）

brew install claude-code
# 手动更新：brew upgrade claude-code

方式三：WinGet（Windows）

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

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

2.3 认证登录

# 启动后会自动提示登录，或手动执行：
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 模式

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

# 进入交互模式
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 继续会话模式

# 继续上次对话
claude --continue

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

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

3.4 计划模式（Plan Mode）

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

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

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

3.5 自动执行模式

# 跳过权限提示（仅用于可信容器环境！）
claude --dangerously-skip-permissions

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

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

四、完整命令参考

4.1 基础 CLI 命令

命令 说明
claude 启动交互式 REPL 会话
claude "提示词" 携带初始提示启动会话
claude -p "提示词" 一次性执行并退出（Print Mode）
claude --continue 继续上次对话
claude --version 显示版本号
claude --help 显示帮助信息
claude auth login 登录 Anthropic 账号
claude auth logout 退出登录
claude auth status 查看认证状态
claude agents 列出所有已配置的代理
claude remote-control 启动远程控制模式（供 IDE/CI 调用）

4.2 常用启动标志（CLI Flags）

会话控制
标志 说明
-p / --print 一次性执行模式，执行后退出
--continue 继续上次对话
--resume <id> 通过 Session ID 恢复特定会话
--teleport <id> 从远程（Web）拉取会话到本地继续
--cwd <path> 指定工作目录
--no-auto-commit 禁止自动提交 Git 更改
模型与模式控制
标志 说明
--model <name> 指定使用的模型（sonnet / opus / haiku）
--plan 以计划模式启动（不立即执行）
--thinking 启用扩展思考模式
--fast 使用 Haiku 模型快速执行探索性任务
输出控制
标志 说明
--output-format text 默认文本格式输出
--output-format json JSON 格式输出（适合脚本）
--output-format stream-json 流式 JSON 输出
--verbose 显示详细输出（含完整对话）
--no-verbose 精简输出
--max-turns <n> 限制最大对话轮次（自动化场景）
系统提示控制
标志 说明
--system-prompt "提示" 完全替换默认系统提示（高级用法）
--append-system-prompt "提示" 追加到默认系统提示（推荐）
权限控制
标志 说明
--allowedTools "Read,Write" 仅允许指定工具
--disallowedTools "Bash" 禁止使用指定工具
--dangerously-skip-permissions 跳过所有权限提示（仅限可信环境）

五、会话内斜杠命令（Slash Commands）

5.1 项目管理

命令 说明
/init 初始化项目，生成 CLAUDE.md 配置文件（每个新仓库都应执行）
/compact 压缩对话上下文，保留核心信息释放空间
/clear 清空当前对话上下文，重新开始
/resume 恢复上次中断的对话
/export [文件名] 导出当前对话到文件或剪贴板
/rewind 撤回到上一个操作状态（代码时间旅行）

5.2 信息与状态

命令 说明
/help 显示所有可用命令，含自定义命令
/status 查看当前会话状态、token 使用量
/cost 显示本次会话的 token 消耗和费用
/context 查看上下文使用情况（含 Skills 加载状态）
/doctor 诊断 Claude Code 配置和环境问题

5.3 模式与模型控制

命令 说明
/model 切换 Claude 模型（Sonnet / Opus / Haiku）
/plan 切换到计划模式（仅制定计划，不执行）
/fast 切换到快速模式（使用 Haiku）
/thinking 启用/关闭扩展思考模式

5.4 功能管理

命令 说明
/permissions 查看和更新工具权限设置
/config 打开配置界面（模型、隐私等设置）
/privacy-settings 管理数据共享和存储设置
/output-style 配置响应格式样式
/hooks 通过交互菜单配置 Hooks（推荐方式）

5.5 集成与扩展

命令 说明
/mcp 管理 MCP 服务器连接
/install-github-app 安装 Claude Code GitHub App
/login 切换登录账号

5.6 内存管理

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

# 本项目使用 2 空格缩进
# 测试框架为 Jest，运行命令是 npm test
# API 文档在 docs/api.md

使用 @ 符号引用文件：

# 引用具体文件
@src/utils/helper.ts 帮我添加单元测试

# 引用目录
@docs/ 生成 API 概览文档

六、键盘快捷键

6.1 基本操作

快捷键 说明
Enter 提交当前输入
Escape 停止 Claude 当前执行（不是退出！）
Ctrl+C 完全退出 Claude Code
Escape × 2 显示历史消息列表，可跳转到任意位置
↑ / ↓ 浏览历史输入
Ctrl+L 清屏（保留上下文）

6.2 模式切换

快捷键 说明
Shift+Tab 循环切换：普通模式 → 自动接受模式 → 计划模式
Tab 自动补全文件名或命令

6.3 文件与图片操作

操作 说明
拖拽文件 在 IDE 中打开（新标签页）
Shift + 拖拽文件 正确引用文件到对话（推荐方式）
Ctrl+V 粘贴剪贴板中的图片

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

6.4 Shell 命令直通

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

! git status
! npm test
! ls -la

七、CLAUDE.md 项目配置文件

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

7.1 文件位置与优先级

文件路径 类型 说明
~/.claude/CLAUDE.md 全局配置 适用于所有项目
.claude/CLAUDE.md 项目配置（团队共享） 提交到 Git，团队统一
CLAUDE.md（项目根） 项目配置 也会被自动加载
.claude/CLAUDE.local.md 本地个人配置 加入 .gitignore，不提交

7.2 最佳实践模板

# 项目概述
这是一个 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 集成（Model Context Protocol）

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 服务器

命令 说明
claude mcp list 列出所有已配置的 MCP 服务器
claude mcp remove <名称> 删除指定 MCP 服务器
claude mcp status 查看 MCP 服务器连接状态
/mcp 在会话中管理 MCP 连接

8.3 常用 MCP 服务器推荐

服务器名称 功能 安装命令
server-github GitHub 仓库、Issue、PR 操作 npx @modelcontextprotocol/server-github
server-postgres PostgreSQL 数据库查询 npx @modelcontextprotocol/server-postgres <url>
server-sqlite SQLite 数据库操作 npx @modelcontextprotocol/server-sqlite <path>
server-filesystem 受控文件系统访问 npx @modelcontextprotocol/server-filesystem <dir>
server-brave-search Brave 网页搜索 npx @modelcontextprotocol/server-brave-search
server-slack Slack 消息和频道操作 npx @modelcontextprotocol/server-slack
server-sentry Sentry 错误追踪查询 npx @modelcontextprotocol/server-sentry
server-puppeteer 浏览器自动化控制 npx @modelcontextprotocol/server-puppeteer

8.4 MCP 配置文件示例

// .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 自动化系统

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

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

9.1 Hook 触发事件

事件名称 触发时机 典型用途
PreToolUse 工具执行前 校验、阻止危险操作
PostToolUse 工具执行后 格式化、触发测试
Notification Claude 发送通知时 自定义通知逻辑
Stop Claude 完成回复时 最终检查、汇报
SessionStart 会话启动/恢复时 环境初始化
PreCompact 压缩上下文前 保存重要状态
ConfigChange 配置文件变更时 重新加载外部状态
WorktreeCreate 创建 Git Worktree 时 Worktree 资源初始化
WorktreeDelete 删除 Git Worktree 时 清理 Worktree 资源

9.2 Hooks 配置文件示例

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

{
  "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）

"PostToolUse": [{
  "matcher": "Write(*.py)|Edit(*.py)",
  "hooks": [
    { "type": "command", "command": "python -m black \"$file\"" },
    { "type": "command", "command": "python -m isort \"$file\"" }
  ]
}]

TypeScript 类型检查

"PostToolUse": [{
  "matcher": "Write(*.ts)|Write(*.tsx)",
  "hooks": [{
    "type": "command",
    "command": "npx tsc --noEmit --skipLibCheck 2>&1 | head -20"
  }]
}]

提交前安全检查

"PreToolUse": [{
  "matcher": "Bash(git commit*)",
  "hooks": [{
    "type": "command",
    "command": "npm audit --audit-level moderate"
  }]
}]

十、Skills（自定义技能）

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

10.1 Skills 目录结构

your-project/
├── .claude/
│   ├── CLAUDE.md
│   ├── skills/
│   │   ├── security-review.md   # 项目级 Skill
│   │   └── deploy.md
│   └── commands/               # 旧版命令（仍兼容）
└── ...

~/.claude/skills/               # 全局 Skill（所有项目可用）
    └── git-commit.md

10.2 创建自定义 Skill

---
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

---
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 前先执行命令，将输出注入上下文。

十一、子代理（Subagents）系统

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

11.1 内置子代理类型

类型 用途
Explore 快速扫描代码库、搜索文件、收集信息
Plan 制定复杂任务的执行计划
General 执行具体的代码修改任务
Custom 通过 --agents 标志定义专用代理

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 代码理解与分析

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

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

12.2 编写与修改代码

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

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

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

12.3 测试与质量

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

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

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

12.4 Git 工作流

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

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

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

12.5 文档生成

# 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）

# 配置 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 重要环境变量

变量名 说明
ANTHROPIC_API_KEY 设置 API Key（直接 API 访问时使用）
CLAUDE_MODEL 设置默认模型
CLAUDE_MAX_TOKENS 设置最大 token 输出数量
ANTHROPIC_BASE_URL 自定义 API 端点（企业代理场景）
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 禁用非必要网络请求（离线环境）
SLASH_COMMAND_TOOL_CHAR_BUDGET 覆盖 Skills 字符预算限制
BASH_DEFAULT_TIMEOUT_MS 设置 Bash 命令默认超时时间
BASH_MAX_TIMEOUT_MS 设置 Bash 命令最大超时时间

13.3 模型选择策略

模型 适用场景 说明
claude-haiku-4-5 探索型任务 快速文件搜索、简单查询、子代理探索（最便宜）
claude-sonnet-4-6 日常开发（默认） 常规编码、调试、代码审查（性价比最高）
claude-opus-4-6 复杂架构任务 系统设计、复杂重构、深度推理（最强大） 
# 会话中切换模型
/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": {
    "allow": ["Read", "Write", "Edit", "Bash(git *)"],
    "deny": ["Bash(rm -rf *)"]
  }
}

十四、费用与订阅说明

14.1 订阅方案

方案 适用对象 特点
Pro 个人开发者 含 Claude Code 访问，有周限额
Max 重度用户 更高限额，支持 1M token 上下文
Team 小团队 团队协作功能，Admin API 访问
Enterprise 企业 无限制，SSO，数据驻留，合规支持
API Key 按量付费 无订阅，按 token 计费，适合自动化

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

模型 输入价格 输出价格
claude-haiku-4-5 $0.80 / 百万 token $4 / 百万 token
claude-sonnet-4-6 $3 / 百万 token $15 / 百万 token
claude-opus-4-6 $5 / 百万 token $25 / 百万 token

14.3 费用查看与控制

# 查看本次会话费用
/cost

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

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

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

十五、企业与团队使用

15.1 GitHub Actions 集成

# .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 团队配置标准化

# 团队统一使用 .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 常见问题速查

问题 排查方法 解决方案
认证失败 claude auth status 检查 claude auth login 重新登录
命令未找到 npm install -g 重新安装 检查 PATH 是否包含 npm bin 目录
上下文溢出 使用 /compact 压缩 或 /clear 重新开始
权限被拒 使用 /permissions 查看 或 --allowedTools 明确授权
速度很慢 切换到 Haiku 模型 /model claude-haiku-4-5
费用过高 使用 /compact 减少 token 子代理用 Haiku 模型
MCP 连接失败 claude mcp status 检查 重启服务器或检查配置

16.2 诊断命令

# 环境诊断
/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 完整使用指南

# 人工智能
Logo
AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

cover

从入门到实战：OpenClaw v2.7.1详细配置手册，解锁AI电脑操控新技能

avatar AtomGit开源社区
cover

深度学习正则化（五）—— 对抗训练 + 切面分类（三十二）

avatar AtomGit开源社区

【无标题】

CLI-Anything 项目通过创新的 7 阶段自动化流水线，成功解决了 AI Agent 调用专业桌面软件的难题。零妥协的真实调用，直接操作真实文件格式全自动化的 CLI 生成流程，无需人工介入严格的验证机制确保输出正确性支持 9 款主流专业软件，覆盖图像、3D、办公、音视频等多个领域该项目为 AI Agent 与专业软件的交互提供了全新的解决方案，值得开发者关注和学习。

avatar AtomGit开源社区