Claude Code 學(xué)習(xí)筆記（一）- 配置和基礎(chǔ)使用

Claude 理解

Claude 交互流程

  • 編程助手（Claude）：基于語言模型 → 具備記憶和工具能力
  • 交互流程：收集上下文 → 制定計(jì)劃 → 完成任務(wù)

Claude 能做什么

這是一個(gè)很好的方向，可以用在目前任何編程助手的項(xiàng)目開發(fā)中

  1. 發(fā)現(xiàn)：
  • 探索代碼庫和歷史
  • 搜索文檔
  • 項(xiàng)目入門
  1. 設(shè)計(jì)
  • 規(guī)劃項(xiàng)目流程
  • 定義開發(fā)規(guī)范
  • 定義技術(shù)架構(gòu)
  1. 構(gòu)建
  • 代碼實(shí)現(xiàn)
  • 編寫和執(zhí)行測(cè)試
  • 提交代碼
  1. 部署
  • 自動(dòng)化 CI/CD
  • 環(huán)境配置
  • 管理部署流程

5. 擴(kuò)展支持

  • 錯(cuò)誤調(diào)試
  • 大規(guī)模項(xiàng)目重構(gòu)
  • 監(jiān)控使用和性能

Claude 是如何使用工具的

  1. 用戶發(fā)出指令
  2. 編程助手組織用戶指令，提取信息，將關(guān)聯(lián)的工具調(diào)用方案和提示詞合并后給到 LLM
  3. LLM 得到指令，根據(jù)編程助手需求拼接指令給到編程助手，編程助手根據(jù)指令執(zhí)行工具，并響應(yīng)結(jié)果內(nèi)容給到 LLM
  4. LLM 讀取結(jié)果，根據(jù)用戶輸入給出結(jié)果

Claude 內(nèi)置工具

即 Claude 自身在執(zhí)行任務(wù)時(shí)調(diào)用的工具

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

# 上面代碼的第一個(gè) Read 就是 Claude 內(nèi)置工具之一，Claude 可以清晰看到工具調(diào)用流程

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

工具名稱 用途
Bash 運(yùn)行 shell 命令
Edit 編輯文件
Glob 根據(jù)模式查找文件
Grep 在文件內(nèi)容中搜索模式
LS 列出文件和目錄
MultiEdit 同時(shí)進(jìn)行多處編輯
NotebookEdit 修改 Jupyter notebook 單元格
NotebookRead 讀取并顯示 Jupyter notebook 單元格
Read 讀取文件
Task 運(yùn)行子代理來處理復(fù)雜的多步驟任務(wù)
TodoWrite 創(chuàng)建和管理結(jié)構(gòu)化任務(wù)列表
WebFetch 從 URL 獲取內(nèi)容
WebSearch 搜索網(wǎng)絡(luò)
Write 創(chuàng)建或覆蓋文件

安全性 - 代理搜索

Claude 通過內(nèi)置工具提取數(shù)據(jù)，只發(fā)送文件所需的代碼片段和數(shù)據(jù)到外部的 LLM 服務(wù)
不需要提供完整的代碼庫上下文信息，保證代碼安全性

如何理解"代理"：表示 Claude 編程助手代替外部服務(wù)提取信息

環(huán)境配置

安裝

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

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

使用問題

目前 Claude Code 因?yàn)殒i區(qū)，使用會(huì)有相關(guān)限制：

  • 注冊(cè)賬戶：需要有國(guó)外的手機(jī)號(hào)來完成，盡量不要使用國(guó)內(nèi)郵箱
  • 套餐購買：需要國(guó)際信用卡

解決方案

目前的方案：

  • 購買成品賬戶，最簡(jiǎn)單的方案，但是自己感覺不太安全，有需要可以自己查找
  • 接碼平臺(tái)解決登錄問題，國(guó)際信用卡解決套餐問題，但是實(shí)際使用會(huì)不會(huì)鎖區(qū)，不太清楚，如果不鎖可以用 Claude Code 的完整能力
  • 通過環(huán)境變量配置，使用第三方 API，Claude 有對(duì)接例如 Amazon Bedrock、Microsoft Foundry、Vertex AI 來解決，如果是 OpenAI 兼容協(xié)議規(guī)范，可以通過配置環(huán)境變量欺騙 Claude Code 來解決

OpenAI 規(guī)范接入方案

在電腦里添加環(huán)境變量，一般對(duì)應(yīng)的平臺(tái)也會(huì)提供環(huán)境變量配置方法

添加以下環(huán)境變量：

  • ANTHROPIC_API_KEY：平臺(tái)申請(qǐng)的 API Key
  • ANTHROPIC_BASE_URL：平臺(tái)的 Base API
  • ANTHROPIC_MODEL：你要使用的平臺(tái)模型名稱
Windows 系統(tǒng)環(huán)境配置

這里以硅基流動(dòng)為例，使用的是 Qwen3 模型（GLM 和 Qwen-Coder 都不錯(cuò)）

硅基流動(dòng)會(huì)提供免費(fèi)模型額度調(diào)用，不過最近發(fā)現(xiàn)免費(fèi)額度和充值額度分開了，會(huì)限制免費(fèi)額度的使用模型，而且對(duì)免費(fèi)額度的每分鐘用量（TPM） 限制有點(diǎn)低。
具體可以查看規(guī)則：Rate Limits - SiliconFlow
如果有其他好的平臺(tái)渠道也可以使用其他平臺(tái)

認(rèn)證問題解決

此時(shí)執(zhí)行 claude 運(yùn)行項(xiàng)目，可能會(huì)出現(xiàn)以下錯(cuò)誤信息：

 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

