Claude code 安装使用教程

1.git下载安装

Git - Install for Windows (官网比较慢)

镜像下载:速度很快

CNPM Binaries Mirror

傻瓜式安装,直接点击下一步,下载安装Git是为了给Claude code提供执行的终端环境,并且可以很好的管理代码版本

windows+r 输出cmd,打开命令行窗口,说明已经安装好了

2.Node.js下载安装

https://nodejs.org/zh-cn/download

NPM 是 Node.js 自带的包管理工具,因此,通常你只需安装 Node.js,NPM 就会自动安装在系统中。NPM 允许开发者轻松地下载、安装、共享、管理项目的依赖库和工具。ClaudeCode就是npm里面的一个包。

3.安装claude code

设置阿里云镜像加速

npm config set registry https://registry.npmmirror.com

使用npm安装Claude Code

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

#执行启动claude

报错是因为国内无法使用,我们改配置,用户下面的.claude.json添加配置 "hasCompletedOnboarding": true,

再重新运行就好了

4.接入国内模型

但是现在不能问问题,因为我们不能直接使用Claude code自带模型,所以我们接入国内模型

阿里云百炼平台:https://bailian.console.aliyun.com/cn-beijing/?spm=a2c4g.11186623.0.0.16fe6fd16cGJ3x&tab=model#/model-market

支付宝扫码登录。新用户首次开通后。有100w的免费token使用额度。限时3个月。用于掌握学习这个工具应该是足够的。先把免费额度用完即停开启,以免超出额度,扣费。

选择秘钥管理。秘钥管理需要登录后才会展示。创建一个APIkey

创建好了,复制粘贴出来。这样我们的key就已经有了。

打开命令行窗口,设置环境变量参数

复制代码
## YOUR_DASHSCOPE_API_KEY 需要替换成你自己的key
setx ANTHROPIC_API_KEY "YOUR_DASHSCOPE_API_KEY"
setx ANTHROPIC_BASE_URL "https://dashscope.aliyuncs.com/apps/anthropic"
setx ANTHROPIC_MODEL "qwen3.5-plus"

新开一个窗口,查看参数是否设置成功

复制代码
echo %ANTHROPIC_API_KEY%
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_MODEL%

启动Claude发现可以进行对话了。

5.ClaudeCode快速入门

Claude Code 的输入框不是纯聊天框,而是一个:

AI + 编辑器 + 命令调度器的融合终端

操作命令

