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

【Claude Code 】----2026完整版 Claude Code CLI 从0到精通项目级全局编码规范持久提示词配置命令实战一、前言 Claude Code CLI是 Anthropic 官方推出的终端原生AI编程工具脱离编辑器、纯终端驱动代码生成、重构、CodeReview、Bug修复。核心痛点每次对话重复粘贴编码规范、项目架构约束效率极低本文重点讲解项目级持久提示词自动加载方案配套完整配置代码、可复制命令、彩色Mermaid流程、实战案例一篇吃透CLI全能力。二、核心概念三级提示词作用域优先级分层2.1 三级配置文件存放位置关键全局用户级本机所有项目共用不提交GitWindows**%USERPROFILE%/.claude/cli.config.yaml**Mac/Linux**~/.claude/cli.config.yaml**适用公司通用基础编码规范、全局模型参数项目级仓库共享强制推荐本文重点项目根目录**./.claude.config.yaml**配套规范文档./.claude/rules/coding-standard.md编码规范持久提示词适用项目专属命名、注释、架构、代码审查规则提交Git团队统一生效临时会话级单次对话优先级最高交互内手动输入、claude -p临时传参、CLAUDE.md临时补充临时内容会覆盖全局/项目配置仅当前会话有效2.2 配置加载优先级彩色Mermaid流程图执行 claude 启动CLI读取临时参数 -p/-r加载项目 .claude.config.yaml加载全局 ~/.claude/cli.config.yaml拼接全部持久提示词发起AI请求携带编码规范说明临时参数 项目配置 全局配置项目配置提交Git团队共用三、环境安装与基础启动命令 3.1 一键安装命令WindowsPowerShell管理员# winget官方安装**winget install Anthropic.ClaudeCode**# 更新工具**winget upgrade Anthropic.ClaudeCode**Mac/Linux# 官方一键脚本**curl-fsSLhttps://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 └── .gitignore4.2 步骤1编写持久规范文档.claude/rules/coding-standard.md# 项目强制编码规范全局自动注入上下文 ## 1 Java后端规范 1. 包名全小写类名大驼峰UpperCamelCase方法/变量小驼峰lowerCamelCase 2. 所有接口返回统一ResultT结构体包含code、msg、data 3. 必须写JavaDoc注释公有方法、类、枚举强制注释 4. 异常统一使用项目自定义GlobalException禁止直接抛RuntimeException 5. 数据库字段使用下划线命名实体类驼峰MyBatis自动映射 ## 2 Python规范 1. 遵循PEP8行宽1204空格缩进 2. 函数必须添加Type Hints类型注解 3. 工具函数增加文档字符串 4. 禁用全局变量依赖注入优先 ## 3 代码输出约束 1. 输出完整可运行代码不省略关键导入、配置 2. 修改代码时标注变更位置说明修改原因 3. 提供单元测试用例覆盖边界场景 4. 输出完成后自动校验是否符合本规范4.3 步骤2项目配置文件.claude.config.yaml加载规则核心# Claude Code CLI 项目级配置提交Git共享model:astron-code-latesttimeout:60000# 持久项目提示词配置本文核心project_prompts:-file:./.claude/rules/coding-standard.mdweight: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# 本机全局通用配置不提交Gitproject_prompts:-file:~/.claude/global-base-rule.mdweight:5~/.claude/global-base-rule.md存放通用约束代码安全、注释通用要求。4.5 配置生效校验命令排错进入项目目录执行自动校验配置是否正常加载规范文件# 启动CLI交互**claude**# 执行诊断命令查看加载的project_prompts文件列表**/doctor**输出中能看到./.claude/rules/coding-standard.md即代表自动加载成功。五、完整实战案例带持久编码规范批量重构代码 ️场景后端项目统一重构所有Controller自动遵循项目规范提前配置好上述.claude.config.yamlcoding-standard.md终端进入项目根目录执行单次非交互任务# 单次执行重构任务自动携带编码规范上下文**claude-p遍历src/main/java/com/controller下所有Controller统一修改返回体为ResultT增加参数校验注释严格遵循项目coding-standard.md规范**CLI自动读取持久规范文件输出代码完全符合团队标准无需手动粘贴规范文本。多轮交互实战流程Mermaidcd 项目根目录claude 启动交互CLI自动加载 .claude.config.yaml → coding-standard.md输入需求新增用户登录接口AI生成代码自动匹配规范Result返回、JavaDoc、自定义异常输入/clear清空对话持久规范仍保留新需求新增用户Mapper规范持续生效六、Git仓库最佳实践 ⚙️必须提交.claude.config.yaml、.claude/rules/coding-standard.md团队成员克隆仓库后打开CLI自动加载统一编码规范新人零配置必须忽略.claude/sessions/会话缓存、.claude/settings.local.json个人本地覆盖配置在项目.gitignore追加# Claude CLI 缓存忽略 .claude/sessions/ .claude/*.local.json个人个性化覆盖新建.claude/settings.local.json不提交Git用于本机个性化参数覆盖项目配置。七、常见问题排错指南 ❌问题1编码规范没有自动加载检查yaml文件缩进YAML对空格敏感禁止Tab执行claude→/doctor查看加载文件列表确认project_prompts.file路径为相对项目根目录不要使用绝对路径问题2临时需求覆盖项目规范临时参数优先级更高如需强制使用项目规范删除单次-p内的冲突约束或提高yaml内weight数值。问题3会话过长Token爆炸执行交互命令**/compact**压缩上下文持久提示词不会被压缩丢失。八、总结 ✨Claude Code CLI持久编码规范优先使用项目级.claude.config.yaml .claude/rules/方案团队共享、自动加载三级配置优先级临时命令参数 项目配置 本机全局配置所有命令、关键字统一使用xxx标记可直接复制运行搭配Mermaid彩色流程图清晰理解加载链路/doctor是配置排错核心命令规范文件写入Git团队统一编码标准彻底解决每次提问重复粘贴规范的低效问题。