這是因?yàn)?Claude 添加了登錄攔截認(rèn)證

在電腦里找到 .claude.json 配置文件，通常在 <用戶名>/.claude.json 位置

在 JSON 文件中添加字段繞過認(rèn)證，讓 Claude 使用環(huán)境配置的 API 服務(wù)

"hasCompletedOnboarding": true, 跳過登錄階段

之后運(yùn)行 claude 通過啟動(dòng)頁面的模型配置來驗(yàn)證是否切換成功

可以看到顯示 Qwen 模型

基礎(chǔ)

基礎(chǔ)操作

  • 啟動(dòng)：claude 啟動(dòng)終端，最好通過 Powershell 啟動(dòng)，Bash 終端有 Bug
  • 更新：claude install 執(zhí)行 Claude 終端更新
  • 文件搜索：@ 開頭實(shí)現(xiàn)文件搜索，和 Copilot 的 # 有些區(qū)別
  • 命令調(diào)用：/ 開頭執(zhí)行命令，選擇的過程中用 Tab 補(bǔ)全，觸發(fā) Enter 會(huì)直接執(zhí)行
  • 圖片粘貼：截圖后在 CLI 中執(zhí)行 Alt + V 粘貼即可（Mac/Linux 是 Ctrl + V），會(huì)顯示為 [Image #n] 的格式
  • 計(jì)劃模式：Shift + Tab 啟動(dòng)，計(jì)劃完成后再執(zhí)行，適合大型項(xiàng)目修改的場(chǎng)景
  • 換行：反斜杠 \ + 回車

記憶

基于 CLAUDE.md 文件可以實(shí)現(xiàn)記憶功能

  • 可以定義風(fēng)格指南和通用指令
  • 文件內(nèi)容會(huì)自動(dòng)加載到 Claude 上下文（類似于 Cursor 的全局規(guī)則）

快速創(chuàng)建

執(zhí)行 /init 指令完成，Claude 會(huì)自動(dòng)分析代碼倉庫去生成 CLAUDE.md

最佳實(shí)踐

  • CLAUDE.md 作為團(tuán)隊(duì)指南提交到倉庫
  • CLAUDE.local.md 作為本地指南使用
  • 如果要共享所有本地項(xiàng)目使用，可以放到 <用戶名>/.claude/CLAUDE.md 中

歷史會(huì)話信息

Claude 會(huì)把會(huì)話的對(duì)話數(shù)據(jù)存儲(chǔ)在本地

持續(xù)會(huì)話

在當(dāng)前會(huì)話中，Claude 可以延續(xù)之前的對(duì)話內(nèi)容

如果不小心關(guān)閉了會(huì)話，通過 claude --resume 恢復(fù)

重啟會(huì)話

通過 claude 重啟新對(duì)話不會(huì)保持之前的上下文

也可以通過執(zhí)行 /clear 清空上下文

如果需要保留之前的內(nèi)容記憶又想清空上下文，可以執(zhí)行 /compact，Claude 會(huì)自動(dòng)整理內(nèi)容

輸入內(nèi)容記憶

在任何對(duì)話開頭加上 # 修飾符來保存當(dāng)前輸入的內(nèi)容，這個(gè)主要是用于存儲(chǔ)一些規(guī)范等，例如：

# 在任何計(jì)劃之前不要修改代碼

Claude 會(huì)詢問你要記憶內(nèi)容的地方，之后將輸入內(nèi)容添加到對(duì)應(yīng)的記憶文件里

注意：

  • 記憶的內(nèi)容是你輸入的內(nèi)容，不是執(zhí)行對(duì)話輸出結(jié)果，Claude 不會(huì)做任何事情
  • 如果沒有這個(gè)功能，可以嘗試 claude install 更新一下 Claude 版本

編輯器交互

Claude 支持執(zhí)行 /ide 關(guān)聯(lián)當(dāng)前的編輯器，會(huì)自動(dòng)定位你當(dāng)前所在的文件上下文，有利于 Claude 理解你要修改的內(nèi)容

需要在編輯器里安裝官方插件，比如 VSCode 就是安裝 Claude Code 插件

這個(gè)功能似乎需要官方賬戶來實(shí)現(xiàn)聯(lián)動(dòng)，目前還沒有測(cè)試過

MCP Server 使用

在命令行：

claude mcp add <自定義插件名稱> <執(zhí)行的 MCP Server 啟動(dòng)命令>

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

查看 MCP 使用情況：

執(zhí)行 /mcp 可以看到 MCP Server 的啟用情況

/mcp 命令詳情頁

這里就是啟用失敗 failed，如果啟用成功會(huì)顯示 connected。
按回車可以查看 MCP 插件的相關(guān)信息，例如：

  • MCP 是否連接
  • 啟動(dòng)命令
  • 啟動(dòng)參數(shù)
  • 配置信息
  • 功能類型，例如 tool
  • 提供的工具選項(xiàng)，View Tools 可以進(jìn)一步查看工具能力

啟動(dòng)失敗，進(jìn)入信息頁執(zhí)行 Reconnect 重試：


啟動(dòng)失敗

啟動(dòng)成功就會(huì)打勾：


啟動(dòng)成功

View Tools 查看詳細(xì)的工具能力：


可以看到每個(gè)工具

使用 MCP Server

顯示指定要使用的 MCP Server
例如基于 Playwright MCP，打通 Claude 和瀏覽器之間的調(diào)試通信，不再手動(dòng)截圖傳遞信息

使用 Playwright MCP 幫我優(yōu)化頁面中 xxx 功能的顯示效果

參考內(nèi)容

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容