Claude Code：介绍与使用教程

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

Claude Code是为编写代码而生的Agent，您可以像与人对话一样，使用自然语言轻松实现的想法，无需任何学习成本。
只需等待一杯咖啡的时间，Claude Code就可以为您解决所有问题。

Claude Code 是由 Anthropic 开发的可在本地运行的自动化工具，基于Claude 4系列模型获得强大的能力.
能理解您的代码库，执行命令，自动化管理Git仓库，调用您的Model Context Protocol (MCP)。
能按照您的想法创造、修改项目，出色地完成撰写文档，转写语言等您平时十分繁重的工作。

基于 Claude 4 系列模型，具有迄今为止最出色的编程能力。
相较于竞品，Claude Code能够直接使用您本地的工具，帮助您直接部署环境、设计工程。
完全集成于您的命令行，您甚至无需运行任何命令。
无需学习多个技术栈，只需自然语言就能轻松解决您的问题和需求。
经济的计费方式，使您需要极低的成本以最高的效率完成繁重的工作。
兼容所有命令行工具

基于 Claude 4 系列模型，具有迄今为止最出色的编程能力。
相较于竞品，Claude Code能够直接使用您本地的工具，帮助您直接部署环境、设计工程。
完全集成于您的命令行，您甚至无需运行任何命令。
无需学习多个技术栈，只需自然语言就能轻松解决您的问题和需求。
经济的计费方式，使您需要极低的成本以最高的效率完成繁重的工作。
兼容所有命令行工具

前置要求

在开始之前，请确保你的系统满足以下要求：

操作系统：Windows、macOS 或 Linux
Node.js 版本 ≥ 18.0
稳定的网络连接

如果你已经安装了 Node.js 18+ 版本，可以跳过此步骤。

Ubuntu / Debian 用户

 macOS 用户
 Windows 用户（目前可以直接安装code）

详细安装教程和配置环境设置

1.安装 Git for Windows

github.com/git-for-win...

2.安装 Node.js(版本 18 以上)

访问 Node.js nodejs.org/zh-cn/downl... 官网下载并安装最新稳定版

3.打开命令提示符或 PowerShell，验证安装：

 提示

建议使用 Node.js LTS（长期支持）版本以确保稳定性。

如果您先前安装过镜像Claude Code，请您务必先通过以下命令卸载（如果没有请跳过此步骤）

 卸载后再次输入 claude 命令，如果还是没有卸载成功，那就在终端输入

使用 npm 全局安装 Claude Code：

 如果遇到权限问题，可以尝试：
 注意

如果安装过程中遇到网络问题，可以尝试使用国内 npm 镜像：

配置文件在下，如果没有文件，则新建一个，如果存在，那么进入编辑:

 上面的配置配置复制设置中，同时需要把平台生成的token替换里面的token占位符的内容.

只需修改这3个地方，其他地方不需要修改，注意不要误删标点符号~

可以使用下面的命令帮助创建:

 打开Claude Code

在命令行执行命令

 则进入到 claude code里了，然后应该会识别出你是API KEY用户，直接就可以开始对话使用。

激活"自动执行"模式 (Bypass Permissions)

默认情况下，Claude Code 在执行修改文件、运行命令等操作前会请求您的授权。为了让它能自动连续工作，您可以激活"Bypass Permissions"模式。

方法：在启动命令后添加参数。

 这样，Claude Code 将跳过所有权限检查，自动执行任务，极大提升工作流效率。

1.提问清晰，直接告诉claude修改什么文件/函数/页面，这样可以避免扫描所有文件去自动定位消耗配额

2.大需求改成小需求，一步一步提问，或者先生成一个执行计划，避免一个大需求跑了几百配额，然后发现实现方式不对或者需求理解有问题，又从头再来

3./compact 命令减少上下文和缓存数量，减少cc模型思考时间

建议您使用以下方式压缩上下文，Claude会仅保留核心信息来节约积分：

