【AI编码】Claude Code是什么？如何安装和使用Claude Code｜小白Claude Code使用教程与完整指南

写在开头

Claude Code 是近期热度最高的 AI 编程工具，特别在海外社区获得了大量讨论。

它是 Anthropic 开发的一款智能编程工具 (agentic coding tool)，它能够在你的终端中运行，帮助你更快地将想法转化为代码。越来越多的开发者将其视为 AI 结对编程伙伴，当然它还远不只是一个写代码的 AI，而是能够主动搜索、读取代码、编辑文件、运行测试、甚至提交代码到 GitHub 的 Agentic 系统。

Claude Code 选择了"黑框"终端界面，这在一些用户看来过于原始简陋，但实际上是 Anthropic 经过深思熟虑的设计，它代表了"反璞归真"的设计哲学。

终端界面的三大优势在于：

自由度最大：AI 可以调用一切系统能力，不受 UI 框架的限制。
认知负担最小：你只需要说出你想要什么，无需学习复杂的界面操作。
天然集成工具链：所有的开发工具（如 Git、npm 等）本来就是命令行（CLI）的，终端是最好的集成环境。

这使得 Claude Code 能更好地专注于 Agentic Coding 的核心循环：感知、规划、行动。

如何安装与配置 Claude Code（claude 教程/claude code 如何使用）

Claude Code 用户中心

API密钥管理

管理您的API密钥，用于CLI工具和自动化脚本

MacOS/Linux ClaudeCode安装指南

系统要求

macOS 10.15+ 系统或 Linux 系统

安装步骤

1、打开终端

使用 Cmd+Space 搜索 "Terminal" 或在应用程序 > 实用工具中找到终端

2、复制并执行环境检查脚本

复制代码

$ curl -fsSL https://download.aicodemirror.com/env_deploy/env-install.sh | bash

3、卸载已安装的Claude Code（未安装请跳过）

复制代码

$ npm uninstall -g @anthropic-ai/claude-code

4、安装官方原版包

复制代码

$ npm install -g @anthropic-ai/claude-code

5、在「API密钥」界面配置一个API Key

访问仪表板的「API密钥」页面，创建并复制一个新的API密钥

6、复制并执行环境变量配置脚本

复制代码

$ curl -fsSL https://download.aicodemirror.com/env_deploy/env-deploy.sh | bash -s -- "你的API_KEY"

7、重启终端，验证安装结果

重启终端后运行以下命令，确认安装成功

这步很重要，如果不重启终端一定要 source 一下配置，我的是 source .zshrc，这样环境变量才会生效；

复制代码

$ claude -v

Windows ClaudeCode安装指南

在 Windows 系统上安装官方 Claude Code CLI

系统要求

Windows 10 (版本 1809 / build 17763) 及以上

安装步骤

1、【此步骤在桌面】下载git

访问 https://git-scm.com/downloads/win，安装时全都下一步，不要修改路径

2、【此步骤在桌面】下载nodejs

访问 https://nodejs.org/zh-cn/download，安装时全都下一步，不要修改路径

3、【此步骤在Windows PowerShell】验证安装情况

打开Windows PowerShell（蓝色图标），执行以下命令验证安装情况：

复制代码

PS> node -v
PS> npm -v

若提示「No suitable shell found」，是git没装好。请将 CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\git\bin\bash.exe 设置到系统环境变量中，重启终端再试。依旧无效，重装git，重启终端后再试

4、【此步骤在Windows PowerShell】卸载已安装的Claude Code（未安装请跳过）

复制代码

PS> npm uninstall -g @anthropic-ai/claude-code

5、【此步骤在Windows PowerShell】安装官方原版包

复制代码

PS> npm install -g @anthropic-ai/claude-code

6、【此步骤在控制面板】设置Windows系统环境变量

需要设置以下三个环境变量：

变量名：ANTHROPIC_BASE_URL，变量值：https://api.aicodemirror.com/api/claudecode
变量名：ANTHROPIC_API_KEY，变量值：你的密钥
变量名：ANTHROPIC_AUTH_TOKEN，变量值：你的密钥

设置方法见上文「预备知识：修改环境变量」

7、【此步骤在Windows PowerShell】重启Windows PowerShell，验证安装结果

重启Windows PowerShell后运行以下命令，确认安装成功

复制代码

PS> claude -v

开始使用

