Appearance
功能概览
Claude Code 是一个全功能的 AI 编程助手,通过命令行和编辑器扩展与你的开发环境深度集成。本页是所有功能的快速导航和概览。
界面和操作方式
CLI(命令行界面)
最核心的使用方式,在任何终端中运行 claude 启动交互会话。
核心能力:
- 与 AI 对话式编程,支持多轮交互
- 文件读写、代码搜索、Bash 命令执行
- 会话历史持久化,随时恢复之前的工作
- Git worktree 并行会话,同时处理多个任务
- 非交互模式(
-p),集成到脚本和 CI
VS Code / Cursor 扩展
原生图形界面,无需切换终端。
特有功能:
- 内联 diff 查看器,直接在编辑器中审查改动
@文件名引用当前文件和选中内容- 多对话标签页管理,不同任务并行
- 蓝色/橙色状态点显示待确认事项
- 计划模式在 VS Code 中自动打开 Markdown 文档
上下文和记忆
CLAUDE.md(项目指令)
提交到 git 的项目规范文件,Claude 每次会话启动时自动加载。
- 用于写入团队约定、架构决策、测试命令
- 支持
@路径导入额外文件,保持主文件精简 - 存放位置:项目根目录、
~/.claude/CLAUDE.md(全局)
Skills(可复用工作流)
在 .claude/skills/ 中创建 Markdown 文件,定义可以用 /skill-name 调用的专用工作流。
/deploy-frontend 在 CI 确认后部署前端
/create-pr 创建符合团队模板的 PR
/run-migration 安全地运行数据库迁移按需加载,不占用常规上下文。
子代理(Subagents)
创建专业化 AI 助手处理特定任务,拥有独立上下文窗口:
yaml
---
name: code-reviewer
description: 代码修改后主动审查质量和安全性
tools: Read, Grep, Glob, Bash
model: sonnet
---优势:
- 隔离高输出任务,不污染主对话
- 可以限制工具权限(只读、无网络等)
- 跨会话持久记忆(
memory: user) - 支持并行运行多个子代理
→ 子代理
自动化和集成
Hooks(生命周期钩子)
在 Claude Code 工作流的关键节点自动执行 shell 命令:
| 事件 | 用途 |
|---|---|
PostToolUse | 文件编辑后自动格式化 |
PreToolUse | 阻止危险操作 |
Notification | 发送桌面通知 |
Stop | 验证任务完成情况 |
SessionStart | 注入上下文 |
MCP 服务器
通过 Model Context Protocol 连接外部工具:
bash
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
claude mcp add --transport stdio db -- npx -y @bytebase/dbhub --dsn "..."可接入:GitHub、Sentry、PostgreSQL、Notion、Figma、Slack、Airtable 等上百种工具。
→ MCP 集成
GitHub Actions
在 GitHub CI/CD 中触发 Claude 自动化:
yaml
# PR 评论中 @claude 触发
- uses: anthropics/claude-code-action@v1
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}功能:自动代码审查、Issue 自动实现、定时报告、PR 自动创建。
安全和权限
权限系统
精细控制 Claude 可以访问什么、可以做什么:
json
{
"permissions": {
"allow": ["Bash(npm run *)", "Bash(git commit *)"],
"deny": ["Bash(git push --force *)", "Read(./.env)"]
}
}支持 allow/ask/deny 三级规则,每次使用前可以询问确认。
→ 权限配置
权限模式
| 模式 | 说明 |
|---|---|
default | 首次使用时询问 |
plan | 只读,不允许修改 |
acceptEdits | 自动接受文件编辑 |
bypassPermissions | 跳过所有提示(隔离环境使用) |
沙箱隔离
OS 级别隔离 Bash 命令的文件系统和网络访问:
json
{
"sandbox": {
"enabled": true,
"network": {
"allowedDomains": ["github.com", "*.npmjs.org"]
}
}
}支持 macOS、Linux、WSL2。
检查点回退
VS Code 扩展中,悬停任意消息显示回退选项:
- 从此分叉对话:保留代码改动,创建新对话分支
- 回退代码到此处:保留对话历史,撤销文件改动
- 分叉并回退代码:两者同时执行
配置系统
分层设置
设置文件存在多个位置,形成优先级层次:
| 位置 | 影响范围 | 优先级 |
|---|---|---|
managed-settings.json | 全组织 | 最高 |
~/.claude/settings.json | 所有项目 | 用户级 |
.claude/settings.json | 当前项目(共享) | 项目级 |
.claude/settings.local.json | 当前项目(个人) | 本地级 |
→ 设置参考
环境变量
通过环境变量或 settings.json 的 env 字段配置所有行为,无需修改代码。
工作流特性
计划模式(Plan Mode)
Claude 先分析代码库,给出详细计划,你审批后再执行:
bash
claude --permission-mode planVS Code 中按 Shift+Tab 切换,或在提示框底部切换模式。
并行会话(Git Worktrees)
同时在多个任务上工作,互不干扰:
bash
claude -w feature-auth # 在 worktree 中处理认证功能
claude -w bugfix-payment # 同时修复支付 bug→ 常见工作流
扩展思考(Extended Thinking)
复杂问题触发深度思考:
ultrathink:设计一个高并发缓存架构或按 Option+T / Alt+T 切换整个会话的思考模式。
子代理并行研究
把探索任务隔离到子代理,不污染主上下文:
用子代理并行研究认证、数据库和 API 模块编辑器集成
代码智能感知
通过语言服务器插件,给 Claude 精确的"跳转到定义"和"查找引用"能力,比文本搜索更准确。
@文件引用(VS Code)
Alt+K 插入当前文件和选中内容为 @file.ts#L5-10 格式的引用。
远程控制
从 claude.ai 或 Claude app 远程控制本地 Claude Code 实例:
bash
claude --remote-control "我的项目"企业功能
托管设置
IT 部门可以部署用户无法修改的配置:
- 强制权限规则
- 禁止危险模式(
bypassPermissions) - 指定允许的 MCP 服务器
- 控制可用模型
团队协作
.claude/settings.json提交到 git,团队共享配置.mcp.json共享 MCP 服务器CLAUDE.md共享项目规范.claude/agents/共享专用子代理.claude/skills/共享自定义工作流
云端提供商
支持通过 Amazon Bedrock、Google Vertex AI、Microsoft Foundry 使用 Claude,无需 Anthropic 账户:
功能一览表
| 功能 | CLI | VS Code 扩展 | GitHub Actions |
|---|---|---|---|
| 交互式对话 | ✓ | ✓ | ✗ |
| 文件读写 | ✓ | ✓ | ✓ |
| Bash 命令执行 | ✓ | ✓ | ✓ |
| 内联 diff 查看 | ✗ | ✓ | ✗ |
| @文件引用 | 部分 | ✓ | ✗ |
| 多对话管理 | ✓ | ✓ | ✗ |
| 计划模式 | ✓ | ✓ | ✓ |
| Hooks 自动化 | ✓ | ✓ | 部分 |
| MCP 服务器 | ✓ | 部分 | ✓ |
| 子代理 | ✓ | ✓ | ✓ |
| Skills | ✓ | 部分 | ✓ |
| 会话检查点 | ✓ | ✓ | ✗ |
| Git Worktrees | ✓ | ✓ | ✗ |
| 扩展思考 | ✓ | ✓ | ✓ |
| Tab 自动补全 | ✓ | ✗ | ✗ |
! Bash 快捷方式 | ✓ | ✗ | ✗ |
快速索引
| 我想… | 去哪里找 |
|---|---|
| 安装 Claude Code | 安装配置 |
| 第一个任务 | 快速开始 |
| 了解工作原理 | 工作原理 |
| 配置项目规范 | 记忆和 CLAUDE.md |
| 创建自定义命令 | Skills 系统 |
| 连接数据库/API | MCP 集成 |
| 控制工具权限 | 权限配置 |
| 完整设置参考 | 设置 |
| 在 VS Code 中使用 | VS Code 扩展 |
| 集成到 CI/CD | GitHub Actions |
| 创建专用 AI 助手 | 子代理 |
| 自动化工作流 | Hooks |
| 解决问题 | 故障排查 |
| 所有 CLI 参数 | CLI 参考 |
| 实际开发场景示例 | 常见工作流 |
| 提高使用效率 | 最佳实践 |