【Claude Code 】----2026完整版 Claude Code CLI 从0到精通｜项目级全局编码规范持久提示词配置+命令实战

一、前言 🚀

Claude Code CLI 是 Anthropic 官方推出的终端原生AI编程工具，脱离编辑器、纯终端驱动代码生成、重构、CodeReview、Bug修复。
核心痛点：每次对话重复粘贴编码规范、项目架构约束效率极低，本文重点讲解项目级持久提示词自动加载方案，配套完整配置代码、可复制命令、彩色Mermaid流程、实战案例，一篇吃透CLI全能力。

二、核心概念：三级提示词作用域（优先级分层）📊

2.1 三级配置文件存放位置（关键）

1. 全局用户级（本机所有项目共用，不提交Git）
   • Windows：**```%USERPROFILE%/.claude/cli.config.yaml```**
   • Mac/Linux：**```~/.claude/cli.config.yaml```**
   • 适用：公司通用基础编码规范、全局模型参数
2. 项目级（仓库共享，强制推荐，本文重点）
   • 项目根目录：**```./.claude.config.yaml```**
   • 配套规范文档：./.claude/rules/coding-standard.md（编码规范持久提示词）
   • 适用：项目专属命名、注释、架构、代码审查规则，提交Git团队统一生效
3. 临时会话级（单次对话，优先级最高）
   • 交互内手动输入、claude -p 临时传参、CLAUDE.md 临时补充
   • 临时内容会覆盖全局/项目配置，仅当前会话有效

2.2 配置加载优先级彩色Mermaid流程图

三、环境安装与基础启动命令 🔧

3.1 一键安装命令

Windows（PowerShell管理员）

# winget官方安装
**```winget install Anthropic.ClaudeCode```**
# 更新工具
**```winget upgrade Anthropic.ClaudeCode```**

Mac/Linux

# 官方一键脚本
**```curl -fsSL https://claude.ai/install.sh | bash```**
# 验证安装
**```claude --version```**

3.2 核心启动参数命令大全（可直接复制）

终端命令	功能说明	实战场景
claude	当前目录启动交互式REPL多轮对话	日常开发、持续重构
claude ./backend-project	指定项目目录启动CLI	跨目录快速切换项目
claude "写一个Java工具类，统一异常处理"	带初始需求直接进入对话	快速单任务开发
claude -p "重构src所有Controller，遵循项目编码规范"	非交互单次执行，执行完直接退出	CI脚本、批量自动化处理
claude -r session_001	恢复历史会话上下文	中断任务续做
claude --help	查看CLI全部参数文档	忘记参数时查阅

3.3 交互内斜杠内置命令（REPL模式输入 / 唤起）

# 查看全部内置指令
**```/help```**
# 清空当前对话上下文（不会清除项目持久提示词）
**```/clear```**
# 压缩超长会话，减少Token消耗
**```/compact```**
# 诊断配置文件是否加载正常（排错神器）
**```/doctor```**
# 切换模型：opus/sonnet/haiku
**```/model opus```**
# 查看本次会话Token消耗
**```/cost```**

四、重点：项目级持久编码规范提示词完整配置（核心需求）💡

需求：把Java/Python统一编码规范写入文件，每次启动CLI自动加载，无需重复粘贴，支持团队Git共享。

4.1 目录结构规范（标准工程目录）

your-project/
├── .claude.config.yaml       # CLI主配置文件（核心）
├── .claude/
│   └── rules/
│       └── coding-standard.md  # 完整编码规范提示词本体
├── src/
├── pom.xml / pyproject.toml
└── .gitignore

4.2 步骤1：编写持久规范文档 .claude/rules/coding-standard.md

# 项目强制编码规范（全局自动注入上下文）
## 1 Java后端规范
1. 包名全小写，类名大驼峰UpperCamelCase，方法/变量小驼峰lowerCamelCase
2. 所有接口返回统一Result<T>结构体，包含code、msg、data
3. 必须写JavaDoc注释，公有方法、类、枚举强制注释
4. 异常统一使用项目自定义GlobalException，禁止直接抛RuntimeException
5. 数据库字段使用下划线命名，实体类驼峰，MyBatis自动映射