安装完成后，您可以在任何项目目录中开始使用 Claude Code：

复制代码

# 导航到您的项目
$ cd your-project-folder

# 启动 Claude Code
$ claude

安装过程遇到的问题

我个人使用的是 MAC 版本

问题： Unable to connect 报错解决

在 Mac 上第一次 Claude，终端执行 npm install -g @anthropic-ai/claude-code 安装 Claude 后，出现下面这个报错，于是去网上查，查了好久终于查到有个 github issue 提到了

https://github.com/anthropics/claude-code/issues/2279#issuecomment-3112725753

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.json 配置文件，对其进行编辑

在json 的最后面补充

复制代码

"hasCompletedOnboarding": true

修改后重启 Claude 就可以了（重新运行 claude）

VS Code终端配置

安卓Claude Code扩展

终端没安装对应的扩展，在扩展内直接搜索"Claude Code"，就可以看到；

增加Claude Code 配置 primaryApiKey

打开～/.claude/config.json 文件，进行配置，在配置内增加 ""primaryApiKey": "aicodemirror""；

复制代码

{
"primaryApiKey": "aicodemirror"
}

重启VSCode

重启VSCode，再次打开 Claude Code 插件，恢复正常使用。

Claude Code 实操，跟Claude Code真实操作

因为我是一个小白，以前并没有用过 Claude Code，所以进入以后我让 Claude Code 回答了我一下它自己的功能和使用方式；

下面是实操的问题和回答：

问题1：我一直有个问题，老项目代码逻辑非常的凌乱，那么从什么切入点对你进行使用呢？

回答：

1. 从具体问题入手（最推荐）

修复 Bug：当遇到具体的 bug 时，让我帮你定位和修复

添加小功能：需要添加新功能时，我可以帮你找到合适的位置并实现

解释代码：遇到看不懂的代码逻辑，让我帮你分析

复制代码

示例：
"这个 QrController 中的 generateQr 方法是做什么的？"
"修复用户反馈的二维码生成失败的问题"

2. 理解现有代码

梳理某个功能模块：让我分析某个控制器、服务或功能的完整流程

理解数据流向：追踪数据从入口到出口的完整链路

找出依赖关系：了解某个类/文件被哪些地方使用

复制代码

示例：
"分享二维码功能的完整实现逻辑是什么？"
"QrController 依赖了哪些服务和类？"

3. 重构前的探索

找出重复代码：识别可以提取的公共逻辑

分析某个文件的问题：让我指出代码中的潜在问题

评估重构范围：了解改动某处会影响哪些地方

复制代码

示例：
"这个 QrController 有哪些可以优化的地方？"
"如果要重构二维码生成逻辑，需要改动哪些文件？"

4. 日常开发任务

查找代码位置：快速找到某个功能的实现位置

生成测试用例：为关键逻辑添加测试

编写文档：为复杂模块生成注释或文档

复制代码

示例：
"项目中哪些地方调用了二维码生成接口？"
"为 QrController::generateQr 方法添加单元测试"

问题2:给我一份使用你的手册吧，你都有哪些功能可以供我使用？

因为我是在企业微信获客助手的项目里，所有它的回答有些部分结合了项目文件；

回答：

📘 Claude Code 使用手册（老项目版）

一、基础交互方式

代码理解类

✅ 推荐的提问方式：
- "这个文件是做什么的？"
- "actionMediaplacement 这个方法的作用是什么？"
- "createState 方法是如何生成编码的？"
- "st3 和 st4 参数在哪里使用？"
💡 我会：
- 读取相关文件
- 逐步分析代码逻辑
- 用通俗语言解释
- 标注关键代码位置（文件名:行号）
代码搜索类

✅ 推荐的提问方式：
- "项目中哪些地方调用了 QrService::mediaPlacement？"
- "找出所有生成二维码的接口"
- "state 参数在哪些文件中被使用？"
- "有哪些控制器使用了 BaseController？"
💡 我会：
- 使用 Grep 搜索关键词
- 使用 Glob 查找文件
- 展示所有匹配结果
- 告诉你具体文件和行号
Bug 修复类

✅ 推荐的提问方式：
- "actionGetnumsfriendsadd 方法第389行后面的代码永远不会执行，帮我修复"
- "修复 actionQueryrelation 中的硬编码默认值问题"
- "这个方法报错了：[粘贴错误信息]，帮我看看"
💡 我会：
- 先读取文件了解上下文
- 定位问题原因
- 提供修复方案
- 使用 Edit 工具修改代码
- 说明修改了什么
功能开发类

