Claude Code 是什么?

🧠

基于 Claude 4 系列模型

可在本地运行的自动化工具,基于Claude 4系列模型获得强大的能力。

🔧

全面的代码理解

能理解您的代码库,执行命令,自动化管理Git仓库,调用您的Model Context Protocol (MCP)。

📝

智能项目管理

能按照您的想法创造、修改项目,出色地完成撰写文档,转写语言等您平时十分繁重的工作。

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

🏆

最出色的编程能力

基于 Claude 4 系列模型,具有迄今为止最出色的编程能力

🛠️

本地工具集成

直接使用您本地的工具,帮助您直接部署环境、设计工程

💻

完全命令行集成

完全集成于您的命令行,您甚至无需运行任何命令

🗣️

自然语言交互

无需学习多个技术栈,只需自然语言就能轻松解决问题

Claude Code 如何部署?

📋 系统要求

操作系统

  • macOS 10.15+
  • Ubuntu 20.04+/Debian 10+
  • Windows 11 (需要WSL)

必需工具

  • Node.js 18+
  • git 2.23+ (可选)
  • ripgrep (可选,用于增强搜索)

🚀 安装步骤

步骤 1: 安装 Node.js (如果尚未安装)

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt-get install -y nodejs
node --version
npm --version

步骤 2: 安装 Claude Code

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

步骤 3: 卸载旧版本 (如果需要)

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

步骤 4: 启动 Claude Code

cd your-project-folder
claude

首次使用需要访问命令行提供的链接进行验证,获取验证码完成登录。

💳 Claude Code 如何计费?

积分制计费

  • Claude Code 在本站使用积分制
  • 单次使用扣费根据上下文长度计算
  • 可访问账户查看详细配额与使用情况

节约积分技巧

/compact [注释] # 压缩上下文以节约使用次数

建议经常使用该命令,过长的上下文会导致响应缓慢并消耗更多积分。

🌟 Claude Code 有哪些功能?

🗣️ 交互模式

启动交互模式

claude

快速查询模式

claude -p "查询内容"

管道处理

cat logs.txt | claude -p "分析这些错误"

🔧 IDE 集成

VSCode

在内置终端唤起Claude Code,插件自动安装

JetBrains

需要手动下载安装插件

/ide  # 手动指定IDE

🧠 Claude Code 支持 Claude 4 Opus 与 Claude 4 Sonnet

Claude 4 Opus

最强性能 高计费

顶级性能,适合最复杂的编程任务,但费用较高。

注意:

  • 我们为您默认选择了Claude 4 Sonnet,您可以在登录后在配置中修改这一选项
  • 请注意,您在/model中切换的模型不会受到影响,修改模型需要在代理站中切换

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

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

/compact [instructions] # 压缩对话,可选择焦点说明

💡 建议经常使用该命令,过长的上下文会导致响应缓慢并消耗更多积分。

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

快速恢复最近对话

claude

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

交互式对话选择

claude --resume

这会显示一个交互式对话选择器,显示:

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

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

🖼️ Claude Code 可以处理图像信息

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

📁 拖拽图像

将图像拖放到Claude Code窗口中

📋 粘贴图像

复制图像并使用cmd+v(在Mac上)粘贴到CLI中

📂 提供路径

提供图像路径进行分析

使用示例:

"分析这个UI设计图,帮我实现对应的前端代码"
"这个错误截图显示了什么问题?如何解决?"

🧠 Claude Code 支持深入思考

您需要通过自然语言要求其进行深入思考。推荐您在使用复杂问题的时候使用这一功能,这也会消耗大量的额度点数。

使用示例:

"深入思考OAuth2身份验证系统的最佳实现方法"
"仔细分析这个架构设计的潜在问题和优化方案"
"深度思考这个算法的时间复杂度优化可能性"

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

设置项目记忆

/memory

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

CLAUDE.md 应该包含:

  • 包括常用命令(构建、测试、lint)以避免重复搜索
  • 记录代码风格偏好和命名约定
  • 添加特定于您项目的重要架构模式
  • 团队协作规范和个人偏好设置

CLAUDE.md记忆可用于与团队共享的指令和您的个人偏好。

更多关于记忆的设置,您可以访问官方文档了解:Claude Code 概述

管理Claude的内存详细用法:管理Claude的内存

🚀 Claude Code 支持自动化 CI 和基础设施工作流程

Claude Code 提供非交互模式,用于无头执行。这在非交互上下文(如脚本、管道和 Github Actions)中运行 Claude Code 时特别有用。

使用 --print (-p) 在非交互模式下运行 Claude:

claude -p "分析代码并生成测试报告"

🔌 Claude Code 支持上下文通用协议(MCP)

模型上下文协议(MCP)是一个开放协议,使LLM能够访问外部工具和数据源。

这是高级功能,您可以访问以下文档获取更多配置信息:

Claude Code不仅支持接入MCP,同样支持作为MCP服务器等各类高级功能。

🌳 Claude Code 支持使用Git工作树运行并行Claude Code会话

Claude Code 支持使用自然语言操作Git。您可以使用工作树创建隔离的编码环境。

工作树的优势:

  • 每个工作树都有自己独立的文件状态,非常适合并行Claude Code会话
  • 在一个工作树中所做的更改不会影响其他工作树,防止Claude实例相互干扰
  • 所有工作树共享相同的Git历史和远程连接
  • 对于长时间运行的任务,您可以让Claude在一个工作树中工作,同时您在另一个工作树中继续开发

