从零开始使用 Claude Code

写在前面

你可能已经听说过 Claude Code：它能读代码、改代码、帮你调试，甚至还能参与整个开发流程。

但真正上手时，很多人卡住的不是“它能做什么”，而是“我该怎么安装、怎么开始用、怎么切换到适合自己的工作方式”。

这篇文章就从零开始，带你完成 Claude Code 的安装、基础使用，以及 Claude Code Switch 的配置思路。

我之所以想着写这篇文章，是因为这段时间的使用体验，Claude 给我的惊喜实在是太多了。

以前我使用 AI，更多是把它当成一个问答工具。你问它一个问题，它给你答案；你让它写代码，它给你一段代码；你让它写文档，它给你一段文字。它当然很有用，但很多时候，它更像是在给你“积木”。

它把积木递给你，至于怎么创建文件、怎么复制代码、怎么运行、怎么调试、怎么整理项目结构，最后还是得靠你自己。

但 Claude Code 给我的感觉完全不一样。

它更像是一个真正可以进入你电脑工作流的桌面智能体。你只需要清晰地表达自己的诉求，告诉它在哪个目录下工作、要实现什么功能、使用什么语言、最终达到什么效果，它就可以自己帮你创建文件、写入代码、运行测试、分析报错，甚至继续修改。

对我来说，Claude Code 最惊艳的地方，不是它“会回答”，而是它真的“会做事”。

一、Claude Code 是什么？

简单来说，Claude Code 是 Anthropic 推出的一个命令行 AI 编程工具。

它和普通聊天式 AI 最大的区别在于：Claude Code 可以直接在你的本地项目目录里工作。

你可以让它读取项目文件、理解代码结构、修改代码、运行命令、检查报错、写测试、生成文档，甚至协助你完成 Git 提交和项目整理。

请帮我阅读当前项目，告诉我项目结构和主要功能。

请在当前目录下创建一个 Python 项目，实现一个简单的学生成绩管理系统。

请运行测试，如果有报错，请分析原因并修复。

这就是 Claude Code 和普通 AI 的区别。

普通 AI 更多是“给你答案”。Claude Code 则更像是“进入你的项目，帮你推进任务”。

二、Claude Code 和普通 AI 工具有什么不一样？

我觉得可以用一个很简单的比喻来说明。

普通 AI 像是一个会给你积木的人。你告诉它“我想做一个项目”，它会给你代码片段、项目思路、命令示例、文档模板。

但后面的事情还是要你自己做：创建文件、复制代码、调整目录、安装依赖、运行测试、处理报错、继续修改。

而 Claude Code 更像是一个会帮你搭积木的人。

请在当前目录下创建一个项目，使用 Python 实现学生成绩管理系统，要求支持添加、删除、查询和统计平均分。

它可以自己创建 .py 文件，自己写代码，自己生成 README，甚至还能调用你本机的 Python 环境运行测试。

普通 AI更多是给你方案、代码片段和解释，落地执行还需要你自己完成。

Claude Code可以进入本地目录，创建文件、修改代码、执行命令并根据结果继续迭代。

三、安装 Claude Code 前需要准备什么？

1. Node.js 和 npm 环境

Claude Code 通常通过 npm 安装，所以电脑上需要先有 Node.js 和 npm。

node -v
npm -v

如果能看到版本号，说明环境已经准备好了。如果提示命令不存在，就需要先安装 Node.js。

2. 准备可用的模型 API，并通过 Claude Code Switch 接入

除了直接使用 Claude 官方账号或 Anthropic API Key 之外，我这里更想重点介绍另一种方式：通过 Claude Code Switch 接入其他模型的 API。

这里先说明一下，本文里说的 Claude Code Switch，指的是一种用于管理和切换 Claude Code API 配置的工具或方案。它的核心作用是：让我们可以在不同模型、不同 API Key、不同 Base URL 之间切换。

Claude Code 负责执行任务，Claude Code Switch 负责切换模型接口。

通过 Claude Code Switch，我们就不一定只能使用默认配置，也可以根据自己的需求接入其他兼容接口的模型 API。

可以根据预算选择不同模型；
可以根据任务复杂度切换不同模型；
可以在不同 API 服务之间灵活切换；
某个 API 额度不足时，可以换另一个继续使用；
对喜欢折腾 AI 工具和本地工作流的人来说，可玩性更高。

第一，API Key

API Key 就是模型服务平台提供给你的密钥。它相当于你的调用凭证，不要公开，不要截图发群里，也不要上传到 GitHub。

sk-xxxxxxxxxxxxxxxxxxxxxxxx

第二，API Base URL

API Base URL 就是接口地址。不同模型平台的接口地址不同，配置时一定要按照对应平台提供的地址填写。

