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

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

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

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

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

显示了claude版本号和模型

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

简单对比

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

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

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

那到底用哪个？

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

1. CLI 是 Claude Code 的"正主"
   ，所有官方文档、教程都默认你在用 CLI
2. 功能最全
   ：/init、/model、/plugin、/clear 这些斜杠命令在 CLI 里最完整
3. 稳定性更好
   ：面板版偶尔有 UI bug，CLI 不会
4. 更接近 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

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

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

欢迎大家交流学习