Claude Code 指南：终端 AI 编程助手的正确打开方式

如果你已经习惯了 Cursor 或 GitHub Copilot 这类 IDE 插件，初次接触 Claude Code 时，可能会有点摸不着头脑。它看起来就是个朴素的终端，没有代码高亮，没有 diff 视图，也没有实时补全。这玩意儿到底有什么用？

但当你第一次对它说“帮我把这个模块重构一下”，然后看着它自主地读取文件、分析依赖、执行命令、运行测试，甚至提交代码时，才会恍然大悟：这根本不是传统意义上的“编程助手”，而是一个能在代码库级别自主行动的 AI Agent。

这篇文章，我们就来彻底搞懂 Claude Code，看看它到底能做什么，以及如何高效地使用它。

零、它和 Cursor 有什么本质区别？

Cursor：IDE 的 AI 增强

Cursor 的核心价值在于提升编码的即时效率。它的两大法宝是实时补全和对话式编辑。在 Cursor 里，你始终是主驾驶，AI 是副驾驶：你写代码，它提建议，帮你修改局部片段。这是一种紧密的、交互式的协作。

Claude Code：代码库级别的 AI Agent

Claude Code 走的完全是另一条路。它没有实时补全，你给它的不是一个光标位置，而是一个完整的任务。它会像一个真正的工程师一样，去读取项目文件、分析依赖、执行 Shell 命令、运行测试、提交 Git，最后把结果告诉你。在这个模式下，你的角色更像是产品经理或架构师，负责提出需求和验收成果。

一句话总结

简单来说：日常快速写代码、修修补补，用 Cursor；涉及到多文件协调、复杂重构、自动化工作流，就该 Claude Code 上场了。

一、使用

1. 账号

要使用 Claude Code，首先得有账号。常见的方式有两种：一是直接购买 Claude 官方账号，功能最全，但需自行评估相关风险；二是使用支持 Claude API 的国产模型，比如 Kimi、智谱 GLM 等。拿到 API Key 后，按照各平台的指引配置到环境变量即可。

2. 交互式使用

2.1 终端软件使用

在终端里，你有几种方式与它交互：最直接的就是常规文字输入。输入 /vim 可以切换到类 Vim 的编辑模式，方便处理多行内容，再输一次切回。对于长段内容，Ctrl + G 可以打开独立编辑窗口。如果想针对特定文件操作，用 @file 指定文件路径就行。

2.2 IDE 模式

如果你离不开 IDE，也可以在扩展市场搜索“Claude Code”插件来集成。它能让你方便地引用代码中的特定行，提升对话效率。

VS Code

在 VS Code 里，体验比较顺畅，可以直接把文件拖进对话窗口，或者用 Shift 键配合选择，复制粘贴也行。

JetBrains / 终端

在 JetBrains 系列 IDE 或纯终端环境下，主要通过复制粘贴来传递文件内容，mac 下粘贴可以用 Ctrl + V。它也支持直接上传图片或文件进行分析。

3. 非交互式使用

基础命令

除了聊天，Claude Code 也能通过命令行直接调用，适合集成到脚本或自动化流程中。基础命令格式是：claude -p "你的问题" --system-prompt "系统提示词"。

JSON 结构输出（附带元数据）

加上 --output-format json 参数，可以让它输出结构化的 JSON 数据，里面会包含 tokens 消耗等元信息。这特别适合脚本调用、CI/CD 集成或者批处理任务，方便程序解析结果。

4. 工作区

4.1 运行目录

Claude Code 默认基于你启动它时所在的目录进行工作。

4.2 添加项目

但它不局限于一个目录。启动时通过 --add-dir 参数，或者运行中动态加载，都可以把其他项目目录加进来。这对于多仓库联动、主仓库加 SDK，或者前后端协作的场景非常有用。

5. 编程范式

Claude Code 主要支持两种工作模式，应对不同场景。

5.1 ReAct

这种模式是“摸着石头过河”，边看边做，迭代速度快。它适合默认的对话场景、探索性任务或者问题排查，灵活性高。

5.2 Plan-and-Execute

这种模式则是“先想清楚再干”。AI 会先制定一个详细的计划，然后再一步步执行。这更适合大型重构、多阶段工作流等复杂的工程任务，可控性更强。

切换方式

