Claude code简版使用手册

一、安装后配置API-KEY ,建议使用cc switch ，方便切换不同的模型；

二、配置全局settings.json文件，一般在 c:\users\当前用户\.cluade\目录下。

    在此文件中，可以配置权限等信息。分全局，项目，目录级别的，此文件放在不同的地方，效果不同；

三、配置claude.md文件，指明用户的要求和喜好，如：用中文回答，缩进两个字符等；

四、使用命令：

   1命令一：claude——启动交互式窗口

   2命令二：claude init——为项目一键生成完整的 AI 配置骨架

   3命令三：claude -c——继续上一次对话

   4命令四：claude -p——单次执行

 

 附：转载

1、五种权限模式：从保姆级守护到全自动飙车

Claude Code内置了五种权限模式，覆盖从最保守到最激进的所有场景，可以在会话中按shift + tab快速进行切换。

模式	行为	适用场景
default（默认）	读文件自动通过 写文件需要确认 命令需要确认	新手优化
accept edits on	读文件自动通过 写文件自动通过 命令需要确认	日常开发模式
plan mode on	只能读和分析 不能写和执行命令	探索不熟悉的代码库 代码审查、分析
dontAsk	读写命令全自动 但是不跳过安全检查	严格锁定、高度安全的环境 需要注意的是所有未经明确授权的操作都会被静默拒绝 可能会导致执行任务时由于权限受阻，影响任务完成
bypass ⚠️	完全跳过所有检查 目前权限级别最高的模式	完全自动化的 CI/CD 或容器环境

在交互模式中按 Shift+Tab，你会看到状态栏在三种模式间循环：

normal-mode → ⏵⏵ accept edits on → ⏸ plan mode on → normal-mode

   示例：

{  
  "permissions": {  
    "defaultMode": "acceptEdits",  
  
    "allow": [  
      "Read",  
      "Edit(./src/**)",  
      "Write(./src/**)",  
      "MultiEdit(./src/**)",  
      "Bash(mvn clean)",  
      "Bash(mvn compile)",  
      "Bash(mvn package)",  
      "Bash(mvn install)",  
      "Bash(npx tsc --noEmit)",  
      "Bash(git status)",  
      "Bash(git diff *)",  
      "Bash(git add *)",  
      "Bash(git commit *)",  
      "Bash(git log *)",  
      "Bash(ls *)",  
      "Bash(cat *)",  
      "Bash(mkdir *)"  
    ],  
  
    "ask": [  
      "Bash(git push *)",  
      "Bash(npm deploy)",  
    ],  
  
    "deny": [  
      "Bash(rm -rf *)",  
      "Bash(sudo *)",  
      "Bash(curl *)",  
      "Read(./.env*)",  
      "Read(./secrets/**)",  
      "Edit(./.env*)",  
      "WebFetch"  
    ]  
  }  
}

2、

CLAUDE.md 放在哪里，区别很大。

Anthropic 设计了四层配置，从个人习惯到项目规范，层层递进：

1. 用户根目录：~/.claude/CLAUDE.md
存放你的个人偏好——比如用中文回复，代码注释用英文，commit 信息遵循 Conventional Commits。所有项目都会继承这些设定，相当于 Claude 对你的基本认知。

2. 项目根目录：/your-project/CLAUDE.md
存放当前项目的技术栈、编码规范、常用命令。比如Java 21 + Spring Boot 3.2，日志使用 lombok，异常用 BusinessException。Claude 在这个项目里干活时会自动遵守。

3. 项目根目录：/your-project/CLAUDE.local.md
项目级的个人偏好，不提交 Git（记得加 .gitignore）。比如你在某个项目里有自己的调试习惯、本地特殊配置。Claude 会把它和 CLAUDE.md 合并，且优先级更高——适合放“只有你需要、不想影响同事”的内容。

4. 子目录：/your-project/src/legacy/CLAUDE.md
用于局部例外，渐进式披露，需要时才加载。比如老模块不想按新规范重构，就在这个文件夹里放一份补充指令，告诉 Claude “这里只修 bug，不要动结构”。

加载顺序：用户级 → 项目级（CLAUDE.md）→ 项目级本地（CLAUDE.local.md）→ 子目录级。后面的覆盖前面的冲突项。

 

下面是一个全局的CLAUDE.md，可以参考使用

## 语言和沟通  
- 用中文回答问题和写注释  
- 代码中的变量名、函数名、commit message 用中文
- 解释技术概念时优先用类比和例子  
  
## 代码风格  
- 缩进：2 个空格  
- 引号：单引号（字符串）  
- 命名导入优先于默认导入  
  
## Git 习惯  
- commit message 格式：type(scope): description  
- 不要自动 push，commit 后等我确认  
  
## 回答偏好  
- 直接给解决方案，减少铺垫  
- 代码修改时说明"为什么"改，不只是"改成什么"  
- 有多种方案时列出优劣对比，让我选择