🚀Claude Code

概述

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

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

Claude Code 是什么?

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

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

🎯 核心优势

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

部署指南

系统要求

使用Claude Code,您需要满足以下要求:

操作系统: macOS 10.15+、Ubuntu 20.04+/Debian 10+ • Windows 用户: 如果您使用Windows 11,请参考:Claude Code:在WSL上部署Node.js: 18+ • Git: 2.23+ (可选) • ripgrep: 用于增强文件搜索 (可选)

安装步骤

1. 安装 Node.js 环境

如果您的环境全新,请通过以下命令安装 Node.js 环境:

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

注意: 如果您已经安装 Node.js,请确保版本为 18.0 或更高版本。

2. 安装 Claude Code

确保您的npm与 Node.js可用后,请通过以下命令安装代理的Claude Code:

npm install -g https://code.gac.zoco.cc/claudecode/install --registry=https://registry.npmmirror.com
claude --version

3. 卸载旧版本(如需要)

如果您先前安装过 Claude Code,请先通过以下命令卸载:

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

首次使用

  1. 启动 Claude Code

cd your-project-folder
claude
  1. 验证登录

当您首次使用时,Claude Code要求您输入验证码。您需访问命令行中提供的链接登录并获取,输入以完成验证。

账户链接: Login - Claude Code

激活码购买地址https://s.tb.cn/c.0DYPCi

  1. 配置设置

在验证后,您需要选择主题、允许使用Bash和当前所在目录。

🎉 恭喜您!您已经完成了 Claude Code的安装与部署!

计费说明

积分制度

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

积分补充

有3种方法补充积分

1、月卡每小时自己补充 100 积分

2、每周可以手动重置积分 2 次【可能会变】。

3、购买加油包直接一次性额外附加10k 积分。

节约积分技巧

建议您使用以下方式压缩上下文,Claude会仅保留核心信息来节约使用次数:

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

核心功能

交互模式

Claude Code 提供两种主要的交互方式:

交互模式

# 启动交互模式
claude

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

单次模式

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

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

IDE 集成支持

• 您可以直接在IDE中看到Claude Code的改动,在IDE中与其交互。 • 支持的IDE: VSCode 与 JetBrains

配置方法

Linux / MacOS 用户: • 如果您使用VSCode,在VSCode的内置终端唤起Claude Code,插件将被自动安装 • 如果您使用JetBrains,您需要通过此链接下载:Claude Code [Beta] - IntelliJ IDEs Plugin

手动指定IDE:

/ide

WSL 用户: 请参考文档中的IDE部分:Claude Code:在WSL上部署

模型选择

Claude 4 Opus 与 Claude 4 Sonnet 支持 • 我们强烈推荐您使用Claude 4 Sonnet,其使用体验与Claude 4 Opus没有明显差别,但计费倍率仅为1/5。 • 我们为您默认选择了Claude 4 Sonnet,您可以在登录后在配置中修改这一选项。

注意: 您在/model中切换的模型不会受到影响,修改模型需要在代理站中切换。

上下文管理

压缩上下文

/compact [instructions]  # 您可以添加说明

恢复对话

# 立即恢复最近的对话
claude --continue

# 显示交互式对话选择器
claude --resume

图像处理能力

您可以使用以下任何方法处理图像:

• 将图像拖放到Claude Code窗口中 • 复制图像并使用cmd+v(在Mac上)粘贴到CLI中 • 提供图像路径

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

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

深入思考功能

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

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

项目记忆管理

CLAUDE.md 文件

您可以使用以下命令设置一个CLAUDE.md文件来存储重要的项目信息:

/init

CLAUDE.md记忆用途: • 包括常用命令(构建、测试、lint)以避免重复搜索 • 记录代码风格偏好和命名约定 • 添加特定于您项目的重要架构模式 • CLAUDE.md记忆可用于与团队共享的指令和您的个人偏好

快速记忆

# 使用 # 开始输入来即时添加记忆
# 始终使用描述性变量名

高级功能

自动化 CI 和基础设施工作流程

Claude Code 提供非交互模式,用于无头执行:

claude -p "使用最新更改更新 README" --allowedTools "Bash(git diff:*)" "Bash(git log:*)" Write --disallowedTools ..

模型上下文协议(MCP)支持

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

这是高级功能,您可以访问此文档获取更多配置信息:Introduction - Model Context Protocol

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

Git 工作流集成

Claude Code 支持使用自然语言操作Git:

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

Git工作树并行会话

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

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

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

# 在每个工作树中运行Claude Code
cd ../project-feature-a
claude

管理工作树:

# 列出所有工作树
git worktree list

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

自然语言编程示例

代码理解

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

智能编辑

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

文档生成

> 在auth模块中查找没有适当JSDoc注释的函数
> 为auth.js中未文档化的函数添加JSDoc注释

测试和调试

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

命令参考

斜杠命令

命令
用途

/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 模式以切换插入和命令模式

快捷键

终端中的换行

快速转义: 输入 \ 后按 Enter • 键盘快捷键: Option+Enter(或配置后的 Shift+Enter)

终端配置:

Mac Terminal.app:

  1. 打开设置 → 配置文件 → 键盘

  2. 勾选"将 Option 键用作 Meta 键"

iTerm2 和 VSCode 终端:

  1. 打开设置 → 配置文件 → 按键

  2. 在常规设置下,将左/右 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

# 升级命令
npm install -g https://code.gac.zoco.cc/claudecode/install --registry=https://registry.npmmirror.com

如果升级出错,可以使用以下命令彻底重装:

npm uninstall -g @anthropic-ai/claude-code
rm ~/.claude -r
rm ~/.claudecode -r
rm ~/.claude.json
cd ~
npm install -g https://code.gac.zoco.cc/claudecode/install --registry=https://registry.npmmirror.com

常见问题解决

命令行参数错误

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

登录问题

如果需要清理Claude Code的登录信息:

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

API Error,Tools Error

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

OAuth验证错误

• 请确保环境变量中没有配置任何代理再进行登录验证。 • 如果问题仍然存在,请无视弹出的浏览器并复制终端中的链接打开,通过验证码方式验证。

长时间无响应

• 建议您按下ctrl+c并重启Claude Code,这往往是网络问题。 • 如果命令行仍然无响应,建议您杀死进程并重新进行会话,这将不会影响您的工作进度。 • 您可以通过以下命令恢复上次的会话:

claude -c

计费相关

何时扣除积分?

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

测试分支(独立站点)

npm install -g https://code.chatshare.zoco.cc/claudecode/install --registry=https://registry.npmmirror.com

价格优势

技术支持

专业技术支持

🎯 7×24小时技术支持 📞 专属开发者客服 📚 详细使用教程 🔧 个性化配置指导

联系我们获取专业的 Claude Code 集成方案!


扩展阅读

Claude Code官方文档 - CLI 使用和控制Claude Code官方文档 - IDE 集成Claude Code官方文档 - 教程Claude Code官方文档 - 设置Claude Code官方文档 - 安全管理


Last updated