claude使用介绍 claude命令介绍 headless使用介绍

一、claude使用介绍

1、claude使用帮助：https://code.claude.com/docs/zh-CN/overview

2、claude命令帮助：https://code.claude.com/docs/zh-CN/cli-reference

3、claude交互帮助：https://code.claude.com/docs/zh-CN/interactive-mode

安装claude-code：

1、安装git：https://git-scm.com/install/windows

2、安装claude-code：npm install -g @anthropic-ai/claude-code

3、配置claude-code：settings.json

4、配置claude-code：DASHSCOPE_API_KEY替换为真实的apikey

5、配置claude-code：%USERPROFILE%\.claude放置文件settings.json

6、配置claude-code：%USERPROFILE%\.claude.json添加配置"hasCompletedOnboarding": true

claude-code系统提示词：

1、替换提示词(不推荐)：--system-prompt，支持交互模式和打印模式；

2、替换提示词(不推荐)：--system-prompt-file，仅支持打印模式；

3、新增提示词(推荐)：--append-system-prompt，支持交互模式和打印模式；

4、新增提示词(推荐)：--append-system-prompt-file，仅支持打印模式；

claude-code提问技巧：

1、建议让claude先学习已有代码；

2、请求需要具体，提供具体的上下文内容；

3、使用分步说明，将复杂任务分解为步骤；

4、流程步骤：探索、规划、实现、提交；

claude-code使用技巧：

1、tab，补全命令；

2、esc+esc，清除输入；

3、CTRL+L，清除输入；

4、CTRL+G，打开文本编辑器；

5、/clear，清除屏幕内容；

6、?，查看所有键盘快捷键；

7、/，查看所有斜杠命令；

8、/help，查看可用命令；

二、claude命令介绍

claude-code配置管理：

1、/config，查看和修改自身配置；

2、/doctor，诊断和验证自身状态；

3、/status，显示当前状态；

4、/stats，显示使用情况；

claude-code配置设置：

1、配置设置：https://code.claude.com/docs/zh-CN/settings

3、模型设置：https://code.claude.com/docs/zh-CN/model-config

4、配置优先级：Managed > 命令行参数 > Local > Project > User

5、用户设置：~/.claude/settings.json 

6、项目设置：.claude/settings.json

7、本地设置：.claude/settings.local.json

08、输出影响：/model设置模型和努力级别

09、输出影响：/config设置thinkingMode

10、输出影响：/config设置outputStyle 

claude-code权限设置：

1、配置设置：https://code.claude.com/docs/zh-CN/settings

2、权限设置：https://code.claude.com/docs/zh-CN/permissions

3、权限评估优先级：deny > ask > allow > defaultMode

4、跳过权限评估：--dangerously-skip-permissions

5、Bash命令评估允许或禁止之后，项目永久有效，无需用户再次确认；

6、Edit/Write评估允许或禁止之后，会话期间有效，除非配置设置了询问；

7、限制命令参数的bash很脆弱，很容易绕过限制；

8、限制访问url，建议使用WebFetch替代curl和wget；

9、限制访问url，可以使用hook，可以在CLAUDE.md增加访问规则；

claude-code常用命令：

1、claude -c，恢复上一次会话；

2、claude -r，恢复指定的会话；

3、/context，上下文使用情况；

4、/memory，编辑长期记忆；

5、/init，建立项目长期记忆；

6、/plan，进入规划模式，生成执行计划；

7、/rewind，出错时使用，回滚会话和代码；

8、/todos，计划工作列表，等待大模型执行；

9、/tasks，后台任务列表，bash命令可以后台执行；

claude-code回滚机制：

1、每个用户的请求都会创建一个新的checkpoint；

2、checkpoint在本地持久存储，30天之后自动清理；

3、checkpoint用于尝试不同的方案，而不会丢失起点；

4、checkpoint用于从错误中进行恢复，可以快速恢复；

5、不能跟踪bash命令的修改，不能跟踪外部的修改；

三、headless使用介绍

1、使用帮助：https://code.claude.com/docs/zh-CN/headless

2、--output-format json，输出结果为json

3、--json-schema schema，输出结果的schema

4、--output-format stream-json，输出结果为流式json

输出结果为json：

claude -p "获取目录下文件列表，无需递归" --output-format json\
 --json-schema '{"type":"object","properties":{"files":{"type":"array","items":{"type":"string"}}},"required":["files"]}'\
 | jq '{type,subtype,is_error,num_turns,result}, .structured_output'

输出结果为流式json：

claude -p "获取目录下文件列表，无需递归" --output-format stream-json --verbose --include-partial-messages\
 | jq -rj 'select(.type == "stream_event" and .event.delta.type? == "text_delta") | .event.delta.text'\
 | iconv -f UTF-8 -t UTF-8

恢复指定会话：

session_id=$(claude -p "Start a review" --output-format json | jq -r '.session_id')
claude -p "Continue that review" --resume "$session_id"