创建新工作树:

git worktree add ../feature-branch feature-branch

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

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

# 在主工作树中
cd /path/to/main-project
claude

# 在另一个终端的工作树中
cd /path/to/feature-branch
claude

管理您的工作树:

# 列出所有工作树
git worktree list

# 删除工作树
git worktree remove ../feature-branch

💡 使用建议:

  • 使用描述性目录名称,以便轻松识别每个工作树的任务
  • 记得根据项目设置在每个新工作树中初始化开发环境
  • JavaScript项目:运行依赖安装(npm install、yarn)
  • Python项目:设置虚拟环境或使用包管理器安装
  • 其他语言:遵循项目的标准设置流程

🗣️ Claude Code 其他的自然语言功能

🔍 识别未文档化的代码

自动分析代码并生成详细的功能说明

📚 生成文档

为您的项目自动创建完整的文档

🤔 理解陌生代码

快速理解和解释复杂的代码逻辑

✏️ 智能编辑代码

基于自然语言指令智能修改代码

🧪 测试或编辑您的代码

自动生成测试用例并优化代码质量

⚡ Claude Code 常见的斜杠命令

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

⌨️ Claude Code 常用的快捷键

🔥 使用 # 快速记忆

通过以 # 开始输入来即时添加记忆,始终使用描述性变量名。系统会提示你选择要将其存储在哪个记忆文件中。

# 始终使用描述性变量名

⏎ 终端中的换行

使用以下方式输入多行命令:

快速转义

输入 \ 后按 Enter

键盘快捷键

Option+Enter(或配置后的 Shift+Enter)

⚙️ 在终端中设置 Option+Enter

对于 Mac Terminal.app

  • 打开设置 → 配置文件 → 键盘
  • 勾选"将 Option 键用作 Meta 键"

对于 iTerm2 和 VSCode 终端

  • 打开设置 → 配置文件 → 按键
  • 在常规设置下,将左/右 Option 键设置为"Esc+"

💡 iTerm2 和 VSCode 用户提示:在 Claude Code 中运行 /terminal-setup 以自动配置 Shift+Enter 作为更直观的替代方案。

📝 Vim 模式

Claude Code 支持一部分 Vim 键绑定,可以通过 /vim 启用或通过 /config 配置。

支持的功能包括:

  • 模式切换:Esc(到 NORMAL),i/I,a/A,o/O(到 INSERT)
  • 导航:h/j/k/l,w/e/b,0/$/^,gg/G
  • 编辑:x,dw/de/db/dd/D,cw/ce/cb/cc/C,.(重复)

🔧 Claude Code的常见问题

🔄 您需要升级 Claude Code?

通过以下命令升级:

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

如果以上升级方法出错,您可以使用以下多条命令彻底重装:

npm uninstall -g @anthropic-ai/claude-code
rm ~/.claude -r
rm ~/.claudecode -r
rm ~/.claude.json
cd ~
npm install -g @anthropic-ai/claude-code

❌ Claude Code 执行的命令行参数错误?

此类问题在WSL上常见,是Agent自身的错误。我们推荐您使用MacOS/Ubuntu,这类环境往往问题较少。

🚪 如何退出登录?

您可以执行以下命令清理Claude Code的登录信息:

rm ~/.claude -r
rm ~/.claudecode -r
rm ~/.claude.json

⚠️ Claude Code 出现 API Error,Tools Error?

这通常是网络问题,请您退出后使用claude -c重新执行。如果问题依然存在,请联系售后支持。

🔐 Claude Code 在登录使用OAuth时验证错误?

请您确保环境变量中没有配置任何代理再进行登录验证。

如果问题仍然存在,请您无视弹出的浏览器并复制终端中的链接并打开,通过验证码方式验证。

⏰ Claude Code 长时间没有响应?

我们建议您按下ctrl+c并重启Claude Code,这往往是网络问题。

如果命令行仍然无响应,我们建议您杀死进程并重新进行会话,这将不会影响您的工作进度。

您可以通过以下命令恢复上次的会话:

claude -c

💰 Claude Code 在什么情况下扣除一次积分?

  • 问Claude Code一个问题时会扣除积分
  • 如果您在任务中选择了"NO",将会被认为开始新的对话,扣除多一次积分

🚀 高级功能

🖼️ 图像处理

支持拖拽、粘贴图像,或提供图像路径进行分析

"分析这个图像:/path/to/your/image.png"

🧠 深入思考

使用自然语言要求进行深度分析和思考

"深入思考OAuth2身份验证系统的最佳实现方法"

📝 项目记忆

通过CLAUDE.md存储重要项目信息和约定

包括常用命令、代码风格、架构模式等

🔄 对话恢复

恢复之前的对话和工作状态

claude  # 恢复最近对话
claude --resume    # 选择对话恢复

❓ 常见问题

如何升级 Claude Code?

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

如何彻底重装 Claude Code?

+
npm uninstall -g @anthropic-ai/claude-code
rm ~/.claude -r
rm ~/.claudecode -r
rm ~/.claude.json
cd ~
npm install -g @anthropic-ai/claude-code

Claude Code 长时间没有响应怎么办?

+

建议按下 Ctrl+C 并重启 Claude Code,这通常是网络问题。可以通过以下命令恢复会话:

claude -c

准备开始使用 Claude Code?

立即访问代理站,开始您的AI编程之旅