过长的上下文可能导致响应速度十分缓慢。为了您的体验，建议您经常使用该命令。

方法一：为不相关的任务开启新的Claude实例

说明：当您要开始一个与当前对话内容完全不相关的新任务时，**做法是关闭当前的Claude Code实例，然后重新打开一个新的实例。这样，新任务会从一个全新的、空白的Context开始，避免携带不必要的历史信息。

方法二：手动执行命令

说明：在对话过程中，如果您感觉上下文变得过长，可以尝试在输入框中键入并发送命令。Claude会尝试对当前对话的上下文进行压缩和精简，保留核心信息，从而可能减少后续调用的Context长度。
注意：此命令的效果取决于对话的具体内容和复杂性。

方法三：利用历史回溯（如适用，通过 + ）

说明：如果您发现对话"走了弯路"，即当前的讨论方向或Claude的解决方案并非您想要的，并且导致了不必要的上下文累积。可以尝试通过快捷键（例如，连续按两次键）来访问会话历史记录。您可以选择回退到历史中某个更早、更相关的节点，并从那里继续对话。这样做可以有效地"剪掉"后续不需要的上下文。

您可了解 Claude Code 常见的工作流，但Claude Code 比您想象的更强大。
Claude Code 提供两种主要的交互方式：

- 交互模式：运行启动 REPL 会话
- 单次模式：使用进行快速命令
- 您可以参考：

对于 Claude Code Client的常用参数和功能，您可以访问官方文档：CLI 使用和控制 - Anthropic

您可以直接在IDE中看到Claude Code的改动，在IDE中与其交互。
Claude Code 现在支持 VSCode 与 JetBrains
如果您使用Linux / MacOS，您可以直接使用该插件

- 如果您使用VSCode，在VSCode的内置终端唤起Claude Code，插件将被自动安装
- 如果您使用JetBrains，您需要通过此链接下载：Claude Code [Beta] - IntelliJ IDEs Plugin | Marketplace

您可能需要手动指定IDE或检查DIE连接，通过以下命令测试：

如果您使用 VSCode+WSL，请您提前在VSCode 插件商店安装 WSL 插件

对于更多的用法，您可以参考Claude Code的官方文档：IDE integrations - Anthropic

Claude Code 通常会有长上下文，我们建议您使用以下斜杠命令来压缩以节省点数，较长的上下文往往需要更多点数。

 Claude Code 支持恢复上一步修改：[未来支持]

Claude Code 支持使用或在Vim模式下使用撤销 Claude Code 的上一步修改。

使用以下命令可以恢复您上次的对话

这会立即恢复您最近的对话，无需任何提示。

您如果需要显示时间，可以输入此命令

这会显示一个交互式对话选择器，显示：

- - 对话开始时间
  - 初始提示或对话摘要
  - 消息数量

- 使用箭头键导航并按Enter选择对话，您可以使用这个方法选择上下文。

您可以使用以下任何方法：

- 将图像拖放到Claude Code窗口中（在MacOS上）
- 复制图像并使用粘贴到CLI中（在MacOS上）
- 提供图像路径

您可以完全使用自然语言要求他进行工作，如：

您需要通过自然语言要求其进行深入思考

推荐您在使用复杂问题的时候使用这一功能，这也会消耗大量的额度点数。

历史按工作目录存储
使用命令清除
使用上/下箭头导航（参见上面的键盘快捷键）
Ctrl+R：反向搜索历史（如果终端支持）
注意：历史扩展（）默认禁用

您可以使用以下命令设置一个CLAUDE.md文件来存储重要的项目信息、约定和常用命令。

包括常用命令（构建、测试、lint）以避免重复搜索
记录代码风格偏好和命名约定
添加特定于您项目的重要架构模式
CLAUDE.md记忆可用于与团队共享的指令和您的个人偏好。
更多关于记忆的设置，您可以访问此官方文档了解：Claude Code 概述 - Anthropic
在官方文档中，此部分记录了记忆的常用用法：管理Claude的记忆 - Anthropic

