Claude Code 笔记- 基本信息

一、Claude Code概述

Claude Code 是一个代理编码工具，可以读取你的代码库、编辑文件、运行命令，并与你的开发工具集成。可在终端、IDE、桌面应用和浏览器中使用。

Claude Code 是一个由 AI 驱动的编码助手，可帮助你构建功能、修复错误和自动化开发任务。它理解你的整个代码库，可以跨多个文件和工具工作以完成任务。

二、Claude Code 如何工作

当您给 Claude 一个任务时，它会经历三个阶段：收集上下文 、采取行动 和验证结果。这些阶段相互融合。Claude 始终使用工具，无论是搜索文件以了解您的代码、编辑以进行更改，还是运行测试以检查其工作

循环会根据您的要求进行调整。关于您代码库的问题可能只需要收集上下文。错误修复会循环通过所有三个阶段多次

代理循环由两个组件驱动：模型进行推理和工具采取行动

模型：Claude Code 使用 Claude 模型来理解您的代码并推理任务。Claude 可以读取任何语言的代码、理解组件如何连接，以及找出需要改变什么来实现您的目标。对于复杂的任务，它将工作分解为步骤、执行它们，并根据学到的内容进行调整。多个模型可用，具有不同的权衡。Sonnet 可以很好地处理大多数编码任务。Opus 为复杂的架构决策提供更强的推理能力。在会话期间使用 /model 切换或使用 claude --model <name> 启动

工具：工具是使 Claude Code 成为代理的原因。没有工具，Claude 只能用文本回应。有了工具，Claude 可以采取行动：读取您的代码、编辑文件、运行命令、搜索网络并与外部服务交互。每个工具使用都会返回信息，反馈到循环中，告知 Claude 的下一个决定。可以使用 skills 扩展 Claude 知道的内容、使用 MCP 连接到外部服务、使用 hooks 自动化工作流，以及将任务卸载给 subagents。这些扩展形成了核心代理循环之上的一层

三、Claude Code安装

1.安装node.js

需要先安装node.js 安装后请先验证版本确保安装成功

复制代码

Microsoft Windows [版本 10.0.18363.592]
(c) 2019 Microsoft Corporation。保留所有权利。
C:\Users\User>node --version
v22.14.0

2.安装Claude

复制代码

C:\Users\User>npm config set registry https://registry.npmmirror.com
C:\Users\User>npm install -g @anthropic-ai/claude-code
changed 2 packages in 2s
1 packa

安装完成后在C:\Users\User\.claude会创建claude相关目录

3.验证安装成功

进入项目所在目录后输入Claude开始使用如果出现下面的截图表示安装成功

四、Claude Code使用

1.替换国内AI模型

第一次使用时会发现上面的报错，报错原因是Claude不对中国开放，支持的国家可以从官网查看https://www.anthropic.com/supported-countries，不幸的是列表里没有中国

可以使用国内AI大模型替换，进入C:\Users\User\.claude打开settings.json文件,修改环境变量使用国内AI大模型，比如doubao-seed

复制代码

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/coding",
    "ANTHROPIC_AUTH_TOKEN": "你的账号token",
    "API_TIMEOUT_MS": "3000000",
    "ANTHROPIC_MODEL": "doubao-seed-2-0-code-preview-260215",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "doubao-seed-2-0-code-preview-260215",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "doubao-seed-2-0-code-preview-260215",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "doubao-seed-2-0-code-preview-260215",
    "ANTHROPIC_REASONING_MODEL": "doubao-seed-2-0-code-preview-260215",
    "CLAUDE_NO_AUTO_UPDATE": "1"
  },
  "theme": "dark",
  "includeCoAuthoredBy": false
}

切换成功后在项目目录输入claude可以正常使用

如果有多个账号可以使用CC-Switch协助管理token （CC-Switch 快速配置工具 | CodeKey）。

CC-Switch 是一款跨平台桌面应用，通过直观的图形界面统一管理 Claude Code、Codex 和 Gemini CLI 的配置切换、MCP 服务器管理、系统提示词和 Claude Skills,核心功能包括

一键切换 AI 工具供应商
API 端点速度测试（附质量指标）
多预设系统提示词管理
MCP 服务器统一架构管理
Claude Skills 发现与安装系统
配置备份/恢复（保留最近 10 个版本）
深度链接协议支持（ccswitch://）
环境变量冲突检测

2.初始化项目

第一次在项目中使用claude时需要使用 /init 命令来初始化项目，执行后会在项目根目录创建一个CLAUDE.md的文件，CLAUDE.md 是一个放在项目根目录的 Markdown 文件，CLAUDE.md 会成为 Claude 系统提示的一部分，在每次会话开始时都会自动读取。

因此claude 在项目中启动时会最先加载这个文件，因此也可以在CLAUDE.md中制定的项目处理规则和行为准则