Claude Code 从入门到实操

Claude（克劳德）Code 是由 Anthropic 公司开发的一款 AI 编程工具 / CLI 命令行工具，ClaudeCode 与其它 IDE 不同的是、它是一个跑在终端上的 AI 编程工具、通过 CMD 黑窗口与之对话。Anthropic 是一家位于美国加州旧金山的人工智能股份有限公司，成立于 2021 年。该公司是一家人工智能安全和研究公司，致力于构建可靠、可解释和可操纵的 AI 系统

GAO.C-H

1657人浏览 · 2025-12-09 16:01:16

GAO.C-H · 2025-12-09 16:01:16 发布

什么是 ClaudeCode？

Claude（克劳德）Code 是由 Anthropic 公司开发的一款 AI 编程工具 / CLI 命令行工具，ClaudeCode 与其它 IDE 不同的是、它是一个跑在终端上的 AI 编程工具、通过 CMD 黑窗口与之对话。
Anthropic 是一家位于美国加州旧金山的人工智能股份有限公司，成立于 2021 年。该公司是一家人工智能安全和研究公司，致力于构建可靠、可解释和可操纵的 AI 系统。Anthropic 公司开发了聊天机器人 Claude，提出的“宪法 AI 原则”。 2025 年 2 月 25 日，Anthropic 宣布推出 Claude 3.7 Sonnet，称这是其迄今为止最智能的模型，也是市场上首款混合推理模型。北京时间 2025 年 5 月 23 日，Anthropic 正式推出 Claude 4 系列大模型。 2025 年 4 月，入选《2025 福布斯 AI 50 榜单》。
1. Claude Code 是不支持离线使用的，因为 Claude Code 需要连接到 Anthropic API。
2. Claude Code 将记忆存储在.claude文件夹当中，如果没有特殊要求，请不要删除此目录。

与传统的代码编辑器插件不同，Claude Code 在终端中运行，具有以下特点：

智能代码理解：深度理解您的项目结构和代码逻辑
自然语言交互：用普通话描述需求，AI 自动执行编程任务
全项目上下文：理解整个代码库的架构和依赖关系
安全可靠：直接连接 Anthropic API，所有操作在本地执行
Git 集成：智能的版本控制操作和历史分析

除此之外，Claude Code 还有以下优势：

原生 Claude 模型，没有 Cursor 暗加的种种故意为了耗费提问次数的提示词，能按照需求制定完善的执行计划
可按 token 计费，而不是提问次数。这样无论问题大小尽管提问，按需付费。
可接入其他模型，这是很重要的一点，因为只要是符合 Anthropic 框架的 LLM 都可以接入 Claude Code 平台
安装简单，调用国内最新模型价格低廉。后续会详细说明安装流程
项目分析，比如快速熟悉新项目、生成项目说明文档

项目性能分析

如果使用 Anthropic 的 Claude 服务的话，其实有很多困难的地方，虽然 Claude 的代码能力在全世界是毋庸置疑的遥遥领先，但是其并没有开放对中国大陆地区的服务，当检测到异常 IP 的话会给中国用户进行迅速封号（会把充值的钱原路返回），因此如果需要使用其服务要么就是自己搭建一套稳定的海外中转站，要么从一些国内开发者搭建的镜像平台购买服务。外加上 Claude 服务的价格也不是很低，也要至少$20 一个月。所以如果不是为了极致的性能和开发质量，我们可以接入 Kimi K2 实现一个向下兼容的替代。
Claude Code 的最新版本终于支持 Windows 系统了，不用再用 WSL 去进行繁琐的配置了！
- WSL（Windows Subsystem for Linux）是微软开发的 Windows 子系统，允许用户在 Windows 10/11 上原生运行 Linux 二进制文件，无需虚拟机或双系统启动。

ClaudeCode 的安装和配置

安装 ClaudeCode 之前的前置工作：ClaudeCode 必须依赖于 Node 和 Git 才可以运行，但首先要先科学上网。

- 记得所有软件的安装、要安装在没有中文的目录下。
- node --version：检查 node 版本（版本需求 18+）
- npm --version：检查 npm 版本
- git --version：检查 git 版本

1. Node.js 的安装

Node.js 是一个开源和跨平台的 JavaScript 的运行时环境。

验证 Node 是否安装成功（Ctrl+C => 按两次会退出）：

核对 Node.js 的版本：node -v

在安装 Node.js 的时候、它会自动把 npm 包管理工具给装上、类似于 Java 中的 Maven、能够安装依赖和下载插件。

2. Git 的安装

验证 Git 是否安装成功：git --version

配置 Git 的环境变量：
- 变量名：CLAUDE_CODE_GIT_BASH_PATH
- 变量值：D:\MySoft\Git\git-bash.exe（git路径）

setx SHELL "D:\MySoft\Git\git-bash.exe" setx SHELL "D:\MySoft\Git\cmd\git.exe"

3. Claude Code 的安装

Claude Code 的 npm 安装（通过 npm 包管理器来安装 ClaudeCode）：

-g 代表的是全局安装

npm install -g @anthropic-ai/claude-code npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

安装完成之后，验证 ClaueCode 是否安装成功：claude --version

安装后，运行 Claude Code，命令行输入claude，使用 claude 命令启动交互式会话、然后回车：

claude

