什么是Claude Code?它为何与普通Claude聊天的工作方式不同
本文在AI辅助下由原文翻译而成。请结合原文核对专业术语和公式。
核心摘要: Claude Code帮助您在开发项目中读取和修改文件、执行命令。在普通Claude对话中获得代码说明,与在项目环境中进行实际修改,需要检查的对象不同。与其比较哪一种绝对更好,应先明确需要的是说明还是文件修改。

1. Claude Code的核心是在项目中工作
官方文档介绍,Claude Code可在终端、IDE、桌面应用、网页等多种环境中使用。在CLI中,可以进行文件编辑和命令执行等项目工作。提供的环境与访问条件请查看官方概述。
例如,粘贴代码并询问“解释这个函数的含义”,与打开项目并委托“查找这个函数的调用位置并修复错误”,范围不同。后者需要相关文件、运行环境与验证命令。获得良好说明,并不能证明实际项目中的错误已经解决。
2. 与普通对话比较时需要确认的三点
| 确认事项 | 以说明为主的请求 | 修改项目的请求 |
| 输入资料 | 粘贴的代码与说明 | 项目文件与运行环境 |
| 预期结果 | 讲解、示例与修改建议 | 实际文件修改与验证记录 |
| 审查对象 | 说明是否与代码一致 | 修改内容与执行结果 |
此表是划分请求类型的示例,并非对产品全部功能作出定论。普通Claude也可以根据账户功能与连接工具执行多种任务。应确认当前会话能访问哪些文件和工具,而不是仅凭界面名称判断功能。
有关Claude Code如何依次收集资料、使用工具和确认结果,工作原理文档提供了说明。用户应在委托工作前确定完成标准,并在工作后检查修改文件与依据。
3. 适合新手委托的首个任务示例
开始时可以先要求说明项目结构或调查一个小错误,而不是添加功能。区分不修改文件的调查与实际修改阶段,更容易审阅回答。以下内容是起始示例,并非在特定项目中执行过的请求。
이 프로젝트의 구조를 먼저 설명해 줘.
실행 시작 파일, 주요 폴더, 기존 테스트 위치를 찾아 근거 경로를 적어 줘.
아직 파일은 수정하지 마.
실행 방법이 문서와 설정에서 일치하는지 확인하고,
확인할 수 없는 부분은 추측하지 말고 질문으로 남겨 줘.
读完说明并确认实际文件存在后,再请求小幅修改。可以指定一个问题,例如“只修复搜索结果为空时显示提示文字的问题。检查现有行为,并说明相关验证结果”。范围较小,也更容易查看哪些内容发生了变化。
4. 修改文件前确认任务范围与权限
项目存在既有修改时,应先检查并保留变更状态。写明目标文件与责任范围,也有助于避免碰触他人正在处理的文件。使用审查用示例资料,避免提供密码或真实客户数据。这些是整理开发工作的基本准备。
Claude Code通过权限设置管理工具访问。在问题中写下“不要修改”的指导,与限制工具使用的配置,作用不同。要管理实际访问范围,请查看官方权限文档和会话设置。对不熟悉的命令,宜先阅读执行目的与影响再继续。
5. 完成报告应检查什么
完成报告应显示修改的文件、修改原因、实际执行的验证,以及尚未确认的事项。“可以测试”或“看起来没有问题”,不同于实际运行测试并通过。应确认运行的命令与结果;如果修改了界面,还应在实际页面中检查行为。
例如只隐藏错误信息,表面上可能看似正常,但原因仍然存在。应同时确认复现条件是否消失,以及原来正常的输入是否仍按原样工作。既不应因为代码由AI生成就省略审查,也不应仅凭说明就断定有错,而应根据修改与观察结果判断。
6. 在终端、IDE与网页之间选择工作环境
即使都使用Claude Code,也应区分界面与代码执行的位置。先确定处理的是在自己的电脑上运行的项目,还是独立工作环境中的仓库。官方工作原理文档分别说明使用界面与执行环境,因此不能仅因为是网页界面,就断定文件在哪里处理。
| 想执行的工作 | 选择时检查的事项 | 首次委托的请求 |
| 修改现有本地项目 | 工作文件夹与当前已安装的工具 | 查找并说明结构与执行命令 |
| 在编辑器中比较变更 | 打开的项目与连接的运行环境 | 调查当前修改及相关调用位置 |
| 在独立环境中操作仓库 | 仓库访问与已准备的依赖 | 报告当前基准与可验证范围 |
| 只需要简短代码说明 | 要提供的代码与问题范围 | 解释输入、输出与异常 |

