Claude Code安装与使用指南

Claude Code概述

Claude Code是什么

Claude Code是由Anthropic推出的一款驻留在你终端中的智能编程代理工具，它能理解你的代码库，并通过执行常规任务、解释复杂代码以及处理Git工作流来帮你加速编程--所有这一切只需要通过自然语言指令即可完成。你可以在终端、IDE中使用它

Claude Code能为你做什么

从需求描述直接构建功能：用自然语言描述你想要构建什么。Claude Code将制定计划、编写代码并确保其正常工作。
调试和修复问题：描述一个错误或粘贴一条错误信息。Claude Code将分析你的代码库、定位问题并实施修复。
导航和理解任意代码库：询问关于你团队代码库的任何内容，并获得深思熟虑的答案。Claude Code维护对整个项目结构的认识，可以从网络上查找最新信息，并且通过MCP可以从互联网上的外部数据源中提取数据。
自动化繁琐的任务：修复棘手的lint问题、解决合并冲突并编写发布说明。从你开发机器上用一个命令完成所有这些，或者在CI中自动完成。

为什么开发者喜欢Claude Code

在你的终端中工作：不是另一个聊天窗口。不是另一个IDE。Claude Code在你已经工作的地方与你相遇，使用你正在使用的工具。
采取行动：Claude Code可以直接编辑文件、运行命令和创建提交。需要更多？MCP让Claude读取你在互联网上的在线文档，将本地报错整合为工单并发送到邮箱，或使用你自定义的开发工具。
Unix哲学：Claude Code是可组合和可脚本化的。tail -f app.log | claude -p "如果在日志看到异常信息立刻通知我" 这种命令是有效的。
企业就绪：使用Claude API，或者AWS或GCP上托管。企业级安全、隐私和合规性是内置的。

使用Claude Code开发的示意流程图

Claude Code的下载与安装

前置条件

大模型选择与配置

需要找支持Claude Code工具的大模型，我这边使用的GLM4.7大模型

GLM模型官方文档网址：https://docs.bigmodel.cn/cn/coding-plan/tool/claude

QWEN模型官方文档网址：https://bailian.console.aliyun.com/?tab=doc#/doc/?type=model&url=2949529

用来看大模型排名(LMArena)的网址：https://lmarena.ai/zh/leaderboard/webdev

在选择大模型并申请对应的API key后就可以配置环境变量了，配置的目的是让Claude Code/Anthropic SDK 不要连接Anthropic官方，连接到你选择的大模型的Claude兼容端点，我这里用的智谱的BigModel

我这里用的是Windows系统，所以通过cmd命令打开命令提示符，执行以下命令来配置用户的环境变量

# 注意替换里面的 `your_zhipu_api_key` 为您上一步获取到的 API Key
# ANTHROPIC_AUTH_TOKEN为调用大模型的API Key
# ANTHROPIC_BASE_URL为兼容Claude的端点
# CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC为禁用Claude Code里面非必要的网络流量：如错误日志上报、统计遥测等

setx ANTHROPIC_AUTH_TOKEN your_zhipu_api_key
setx ANTHROPIC_BASE_URL https://open.bigmodel.cn/api/anthropic
setx CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 1

配置完后可以查看系统高级设置，环境变量中用户变量会新增三个变量

安装Node.js

需要安装Node.js 18或更高版本环境

Node.js的官方下载网址：https://nodejs.org/zh-cn/download

具体安装步骤可以参见我之前的随笔：在Windows环境下安装Node.js - 柯南。道尔 - 博客园

安装Git

Windows系统用户还需要安装git

Git的官方下载网址：https://git-scm.com/install/

具体安装步骤可以参见我之前的随笔：Git的安装与使用 - 柯南。道尔 - 博客园

下载并安装Claude Code

以管理员身份打开命令提示符，进入命令行界面后，执行以下命令进行安装Claude Code