/ 是 Claude Code 中触发内置命令 **/**工具的核心符号,类似终端命令行的指令前缀,用于告诉 Claude 执行特定操作而非单纯生成文本。

**核心用途:**调用内置功能(如代码生成、文件操作、环境执行、插件调用等)。

/ 后紧跟命令关键词,空格后接参数(如文件名、执行命令、修复目标等),是 Claude Code 区分自然语言对话代码操作指令的关键。

输入 / 会弹出命令列表:

|--------------|------------------------------------------------------------------|
| 命令 | 介绍 |
| /help | 显示所有可用的斜杠命令、快捷键以及帮助文档的入口 |
| /init | 在项目根目录初始化生成一个 CLAUDE.md 文件。这个文件是 AI 的"长期记忆",你可以在这里记录项目规范、常用命令等 |
| /clear | 清空当前会话的对话历史,重置上下文。当你切换任务或感觉 AI 开始"忘记"早期指令时使用 |
| /compact | 智能压缩当前对话历史,用一个精炼的摘要代替冗长的对话,可释放 50%-80% 的 Token 空间,同时保留关键信息 |
| /cost | 实时显示当前会话消耗的 Token 数量和预估费用,帮助你控制预算 |
| /context | 查看当前上下文窗口的详细状态,包括已加载的文件和 Token 占用比例 |
| /model | 在当前会话中动态切换 AI 模型,而无需重启 Claude |
| /doctor | 运行系统诊断,检查 Node.js 版本、API 连接、文件权限等,是遇到问题时的首选命令 |
| /config | 打开交互式配置菜单,可以修改主题、权限、默认模型等全局设置 |

上下文注入

@ 后面跟文件名,会主动联想

复制代码
## 引用单文件
@main.py 帮我检查 bug

## 引用多文件
@main.py @main2.py 这两个是否有重复逻辑?

## 引用错误日志:
@npm-debug.log 找出失败原因

Bash 命令

复制代码
#显示当前工作目录
! pwd  

#创建新目录
mkdir dirname


# 列举目录文件
! ls -la

ClaudeCode功能演示

需求:写一个代码,从1加到100。

复制代码
public class Sum1To100 {
    public static void main(String[] args) {
        int sum = 0;
        for (int i = 1; i <= 100; i++) {
            sum += i;
        }
        System.out.println("1 加到 100 的和为:" + sum);
    }
}

ClaudeCode 交互模式

普通模式:【? for shortcuts】

Claude Code 的默认安全模式

使用场景

当你处于以下状态时,应优先使用 Ask 模式:

  • 看不懂现有代码
  • 刚接手一个新项目
  • 想定位 Bug 的原因,但还没想好怎么修
  • 想确认某段逻辑是否合理
模式特点
  • Claude 可以读取代码
  • 可以进行分析、解释、推理
  • 不会修改任何文件
  • 不会执行任何 Shell 命令

一位经验丰富、但双手放在背后的高级工程师。

规划模式:【Plan】

Plan 模式是 Claude Code 中最像架构师思维的模式。

使用场景

当你面对的是复杂或影响范围较大的改动时,应该使用 Plan 模式,例如:

  • 新增一个核心模块
  • 重构已有接口或业务流程
  • 引入新技术(缓存、中间件、鉴权方案等)
  • 涉及多个文件、多个层级的修改
模式特点
  • Claude 不会直接改代码
  • 会先给出完整的实施方案
  • 通常以步骤列表(TODO List)的形式呈现
  • 你确认方案后,才进入 Edit 阶段执行

把先写代码变成先达成共识。

直接执行:【Edit】

Edit 模式是 Claude Code 真正动手的阶段。

使用场景

当你已经明确知道:

  • 要改哪
  • 改成什么
  • 改动风险可控

此时就可以直接进入 Edit 模式。

模式特点
  • Claude 会定位相关文件
  • 生成精确的 Diff(差异修改)
  • 可能会请求执行测试、构建等命令
  • 所有写入操作都需要你确认

按下 Shift**+** tab****切换。三种模式

ClaudeCode记忆系统

每次 Claude Code 会话结束,上下文就会清空。这个时候就需要我们的Claude.md文件了。

什么是CLAUDE.md 文件

CLAUDE.md 是一个放在项目根目录的 Markdown 文件,Claude Code 在每次会话开始时都会自动读取。

CLAUDE.md 会成为 Claude 系统提示的一部分,使每次对话都能预先加载项目上下文,不再需要重复解释基本信息。

一份好的 CLAUDE.md 应该覆盖三个维度:

  • WHAT(是什么):技术栈、项目结构,为 Claude 提供代码库的全局地图
  • WHY(为什么):项目的目的,各模块的功能与定位
  • HOW(怎么做):开发方式,例如使用 bun 而非 node,以及 Claude 如何验证改动是否正确 Humanlayer

变量命令:驼峰原则。下划线

buferSoft

bufer_soft

以下是一份典型的 CLAUDE.md 结构示例:

复制代码
# 项目名称

## 项目概述
简述这个项目的目的和功能。

## 技术栈
- Frontend: React + TypeScript
- Backend: Node.js + Express
- Database: PostgreSQL

## 目录结构
- `src/components/` - React 组件
- `src/api/`        - API 层
- `tests/`          - 测试文件

## 常用命令
- 启动开发服务器:`pnpm dev`
- 运行测试:`pnpm test`
- 代码检查:`pnpm lint`

## 开发规范
- 使用 TypeScript strict 模式
- 优先使用 interface 而非 type
- 禁止使用 any,使用 unknown 替代
```

### 文件位置与层级

项目的核心文件结构如下: 
```
your-project/
├── CLAUDE.md                  # 项目主记忆文件(团队共享)
├── .claude/
│   ├── settings.json          # Hooks、权限、环境配置
│   ├── settings.local.json    # 个人配置(建议加入 .gitignore)
│   └── commands/              # 自定义斜杠命令
│       └── my-command.md
└── .mcp.json                  # MCP 服务配置
```

Claude.md文件创建方式

  • 手工创建:如果是空的项目,就可以手工创建
  • /init 命令自动创建:这个需要项目里面已经有代码

ClaudeCode会话管理

复制代码
#压缩上下文,如果对话超长的话
/compact 

#清空对话
/clear

# 按esc 可以暂停会话

# 继续最近的一次对话(快速恢复)
claude --continue
# 或使用简写
claude -c


# 显示历史对话列表并选择恢复。从当前文件的目录下恢复
claude --resume
# 或使用简写
claude -r

参照:

ClaudeCode学习笔记
手把手教学ClaudeCode安装教程_哔哩哔哩_bilibili

相关推荐
oscar9997 小时前
Claude Code与OpenCode的全方位对比
claude code·opencode
神码小Z10 小时前
让AI自己打开网页、点按钮、截图并识别内容——Claude Code这个插件我天天在用
claude code
何中应10 小时前
Claude Code报错
ai·ai编程·claude code
Sestid12 小时前
前端开发Claude Code使用指南
状态模式·ai编程·claude code
Rubin智造社13 小时前
04月20日AI每日参考:华为AI眼镜今日发布,Meta裁员8000人押注AI文件格式
人工智能·claude code·ai硬件·华为ai眼镜·meta裁员·cerebras ipo·字节跳动seedance
codeRichLife14 小时前
Claude Code常用命令
ai编程·claude code
江湖人称小鱼哥1 天前
Obsidian-Graphify-让你的笔记库自己长出知识图谱
笔记·知识图谱·obsidian·claude code·graphify·卡帕西
92year1 天前
AI编程一个月烧了多少钱?用CodeBurn一条命令算清楚
ai编程·开发工具·cursor·claude code·token优化
Hoper.J2 天前
聊聊 Claude Code v2.1.111:Opus 4.7,Auto 模式开放,新的思考等级 xhigh,以及“限免3次”的 ultrareview
claude·claude code·opus 4.7