## 2 Python规范
1. 遵循PEP8，行宽120，4空格缩进
2. 函数必须添加Type Hints类型注解
3. 工具函数增加文档字符串""" """
4. 禁用全局变量，依赖注入优先

## 3 代码输出约束
1. 输出完整可运行代码，不省略关键导入、配置
2. 修改代码时标注变更位置，说明修改原因
3. 提供单元测试用例，覆盖边界场景
4. 输出完成后自动校验是否符合本规范

4.3 步骤2：项目配置文件 .claude.config.yaml（加载规则核心）

# Claude Code CLI 项目级配置，提交Git共享
model: astron-code-latest
timeout: 60000

# 持久项目提示词配置（本文核心）
project_prompts:
  - file: "./.claude/rules/coding-standard.md"
    weight: 10  # 权重越高，优先级越高，建议规范设最高权重
    description: 项目统一编码规范，所有代码生成/重构自动生效

# 权限控制（可选，自动执行git命令无需确认）
permissions:
  allow:
    - Bash(git diff *)
    - Bash(git status)
    - Bash(npm run test)
  deny:
    - Read(.env*) # 禁止读取环境密钥文件

4.4 步骤3：全局公共规范补充（本机所有项目通用）

文件路径：~/.claude/cli.config.yaml

# 本机全局通用配置，不提交Git
project_prompts:
  - file: "~/.claude/global-base-rule.md"
    weight: 5

~/.claude/global-base-rule.md 存放通用约束：代码安全、注释通用要求。

4.5 配置生效校验命令（排错）

进入项目目录执行，自动校验配置是否正常加载规范文件：

# 启动CLI交互
**```claude```**
# 执行诊断命令，查看加载的project_prompts文件列表
**```/doctor```**

输出中能看到 ./.claude/rules/coding-standard.md 即代表自动加载成功。

五、完整实战案例：带持久编码规范批量重构代码 🛠️

场景：后端项目统一重构所有Controller，自动遵循项目规范

1. 提前配置好上述 .claude.config.yaml + coding-standard.md
2. 终端进入项目根目录，执行单次非交互任务

# 单次执行重构任务，自动携带编码规范上下文
**```claude -p "遍历src/main/java/com/controller下所有Controller，统一修改返回体为Result<T>，增加参数校验注释，严格遵循项目coding-standard.md规范"```**

3. CLI自动读取持久规范文件，输出代码完全符合团队标准，无需手动粘贴规范文本。

多轮交互实战流程Mermaid

六、Git仓库最佳实践 ⚙️

1. 必须提交：.claude.config.yaml、.claude/rules/coding-standard.md
   • 团队成员克隆仓库后，打开CLI自动加载统一编码规范，新人零配置
2. 必须忽略：.claude/sessions/（会话缓存）、.claude/settings.local.json（个人本地覆盖配置）
   在项目.gitignore追加：

   # Claude CLI 缓存忽略
   .claude/sessions/
   .claude/*.local.json
   

3. 个人个性化覆盖：新建 .claude/settings.local.json，不提交Git，用于本机个性化参数覆盖项目配置。

七、常见问题排错指南 ❌

问题1：编码规范没有自动加载

1. 检查yaml文件缩进（YAML对空格敏感，禁止Tab）
2. 执行 claude → /doctor 查看加载文件列表
3. 确认 project_prompts.file 路径为相对项目根目录，不要使用绝对路径

问题2：临时需求覆盖项目规范

临时参数优先级更高，如需强制使用项目规范，删除单次-p内的冲突约束，或提高yaml内weight数值。

问题3：会话过长Token爆炸

执行交互命令 **```/compact```** 压缩上下文，持久提示词不会被压缩丢失。

八、总结 ✨

1. Claude Code CLI 持久编码规范优先使用项目级 .claude.config.yaml + .claude/rules/ 方案，团队共享、自动加载；
2. 三级配置优先级：临时命令参数 > 项目配置 > 本机全局配置；
3. 所有命令、关键字统一使用 xxx 标记，可直接复制运行；
4. 搭配Mermaid彩色流程图清晰理解加载链路，/doctor 是配置排错核心命令；
5. 规范文件写入Git，团队统一编码标准，彻底解决每次提问重复粘贴规范的低效问题。