Claude Code 支持Python SDK，请参考官方文档：Claude Code SDK - Anthropic
直接访问 Python SDK Github 仓库：GitHub - anthropics/claude-code-sdk-python

模型上下文协议(MCP)是一个开放协议，使LLM能够访问外部工具和数据源。
这是高级功能，您可以访问此文档获取更多配置信息：Introduction - Model Context Protocol
Claude Code不仅支持接入MCP，同样支持作为MCP服务器等各类高级功能，您可以访问此文档获得更多信息：教程 - Anthropic

Claude Code 支持使用自然语言操作Git，如：

您可以使用工作树创建隔离的编码环境。

- 如果您您需要同时处理多个任务，并在Claude Code实例之间完全隔离代码，您可以使用此功能：

- - Git工作树允许您从同一存储库中检出多个分支到单独的目录。每个工作树都有自己的工作目录，文件是隔离的，同时共享相同的Git历史。在git-worktree中了解更多。
  - 创建新工作树

- - 这会创建一个包含存储库单独工作副本的新目录。

- - 在每个工作树中运行Claude Code

- 在另一个终端中：

- 管理您的工作树

- 每个工作树都有自己独立的文件状态，非常适合并行Claude Code会话
- 在一个工作树中所做的更改不会影响其他工作树，防止Claude实例相互干扰
- 所有工作树共享相同的Git历史和远程连接
- 对于长时间运行的任务，您可以让Claude在一个工作树中工作，同时您在另一个工作树中继续开发
- 使用描述性目录名称，以便轻松识别每个工作树的任务
- 记得根据项目的设置在每个新工作树中初始化开发环境。根据您的技术栈，这可能包括：

- - - JavaScript项目：运行依赖安装（、）
    - Python项目：设置虚拟环境或使用包管理器安装
    - 其他语言：遵循项目的标准设置流程

此功能仍是Beta版本，您可访问此链接获取使用

- GitHub - anthropics/claude-code-action
- Claude Code GitHub Actions - Anthropic

这是一个适用于 GitHub PR 和 issues 的通用 Claude Code 动作，可以回答问题并实现代码更改。此动作会在评论中监听触发词并根据请求激活 Claude 动作。

- Claude Code GitHub Actions 为您的 GitHub 工作流程带来 AI 驱动的自动化。只需在任何 PR 或 issue 中简单地提及，Claude 就可以分析您的代码、创建拉取请求、实现功能和修复错误 - 所有这些都遵循您项目的标准。--Anthropic

通过以下命令部署 Claude Code Github App，此命令将引导您完成设置 GitHub 应用和所需的密钥：

安装成功后，您可用命令，如：

识别未文档化的代码

生成文档

理解陌生代码

智能编辑代码

测试或编辑您的代码

命令用途 /bug 报告错误（将对话发送给 Anthropic） /clear 清除对话历史 /compact [instructions] 压缩对话，可选择焦点说明 /config 查看/修改配置 /cost 显示令牌使用统计 /doctor 检查 Claude Code 安装的健康状况 /help 获取使用帮助 /init 使用 CLAUDE.md 指南初始化项目 /login 切换 Anthropic 账户 /logout 从 Anthropic 账户登出 /memory 编辑 CLAUDE.md 记忆文件 /pr_comments 查看拉取请求评论 /review 请求代码审查 /status 查看账户和系统状态 /terminal-setup 安装 Shift+Enter 换行键绑定（仅限 iTerm2 和 VSCode） /vim 进入 vim 模式以切换插入和命令模式

命令描述示例 claude 启动交互式 REPL claude claude "query" 使用初始提示启动 REPL claude "explain this project" claude -p "query" 通过 SDK 查询，然后退出 claude -p "explain this function" cat file claude -p "query" 处理管道内容 cat logs.txt claude -p "explain" claude -c 继续最近的对话 claude -c claude -c -p "query" 通过 SDK 继续 claude -c -p "Check for type errors" claude -r "" "query" 通过 ID 恢复会话 claude -r "abc123" "Finish this PR" claude mcp 配置模型上下文协议 (MCP) 服务器请参阅 Claude Code MCP 文档。

