Claude Code 全量常用命令详解（终端 CLI 模式，Mac / Linux 通用）

启动方式：项目根目录终端输入 claude 进入交互式会话，不带参数；也可 claude 指令 单次执行。

前置：已经装好 claude-code、配置好 ~/.claude/settings.json / 项目CLAUDE.md

一、进入 / 退出基础命令 

1. claude

• 作用：进入 Claude Code 交互式对话终端（最常用），加载当前项目 CLAUDE.md + .claude/settings
• 使用：项目根目录直接终端执行

进入后左侧提示符 > 即可发自然语言指令。

2. /exit | /quit

• 作用：退出 claude 交互式会话，返回系统 shell
• 使用：claude 交互界面里输入

3. /clear

• 作用：清空当前会话上下文历史（清空本轮对话记忆，不删文件配置）

场景：前面对话 AI 跑偏、上下文混乱，清掉重新提问。 

二、上下文 & 文件读取核心命令（开发高频）

1. /add [文件/目录路径]

含义：手动追加指定文件到 AI 上下文，AI 加载源码分析

• 支持单个文件、多个文件、文件夹

# 单个java文件
> /add finance-nc-accounting-engine-core/src/main/java/com/zto/impl/data/FetchDataServiceImpl.java
# 整个mapper目录
> /add finance-nc-accounting-engine-core/src/main/java/com/zto/mapper/
# 多文件空格分隔
> /add XxxMapper.java XxxService.java

配合：需要针对性分析某几个类时用，避免 AI 全项目扫描浪费 token。 

2. /remove [路径]

含义：从当前会话上下文移除已加载的文件，减少上下文冗余

> /remove finance-nc-accounting-engine-core/src/main/java/com/zto/impl/data/FetchDataServiceImpl.java 

3. /files

含义：查看当前会话已经加载了哪些源码文件清单

排查：AI 读了多余配置文件、不该读的 yml，用这个查看再/remove删掉。 

三、项目配置查看类命令

1. /settings

含义：查看当前项目最终生效配置（合并：项目 local > 项目 settings > 全局 settings）

• 展示：当前在用模型、base_url、黑白名单 allowed_paths/denied_paths、环境变量

排查 402、模型不生效、API 地址错误首选命令

2. /rules

含义：打印当前生效的 CLAUDE.md 全部规则内容（项目级 + 全局合并）

校验：自己写的编码规范有没有被 AI 正确加载

四、代码修改 / 执行命令（改代码、运行脚本、SQL）

1. /apply

最关键命令：确认应用 AI 生成的代码变更到本地磁盘
使用流程：

1. 你提问：优化 FetchDataServiceImpl 分批删除逻辑
2. AI 输出修改代码、列出变更清单
3. 输入 /apply → 自动覆盖本地源文件

• 不想改：/reject 放弃全部修改

2. /reject

放弃 AI 本次给出的所有代码修改，不落地到文件。

3. /bash 命令 

在项目目录执行 shell 指令（受 settings.json denied_commands 黑名单管控）

# 查看目录
> /bash ls -l
# mvn编译项目
> /bash mvn compile -DskipTests

黑名单配置了rm、rm -rf则无法执行对应 bash。 

五、会话 & 模型切换命令

1. /model 模型名

临时切换当前会话使用的大模型，只生效当前对话，不修改 settings 配置文件

> /model deepseek-v4-flash
> /model deepseek-v4-pro[1m]

场景：临时想试用付费 pro，不想改配置文件。

2. /new

开启全新空会话（全新上下文，不继承上一轮聊天记录）

一个项目做多模块开发，切换业务模块时新开会话，隔离上下文。

六、帮助 & 查询命令

/help

列出全部可用命令清单

七、非交互式：终端直接单次调用（不进 claude 会话）

不用进入 claude> 界面，shell 直接一句话执行

# 直接分析指定类代码
claude "优化FetchDataServiceImpl中nc_source_data_0000批量删除逻辑，遵循分批limit 1000" --add finance-nc-accounting-engine-core/src/main/java/com/zto/impl/data/FetchDataServiceImpl.java

# 查看当前生效配置
claude /settings

八、开发日常高频使用场景举例（你的财务 NC 项目）

场景 1：优化源数据删除代码 

# 1.项目目录进入claude
claude
# 2.加载目标service文件
> /add finance-nc-accounting-engine-core/src/main/java/com/zto/impl/data/FetchDataServiceImpl.java
# 3.发需求
> 根据CLAUDE.md规范，改造delete逻辑，禁止全表删除，按sum_date分批每次删1000条
# 4.AI出代码后落地
> /apply

场景 2：排查当前为什么还是在用 flash 模型没走 pro

> /settings
# 查看env里ANTHROPIC_MODEL，确认是否被项目settings.local覆盖

场景 3：AI 误读了 resources/db-config.yml 密钥配置

> /files
# 看到yml被加载
> /remove finance-nc-accounting-engine-core/src/main/resources/db-config.yml
# 后续可在settings.json denied_paths永久禁止读取

九、命令优先级补充 

1. /model临时指令 > settings 配置（单次会话生效）
2. CLAUDE.md 规则 > 自然语言临时指令（AI 优先遵守 md 约束）
3. denied_paths 黑白名单 > /add 强行加载（黑名单目录文件无法 add 加载）

十、易混区分