2026-04-05

claude介绍和使用

# 1. CLAUDE.md说明

# 1.1. CLAUDE.md说明配置

# 项目：项目名称/项目介绍

## 技术栈
- html + css + javaScript

## 目录结构
src/
|—— pages/ # 页面
|—— style/ # css样式
|—— javascript/ #js脚本
|—— docs/ 规范文档放置位置

.claude/
└── rules/
    ├── typescript.md      # TypeScript 规范
    ├── testing.md         # 测试规范
    ├── api-design.md      # API 设计规范
    └── security.md        # 安全规范

 ## 组件规范
 ## 常用命令
 ## 详细文档
 - 数据库设计: 见 `docs/database.md`
 - API 规范: 见 `docs/api-spec.md`
 - 部署流程: 见 `docs/deployment.md`


## 安全要求
- 禁止在代码中硬编码任何密钥或敏感信息
- 所有 API 调用必须使用 HTTPS
- 用户输入必须经过验证和清理

## 合规要求
- 所有日志必须排除 PII（个人身份信息）
- 数据库连接必须使用加密传输

## 禁止项
- 禁止使用未经审批的第三方库
- 禁止直接访问生产数据库

# 2. 安装

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

特别说明 免费模型如智谱，需要先在cc-switch中配置使用，然后使用cmd打开claude才能在vscode插件中使用

# 2.1. CLAUDE.md不同平台位置

Windwos: C:\Program Files\ClaudeCode\CLAUDE.md
macOS: /Library/Application Support/ClaudeCode/CLAUDE.md
Linux: /etc/claude-code/CLAUDE.md

# 3. Claude Code的四种工作模式

# 3.1. 切换方式

在 Claude Code 终端会话中，按下「Alt+M」组合键
在VSCode设置中修改，打卡插件管理，然后点击“齿轮”（设置选项），找到Initial Permission Mode选项进行修改，直接选择acceptEdits选项。
在vscode插件对话框模式下直接修改，这里只有前3种模式

# 3.2. 模式一 acceptEdits模式-确认执行，掌控细节

核心定义： acceptEdits模式，也叫做Ask before Edits 先询问后编辑,我喜欢叫它采纳模式，又称接受修改模式，是 Claude Code 中「高效便捷优先」的工作模式，核心是在AI修改前，先给出修改方案（创建、修改、删除文件等），然后你确认是否修改。这也是最常用的一种模式，可以知道每一项修改的位置和文件，掌控感比较强。

优缺点介绍优点: 掌控感比较强，可以高效准确的完成开发，实现精细化编程。

缺点:：需要手工确认，不能是实现全自动编程，一个大的需求模块要确认和多次。

# 3.3. 模式二 plan 模式三思而后行，安全可控

核心定义： plan 模式，全称“计划模式”，是 Claude Code 中主打“安全可控、精细化开发”的工作模式。该模式的核心是“先规划、后执行”，开启后 Claude Code 不会直接执行任何修改操作（处于只读模式），而是先对用户需求进行系统性分析，生成详细的执行计划，待用户审查、确认或修改计划后，再执行相应操作。

优缺点介绍优点：安全性极高，只读模式可避免意外修改文件；可控性强，用户能全程掌控操作细节，减少返工；适合复杂任务，通过系统性规划提升开发效率和代码质量——据社区调研，使用 plan 模式可使开发一次成功率从 45% 提升至 82%，返工次数减少 74%；计划可纳入 Git 管理，便于追溯决策过程。

缺点：流程相对繁琐，比 acceptEdits 模式和 bypassPermissions 模式多了“规划-审查”的环节，不适合简单、紧急的临时任务；会消耗一定的额外 token（用于生成和优化计划）。

# 3.4. 模式三 Edit automatically 自动编辑模式 —— 高效自动化，省心省时间

核心定义： Edit automatically 模式，又称自动执行模式，是 Claude Code 中「高效便捷优先」的工作模式，核心作用是让 AI 自动确认并执行所有文件操作（创建、修改、删除文件等），无需人工逐一步骤确认，全程自动化完成编程相关操作，大幅减少手动干预成本。

优缺点介绍优点：效率极高，无需用户手动确认每一步，减少交互成本，能快速完成基础开发任务；可通过 /permissions 命令配置自动接受的特定工具，实现精细化自动化。缺点: 自主性强，风险相对较高——若 Claude Code 对需求解析出现偏差，会直接执行错误操作（如修改错误文件、运行不合理命令），可能导致代码异常或项目损坏；不适合复杂、高风险的开发任务。

# 3.5. 模式四 bypassPermissions 模式 —— 极致高效，风险自负，只有终端和vscode设置才能打开

核心定义: bypassPermissions 模式,早期我们称为Yolo模式,是 Claude Code 中主打“极致高效、无任何干预”的工作模式，也是风险最高的模式。该模式的核心是“跳过所有确认和校验步骤”，用户输入需求后，Claude Code 不进行任何合理性分析、不生成计划、不请求用户确认，直接执行所有判定为满足需求的操作，完全自主决策。

优缺点介绍优点：执行速度最快，无任何中间交互和校验环节，能最大程度节省时间；适合紧急场景和已知安全的简单操作。缺点：风险极高，是三种模式中最容易出现错误的模式——可能因需求解析偏差、操作考虑不周，导致代码损坏、数据泄露、系统故障等严重问题；无任何中间反馈，出现错误后难以追溯原因；官方不推荐在核心项目或生产环境中使用。

上次更新: 2026-04-05