切换起来很方便：在对话中用 Shift + Tab 快捷键；启动时通过 --permission-mode plan 参数指定；或者借助 superpowers-marketplace 这类插件来管理。

6. 会话管理

6.1 中断

想让 AI 停止当前操作？按 ESC 键就行。

6.2 撤销

如果对 AI 的修改不满意，想回退到某个对话点，有两种方法：输入 /rewind 命令，或者快速连按两次 ESC。

6.3 恢复会话

Claude Code 的会话是持久的。要恢复当前项目最近的一次对话，用 claude -c。想恢复更早的某次特定对话，则需要使用退出时显示的会话 ID，命令是 claude -r xxx-xxx-xx。你还可以在对话中用 /rename 给会话起个易懂的名字，之后就能按名字恢复了。

6.4 压缩上下文

对话长了，上下文太多，AI 可能会“迷失”。这时需要压缩上下文，总结关键信息。通常 Claude Code 会自动处理，你也可以手动用 /compact 命令，或者用 /clear 直接清除上下文。

6.5 临时问题

有些问题只是随口一问，不想污染主任务的上下文流。这时可以用临时提问的方式，问完即走，不影响主线。

二、运行原理：Agent

要理解 Claude Code，得先明白 Agent 的基本架构。它通常包含四个核心组件：LLM（大脑）、工具（手脚）、记忆（经验）和规划模块（策略）。

1. LLM

LLM 是整个系统的大脑，负责理解你的任务、做出决策并生成行动方案。你可以通过 /model 命令来切换使用的底层模型。

2. 记忆

2.1 短期记忆：对话上下文

就是当前会话中你与 AI 交流的所有历史记录。

2.2 长期记忆：规范文件

这才是让 AI 真正理解你项目的关键。最核心的文件是项目根目录下的 CLAUDE.md。这里可以放项目结构、开发规范、构建方式等。建议控制在 500 行以内，太长了可以拆分，用 @file 引入。

用 /init 命令可以让 AI 自动分析项目并生成初始的规范文件。对于标准化业务，你甚至可以在这里定义固定的开发工作流和专用助手。

2.3 Memory（开发偏好）

Claude Code 还会在本地记录你的开发偏好，比如代码风格、常用命令、协作习惯等。这些信息沉淀下来，能让它越来越懂你。

3. 工具

3.1 常规工具

Claude Code 原生就能做很多事：查找、读取、修改文件，执行 bash 命令，调用 git、go、npm 等命令行工具。

3.2 MCP

MCP（Model Context Protocol）是一个开源标准，可以把它理解为 AI 应用的“外设接口”。通过 MCP Server，Claude Code 能连接各种数据源、工具和工作流，从而获得访问关键数据和执行复杂任务的能力。比如，你可以通过 MCP 让它直接操作浏览器获取网页内容。

3.3 Skill

Skill 可以理解为封装好的“技能包”。你可以从开源市场下载，或者自己把常用的操作（比如几个固定的 git 命令组合）封装成 Skill。这样做的好处是标准化、可复用、输出稳定，还能降低重复写提示词的成本。当然，使用第三方 Skill 时要注意安全，可以用 skill-vetter 这类工具检查一下。

3.4 Plugin

插件功能就更强大了，可以从市场安装现成的，也支持自定义开发，适合封装企业内部的工作流或接入特定能力。

3.5 其它：CLI

一个很重要的思路是：尽量为你的项目提供完善的 CLI 工具。因为相比图形界面，AI 通常更擅长理解和操作命令行，这能极大提升 Agent 的执行效率和成功率。

三、Multi-Agent

1. Sub Agent

Subagents 是专门处理特定类型任务的 AI 助手。每个 Subagent 都有自己的上下文窗口、系统提示词和工具权限。当主 Agent 遇到匹配的任务时，会把它委托给对应的 Subagent 去独立完成，比如代码审查、测试生成、文档整理等。这相当于为工作流引入了“领域专家”。

2. Agent Team

如果说 Subagent 是公司里的专项小组，那 Agent Team 就是真正的项目团队。它允许你协调多个 Claude Code 实例一起工作：一个会话作为负责人，分配任务、汇总结果；其他成员独立工作，彼此之间还能直接通信。这和单个会话内的 Subagent 协作有本质区别。

