AI工具实践|经管文科小白用 VScode+Claude Pro 跑通 Claude Code,整理出这份小白避坑清单

终于用上CC了，这一刻是很开心的

前期一直因为网络原因，没有成功，踩了很多坑，浪费了很多时间。

今天给大家总结分享一下适合小白的操作流程

一、首先就是要有一个稳定的账号和网络

建议不要是新号，很容易封。我的账号是24年注册的，最近用着还算稳定。

其次就是科学上网，网络一定要纯净，很多被封就是网络不干净。

我前面就是因为网络问题，试了很多次，后面换了个干净的，就一下子成功了

网络一定要开TUN模式，优先选漂亮国以及它的铁小弟国，这俩是最稳定的（比较它俩是铁哥们）

建议从第一次开始，就认定一个国，切记换来换去的，会被怀疑你是中国的，然后就噶了。

接下来就是今天的主角CC了

第一步，词元（token），先给它准备好燃料

我本人还是想先试试原生的小克模型

看网上有人说最近API和反重力都不太稳定，这两个也比较费钱，还有claude官方的max5和max20一个月要一千人民币左右

所以我优先在小黄鱼上选了claude pro的直充服务，一个月100多点(对新手来说够用了。

一定要用在特别重要的任务上，我就是第一次没经验，竟然让CC给我自动安装stata18，我的密钥好像过期了，结果最后浪费了很多额度

第二步，在VSCODE里，安装CC

这步之前主要的准备工作是安装node.js、git、vs code，这几项工具我都是让trace帮我自动下载和配置的，也可以自己下载

然后打开claude code 打开终端terminal，把下面的命令直接复制进终端，按回车确定，系统就会自动开始安装Claudecode

代码：npm install -g @anthropic-ai/claude-code

安装CCSwitch配置（方面后期配置切换不同的模型，如果你像我一样直接用的claude pro，是不需要这个工具

安装好CC后，会自动跳转到浏览器，让你登录你的claude账号，直接登上，就能用了

小tips，记得这步之前先把浏览器默认为chrome浏览器，这样就能自动跳转，方便登录

本人后面踩坑点：

坑 1：你电脑里其实有"两个" Claude Code

如图，打开VS Code，你可能同时看到：

- 右边栏的 Claude Code 面板：聊天界面，VS Code 插件

- 左下方终端里输 `claude` 启动的命令行：Anthropic 官方命令行版（CLI）

显示了claude版本号和模型

这俩都是 Claude Code，是同一个工具的两种界面，关键区别在"用什么方式跟它对话"。

简单对比

方面	上：VS Code 面板版	下：终端 CLI 版
位置	VS Code 右侧栏的标签	VS Code 底部"终端"里
交互方式	图形界面，像聊天软件	纯文字，像命令行
文件 diff 显示	直接在 VS Code 编辑器里展示修改对比	在终端里打印文本对比
快捷键命令	通过界面按钮	输 `/` 调出（你截图下面那一长串就是）
后端模型	同一个 Claude	同一个 Claude
Pro 订阅额度	共用	共用

重点：这俩理论上应该是一回事

Anthropic 官方 Claude Code 既出了 CLI，也出了 VS Code 扩展，目的就是让你能选自己习惯的方式。它们：

共享你的 Claude Pro 账号认证
共享 ~/.claude/ 配置目录（包括 CLAUDE.md、skills 等）
模型选择、用量配额都打通

那到底用哪个？

我个人建议主用 CLI，原因：

CLI 是 Claude Code 的"正主"
，所有官方文档、教程都默认你在用 CLI
功能最全
：/init、/model、/plugin、/clear 这些斜杠命令在 CLI 里最完整
稳定性更好
：面板版偶尔有 UI bug，CLI 不会
更接近 Claude Code 原生体验

但面板版有一个独特优势：改文件时它会在 VS Code 编辑器里直接显示双栏 diff，可以一行一行看修改，比 CLI 在终端里打印文本对比更直观。

实操建议：日常对话、跑命令用 CLI；改大量文件、需要逐行 review 修改时切到面板版。两边状态是同步的，无缝切换。

坑 2：环境变量会"偷偷"绕过你的 Pro 订阅

如果你电脑上设过 `ANTHROPIC_API_KEY` 环境变量，Claude Code 会优先用这个 API key 而不是 Pro 订阅——结果就是你以为在用 $20/月的免费额度，其实在按 token 烧钱。

很多人是因为之前装过别的"AI 工具"或者"代理脚本"，环境变量被默默设上的。

自查方法

打开PowerShell，跑：

```powershell

echo $env:ANTHROPIC_API_KEY

echo $env:ANTHROPIC_BASE_URL

- ✅ 两条都输出空行 → 没问题，Claude Code 走 Pro 订阅

- ❌ 输出了一串字符或网址 → 就是它，去系统设置删掉

Windows 删除方法：右键"此电脑" → 属性 → 高级系统设置 → 环境变量 → 找到这两个变量删除 → 重启 VS Code 让改动生效。

坑 3：CLAUDE.md 必须在"根目录"，子文件夹无效，只能在子文件夹这个特定项目里用

`CLAUDE.md` 是 Claude Code 每次启动自动读取的项目配置文件，相当于给 AI 一份"入职手册"。对科研党来说这步是从"通用聊天工具"变成"懂你研究的助手"的关键。

我踩的坑

建错位置

我第一次让Claude帮建CLAUDE.md它建到了 `D:\DResearch\chain\CLAUDE.md`——一个子文件夹里。结果以后我开其他论文项目时，配置完全不生效。

正确位置：你 `cd` 启动 Claude Code 的那个目录的根上。

如果你在`D:\DResearch\` 启动 → CLAUDE.md 必须在 `D:\DResearch\CLAUDE.md`。

我现在的做法是：直接写一段长 prompt 把所有要求列清楚，让CC帮我建好，并写一份给我

怎么验证 CLAUDE.md 生效

启动Claude Code 后，第一句话别急着干活，先问：

`总结一下你刚才读到的CLAUDE.md 的核心内容。

- ✅ 它能复述出你的研究方向、目标期刊、方法工具箱 → 生效了**

- ❌ 它说"没看到 CLAUDE.md"或者复述错了 → 检查文件位置和内容

坑 4：装 Skills 一定要用完整 HTTPS 地址

Skills 是 Claude Code 的"扩展插件"，第三方做好的工作流。学术圈最实用的几个：

- Imbad0202/academic-research-skills —— 论文规划、模拟审稿、修改全流程

- flonat/claude-research—— 文献管理、Zotero 集成、参考文献验证

- Anthropic 官方 docx/xlsx/pptx skills —— 默认就有，输出 Word/Excel/PPT

我踩的坑：按教程写简写格式，撞 SSH 报错

按教程写：`

/plugin marketplace add Imbad0202/academic-research-skills

报错：

Failed to clone marketplace repository:

SSH host key is not in your known_hosts file.

Host key verification failed.

原因：用 `owner/repo` 简写时，Claude Code 默认走 SSH 协议 clone GitHub，但你电脑没配过 SSH key，所以拒绝连接。

正确写法：用完整 HTTPS URL

/plugin marketplace add https://github.com/Imbad0202/academic-research-skills

/plugin install academic-research-skills

HTTPS 写法适用于所有公开仓库，零配置零报错。

⚠️ 再次强调：`/plugin` 命令只能在 Claude Code CLI（终端版）里用。在 VS Code 插件里输会报 "/plugin isn't available in this environment"。

怎么切换

在Claude Code 里输：

/model

会列出可选模型，选你要的就行。

常用资源

官方：https://docs.claude.com/en/docs/claude-code/overview

官方 Skills 文档：https://code.claude.com/docs/en/skills

-记忆系统文档：https://code.claude.com/docs/en/memory

Skills 市场：https://www.skillsdirectory.com

-社区精选 Skills：https://github.com/anthropics/skills

（以上我的初级进阶复盘过程，后续精进了，会继续分享）

欢迎大家交流学习