✅ 推荐的提问方式：
- "给 QrController 添加一个批量生成二维码的接口"
- "在 actionExternalqrcode 中添加日志记录功能"
- "实现一个检查二维码是否过期的方法"
💡 我会：
- 先了解现有代码结构
- 创建待办列表规划任务
- 逐步实现功能
- 遵循现有代码风格
代码重构类

✅ 推荐的提问方式：
- "QrController 中重复的错误处理代码能否提取成公共方法？"
- "优化 createState 方法的可读性"
- "这段代码有哪些可以改进的地方？"
💡 我会：
- 分析代码问题
- 提出改进建议
- 征求你的同意后再动手
- 保持功能不变的前提下优化

二、我的工作流程

📖 阅读代码时

复制代码

我会：
1. 使用 Read 工具读取文件
2. 边读边分析（不是一次性输出）
3. 用通俗语言解释
4. 标注关键位置 [filename.ts:42](path/file.ts#L42)

✏️ 修改代码时

复制代码

我会：
1. 先用 Read 读取文件（必须！）
2. 创建 TodoWrite 待办列表
3. 使用 Edit 工具精确替换
4. 告诉你改了什么
5. 不会改无关的代码

🔍 搜索代码时

复制代码

我会：
1. 用 Grep 搜索关键词
2. 用 Glob 查找文件模式
3. 如果搜索复杂，会启动 Task 工具（探索代理）
4. 展示所有相关结果

🚀 执行命令时

复制代码

我会：
1. 使用 Bash 工具执行命令
2. 展示执行结果
3. 如果出错，帮你分析原因

三、实用技巧

💡 技巧 1：让我一步步分析

复制代码

❌ 不好的问法：
"分析整个项目的架构"

✅ 好的问法：
"从 QrController 开始，逐步分析二维码生成的完整流程"

💡 技巧 2：给我足够的上下文

复制代码

❌ 不好的问法：
"这个方法有问题"

✅ 好的问法：
"QrController.php 的 actionMediaplacement 方法在生产环境偶尔返回404，
参数都传了，帮我看看可能是什么原因"

💡 技巧 3：让我帮你探索

复制代码

✅ 这样问：
"二维码生成失败后的错误处理流程是怎样的？涉及哪些文件？"

我会启动探索代理，深入追踪代码流程

💡 技巧 4：让我验证想法

复制代码

✅ 这样问：
"我想把所有二维码接口的错误处理统一到一个方法里，可行吗？"

我会分析现有代码，给出建议和实现方案

四、我擅长做什么

✅ 我很擅长

📖 阅读和理解代码（包括复杂的老代码）

🔍 搜索和定位代码位置

🐛 修复明确的 Bug

✨ 添加新功能

📝 解释代码逻辑

🔧 重构和优化代码

📊 分析代码结构和依赖关系

📋 创建和管理任务列表

⚠️ 我的限制

❌ 不会主动修改你没要求改的代码

❌ 不会创建不必要的文档文件

❌ 不会过度设计（除非你要求）

❌ 看不到运行时的实际数据（需要你提供）

❌ 不能直接访问数据库或外部服务

五、常用命令示例

📝 查看文件

复制代码

"打开 QrController.php"
"读取 QrService.php 的前100行"

🔍 搜索代码

复制代码

"搜索所有调用 createState 的地方"
"找出所有 Controller 文件"
"项目中哪些地方用到了 state 参数"

🐛 修复问题

复制代码

"修复 actionGetnumsfriendsadd 中的逻辑错误"
"把硬编码的默认值改成从配置读取"

✨ 添加功能

复制代码

"给二维码生成接口添加访问频率限制"
"实现一个批量生成二维码的方法"

🔧 重构代码

复制代码

"提取重复的错误处理逻辑到父类"
"优化 createState 方法的可读性"
"这个方法能否拆分成更小的函数？"

📊 分析代码

复制代码

"QrController 依赖了哪些服务？"
"二维码生成的完整流程是怎样的？"
"这个项目的目录结构是什么样的？"

六、最佳实践

✅ DO - 推荐做法

明确具体的问题

复制代码

✅ "QrController 的 actionMediaplacement 方法中，
   st3 和 st4 参数是必传的，但没看到在哪里校验，帮我加上校验逻辑"

让我逐步分析

复制代码

✅ "从 QrController 开始，一步步追踪二维码生成的流程"

提供错误信息

复制代码

✅ "生产环境报错：Call to undefined method QrService::mediaPlacement()
   帮我看看是不是方法名写错了"

让我帮你规划

复制代码

✅ "我想重构二维码生成逻辑，先帮我分析现有代码有哪些问题"

❌ DON'T - 不推荐做法

太模糊的问题

复制代码

❌ "这个项目怎么样？"
❌ "帮我优化一下"

要求我猜测

复制代码

❌ "这个项目应该用什么技术栈？"（我可以看代码判断）
❌ "生产环境的配置是什么？"（需要你提供）

没有上下文的修改

复制代码

❌ "把所有代码都用最新的 PHP 8 语法重写"（风险太大）

七、快速上手场景

🎯 场景 1：接手新模块

复制代码

你：这个 QrController 是做什么的？
我：[逐步分析文件功能]

你：actionExternalqrcode 方法的业务流程是怎样的？
我：[详细解释方法逻辑]

你：createState 是如何编码的？
我：[分析编码规则]

🎯 场景 2：修复 Bug

复制代码

你：生产环境报错 [粘贴错误信息]
我：[帮你定位问题原因]

你：帮我修复这个问题
我：[创建待办列表 → 修改代码 → 说明改动]

🎯 场景 3：开发新功能

复制代码

你：我要添加一个批量生成二维码的接口
我：[分析现有代码 → 给出实现方案]

你：好的，开始实现吧
我：[创建待办列表 → 逐步实现 → 标记完成]

🎯 场景 4：代码重构

复制代码

你：QrController 有哪些可以改进的地方？
我：[列出具体问题和建议]

你：重复的错误处理能否提取？
我：[分析可行性 → 征求同意 → 实施重构]

八、特殊功能

🔧 Git 操作

复制代码

"创建一个新分支 feature/qr-batch"
"提交当前修改，commit 信息：修复二维码生成逻辑"
"创建 PR，标题：优化 QrController 错误处理"

📦 依赖管理

复制代码

"运行 composer install"
"查看 composer.json 中的依赖"

🧪 测试相关

复制代码

"运行 PHPUnit 测试"
"为 actionMediaplacement 方法编写单元测试"

九、现在开始使用

你可以这样开始：

了解现有功能

复制代码

"QrService 这个服务类有哪些方法？"
"二维码生成失败后会记录日志吗？在哪里记录的？"

修复当前问题

复制代码

"actionGetnumsfriendsadd 第389行后的代码永远不会执行，帮我修复"

探索代码结构

复制代码

"从 QrController 开始，帮我理清二维码生成的完整链路"

开发新功能

复制代码

"给 QrController 添加一个查询二维码使用统计的接口"

好啦，今天就分享到这里，你学到了吗？

如果觉得这篇内容有用，点赞收藏走一波，我们下期见！上面的内容不清楚的地方欢迎大家留言一起讨论学习～

【AI编码】Claude Code是什么？如何安装和使用Claude Code｜小白Claude Code使用教程与完整指南

写在开头

如何安装与配置 Claude Code（claude 教程/claude code 如何使用）

推荐大家使用 AICodeMirror

Claude Code 用户中心

API密钥管理

MacOS/Linux ClaudeCode安装指南

系统要求

安装步骤

Windows ClaudeCode安装指南

系统要求

安装步骤

开始使用

安装过程遇到的问题

问题： Unable to connect 报错解决

解决方式：

VS Code终端配置

安卓Claude Code扩展

增加Claude Code 配置 primaryApiKey

重启VSCode

Claude Code 实操 ，跟Claude Code真实操作

问题1：我一直有个问题，老项目代码逻辑非常的凌乱，那么从什么切入点对你进行使用呢？

回答：

1. 从具体问题入手（最推荐）

2. 理解现有代码

3. 重构前的探索

4. 日常开发任务

问题2:给我一份使用你的手册吧，你都有哪些功能可以供我使用？

回答：

📘 Claude Code 使用手册（老项目版）

一、基础交互方式

二、我的工作流程

三、实用技巧

四、我擅长做什么

五、常用命令示例

六、最佳实践

七、快速上手场景

八、特殊功能

九、现在开始使用

Claude Code 实操，跟Claude Code真实操作