第三，模型名称 Model Name

模型名称就是你要调用的模型 ID。不同平台的模型名称不同，不能凭感觉乱填，配置时一定要去平台文档里复制准确的模型名称。

3. 一个适合练手的项目目录

第一次使用 Claude Code，不建议直接拿重要项目测试。可以先创建一个空文件夹：

mkdir claude-demo
cd claude-demo

然后在这个目录里启动 Claude Code，让它帮你写一个简单脚本。这样即使出错，也不会影响重要文件。

四、如何安装 Claude Code？

Claude Code 的常见安装命令是：

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

安装完成后，可以输入：

claude

如果能够正常进入 Claude Code 的交互界面，就说明安装成功了。

如果提示命令找不到，可能是 npm 全局路径没有加入环境变量。如果提示权限不足，Windows 用户可以尝试使用管理员权限 PowerShell；macOS 或 Linux 用户则需要检查 npm 全局安装权限。

安装完成后，也可以使用下面的命令更新 Claude Code：

claude update

Claude Code 版本更新比较快，具体安装命令和认证方式建议以官方文档最新版为准。

五、使用 Claude Code Switch 接入其他模型 API

前面我们已经安装好了 Claude Code，接下来重点讲一下我自己的使用方式：通过 Claude Code Switch 接入其他模型 API。

很多人第一次接触 Claude Code Switch，可能会以为它是另一个 AI 工具。其实不是。

Claude Code Switch 更像是一个配置切换工具。它不是用来替代 Claude Code 的，而是用来帮助 Claude Code 切换不同 API 配置的。

Claude Code：负责读文件、写代码、执行任务。
Claude Code Switch：负责切换 API Key、Base URL 和模型名称。

配置好之后，你平时还是正常使用 Claude Code，只是背后的模型接口可以根据你的配置进行切换。

1. Claude Code Switch 适合解决什么问题？

第一，切换不同模型

有些任务比较简单，比如写文档、解释代码、生成 README，用普通模型就可以。有些任务比较复杂，比如大型项目分析、复杂 bug 修复、长代码重构，就需要更强的模型。

第二，切换不同 API 服务

有些 API 速度快，有些 API 成本低，有些 API 上下文长，有些 API 推理能力强。不同平台各有优势，通过 Claude Code Switch，可以把多个 API 配置保存起来，需要时直接切换。

第三，避免单一额度限制

有时候一个 API 额度用完了，或者某个模型临时不可用，就可以切换到另一个配置继续工作。

2. 配置前要准备什么？

API Key
API Base URL
Model Name

可以把它们理解成三件套：API Key 是你的密钥，Base URL 是接口地址，Model Name 是模型名称。

3. 基本配置思路

不同版本的 Claude Code Switch 具体界面或命令可能不完全一样，但整体配置思路基本类似。

第一步：安装或打开 Claude Code Switch并添加一个模型配置

第二步：新增一个模型配置，如果选项里有你已经购买过token，给你提供了api接口的供应商，直接选对应的就行，我这里用的gpt所以自定义配置

第三步：填写 API Key、请求地址（提供api接口的网址）和模型名称

第四步：点开高级选项点击获取模型列表，其他保持默认即可

第五步：重新启动 Claude Code 并测试

如果是配置文件形式，通常会看到类似这样的字段：

{
  "name": "my-model",
  "api_key": "sk-xxxxxxxxxxxxxxxx",
  "base_url": "https://api.example.com",
  "model": "your-model-name"
}

这里只是示例，实际配置要以你使用的 Claude Code Switch 工具为准。

4. 如何测试是否接入成功？

配置完成后，可以重新进入项目目录，然后在目录顶部地址栏输入claude启动 Claude Code：

claude

进入之后，先不要上来就做复杂任务。可以先问一个简单问题：

请简单介绍一下你现在可以帮我做什么。

如果能正常回复，说明基本连接成功。然后可以再测试一个简单文件任务：

请在当前目录创建一个 hello.txt，内容写入“Claude Code 测试成功”。

5. 常见问题和解决方法

认证失败

如果出现 401、Unauthorized、Invalid API Key，一般是 API Key 填错了，或者 Key 已经过期、被禁用。

模型不存在

如果出现 model not found、model does not exist，通常是模型名称填错了。解决方法是去 API 平台文档查看模型列表，复制准确的模型 ID。

连接失败或 404

如果出现连接失败、404、请求地址错误，通常是 Base URL 填错了。检查 URL 是否完整、有没有多余的斜杠，以及网络是否可以访问。

额度不足或请求频率过高

如果出现 quota exceeded、rate limit、billing error，一般是额度不足、余额不足，或者请求频率太高。

