Claude Code 使用笔记（一）- 配置和基础

Claude 理解

Claude 交互流程

• 编程助手（Claude）：基于语言模型 → 具备记忆和工具能力
• 交互流程：收集上下文 → 制定计划 → 完成任务

Claude 能做什么

这是一个很好的方向，可以用在目前任何编程助手的项目开发中

1. 发现：

• 探索代码库和历史
• 搜索文档
• 项目入门

2. 设计

• 规划项目流程
• 定义开发规范
• 定义技术架构

3. 构建

• 代码实现
• 编写和执行测试
• 提交代码

4. 部署

• 自动化 CI/CD
• 环境配置
• 管理部署流程

5. 扩展支持

• 错误调试
• 大规模项目重构
• 监控使用和性能

Claude 是如何使用工具的

1. 用户发出指令
2. 编程助手组织用户指令，提取信息，将关联的工具调用方案和提示词合并后给到 LLM
3. LLM 得到指令，根据编程助手需求拼接指令给到编程助手，编程助手根据指令执行工具，并响应结果内容给到 LLM
4. LLM 读取结果，根据用户输入给出结果

Claude 内置工具

即 Claude 自身在执行任务时调用的工具

● Read(app\app.vue)
  ⎿  Read 67 lines

# 上面代码的第一个 Read 就是 Claude 内置工具之一，Claude 可以清晰看到工具调用流程

工具列表翻译，可以知道 Claude 能做什么事情：

工具名称	用途
Bash	运行 shell 命令
Edit	编辑文件
Glob	根据模式查找文件
Grep	在文件内容中搜索模式
LS	列出文件和目录
MultiEdit	同时进行多处编辑
NotebookEdit	修改 Jupyter notebook 单元格
NotebookRead	读取并显示 Jupyter notebook 单元格
Read	读取文件
Task	运行子代理来处理复杂的多步骤任务
TodoWrite	创建和管理结构化任务列表
WebFetch	从 URL 获取内容
WebSearch	搜索网络
Write	创建或覆盖文件

安全性 - 代理搜索

Claude 通过内置工具提取数据，只发送文件所需的代码片段和数据到外部的 LLM 服务

不需要提供完整的代码库上下文信息，保证代码安全性

如何理解"代理"：表示 Claude 编程助手代替外部服务提取信息

环境配置

安装

参考：https://code.claude.com/docs/zh-CN/quickstart

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

使用问题

目前 Claude Code 因为锁区，使用会有相关限制：

• 注册账户：需要有国外的手机号来完成，尽量不要使用国内邮箱
• 套餐购买：需要国际信用卡

解决方案

目前的方案：

• 购买成品账户，最简单的方案，但是自己感觉不太安全，有需要可以自己查找
• 接码平台解决登录问题，国际信用卡解决套餐问题，但是实际使用会不会锁区，不太清楚，如果不锁可以用 Claude Code 的完整能力
• 通过环境变量配置，使用第三方 API，Claude 有对接例如 Amazon Bedrock、Microsoft Foundry、Vertex AI 来解决，如果是 OpenAI 兼容协议规范，可以通过配置环境变量欺骗 Claude Code 来解决

OpenAI 规范接入方案

在电脑里添加环境变量，一般对应的平台也会提供环境变量配置方法

添加以下环境变量：

• ANTHROPIC_API_KEY：平台申请的 API Key
• ANTHROPIC_BASE_URL：平台的 Base API
• ANTHROPIC_MODEL：你要使用的平台模型名称

这里以硅基流动为例，使用的是 Qwen3 模型（GLM 和 Qwen-Coder 都不错）

硅基流动会提供免费模型额度调用，不过最近发现免费额度和充值额度分开了，会限制免费额度的使用模型，而且对免费额度的每分钟用量（TPM） 限制有点低。

具体可以查看规则：Rate Limits - SiliconFlow

如果有其他好的平台渠道也可以使用其他平台

认证问题解决

此时执行 claude 运行项目，可能会出现以下错误信息：

 Unable to connect to Anthropic services

 Failed to connect to api.anthropic.com:
 ERR_BAD_REQUEST

 Please check your internet connection and
 network settings.

 Note: Claude Code might not be available in
 your country. Check supported countries at
 https://anthropic.com/supported-countries