如果显示连接 Anthropic 失败（Claude Code 客户端无法连接到 Anthropic 的服务端接口 - api.anthropic.com），则需要设置环境变量（ClaudeCode 如果识别到国内网络环境则会禁止登录）：

如何设置环境变量，开启翻墙的代理服务之后、还要设置代理、绕过它的网络环境：

set http_proxy=http://127.0.0.1:Port（这里的端口号替换为你科学上网的工具、所使用的端口号）
set https_proxy=http://127.0.0.1:Port（这里的端口号替换为你科学上网的工具、所使用的端口号）

Choose the text style…是主题选择列表，按方向键进行选择、然后回车即可：
- Dark mode：深色主题（已打勾的项为当前选择）
- Light mode：浅色主题
- Dark mode （colorblind-friendly）：适合色弱/色盲的深色主题
- Light mode （colorblind-friendly）：适合色弱/色盲的浅色主题
- Dark mode （ANSI colors only）：只使用 ANSI 基础色的深色主题，兼容性更强，适用于颜色支持有限的终端
- Light mode （ANSI colors only）：同上，浅色版本

Claude 的登录方式选择界面，意思是：Claude Code 支持两种账号计费模式，你需要选其一完成登录后才能正常使用，两种模式（订阅账户 & Console API Key）的区别与使用场景、但这两个都取决于你需要有一个 ClaudeCode 的账号：

Claude account with subscription（订阅账户）
1. 适用于已在官网开通 Pro、Max、Team、Enterprise 等订阅的个人/团队账号。
2. 登录后按订阅配额使用，无需 API Key。
3. 通常会弹出浏览器进行账户登录或组织选择，成功后返回终端。
Anthropic Console account（控制台账户，API 用量计费）
1. 适用于在 Anthropic Console 中创建项目并开通计费的开发者/企业。
2. 需要你在 Console 里生成 API Key，然后在终端粘贴或配置该密钥。
3. 按调用量计费，更适合程序化/集成开发。

选择建议

如果你已有 Claude Pro/Max 等订阅，用第 1 项更直接。
如果你是开发者，已有 Console 项目和可用的 API Key，用第 2 项。

后续流程（概览）

选 1：终端会打开浏览器，完成账户登录/授权后返回终端显示登录成功。
选 2：终端会引导你输入 API Key（来自 Console）。校验通过后即可开始使用。

选择第二种、配置 API Key（配置 API Key 有两种模式）：

配置两个系统环境变量，分别是配置秘钥（也就是 API KEY）以及配置 API 地址：
1. 变量名：ANTHROPIC_AUTH_TOKEN/ANTHROPIC_API_KEY 变量值：sk-xxxxxxx
2. 变量名：ANTHROPIC_BASE_URL 变量值：https://xxx
https://user.claudecode.uk/，在命令行终端运行以下命令设置环境变量，在命令提示符（CMD）中依次执行以下命令：：
1. setx ANTHROPIC_BASE_URL "https://xxx"
2. setx ANTHROPIC_AUTH_TOKEN "卡密"

Mac 系统

在终端中依次执行以下命令：

echo 'export ANTHROPIC_BASE_URL="https://xx"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="卡密"' >> ~/.zshrc
source ~/.zshrc

开始使用

新开一个命令行，cd 到项目目录执行 claude 就可以用了：claude。

ClaudeCode 的具体使用

Claude 完全是通过终端来进行交互的，其中内置了多种工具，比如文件操作、搜索等，它可以理解自然语言并转化为相应的命令执行。

[该类型的内容暂不支持下载]

更新 Claude Code CLI 工具本身：

Bash

npm update -g @anthropic/claude-code

或者如果使用 npx：

Bash

npx @anthropic/claude-code@latest

检查当前版本：

Bash

claude --version

配置文件：检查你的 Claude Code 配置文件（通常在～/。config/claude-code/ 或项目的。claude/

目录），看是否有模型选择相关的设置。

ClaudeCode 在执行任务的过程当中，你可以随时给它发新的消息，它会判断你给它发的这个新的消息是不是想去中断或者说取消当前任务的执行，当然如果你真的想中断当前任务的执行，我觉得直接按ESC键即可中断，这个也是 ClaudeCode 独有的功能，比如当你在用 ChatGpt 的时候、当 ChatGpt 在处理你给它的任务的时候、你是不能够去给它发送新的消息的。
使用think、think hard、think harder、ultrathink（做最深入最努力的思考）这样的关键字来触发 ClaudeCode 不同级别或者不同深入程度的思考。

已经启动会话后、就可以在对话框用/xxx输入命令：

/exit：退出当前会话
/add-dir <你的工作目录>：添加命令传入工作目录
/init：完成项目分析的初始化，该命令会去扫描当前项目的代码库，在项目根目录生成一个CLAUDE.md文件，作为该项目的知识指南。
/help：查看命令列表
/clear：清除当前会话的对话历史
/compact：压缩对话内容
/status：会话状态检查
/review：请求代码审查
/resume：继续上一次的会话
/rewind：回退对话和/或代码
Claude Code 支持深入思考：您需要通过自然语言要求其进行深入思考，推荐您在使用复杂问题的时候使用这一功能，这也会消耗大量的额度点数。
使用 /init 生成 CLAUDE.md 项目指南，Claude Code 通过 Claude.md 存储重要记忆。
- CLAUDE.md文件：比如你可以定义跟所有代码相关的风格
使用/cost命令显示令牌使用统计。
切换到最新的 4.5 模型：export ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"