# 通过npm命令把Anthropic官方的Claude Code工具安装到你系统的全局环境中
npm install -g @anthropic-ai/claude-code

安装结束后，执行以下命令来检查Claude的版本号，如果能够成功显示版本号则安装成功

claude --version

安装结束，可以在终端或IDE中执行claude命令即可使用Claude Code，启动时会让你选择界面主题(我先的默认的Dark mode)，以及是否信任Claude Code访问文件夹里面的文件，选择Yes后即可使用

Claude Code的常用命令

Claude Code有很多命令，这里只列出常用的命令，其他命令可参见官网

Claude Code命令相关介绍的网址：https://code.claude.com/docs/zh-CN/cli-reference

CLI命令

命令	描述
claude	启动交互模式-REPL(交互式编程环境，会不断重复做Read-读取，Eval-执行，Print-打印，Loop-循环)
claude "query"	使用初始提示启动REPL
claude -p "query"	通过SDK查询，然后退出
cat file \|claude -p "query"	处理管道内容
claude -c	继续最近的对话
claude update	更新到最新版本
claude mcp	配置模型上下文协议(MCP)服务器

交互模式快捷键

快捷键	描述
Ctrl+C	取消当前输入或生成
Ctrl+D	退出Claude Code会话
Ctrl+L	清除终端屏幕
Ctrl+O	切换详细输出
Ctrl+R	反向搜索命令历史
Up/Down arrows	导航命令历史
Esc+Esc	回退代码/对话
\ + Enter	多行输入

斜杠命令

命令	含义
/add-dir	添加额外的工作目录
/bashes	列出并管理后台任务
/clear	清除对话历史
/config	打开设置界面
/cost	显示token使用统计信息
/doctor	检查Claude Code安装的健康状态
/exit	退出REPL
/export [filename]	将当前对话导出到文件或剪切板
/help	获取使用帮助
/init	使用CLAUDE.md指南初始化项目
/login	切换Anthropic账户
/loginout	从Anthropic账户登出
/mcp	管理MCP服务器连接和OAuth身份验证
/review	请求代码审查
/status	打开设置界面(状态选项卡)，显示版本、模型、账户、连接性
/usage	显示计划使用限制和速率限制状态
/vim	进入vim模式以交替使用插入和命令模式

Claude Code使用示例

使用Claude Code分析一个新项目示例

从网上的开源项目中找了一个项目,通过Claude Code来快速了解项目内容

项目链接：https://gitee.com/dromara/easyAi

用IDEA打开项目并编写关键词

我想让你熟悉这个项目。
首先，请排除.idea和zf目录，然后查看项目目录结构。
接着，请阅读src/main/java下的文件。
完成后，请用中文输出一个项目概览报告

生成最终的项目概览报告

使用Claude Code从0构建项目示例-构建一个2048网页游戏的项目

1.提示词编写

请帮我创建一个基于 Spring Boot 的 2048 网页游戏项目。项目采用前后端分离架构，技术栈要求如下：

后端:
语言: Java 17+
框架: Spring Boot (Web, Lombok)
功能: 负责游戏的核心逻辑（包括初始化网格、移动算法、合并数字、生成新方块、判断胜负/输赢）。
API 设计:
POST /api/game/new: 开始新游戏
POST /api/game/move: 接收方向指令 (UP, DOWN, LEFT, RIGHT)，返回移动后的新网格状态
GET /api/game/state: 获取当前状态 (分数, 网格数据)
前端:
技术: 原生 HTML, CSS, JavaScript (无需 React/Vue)
功能: 通过 fetch API 调用后端接口，渲染 4x4 网格，处理键盘事件，显示分数。
样式: 使用 Flexbox 或 Grid 布局，模仿原版 2048 的配色方案。
项目结构:
请生成标准的 Maven 目录结构。
包名: com.example.game2048
前端静态文件 放在 src/main/resources/static 目录下。
请分步骤创建代码，并最后告诉我如何启动和运行这个项目。