Claude Code：介绍与使用教程

迄今为止最先进的代码助手：

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

Claude Code 的介绍与演示：(English)

Claude Code 是什么？

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

Claude Code 为什么是最好的助手？

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

Claude Code 如何部署？详细安装步骤

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

Claude Code 如何部署？详细安装步骤

前置要求

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

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

mac os系统3步安装cc即配置环境教程点击查看教程

一、安装 Node.js

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

Ubuntu / Debian 用户

csharp 复制代码

# 添加 NodeSource 存储库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -

# 安装 Node.js
sudo apt-get install -y nodejs

# 验证安装
node --version
npm --version

macOS 用户

bash 复制代码

# 安装 Xcode 命令行工具
sudo xcode-select --install

# 安装 Homebrew（如未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 使用 Homebrew 安装 Node.js
brew install node

# 验证安装
node --version
npm --version

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

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

1.安装 Git for Windows

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

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

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

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

css 复制代码

node --version
npm --version

提示

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

二.卸载之前的镜像code(没有下载过可以跳过)

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

bash 复制代码

npm uninstall -g @anthropic-ai/claude-code

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

css 复制代码

sudo -i
npm uninstall -g @anthropic-ai/claude-code

三、安装 Claude Code

使用 npm 全局安装 Claude Code：

bash 复制代码

npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

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

bash 复制代码

# macOS/Linux 用户
npm install -g @anthropic-ai/claude-code

# Windows 用户（以管理员身份运行）
npm install -g @anthropic-ai/claude-code

注意

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

bash 复制代码

npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com

配置环境变量

配置文件在 ~/.claude 下，如果没有 setting``s``.json 文件，则新建一个，如果存在，那么进入编辑:

json 复制代码

{
  "env": {
    "ANTHROPIC_API_KEY": "token",
    "ANTHROPIC_BASE_URL": "https://code.ppchat.vip"
  },
  "permissions": {
    "allow": [],
    "deny": []
  },
  "apiKeyHelper": "echo 'token'"
  }

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

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

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

perl 复制代码

echo "请输入您的token:"
read -s TOKEN
mkdir -p ~/.claude
cat << EOF > ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_API_KEY": "$TOKEN",
    "ANTHROPIC_BASE_URL": "https://code.ppchat.vip"
  },
  "permissions": {
    "allow": [],
    "deny": []
  },
  "apiKeyHelper": "echo '$TOKEN'"
}
EOF
echo "设置文件已创建完成！"

打开Claude Code

在命令行执行命令

复制代码

claude

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

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

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

方法：在启动命令后添加 --dangerously-skip-permissions 参数。

css 复制代码

claude --dangerously-skip-permissions

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

减少配额消耗/提升cc返回速度和质量的使用技巧:

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

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

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

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

shell 复制代码

> /compact [注释] #您可以添加注释

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

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

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

方法二：手动执行 `/compact` 命令

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

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

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

Claude Code 有哪些功能？

Claude Code 直接进行交互：

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

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

bash 复制代码

# 启动交互模式
claude

# 以初始查询启动
claude "解释这个项目"

# 运行单个命令并退出
claude -p "这个函数做什么？"

# 处理管道内容
cat logs.txt | claude -p "分析这些错误"

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

Claude Code 支持连接到主流IDE：

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

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

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

shell 复制代码

> /ide

如果您使用 VSCode+WSL，请您提前在VSCode 插件商店安装 WSL 插件
对于更多的用法，您可以参考Claude Code的官方文档：IDE integrations - Anthropic

Claude Code 支持压缩上下文以节省点数：

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

bash 复制代码

/compact [您的描述]

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

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

Claude Code 能够恢复以前的对话：

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

kotlin 复制代码

claude --continue

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

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

css 复制代码

claude --resume

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

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

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

Claude Code 可以处理图像信息：

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

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

shell 复制代码

> 分析这个图像：/path/to/your/image.png

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

markdown 复制代码

> 这是错误的截图。是什么导致了它？ 
> 这个图像显示了什么？ 
> 描述这个截图中的UI元素 
> 生成CSS以匹配这个设计模型 
> 什么HTML结构可以重新创建这个组件？

Claude Code 支持深入思考：

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

markdown 复制代码

> 我需要使用OAuth2为我们的API实现一个新的身份验证系统。深入思考在我们的代码库中实现这一点的最佳方法。
> 思考这种方法中潜在的安全漏洞 
> 更深入地思考我们应该处理的边缘情况

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

Claude Code 支持管理命令历史：

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

Claude Code 通过 Claude.md 存储重要记忆：

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

shell 复制代码

> /init

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