简单问答可以，但复杂任务不稳定

有些模型虽然可以聊天，但不一定完全适合 Claude Code。因为 Claude Code 不只是聊天，它还需要模型理解文件、处理工具调用、进行多步任务规划。

Claude Code Switch 很方便，但一定要注意 API Key 安全。不要把 Key 写进公开文章、上传到 GitHub、发到群聊，或者交给来源不明的工具。

六、Claude Code 的基础使用方式

安装和配置完成后，就可以开始使用 Claude Code 了。最常见的方式是进入项目目录，然后启动：

cd your-project
claude

启动后，你就可以直接输入自然语言指令。

请帮我阅读这个项目，告诉我主要目录结构和启动方式。

请帮我检查这个项目有没有明显问题，先不要修改文件，只给我分析。

请帮我给这个项目增加一个登录功能，并先告诉我需要修改哪些文件。

一定要先进入正确的项目目录，再启动 Claude Code。因为 Claude Code 会基于当前目录理解项目。

新手推荐流程

先让它读项目：请先阅读当前项目，暂时不要修改任何文件。

再让它提计划：如果我要增加功能，需要修改哪些文件？

确认后再执行：可以，按照刚才的计划开始修改。

最后运行测试：请运行测试，确认刚才的修改是否生效。

七、Claude Code 最让我惊艳的地方

如果只是安装和基础使用，Claude Code 可能看起来只是另一个 AI 工具。但真正用了一段时间之后，我发现它最厉害的地方并不是“会聊天”，而是它可以真正参与到本地工作流里，把很多原本需要手动完成的事情自动串起来。

以前使用普通 AI 时，我更多是在和它对话。我提出需求，它给我代码、思路、文档或者步骤。但后面的事情还是要我自己做。

而 Claude Code 给我的感觉完全不一样。你只要把需求说清楚，它不只是给你积木，它还可以帮你把积木准备好，然后按照你的要求一步一步搭起来。

1. 它可以从零帮你搭一个项目

请在当前目录下创建一个 Python 项目，实现一个简单的学生成绩管理系统，要求支持添加学生、删除学生、查询学生、统计平均分，并生成 README。

它可以自己分析需求，然后在当前目录下创建对应文件，比如 main.py、student.py、storage.py、README.md、requirements.txt。

如果你想用 Java、C、Kotlin、JavaScript，也可以直接说清楚语言和要求。它不只是把代码发给你，而是真的可以在本地目录里创建文件，并把代码写进去。

2. 它可以自己运行测试，发现问题再继续修

请运行这个项目，检查有没有报错。

请执行测试，如果有 bug，请分析原因并修复。

如果你的电脑上已经有对应环境，比如 Python、Java、Node.js、Git 等，它就可以调用本机环境去运行项目。

如果运行时报错，它会读取报错信息，然后继续分析问题出在哪里，再继续修复。

提出需求 → 创建项目 → 写代码 → 运行测试 → 发现报错 → 修复问题 → 再次验证

这才是 Claude Code 真正让我觉得强的地方。它不是只负责生成，而是可以参与验证和迭代。

3. 它甚至可以帮你配置开发环境

有些时候项目跑不起来，并不是代码的问题，而是环境没配好。比如缺少 Python 包、Node 依赖、Java 环境变量、ADB 工具、Git 配置等。

请检查当前电脑是否已经安装 Node.js、npm 和 Git。

这个项目运行失败了，请帮我检查是代码问题还是环境问题。

它会根据终端输出继续分析。涉及管理员权限、安装软件、修改系统环境变量时，最好不要盲目授权，可以先让它列出操作计划。

4. 它可以帮你把项目推送到 GitHub

请帮我检查当前项目结构，生成 .gitignore 和 README，然后准备推送到我的 GitHub 仓库。

它可以帮你检查项目目录、生成 .gitignore、编写 README、整理提交信息、初始化 Git、添加远程仓库、提交代码并推送到 GitHub。

当然，推送仓库属于比较重要的操作，尤其是涉及远程仓库覆盖、删除文件、公开代码时，一定要看清楚它准备执行什么命令。

本篇文章就是用claude帮忙推送到我的github仓库中去的，然后通过“赛博大善人”cloud flare实现github静态网页托管，套一个国内cdn节点，最终将这篇文章呈献出来

5. 它可以辅助安全研究和逆向分析

对于做安全研究、CTF、逆向分析或者代码审计的人来说，Claude Code 的价值也很明显。

在合法授权的场景下，你可以让它检查分析环境、整理反编译后的项目结构、查找关键函数、分析代码调用链、总结可疑逻辑、生成分析报告，或者帮你整理 CTF 题目的解题思路。

