Claude Code 入口地图
Claude Code 不是只有一个入口。入口选错了,任务会变慢、上下文会断、验收也会困难。
新手默认选择
第一次学习优先用 Terminal CLI。它最贴近真实项目,能完整体验 Plan Mode、权限审批、文件修改、检查和 Git 状态。
入口不是身份标签,而是任务工具。真实开发任务优先 CLI;局部解释和小改动可以用 IDE;远程跟进可以用 Web 或 mobile。
入口怎么选
- Terminal CLI:本地项目、构建、测试、Git、长时间代码任务。
- VS Code / JetBrains:当前文件解释、选中代码局部修改、inline diff 审查。
- Desktop:多会话、视觉化 diff、定时任务、本机文件任务。
- Web / mobile:远程仓库、长任务、离开电脑后的跟进。
可以先记一个简单判断:需要改本地项目、跑检查、看 Git,就优先 CLI;只想解释当前文件,就优先 IDE;需要远程跟进任务状态,再考虑 Web 或 mobile。
入口没有绝对好坏,只有是否适合当前任务。可以先按任务类型判断:
| 任务类型 | 推荐入口 | 不推荐原因 |
|---|---|---|
| 第一次读项目 | CLI | 上下文最完整,最接近真实项目 |
| 小范围解释当前文件 | IDE | CLI 也能做,但 IDE 上下文更直接 |
| 多文件修改 | CLI | Web 或 mobile 不适合频繁看本地 diff |
| 远程仓库长任务 | Web / mobile | 本地 CLI 不一定一直开着 |
| 视觉化检查 diff | IDE / Desktop | 纯终端阅读成本更高 |
| 本机文件整理 | Desktop / CLI | Web 不适合操作本机文件 |
入口选择表
- 要让 CC 读完整项目:用 CLI。
- 要让 CC 修改多个文件:用 CLI。
- 要解释当前文件或当前选中代码:用 IDE。
- 要一边看 diff 一边决定是否接受:IDE 或 Desktop 更舒服。
- 要离开电脑继续看任务状态:Web 或 mobile。
- 要接本地文件、本机脚本、本地服务:CLI 或 Desktop。
- 要处理远程仓库里的长任务:Web 更合适。
不要混用到失控
同一个任务不要同时在多个入口里反复指挥。比如 CLI 正在改文件,IDE 里又让 CC 改同一片代码,很容易上下文冲突。
推荐做法:
- 一个任务选一个主入口。
- 其他入口只做查看和补充。
- 换入口前先让 CC 生成交接摘要。
- 新入口先只读确认当前状态。
什么时候应该换入口
入口不是选定就永远不换。出现这些情况,可以考虑切换:
| 当前情况 | 建议 |
|---|---|
| IDE 里局部解释不够,需要读完整项目 | 切到 CLI |
| CLI 改完后想更舒服地看 diff | 切到 IDE 或 Desktop 查看 |
| 本地电脑要关机,但远程任务还要跟进 | 切到 Web / mobile |
| Web 任务需要本地运行和截图验收 | 回到 CLI 或 Desktop |
| 多入口已经开始混乱 | 暂停,先生成交接摘要 |
换入口前不要直接继续指挥。先让当前入口总结状态,再让新入口只读确认。
入口选错的信号
- CC 一直缺上下文,不知道项目入口在哪里。
- 文件已经被另一个入口改了,当前入口还按旧状态分析。
- 明明只是解释选中代码,却让 CC 扫完整仓库。
- 明明是多文件改造,却在只适合局部编辑的入口里来回补上下文。
- 远程任务已经完成,但本地项目没有同步状态。
出现这些情况,不要继续硬做。先让 CC 总结当前状态,再换入口。
入口选择的反例
这些做法容易让任务变慢:
- 在 mobile 上处理复杂多文件改动。
- 在 IDE 里让 CC 长时间扫完整仓库。
- 在 Web 上处理必须本地运行的 UI 验收。
- CLI 正在改文件时,又在 IDE 里让 CC 改同一批文件。
- 没有交接摘要就从一个入口切到另一个入口。
入口选错不一定会失败,但会增加上下文丢失和重复修改的概率。
判断模板
请帮我判断这个任务应该用 Claude Code 的哪个入口。 任务是: 【描述任务】 请按下面格式回答: 1. 推荐入口: 2. 为什么: 3. 不推荐哪些入口: 4. 开始前要准备什么: 5. 最小验收方式:
开始任务前的入口确认
每次任务开始前,可以先发一句:
请先判断当前入口是否适合这个任务。 任务目标: 【写任务】 请告诉我: 1. 当前入口是否适合。 2. 如果适合,第一步应该做什么。 3. 如果不适合,建议换到哪个入口。 4. 换入口前需要交接哪些信息。
换入口时的交接模板
我要从当前入口切换到另一个 Claude Code 入口继续任务。 请生成交接摘要: 1. 当前任务目标。 2. 已经完成的内容。 3. 修改过的文件。 4. 已验证内容。 5. 未验证和剩余风险。 6. 新入口继续时第一步应该做什么。
第一次学习路线
- 先用 CLI 完成安装、登录、模型验证。
- 再用 CLI 做第一次只读项目分析。
- 熟悉 diff 和权限后,再尝试 IDE 局部修改。
- 长任务和远程仓库场景再看 Web / mobile。
多入口协作的安全规则
| 规则 | 目的 |
|---|---|
| 一个任务一个主入口 | 避免上下文互相覆盖 |
| 换入口先交接 | 避免新入口误判状态 |
| 新入口先只读 | 确认文件和任务进度 |
| 不同时改同一批文件 | 避免冲突和重复修改 |
| 提交前回到 Git 状态 | 确认最终 diff 干净 |
验收结果
- 你知道 CLI、IDE、Desktop、Web 的分工。
- 你知道第一次学习优先用 CLI。
- 你知道入口选择要根据任务决定。
- 你知道切换入口前要交接上下文。