标志描述示例 --print, -p 在非交互模式下运行 claude -p "query" --output-format 指定输出格式（text、json、stream-json） claude -p --output-format json --resume, -r 通过会话 ID 恢复对话 claude --resume abc123 --continue, -c 继续最近的对话 claude --continue --verbose 启用详细日志记录 claude --verbose --max-turns 在非交互模式下限制代理轮次 claude --max-turns 3 --system-prompt 覆盖系统提示（仅适用于 --print） claude --system-prompt "Custom instruction" --append-system-prompt 附加到系统提示（仅适用于 --print） claude --append-system-prompt "Custom instruction" --allowedTools 允许的工具的空格分隔列表，或允许的工具的逗号分隔列表字符串 claude --allowedTools mcp__slack mcp__filesystem,claude --allowedTools "Bash(npm install),mcp__filesystem" --disallowedTools 拒绝的工具的空格分隔列表，或拒绝的工具的逗号分隔列表字符串 claude --disallowedTools mcp__splunk mcp__github,claude --disallowedTools "Bash(git commit),mcp__github" --mcp-config 从 JSON 文件加载 MCP 服务器 claude --mcp-config servers.json --permission-prompt-tool 用于处理权限提示的 MCP 工具（仅适用于 --print） claude --permission-prompt-tool mcp__auth__prompt --logout 退出GAC登录 --pick-relay 选择GAC节点

通用控制：

快捷键描述上下文 Ctrl+C 取消当前输入或生成标准中断 Ctrl+D 退出 Claude Code 会话 EOF 信号 Ctrl+L 清除终端屏幕保留对话历史上/下箭头导航命令历史回调之前的输入 Esc + Esc 编辑上一条消息双击 Escape 键修改

多行输入：

方法快捷键上下文快速转义 + Enter 在所有终端中工作 macOS 默认 Option+Enter macOS 上的默认设置终端设置 Shift+Enter 在 /terminal-setup 之后粘贴模式直接粘贴用于代码块、日志

快速命令：

快捷键描述注释开头的 # 内存快捷键 - 添加到 CLAUDE.md 提示文件选择开头的 / 斜杠命令参见斜杠命令

Vim 模式：

- 参考：交互模式 - Anthropic

Claude Code可以被用作Claude用作类Unix工具：教程 - Anthropic
Claude Code支持自定义斜杠指令：教程 - Anthropic
Claude Code支持使用添加命令参数：教程 - Anthropic
Claude Code支持高级设置，您可以参考此文档：Claude Code 设置 - Anthropic
Claude Code的安全设置，请参考此官方文档：管理权限和安全 - Anthropic

常见问题

Q: 安装时提示权限错误 A: 尝试使用（Linux/macOS）或以管理员身份运行命令（Windows）

Q: 无法连接到 API A: 检查网络连接和 API 地址是否正确配置

Q: 令牌认证失败 A: 确认令牌格式正确（以开头）且未过期

Q: 命令找不到 A: 确保 Node.js 和 npm 已正确安装，并且 PATH 环境变量包含 npm 全局安装目录

获取帮助

如果遇到问题，可以：

查看 Claude Code 官方文档
在终端中运行
百度google一下

现在你已经成功配置了 Claude Code，可以开始享受 AI 辅助编程的强大功能了！记住，Claude Code 是你的编程搭档，善用它可以大大提高开发效率。

Claude Code：介绍与使用教程

前置要求

Ubuntu / Debian 用户

macOS 用户

Windows 用户（目前可以直接安装code）

github.com/git-for-win...

访问 Node.js nodejs.org/zh-cn/downl... 官网 下载并安装最新稳定版

如果您先前安装过镜像Claude Code，请您务必先通过以下命令卸载（如果没有请跳过此步骤）

打开Claude Code