此表是选择环境时的判断框架,并非各账户的功能清单。某应用存在按钮,并不能证明当前需要的仓库与工具已经连接。先要求说明“当前工作路径、执行Shell、可读取的文件与无法确认的环境”,更容易确定下一请求的范围。
7. 首次修改前的项目准备顺序
- 打开实际工作的文件夹,并与其他同名项目区分。
- 区分用户原先修改的文件与新任务的目标文件。
- 从README和配置文件查找执行与验证方法。
- 区分不连接外部服务就可审查的部分,以及必须实际连接的部分。
- 简短记录正常输入与错误输入的预期行为。
如果是Git仓库,也可以查看变更状态。例如git status --short用于了解工作中的修改。本文章并未运行该命令;没有Git仓库的文件夹不能直接应用。应先了解显示的修改由谁创建,避免自动删除或还原文件。
이 폴더를 처음 확인합니다.
README와 설정 파일을 근거로 실행 방법을 설명하세요.
현재 변경 중 이번 요청과 관계있는 부분을 구분하세요.
파일을 수정하거나 패키지를 설치하지 마세요.
검증 명령을 발견하면 명령 / 목적 / 실행 조건을 적으세요.
외부 계정이나 비밀값이 필요한 확인은 그 값 대신
필요한 항목의 이름과 준비할 절차를 알려 주세요.
如果希望修改代码前先查看计划,可以参考官方指南中的claude --permission-mode plan等方式。有关计划模式的行为与批准流程,请参阅官方工作流程。自然语言中的“不要修改”请求,与实际会话权限模式,作用不同,应根据当前目的同时使用。
8. 将假想输入错误从说明转化为修改任务
以下是假想笔记应用的代码,并非从真实仓库取得,也不是使用Claude Code测试的结果。此示例用于理解代码说明请求与实际工作请求的差异。
function addNote(text, notes) {
notes.push({ text: text });
}
如果只需要说明,可以问“解释此函数的输入与数组修改,并说明接收空白字符串时应考虑哪些条件”。委托实际项目修改时,还应调查函数在哪里调用、是否可能传入非字符串输入,以及应该如何保持保存格式。
가상 메모 앱에서 공백만 적은 항목이 저장되는 문제를 해결하려고 합니다.
대상: [실제 파일 경로]
정상 동작: 내용이 있는 문자열은 기존 형식으로 한 번 저장.
오류 동작: 빈 문자열과 공백뿐인 문자열은 저장하지 않음.
먼저 호출부에서 전달하는 자료형과 기존 입력 검증을 조사하세요.
앞뒤 공백을 보존할지 제거할지는 현재 요구사항을 확인하세요.
공개 저장 형식은 바꾸지 마세요.
필요한 최소 수정과 관련 검증을 진행하고,
직접 실행한 명령·결과·미실행 항목을 보고하세요.
此示例中,“阻止仅含空白的字符串”与“删除所有句子首尾的空白”是不同要求。不需要后者的产品,也可以原样保存原文,仅判断有效性。即使认为已经找到原因,也应写明条件,避免擅自扩大产品行为。
| 假想审查输入 | 依据请求的预期 | 还需确定的条件 |
| 空字符串 | 不保存 | 是否显示提示文字 |
| 三个空格 | 不保存 | 是否包括其他空白字符 |
| “今天的待办事项” | 按现有格式保存 | 重复点击的处理 |
| “ 今天的待办事项 ” | 有内容的输入 | 首尾空格的保留政策 |
此表是完成标准的草稿,并非已执行的测试记录。获得实际验证结果后,应标明真正执行过哪些输入,其余项目仍保留为计划状态。
9. 阅读工作报告的实用方法
如果只得到“添加了输入验证”的说明,应分别要求说明代码修改事实与行为验证。只有修改文件及差异、已运行命令的输出、尚未准备好的环境分别列出,才能理解当前状态。即使验证命令成功,也应确认是否覆盖了所需输入案例。
완료 보고를 다음처럼 구분해 주세요.
변경: 파일명과 바꾼 동작.
관찰: 실제 실행한 명령과 확인한 입력·결과.
해석: 그 결과로 판단할 수 있는 범위.
미확인: 실행하지 않은 화면·환경·외부 연결.
다음 단계: 남은 확인을 수행할 구체적인 방법.
테스트 코드 작성과 테스트 실행을 같은 상태로 쓰지 마세요.
如果报告隐藏失败,可以要求“先说明最早失败的命令与错误位置,不要用预测填补结果”。区分获得项目说明、修改代码与确认实际行为的阶段,更容易决定下一步委托什么工作。
常见问题与错误解决
不懂编程也能使用吗? 可以先请求结构说明,但实际修改需要执行与审查能力。 只能在终端中使用吗? 官方指南介绍了多种使用环境,请确认自己的环境。 可以一次委托整个应用吗? 将目标按功能拆分,并确定各阶段完成标准,更容易理解进度。
官方来源与确认日期
官方文档确认日期:2026年10月3日。此后界面与提供条件可能发生变化。
为帮助理解本文而制作的原创插画。
Tistory 原文 ↗