这个功能默认是关闭的，需要通过环境变量 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS="1" 来启用。团队用完后，记得让研究员队友关闭，或者直接清理整个团队。

四、Web Hook / Hooks

Hooks 的作用是在 Claude Code 生命周期的特定节点，自动触发你定义的 Shell 命令。它的特点是确定性触发，不依赖 LLM 的判断，工程化价值很高。

适合用 Hooks 来做的事情很多，比如代码格式化、发送通知、校验命令、强制执行项目规则等。

示例：Mac 系统通知

一个很实用的场景是系统通知。配置好 Hooks 后，当 Claude Code 需要权限确认时，或者当一项耗时任务完成时，你的 Mac 会弹出系统通知。这样你就不用一直盯着终端窗口了。

五、使用技巧

1. 永远使用简体中文

Claude 原生有时会偏向用英文输出。虽然可以通过 --append-system-prompt 参数强制要求使用简体中文，但每次手动输入太麻烦。这时候可以借助 Claude Code Router 这类工具一劳永逸地解决。

2. Claude Code Router（CCR）

2.1 简介

Claude Code Router 是一个强大的模型路由工具。它能让你在 Claude Code 中无缝切换不同 AI 模型，无需手动改环境变量。同时还支持启动时追加参数、多模型切换和状态栏显示。

2.2 安装配置（启动参数 + 多模型 + 状态栏）

安装很简单：npm install -g @musistudio/claude-code-router。常用命令就几个：ccr ui 打开配置界面，ccr code 启动 Claude Code，ccr restart 重启网关。

核心是一个 JSON 配置文件，在里面定义好不同供应商的模型、路由策略（比如简单任务用国产模型，复杂任务用 Claude）以及状态栏显示内容即可。

Windows 用户常见坑

这里有个小提示：建议不要把 Node.js 安装在 Program Files 这类带空格的路径里，容易出问题。如果已经装了，在配置文件的路径上加双引号通常可以解决。

3. 权限与安全

上面的配置示例里用到了 --dangerously-skip-permissions 参数。首先必须明确：这个选项是危险的。因为它跳过了权限检查，意味着 Claude 可能获得你电脑环境的全部权限。

虽然很多人在实际使用中觉得和 Cursor 类似，没遇到问题，但风险是客观存在的。官方更建议在沙箱或无网络环境中使用。在 macOS、Linux 或 WSL2 下，可以用 /sandbox 命令启用沙箱环境。

对于官方账号用户，还可以使用 Auto mode。它会依赖模型分类器对命令进行风险评估，对常规安全操作自动放行，对高风险操作则要求确认或阻止。

4. 查看数据

Claude Code 提供了一些命令来查看运行状态：/cost 查看消耗，/context 查看上下文使用情况，/status 查看当前状态（包括模型）。/export 命令可以导出当前对话，方便保存或导入到其他工具（如 Cursor）中继续处理。

六、JetBrains 全家桶集成

1. macOS

在 macOS 下集成体验比较顺滑，安装插件后基本就能直接用了，无需手动 @ 文件路径。

2. Windows

如果已经安装了 WSL2，体验和 macOS 类似。但如果没装 WSL2，插件安装后可能无法正常使用，主要是因为路径映射和终端联动存在问题。

3. 解决思路：写一个 Go 程序自动修复路径

不想装 WSL2 ？可以写一个 Go 程序常驻后台，自动修复 IDE 和终端之间的路径映射问题。这样既能享受丝滑联动，又不用跑一个 WSL2 虚拟机，对 JetBrains 这种本就吃内存的 IDE 更友好。

七、总结

如果用一句话概括 Claude Code，那就是：它是一个代码库级别的 AI 执行引擎。

它最适合的场景，不是写一两行函数、补一个 if、改一处变量名。而是跨文件重构、大规模迁移、自动化执行工作流、多项目协同修改、复杂任务拆解与执行。

适合谁？

Claude Code 特别适合那些拥有中大型代码库、经常需要做多文件改动、偏爱终端工作流，并且希望将重复性工程操作自动化的开发者。

最佳搭配建议

实际工作中，没必要非此即彼。一个比较高效的组合是：用 Cursor 负责日常编码、补全和局部编辑；用 Claude Code 负责复杂的重构任务和自动化工作流。两者分工协作，效率最高。

相关攻略

热门推荐