这是因为 Claude 添加了登录拦截认证

在电脑里找到 .claude.json 配置文件，通常在 <用户名>/.claude.json 位置

在 JSON 文件中添加字段绕过认证，让 Claude 使用环境配置的 API 服务

"hasCompletedOnboarding": true, 跳过登录阶段

之后运行 claude 通过启动页面的模型配置来验证是否切换成功

基础

基础操作

• 启动 ：claude 启动终端，最好通过 Powershell 启动，Bash 终端有 Bug
• 更新 ：claude install 执行 Claude 终端更新
• 文件搜索 ：@ 开头实现文件搜索，和 Copilot 的 # 有些区别
• 命令调用 ：/ 开头执行命令，选择的过程中用 Tab 补全，触发 Enter 会直接执行
• 图片粘贴 ：截图后在 CLI 中执行 Alt + V 粘贴即可（Mac/Linux 是 Ctrl + V），会显示为 [Image #n] 的格式
• 计划模式 ：Shift + Tab 启动，计划完成后再执行，适合大型项目修改的场景
• 换行 ：反斜杠 \ + 回车

记忆

基于 CLAUDE.md 文件可以实现记忆功能

• 可以定义风格指南和通用指令
• 文件内容会自动加载到 Claude 上下文（类似于 Cursor 的全局规则）

快速创建

执行 /init 指令完成，Claude 会自动分析代码仓库去生成 CLAUDE.md

最佳实践

• CLAUDE.md 作为团队指南提交到仓库
• CLAUDE.local.md 作为本地指南使用
• 如果要共享所有本地项目使用，可以放到 <用户名>/.claude/CLAUDE.md 中

历史会话信息

Claude 会把会话的对话数据存储在本地

持续会话

在当前会话中，Claude 可以延续之前的对话内容

如果不小心关闭了会话，通过 claude --resume 恢复

重启会话

通过 claude 重启新对话不会保持之前的上下文

也可以通过执行 /clear 清空上下文

如果需要保留之前的内容记忆又想清空上下文，可以执行 /compact，Claude 会自动整理内容

输入内容记忆

在任何对话开头加上 # 修饰符来保存当前输入的内容，这个主要是用于存储一些规范等，例如：

# 在任何计划之前不要修改代码

Claude 会询问你要记忆内容的地方，之后将输入内容添加到对应的记忆文件里

注意：

• 记忆的内容是你输入的内容，不是执行对话输出结果，Claude 不会做任何事情
• 如果没有这个功能，可以尝试 claude install 更新一下 Claude 版本

编辑器交互

Claude 支持执行 /ide 关联当前的编辑器，会自动定位你当前所在的文件上下文，有利于 Claude 理解你要修改的内容

需要在编辑器里安装官方插件，比如 VSCode 就是安装 Claude Code 插件

这个功能似乎需要官方账户来实现联动，目前还没有测试过

MCP Server 使用

在命令行：

claude mcp add <自定义插件名称> <执行的 MCP Server 启动命令>

不同插件有不同的添加方式，可以到 MCP 插件下方查看添加方法

查看 MCP 使用情况：

执行 /mcp 可以看到 MCP Server 的启用情况

这里就是启用失败 failed，如果启用成功会显示 connected。

按回车可以查看 MCP 插件的相关信息，例如：

• MCP 是否连接
• 启动命令
• 启动参数
• 配置信息
• 功能类型，例如 tool
• 提供的工具选项，View Tools 可以进一步查看工具能力

启动失败，进入信息页执行 Reconnect 重试：

启动成功就会打勾：

View Tools 查看详细的工具能力：

使用 MCP Server

显式指定要使用的 MCP Server

例如基于 Playwright MCP，打通 Claude 和浏览器之间的调试通信，不再手动截图传递信息

使用 Playwright MCP 帮我优化页面中 xxx 功能的显示效果

参考内容

• 解决：Claude Code 无法连接到 Anthropic 服务 - CSDN博客
• Claude Code 官方文档
• Claude Code: A Highly Agentic Coding Assistant - DeepLearning.AI