国内新手零成本上手Claude Code完整指南

Claude Code 是当前最受关注的 AI Agent 工具之一，它不止能写代码，还能写文案、操控电脑处理日常杂务。但对国内用户来说，官方订阅门槛高、网络受限，很多人卡在安装和配置这一步。B站上有 UP 主做了一期面向纯小白的实操教程，核心思路是用国产免费模型替代官方 API，实现零成本使用。这篇文章把其中的关键步骤和原理拆解清楚，帮你少走弯路。

Claude Code 到底是什么，为什么值得折腾

Claude Code 本质上是一个运行在终端里的 AI Agent。和普通聊天式的 AI 不同，它能直接读写文件、执行终端命令、修改代码库，属于「动手型」工具。你告诉它要做什么，它会自己规划步骤、调用工具、验证结果。

正因为要真刀真枪地改代码、跑命令，普通模型容易「脑子一热直接蛮干」，改出一堆 bug。这也是为什么 Claude Code 对底层模型的 agent 能力和推理能力要求较高。理解了这一点，后面选择替代模型时就有了判断标准。

AI Agent（智能体） 是指能自主感知环境、规划步骤并调用外部工具来完成任务的 AI 系统，与只能一问一答的聊天机器人有本质区别。在 Claude Code 这类编码场景中，Agent 会先拆解需求、决定读哪个文件、执行哪条命令，再根据命令返回的结果调整下一步动作，形成「思考—行动—观察」的循环。这种循环对模型的工具调用格式遵循能力、长上下文记忆和多步推理稳定性要求很高，任何一步格式出错都可能导致任务中断。因此同一款模型在闲聊场景表现不错，套进 Agent 框架后却可能频繁卡壳，这也是评估替代模型时必须考察 agent 能力的原因。

两种安装方式：命令行与 IDE 插件

据 B站 UP 主的演示，安装主要分两个流派。

命令行方式（硬核路线）：以 Windows 为例，搜索并打开 PowerShell，粘贴官方安装命令，等待安装完成。此时还不能直接使用，因为环境变量里没有 Claude Code 的安装路径。需要打开环境变量设置，在用户变量的 Path 中新增 Claude Code 所在目录，重启 PowerShell 后即可调用。

IDE 插件方式（推荐新手）：所有基于 VS Code 开发的 AI 编程工具，包括国外的 Cursor 和国内的 Trae、Coder、CodeBuddy 等，都可以在插件市场搜索并安装 Claude Code，装完直接在软件内打开使用。

对不熟悉命令行的用户，插件方式明显更友好，也省去了环境变量配置的麻烦。

关键一步：用国产免费模型替代官方 API

安装只是第一步，还需要配置大模型的 API 地址和 Key。如果你有 Claude 官方账号并订阅了付费套餐，按提示网页登录授权即可。但绝大多数国内用户没有这个条件。

替代方案是选择适配了 Claude Code 的国产大模型。UP 主在视频中重点推荐了美团开源的长猫（LongCat）Flash Thinking 模型，理由是：目前免费，每人每天有相当多的 token 额度，且性能处于第一梯队。该模型参数量达 5600 亿，专攻 agent 智能体和深度思考能力。它自带深度推理模式，动手前会先停下来拆解复杂逻辑，再生成代码——这正好对应 Claude Code 对模型「先想再做」的要求。

需要说明的是，这是 UP 主单一来源的推荐，市面上适配 Claude Code 的国产模型不止一个，读者可以按免费额度、agent 能力和社区口碑自行对比。

配置步骤拆解

1. 打开 LongCat API 开放平台，注册并登录，平台会赠送免费 token 额度（UP 主演示时是 50 万，且每日刷新），还可填写行业和使用场景申请更多额度。
2. 在 API Key 菜单新建并复制 Key。
3. 打开接口文档页，官方已给出对接 Claude Code 的配置示例。
4. 找到用户目录下的 Claude 文件夹，打开 settings.json，粘贴配置，把 Key 替换为刚复制的值，模型名称统一改为对应的 flash thinking 模型标识。
5. 在用户目录下找到 claude.json，在末尾新增一个配置项以跳过 Claude 官方登录认证，否则会一直被要求登录。

配置完成后，在桌面新建项目目录，用 PowerShell 切换进去，执行 Claude 命令即可开始对话。UP 主验证时问模型「你是谁」，它会回答自己是 Claude 官方模型，但实际上消耗的是 LongCat 的 token——API 后台能看到用量记录。

API（应用程序编程接口） 是大模型厂商对外开放的调用通道：开发者不通过网页聊天界面，而是用一段程序请求把对话内容发给模型服务器，再接收返回结果。使用 API 需要一个 API Key，相当于身份凭证和计费账号，泄露后他人可冒用你的额度。Claude Code 本身不含模型，它只是外壳，所有推理都通过 API 地址转发给背后的模型服务商。因此只要把配置中的接口地址和 Key 换成另一家兼容的服务商，就能在不改动工具的前提下更换底层模型，这也是文中用国产模型替代官方 API 的原理。

文中提到的 settings.json 和 claude.json 是 Claude Code 的配置文件，通常位于用户主目录下的 .claude 文件夹中，以 JSON 格式保存键值对。settings.json 主要记录模型服务地址、API Key、默认模型名称等运行参数；claude.json 则保存登录状态、项目历史等会话信息。直接编辑 JSON 时要注意逗号、引号和括号的配对，格式错误会导致程序启动失败。修改前建议先备份原文件，改动后重启终端使配置生效。

实操演示：用自然语言开发一个小工具

配置好之后能做什么？UP 主演示了一个典型场景：做一个待办事项网页工具。

有意思的是提问方式。他没有直接罗列功能清单，而是让模型反过来问他——先由模型列出核心功能选项让他多选，再依次确认数据保存方式、界面风格和高级功能。选项不够用时还能手动补充需求。需求确认后，模型全自动完成开发，最终交付的网页工具覆盖了此前确认的全部功能。

这种「让 AI 先问再答」的交互技巧值得借鉴：需求边界越清晰，Agent 返工的概率越低。

另外，LongCat 的 flash thinking 模型也能在官网网页端直接使用，开启深度思考后可以调用多个「思考者」并行独立推理，再汇总结果，适合拆解复杂问题。

几点提醒

Claude Code 的生态变化很快，模型适配情况和免费额度政策可能随时调整，配置前建议先看官方文档的最新说明。跳过登录认证的配置项属于非官方用法，后续版本是否兼容存在不确定性。对国内新手来说，先用 IDE 插件 + 免费国产模型跑通流程，再决定是否深入，是成本最低的路径。