Column 1
Column 2
参考资料
Claude Code Docs快速开始 - Claude Code Docs
快速开始 - Claude Code Docs
欢迎使用 Claude Code！
Claude Code DocsClaude Code DocsCommon workflows - Claude Code Docs
Common workflows - Claude Code Docs
Learn about common workflows with Claude Code.
Claude Code Docs介绍常用工作流，包括理解代码库，修正bug，重构代码，使用Plan模式，如何引用图片和文件，思考模式。会话管理等等
Claude Code DocsVisual Studio Code - Claude Code Docs
Visual Studio Code - Claude Code Docs
Use Claude Code with Visual Studio Code through the native extension or CLI integration
Claude Code DocsClaude Code DocsClaude Code on desktop - Claude Code Docs
Claude Code on desktop - Claude Code Docs
Run Claude Code tasks locally or on secure cloud infrastructure with the Claude desktop app
Claude Code Docs安装配置Claude Code 环境
- 安装git bash
环境变量 CLAUDE_CODE_GIT_BASH_PATH=D:\Git\usr\bin\bash.exe
- 安装 Node.js及换源安装claude code
- 配置API密钥（使用第三方API）
- 在 Git Bash 中执行以下命令设置环境变量：
- 永久设置环境变量
.claude/settings.json
- 安装代码编辑器
- 错误解决
在连接服务时遇到了问题。错误信息 ERR_BAD_REQUEST 和提示“可能不在支持的国家”通常意味着网络连接或服务配置有误。
任务拆解
- 小任务：一次性发送明确需求，Claude 可快速完成，适合如“重写注释”、“格式化当前文件”等场景。
- 复杂任务：建议手动拆分步骤，例如：
- 第一步：创建 API 接口
- 第二步：添加字段验证
- 第三步：编写测试用例
- 第四步：写文档或 PR 描述拆解有助于 Claude 聚焦上下文，避免 token 超限或逻辑混乱
常用命令
命令 | 功能 | 示例 |
claude | 启动交互模式 | claude |
claude "task" | 运行一次性任务 | claude "fix the build error" |
claude -p "query" | 运行一次性查询，然后退出 | claude -p "explain this function" |
claude -c | 继续最近的对话 | claude -c |
claude -r | 恢复之前的对话 | claude -r |
claude commit | 创建 Git 提交 | claude commit |
/clear | 清除对话历史 | > /clear |
/help | 显示可用命令 | > /help |
exit 或 Ctrl+C | 退出 Claude Code | > exit |
claude --dangerously-skip-permissions | 设置Safe YOLO模式，自动跳过所有权限确认 | ㅤ |
/compact | 压缩对话历史，只保留上下文摘要，从而减少 token 占用。 | ㅤ |
恢复历史会话
在启动的时候，执行
claude -c，可以继续上次对话执行
claude -r，可以选择历史对话继续。如果你已经打开了某个对话，你也可以输入 /resume 来切换到其他会话中。自定义命令
如果有一些经常用到的工作流程，你可以将流程设置为自定义指令。自定义指令分为两种：
- 用户级命令：放在
~/.claude/commands/目录下，适合所有项目通用的命令。触发方式是输入/user:命令名。
- 项目级命令：放在项目根目录下的
.claude/commands/目录中，适合这个项目专用的命令。触发方式是/project:命令名。
举个例子：
假设在
.claude/commands/ 文件夹里新建了一个 optimize.md 文件，里面写上：保存后，你就可以在 Claude Code 中执行
/project:fix-github-issue 1234 ，让 Claude 自动修复指定的 GitHub issue。其中1234是Issue的ID，而指令中的ARGUMENTS会被自动替换成1234你还可以把其他需求封装成命令，比如：
/user:write-tests→ 生成测试用例
/project:lint→ 按团队规范格式化代码
/user:explain→ 把复杂代码解释成人话
在项目根目录创建 CLAUDE.md，定义技术栈、规范和目标：
你可以在项目根和子目录创建多个
CLAUDE.md，为每个上下文提供个性化配置。文件路径 | 作用 |
项目根目录/CLAUDE.md | 团队共享的项目级配置，提交至 Git 供所有成员使用 |
项目根目录/CLAUDE.local.md | 个人本地覆盖配置，通常加入 .gitignore 避免影响他人 |
父目录/CLAUDE.md | 在 Monorepo 结构中自动继承的上级配置（递归向上查找） |
子目录/CLAUDE.md | 针对特定子模块/功能的独立配置（优先于父级配置加载） |
~/.claude/CLAUDE.md | 用户全局默认配置，适用于所有 Claude 会话的基线设定 |
提示与思考策略
XML 标签结构化提示
Claude 对结构化语言比较敏感，使用类似 XML 的分块格式，可以显著提升提示词的清晰度与可控性。推荐使用如下结构：
这种写法能帮助 Claude 更准确地区分“你要它做什么”和“你提供了哪些辅助信息”，避免它把背景当成目标来执行。
预激活：先学会，再动手
Claude 是可以学习的，关键是你得让它在行动前先理解上下文。
比如：
你希望它重构一个后端模块，不要一上来就说“重构这段代码”，而是先让它阅读整个模块、分析目录结构、总结已有功能，再进入编码阶段。
分步骤操作如下：
- 要求 Claude 阅读特定文件夹（如
/src/services/user/），并让它输出总结；
- 确保它已经理解后，再下达具体任务，例如“将 A 功能迁移到 B 模块中并优化逻辑”。
这种预激活式引导，比直接抛任务更可靠。
强制深度思考
从提示词的角度来看，Claude 有深度思考模式，但是默认不启用。你可以通过添加关键词唤起它进入认真思考的状态。
常用关键词：
think harder
ultrathink
step-by-step reasoning
添加上述关键词后，虽然响应时间稍长，但模型输出质量会显著提升。
提供清晰的需求文档
Claude 不是你脑内的复制人，如果你的指令含糊、信息不全，它就只能瞎猜，结果十有八九都不准。
正确做法是：
- 花时间写清楚你要它完成的功能点；
- 明确涉及哪些接口、交互方式、边界条件；
- 如果能画图（流程图、数据流）就更好了。
你写得越清晰，Claude 越能准确执行； 你模糊带过，它就只能听个响。
Git 流程自动化
"为新特性创建分支（命名：feature/auth），提交所有修改，推送到远程”
检查代码质量：
"检查这段代码是否足够简单，有无潜在问题”
生成测试用例
"为这个 PR 写一份测试计划”
优化遗留系统
"分析当前代码库的依赖关系，提出模块化重构方案，并生成迁移脚本”