Claude Code 拥有SDK：

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

Claude Code 支持上下文通用协议（MCP）：

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

Claude Code 在 Git 中的高级设置：

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

shell 复制代码

> 提交我的更改
> 创建一个 pr
> 哪个提交在去年十二月添加了 markdown 测试？
> 在 main 分支上变基并解决任何合并冲突

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

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

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

bash 复制代码

# 创建带有新分支的工作树 
git worktree add ../project-feature-a -b feature-a

# 或使用现有分支创建工作树
git worktree add ../project-bugfix bugfix-123

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

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

bash 复制代码

# 导航到您的工作树 
cd ../project-feature-a

# 在这个隔离环境中运行Claude Code
claude

- - 在另一个终端中：

bash 复制代码

cd ../project-bugfix
claude

- - 管理您的工作树

bash 复制代码

# 列出所有工作树
git worktree list

# 完成后移除工作树
git worktree remove ../project-feature-a

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

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

Claude Code 支持 Github Actions：

此功能仍是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，Claude 就可以分析您的代码、创建拉取请求、实现功能和修复错误 - 所有这些都遵循您项目的标准。--Anthropic

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

shell 复制代码

> /install-github-app

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

java 复制代码

> @claude 根据 issue 描述实现此功能
> @claude 我应该如何为此端点实现用户身份验证？

Claude Code 其他的自然语言功能：

识别未文档化的代码

markdown 复制代码

> 在auth模块中查找没有适当JSDoc注释的函数

生成文档

markdown 复制代码

> 为auth.js中未文档化的函数添加JSDoc注释

理解陌生代码

markdown 复制代码

> 支付处理系统做什么？
> 查找用户权限在哪里被检查
> 解释缓存层是如何工作的

智能编辑代码

markdown 复制代码

> 为注册表单添加输入验证
> 重构日志记录器以使用新的 API
> 修复工作队列中的竞态条件

测试或编辑您的代码

markdown 复制代码

> 运行 auth 模块的测试并修复失败
> 查找并修复安全漏洞
> 解释为什么这个测试失败了

Claude Code 常见的斜杠命令：

命令	用途
/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 Code 常见的 CLI 命令：

命令	描述	示例
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 文档。

Claude Code 常见的 CLI 参数：

标志	描述	示例
--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节点

Claude Code 常用的快捷键：

通用控制：

快捷键	描述	上下文
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 Code可以被用作Claude用作类Unix工具：教程 - Anthropic
Claude Code支持自定义斜杠指令：教程 - Anthropic
Claude Code支持使用$ARGUMENTS添加命令参数：教程 - Anthropic
Claude Code支持高级设置，您可以参考此文档：Claude Code 设置 - Anthropic
Claude Code的安全设置，请参考此官方文档：管理权限和安全 - Anthropic

Claude code 接入cursor

故障排除

常见问题

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

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

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

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

获取帮助

如果遇到问题，可以：

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

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

Claude Code：介绍与使用教程

迄今为止最先进的代码助手：

Claude Code 的介绍与演示：(English)

Claude Code 是什么？

Claude Code 为什么是最好的助手？

Claude Code 如何部署？详细安装步骤

Claude Code 如何部署？详细安装步骤

前置要求

mac os系统3步安装cc即配置环境教程 点击查看教程

一、安装 Node.js

Ubuntu / Debian 用户

macOS 用户

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

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

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

二.卸载之前的镜像code(没有下载过可以跳过)

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

三、安装 Claude Code

配置环境变量

打开Claude Code

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

减少配额消耗/提升cc返回速度和质量的使用技巧:

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

方法二：手动执行 /compact 命令

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

Claude Code 有哪些功能？

Claude Code 直接进行交互：

Claude Code 支持连接到主流IDE：

Claude Code 支持压缩上下文以节省点数：

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

Claude Code 能够恢复以前的对话：

Claude Code 可以处理图像信息：

Claude Code 支持深入思考：

Claude Code 支持管理命令历史：

Claude Code 通过 Claude.md 存储重要记忆：

Claude Code 拥有SDK：

Claude Code 支持上下文通用协议（MCP）：

Claude Code 在 Git 中的高级设置：

Claude Code 支持 Github Actions：

Claude Code 其他的自然语言功能：

Claude Code 常见的斜杠命令：

Claude Code 常见的 CLI 命令：

Claude Code 常见的 CLI 参数：

Claude Code 常用的快捷键：

Claude Code 其他的高级功能：

Claude code 接入cursor

故障排除

常见问题

获取帮助

mac os系统3步安装cc即配置环境教程点击查看教程

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

方法二：手动执行 `/compact` 命令

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