Claude Code基础使用手册

Claude Code基础使用手册

不要完全依赖AI，面对一个黑箱项目时的束手无策，源于人类最原始的傲慢。

简介

Claude Code 是 Anthropic 推出的面向开发者的 AI 编程协作工具，与在聊天窗口里写几段代码不同，Claude Code 的核心目标是理解你的整个项目，并参与到真实的编码、修改和重构过程中。

Claude Code不是chat，并不局限于聊天，Claude Code时Agent，是代理人，能够帮助用户直接编辑代码以完成项目。

Claude Code CLI安装

在Windows的Powershell安装：

1
irm https://claude.ai/install.ps1 | iex

检验是否安装成功：

1
claude --version

如果出现版本号就是安装成功。

更新命令：

1
claude install

或者可以在settings.json中设置

1
2
3
4
5
6
7
8
{
  "autoUpdatesChannel": "stable"    // 更新渠道：stable（稳定版，推荐）或 beta（测试版）
}
{
  "env": {
    "DISABLE_AUTOUPDATER": "1"    // 设为 "1" 禁用自动更新，"0" 或删除该行则恢复自动更新
  }
}

删除指令：

1
2
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

安装过程中可能需要手动添加环境变量，这里不多赘述。

启动

1
claude

首次启动后claude会引导你登录，但是登录似乎需要Max或者Pro。不登录也没关系。

接入DeepSeek API

Deepseek是思考问题的大脑，Claude是大脑之下的身体而已，所以我们只需要付给Deepseek API费用就足够了。

你需要去在 DeepSeek Platform 注册账号并创建 API Key。

然后在Powershell中执行命令以设置环境变量：

1
2
3
4
5
6
7
8
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<你的 DeepSeek API Key>"
$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"

随后在任意项目地址使用claude启动：

image-20260502140258568

可以看到deepseek-v4-pro的模型，提问会消耗api，所以如果要吹水建议去网页chat。

API是按量计费的，如果使用包月的Coding Plan 就能够按月计费。

随后你可以在IDE中安装claude的插件来在IDE中使用。

至此，你已经安装并配置完成了，在Token够用的情况下，你可以自由地使用Claude Code。

项目初始化

1
/init

Claude 会自动扫描你的代码库——读取 package.json、现有文档、配置文件以及代码结构，然后生成一份专属于你项目的 CLAUDE.md 文件。

Claude 整个过程无需手动操作，Claude 会自行分析并输出初始配置。

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

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

但是不要让 CLAUDE.md 替代 linter：在文件中写代码风格规范是最常见的误区之一。永远不要用 LLM 来做 linter 的工作——linter 更快、更便宜，而且是确定性的。代码风格约束只会让上下文窗口膨胀，降低 Claude 的指令遵从质量。

你可以使用#让模型记住什么事情，比如：

1
2
# 强制使用shell以保证兼容性
# 最后项目需要经过编译测试

Claude Code目录结构

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
your-project/
├── CLAUDE.md                    ← 团队共享指令，提交到 git
├── CLAUDE.local.md              ← 个人覆盖，被 git 忽略
└── .claude/
    ├── settings.json            ← 权限 + 配置，提交到 git
    ├── settings.local.json      ← 个人权限，被 git 忽略
    ├── commands/                ← 自定义斜杠命令
    │   ├── review.md            →  /project:review
    │   ├── fix-issue.md         →  /project:fix-issue
    │   └── deploy.md            →  /project:deploy
    ├── rules/                   ← 模块化指令文件（全局生效）
    │   ├── code-style.md
    │   ├── testing.md
    │   └── api-conventions.md
    ├── skills/                  ← 自动调用的工作流
    │   ├── security-review/
    │   │   └── SKILL.md
    │   └── deploy/
    │       └── SKILL.md
    └── agents/                  ← 子代理角色定义
        ├── code-reviewer.md
        └── security-auditor.md

Claude的三种模式：

  • Ask 模式：只看不动（只读分析）
  • Plan 模式：谋定而后动（只规划，不执行）
  • Edit 模式：直接执行（可写代码）

斜杠命令

使用斜杠命令来控制Claude的行为：

img

CLAUDE.md

Claude Code每次关闭就会忘记一切，所以需要Claude来让它记住重要的东西

CLAUDE.md 是 Claude Code 中最重要的配置文件，用于向 Claude 传递项目级别的持久指令。每次启动 Claude Code 会话时，它都会自动读取并加载这个文件中的内容，作为系统级上下文融入每一次对话中。