安全研究和逆向分析必须在合法授权范围内进行。不要把它用于未授权破解、攻击他人系统、绕过商业软件限制或者其他违法用途。

6. 它可以辅助 Android 项目调试，甚至操作测试设备

如果电脑上配置好了 ADB，手机打开开发者模式和 USB 调试，Claude Code 可以通过命令行工具协助你调试设备。

检查手机是否连接；
查看设备列表；
获取应用日志；
分析崩溃信息；
启动测试应用；
执行一些自动化调试命令；
辅助排查 Android 项目运行问题。

如果是自己的测试设备，并且你清楚授权范围，还可以配合 Root、Shizuku 或其他开发调试工具做更深入的测试。

涉及手机 Root、调试接口、设备权限、应用数据时，一定要确保是自己的设备或者授权测试设备。

7. 它还可以帮你处理 Word、Excel、PPT

Claude Code 名字里有 Code，但它真的不只是写代码。我还用它处理过文档类任务，比如 Word、Excel、PPT。

请帮我生成一份 Word 实验报告，内容包括实验目的、实验环境、实验步骤、实验结果和总结。

标题居中，正文首行缩进两个字符，行距 1.5 倍，表格使用三线表风格。

普通 AI 通常是把文档内容生成给你，然后你自己复制到 Word 里，再慢慢调格式。但 Claude Code 可以直接在你的工作目录里创建文件。

八、Claude Code 的核心优势是自动化

总结一下，Claude Code 真正让我惊艳的地方，其实可以归结为两个字：自动化。

它可以自动理解项目，自动创建文件，自动写代码，自动运行测试，自动分析报错，自动修改问题，自动整理文档，自动调用本机工具。

当然，这里的“自动”不是说你完全不用管。你依然需要提出清晰需求，确认关键操作，检查最终结果。

以前你用 AI，可能是这样：

你提出需求 → AI 给你答案 → 你复制代码 → 你创建文件 → 你运行 → 你报错 → 你再问 AI

现在用 Claude Code，更像是这样：

你提出需求 → Claude Code 创建文件 → 写代码 → 运行 → 报错 → 分析 → 修复 → 再验证

一个是给你答案。一个是帮你推进任务。

九、使用 Claude Code 时需要注意什么？

1. 重要操作前先看计划

涉及删除文件、覆盖文件、修改大量代码、安装依赖、修改环境变量、推送 GitHub、使用管理员权限、操作系统配置时，最好让 Claude Code 先列计划。

请先告诉我你准备执行哪些操作，不要直接执行。

2. 重要项目先备份

如果是课程作业、公司项目、比赛项目，建议先用 Git 管理，或者复制一份再让 Claude Code 修改。这样即使结果不符合预期，也可以回退。

3. 不要泄露敏感信息

不要随便把密码、Token、API Key、私钥、Cookie、公司内部资料、未公开代码交给不可信工具。

尤其是使用 Claude Code Switch 接入第三方 API 时，一定要保护好自己的 API Key。

4. 安全研究必须合法授权

Claude Code 可以辅助逆向、安全分析、CTF、代码审计，但前提必须是合法授权。技术能力越强，越要注意边界。

十、总结

我之所以想写这篇文章，就是因为 Claude Code 让我看到了 AI 工具的另一种形态。

它不再只是聊天窗口里那个回答问题的助手，而是可以进入你的电脑，进入你的项目，进入你的开发环境，帮你把事情一步步做完。

你可以让它写代码；
你可以让它改项目；
你可以让它跑测试；
你可以让它修 bug；
你可以让它整理 GitHub；
你可以让它处理文档；
你可以让它辅助调试设备；
你也可以在合法授权的前提下，让它辅助安全研究和逆向分析。

而 Claude Code Switch 的加入，则让它的可玩性进一步提高。通过 Claude Code Switch，我们可以接入不同模型 API，根据任务类型、成本、速度和稳定性自由切换。

对于新手来说，我建议按照这个路线开始：

安装 Node.js 和 npm
↓
安装 Claude Code
↓
准备 API Key、Base URL 和模型名称
↓
通过 Claude Code Switch 接入模型 API
↓
在空目录里测试 Claude Code
↓
让它从简单任务开始
↓
逐渐尝试项目开发、调试、文档和自动化流程

Claude Code 最让我惊艳的地方，不是它能回答多少问题，而是它可以真正帮你把事情做完。

从这个角度看，它不只是一个 AI 工具，更像是一个可以进入你电脑、进入你的项目、进入你工作流的智能助手。

如果你还没有试过，真的可以找一个小项目，从今天开始体验一下。

也许你会和我一样发现：AI 不再只是给你答案，它已经开始帮你执行任务了。