如何配置AI辅助研究环境

适用于经济学、社会科学及相关领域研究者 · macOS & Windows

本指南帮助你从零开始,搭建以 Claude Code 为核心的AI辅助学术研究工作台。完成全部步骤后,你将拥有:

适用系统: macOS 12+ · Windows 10+
所需时间: 约 1–2 小时(取决于网络速度)

Step 0配置 Python 环境

Python 是数据分析的基础语言。我们使用 Miniforge(conda 的轻量社区版)来管理 Python 环境,避免版本冲突。

  1. 访问 conda-forge.org/download,下载对应芯片的安装包:
    • Apple Silicon(M1/M2/M3/M4)Miniforge3-MacOSX-arm64.sh
    • Intel MacMiniforge3-MacOSX-x86_64.sh
    不知道芯片类型?点击左上角苹果菜单 → "关于本机"查看。
  2. 打开终端(启动台搜索"终端",或按 Cmd+Space 输入 Terminal),运行:
    # Apple Silicon
    bash ~/Downloads/Miniforge3-MacOSX-arm64.sh
    
    # Intel Mac
    bash ~/Downloads/Miniforge3-MacOSX-x86_64.sh
    按提示输入 yes 并按 Enter,一路确认。
  3. 安装完成后,关闭并重新打开终端。若提示符前出现 (base),说明 conda 已成功激活。
  4. 创建专用数据科学虚拟环境:
    conda create -n datasci python=3.10
    conda activate datasci
    conda install pandas numpy scipy scikit-learn matplotlib seaborn jupyter
验证:在终端运行 python --version,显示 Python 3.10.x 即成功。
  1. 访问 conda-forge.org/download,下载 Miniforge3-Windows-x86_64.exe
  2. 双击安装包,按图形界面指引安装:
    • 建议勾选 "Add Miniforge3 to PATH environment variable"(方便命令行使用)
    • 其余选项保持默认
  3. 安装完成后,从开始菜单搜索并打开 "Miniforge Prompt"(注意:不是 PowerShell 或 CMD)。
  4. 在 Miniforge Prompt 中创建环境:
    conda create -n datasci python=3.10
    conda activate datasci
    conda install pandas numpy scipy scikit-learn matplotlib seaborn jupyter
验证:在 Miniforge Prompt 运行 python --version,显示 Python 3.10.x 即成功。
↑ 返回顶部

Step 1安装编辑器(VS Code)

VS Code 是 Claude Code 的主要工作台,你通过它与 AI 对话、编写代码、管理项目文件。

备选方案:Trae IDE(字节跳动出品,内置 AI,界面与 VS Code 相似)。两者选一即可,本指南以 VS Code 为主。
  1. 访问 code.visualstudio.com,下载 macOS 版(.dmg)。
  2. 打开 .dmg,将 Visual Studio Code 拖拽到"应用程序"文件夹。
  3. 首次打开时,若系统提示"来自互联网的应用",点击"打开"即可。
  4. 打开 VS Code,点击左侧 Extensions(扩展) 图标,搜索并安装:
    • Python(Microsoft 出品)
    • Jupyter(Microsoft 出品)

测试 Jupyter 环境

  1. 新建文件,保存为 test.ipynb(注意后缀 .ipynb
  2. 点击右上角 "Select Kernel""Python Environments..." → 选择 datasci (Python 3.10.x)
  3. 在代码块输入测试代码并运行:
import pandas as pd
import numpy as np

df = pd.DataFrame(np.random.randn(5, 3), columns=['收入', '消费', '储蓄'])
print("Python 环境正常!")
print(df.describe())
✅ 若看到描述性统计数据,环境配置成功。
  1. 访问 code.visualstudio.com,下载 Windows 版(.exe)。
  2. 双击安装包,建议勾选:
    • "Add to PATH"(命令行输入 code . 可打开当前文件夹)
    • "Register Code as an editor for supported file types"
  3. 打开 VS Code,点击左侧 Extensions(扩展) 图标,搜索并安装:
    • Python(Microsoft 出品)
    • Jupyter(Microsoft 出品)

测试 Jupyter 环境

  1. 新建文件,保存为 test.ipynb
  2. 点击右上角 "Select Kernel""Python Environments..." → 选择 datasci (Python 3.10.x)
  3. 在代码块输入测试代码并运行:
import pandas as pd
import numpy as np

df = pd.DataFrame(np.random.randn(5, 3), columns=['收入', '消费', '储蓄'])
print("Python 环境正常!")
print(df.describe())
✅ 若看到描述性统计数据,环境配置成功。
↑ 返回顶部

Step 2安装 Node.js

Claude Code 需要 Node.js 运行环境。Node.js 相当于 Claude Code 与你电脑之间的"翻译官"。

方式一(推荐):通过 Homebrew 安装

若尚未安装 Homebrew,先在终端运行(仅需一次):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

然后安装 Node.js:

brew install node

方式二:直接下载安装包

访问 nodejs.org/en/download,下载 macOS Installer(.pkg),双击安装。

验证:终端运行 node -vnpm -v,均显示版本号即成功(如 v22.x.x)。
  1. 访问 nodejs.org/en/download,下载 Windows Installer (.msi)(选 LTS 版本)。
  2. 双击安装,按默认选项一路 Next 即可。
  3. 安装完成后,打开 PowerShell(按 Win 键,输入 PowerShell,回车),验证:
    node -v
    npm -v
常见报错:脚本执行策略限制
若看到 "无法加载文件,因为在此系统上禁止运行脚本",执行以下修复(约1分钟):
  1. 右键开始菜单"Windows PowerShell(管理员)"(或"终端(管理员)")
  2. 运行:
    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine
    提示确认时按 Y + 回车
  3. 重新打开普通 PowerShell,再次运行 npm -v
若仍报错:Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
验证node -vnpm -v 均显示版本号即成功。
↑ 返回顶部

Step 3安装 Git

Git 是版本管理工具,Claude Code 需要它来下载依赖和管理项目文件。

打开终端,运行:

git --version

或通过 Homebrew 安装最新版:

brew install git
  1. 访问 git-scm.com/downloads,点击 "Download for Windows"
  2. 双击安装包,推荐选项:
    • "Adjusting your PATH environment" → 选 "Git from the command line and also from 3rd-party software"
    • 其余选项保持默认
  3. 安装完成后,PowerShell 验证:
    git --version
✅ 显示版本号(如 git version 2.44.0.windows.1)即成功。
↑ 返回顶部

Step 4安装 Claude Code

Claude Code 是本套工作流的核心 AI 引擎,通过命令行和 VS Code 插件与你互动。

打开终端,运行:

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

输入系统密码(输入时字符不显示,属正常现象),按回车。等待安装完成(约1-3分钟)。

验证:终端运行 claude,若弹出欢迎界面或登录提示,安装成功。

打开 PowerShell,运行:

npm install -g @anthropic-ai/claude-code
下载缓慢?使用国内镜像:
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
验证:PowerShell 运行 claude,若弹出欢迎界面或登录提示,安装成功。

网络代理配置(中国大陆必看)

由于 Anthropic 服务器在境外,国内直连时常出现以下报错:

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUEST
Please check your internet connection and network settings.

解决方法:在运行 claude 之前,设置代理环境变量。通常 VPN 本地端口为 7890,请先在 VPN 客户端确认端口号。

export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"
claude

若需永久生效(每次打开终端自动设置):

echo 'export HTTP_PROXY="http://127.0.0.1:7890"' >> ~/.zshrc
echo 'export HTTPS_PROXY="http://127.0.0.1:7890"' >> ~/.zshrc
source ~/.zshrc
$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"
claude

若需永久生效(以管理员身份运行 PowerShell):

[System.Environment]::SetEnvironmentVariable("HTTP_PROXY", "http://127.0.0.1:7890", "User")
[System.Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://127.0.0.1:7890", "User")

重启终端后生效。

↑ 返回顶部

Step 4.5替代与补充:Google Antigravity 与 Gemini 配置

Google Antigravity 是谷歌推出的一款面向开发者、以 AI Agent(智能体)为核心的下一代 AI 辅助编程与开发平台。

它不再只是像传统编辑器侧边栏里塞一个简单的 AI 聊天框,而是让 AI Agent 具备高度自主性:

简单来说,它是谷歌用来对标 Cursor、Windsurf 以及 GitHub Copilot Workspace 的重量级 AI 编程生态。

下载 Antigravity 2.0 与 Antigravity IDE

  1. 访问 Google Antigravity 官网,查找最新版本下载入口。
  2. 下载并安装 Antigravity 2.0 桌面客户端,该客户端适用于 macOS 与 Windows。
  3. 如果你希望在一个代码编辑器内使用 Antigravity,选择下载并安装 Antigravity IDE,它基于 VS Code 深度定制,并整合了 Antigravity 的 Agent 管理器和任务面板。
  4. 安装完成后,打开 Antigravity IDE,按指引登录 Google 账号并授权访问。

配置并接入 Gemini

  1. 账户登录与激活:首次打开 Antigravity IDE 时,系统会弹出欢迎向导,点击 Login with your Google account
  2. 注意:登录你拥有 Google One AI Premium(包含 Gemini Advanced 权益)或 Google Cloud / AI Studio 权限的 Google 账号。它会自动识别并激活你的高级 Token 额度。
  3. 如果你是高校用户,可以通过学校的 Google Workspace 教育账户、学院合作协议或校园 Google Cloud 教育计划,申请并免费使用 Google Gemini Pro。许多高校在 Google for Education 或 Cloud 教育计划下会为教师和学生提供免费的 Gemini Pro 试用额度。
  4. 登录成功后,进入 Antigravity IDE 的设置页面,查找 GeminiAI Model 选项,选择 Gemini Advanced / Gemini Pro,并确认模型已激活。
  5. 在需要时,打开 Antigravity 的 Agent Manager,创建新的 Agent 任务并指定目标,如“生成后端登录接口”、“编写前端页面”、“运行自动化测试”等。
Tip:Antigravity 的核心优势在于“由你下高层指令,AI 自动拆解并执行”。使用时,先写清楚目标和验收标准,例如“搭建一个用户登录页面,支持用户名密码登录,数据库存储使用 PostgreSQL,完成后运行接口测试并截图”。
可折叠:Antigravity IDE + Gemini 与 VS Code + Claude 的区别

Antigravity IDE + Gemini 可以作为 VS Code + Claude 的替代方案,但它们的工作方式并不完全相同:

验证 Antigravity 与 Gemini 是否接入成功

在 Antigravity IDE 中创建一个简单任务,例如“使用 Gemini Pro 生成一个 Flask 后端服务,并运行一次本地测试”。如果它能自动创建任务、生成代码、执行服务并给出测试结果,则说明配置成功。

↑ 返回顶部

Step 5安装 VS Code 插件

安装 Claude Code 的 VS Code 插件,实现在编辑器内直接与 AI 对话。

  1. 打开 VS Code,点击左侧 Extensions(扩展) 图标。
  2. 搜索 "Claude Code",找到 "Claude Code for VS Code"(Anthropic 官方出品),点击 Install。
  3. 安装后,VS Code 左侧边栏会出现 Claude Code 图标(圆形 C 标志)。
✅ 点击侧边栏 Claude Code 图标,弹出对话面板即安装成功。
↑ 返回顶部

Step 6配置 API 与登录

方式一:使用 Claude 官方账号(推荐)

Claude Code 支持 Claude Pro / Max / Team / Enterprise 订阅账号直接登录,无需单独购买 API 额度。

  1. 在终端或 VS Code 中运行 claude
  2. 选择登录方式时,选 第1项
    ❯ 1. Claude account with subscription · Pro, Max, Team, or Enterprise
      2. Anthropic Console account · API usage billing
      3. 3rd-party platform · Amazon Bedrock, Microsoft Foundry, or Vertex AI
  3. 按提示在浏览器中完成账号授权,返回终端即完成登录。
  4. VS Code 中的 Claude Code 插件会同步可用。
购买渠道:官方订阅在 claude.ai 购买。国内有代购渠道,请注意甄别风险,选择信誉良好的服务商。

方式二:使用国内第三方 API(替代方案)

若无法访问官方订阅,可使用国内兼容 Claude API 协议的服务,如 MiniMaxDeepSeek

利弊说明:国内服务通常无需代理且更稳定,但模型能力可能与官方 Claude 有差异,且服务商资质需自行判断。
  1. 访问 platform.minimaxi.com,注册并选择套餐。
  2. 在个人中心找到 API Key(格式:sk-...),复制备用。
  3. 在 VS Code 中按:
    • Windows:Ctrl+Shift+P
    • Mac:Cmd+Shift+P
    输入 "Preferences: Open User Settings (JSON)",回车,打开配置文件。
  4. 填入以下配置(将 YOUR_MINIMAX_API_KEY 替换为实际密钥):
    {
      "claudeCode.allowDangerouslySkipPermissions": true,
      "claudeCode.environmentVariables": [
        {
          "name": "ANTHROPIC_BASE_URL",
          "value": "https://api.minimaxi.com/anthropic"
        },
        {
          "name": "ANTHROPIC_AUTH_TOKEN",
          "value": "YOUR_MINIMAX_API_KEY"
        },
        {
          "name": "API_TIMEOUT_MS",
          "value": "3000000"
        },
        {
          "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
          "value": "1"
        },
        {
          "name": "ANTHROPIC_MODEL",
          "value": "MiniMax-M2"
        },
        {
          "name": "ANTHROPIC_SMALL_FAST_MODEL",
          "value": "MiniMax-M2"
        }
      ],
      "claudeCode.selectedModel": "MiniMax-M2",
      "claudeCode.disableLoginPrompt": true
    }
  5. 完全关闭并重新打开 VS Code(不重启配置不生效)。
  1. 访问 platform.deepseek.com,注册并获取 API Key。
  2. 快速配置(命令行):
    export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
    export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>
    export ANTHROPIC_MODEL=deepseek-v4-pro
    export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro
    export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro
    export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
    export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
    export CLAUDE_CODE_EFFORT_LEVEL=max
    claude
  3. 或通过 VS Code 配置文件永久生效:
    {
      "claudeCode.environmentVariables": [
        {
          "name": "ANTHROPIC_BASE_URL",
          "value": "https://api.deepseek.com/anthropic"
        },
        {
          "name": "ANTHROPIC_AUTH_TOKEN",
          "value": "YOUR_DEEPSEEK_API_KEY"
        },
        {
          "name": "ANTHROPIC_MODEL",
          "value": "deepseek-v4-pro"
        },
        {
          "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
          "value": "deepseek-v4-pro"
        },
        {
          "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
          "value": "deepseek-v4-pro"
        },
        {
          "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
          "value": "deepseek-v4-flash"
        },
        {
          "name": "CLAUDE_CODE_SUBAGENT_MODEL",
          "value": "deepseek-v4-flash"
        },
        {
          "name": "CLAUDE_CODE_EFFORT_LEVEL",
          "value": "max"
        }
      ]
    }
    关键说明:
    https://api.deepseek.com/anthropic — Claude API 兼容端点
    deepseek-v4-pro — 主模型,性能与 Claude 3.5 Sonnet 相近
    deepseek-v4-flash — 快速模型,适合子代理
  4. 完全关闭并重新打开 VS Code(不重启配置不生效)。

验证配置

重启 VS Code 后,打开 Claude Code 面板,输入:

你好,你是谁?你使用的是哪个模型?请简述双重差分法(DID)的基本原理。

若 AI 正常回复,配置完成。

↑ 返回顶部

附录 AStata Workbench 配置

Stata Workbench 插件让你在 VS Code 中直接运行 Stata 代码,并由 Claude Code 辅助调试。

  1. 打开 VS Code Extensions,搜索 "Stata Workbench",安装。
  2. 成功连接后,右下角状态栏会显示 "Stata Workbench: Connected"

若未自动连接,需手动配置 Stata 路径。打开 User Settings (JSON),添加:

{
  "stata-workbench.stataPath": "/Applications/Stata/StataMP.app/Contents/MacOS/StataMP",
  "stata-workbench.mcp.stataPath": "/Applications/Stata/StataMP.app/Contents/MacOS/StataMP"
}
路径以实际安装位置为准。不确定?直接告诉 Claude Code:"请帮我配置 Stata Workbench 的路径",AI 会自动检测。
{
  "stata-workbench.stataPath": "C:\\Program Files\\Stata19\\StataMP-64.exe",
  "stata-workbench.mcp.stataPath": "C:\\Program Files\\Stata19\\StataMP-64.exe"
}
若安装路径不同(如 Stata 18 或 SE 版),相应修改版本号和文件名。

测试

新建文件,将文件语言切换为 Stata(右下角点击"纯文本" → 搜索 Stata),输入:

sysuse auto, clear
summarize

点击运行按钮,若看到统计输出,配置成功。

↑ 返回顶部

附录 BLaTeX 环境配置

LaTeX 是学术论文排版的标准工具。完整环境由两部分组成:发行版(编译引擎)和编辑器(前端界面)。

一、安装发行版(编译引擎)

访问 tug.org/mactex,下载 MacTeX.pkg(约 4.5 GB,包含完整 TeX Live)。

或通过 Homebrew 安装(便于日后更新):

brew install --cask mactex
✅ 验证:终端运行 xelatex --version,显示版本号即成功。
  1. 访问 tug.org/texlive,点击 "install TeX Live over the Internet",下载 install-tl-windows.exe
  2. 运行安装器,选择 "Full scheme"(推荐,包含所有宏包,约 5 GB)。
  3. 等待安装完成(视网络速度约 30–90 分钟)。
网络较慢?选择国内镜像:安装时点击 "Change",将安装源切换为清华源(mirrors.tuna.tsinghua.edu.cn)或中科大源。
✅ 验证:PowerShell 运行 xelatex --version,显示版本号即成功。

二、安装编辑器

推荐以下两种方案(任选其一):

编辑器 特点 下载地址
TeXstudio 专为 LaTeX 设计,功能全面,自带代码补全,实时预览;新手友好 texstudio.org
VS Code + LaTeX Workshop 与 Claude Code 无缝集成,可在 AI 辅助下编写 LaTeX;适合已用 VS Code 的用户 在 Extensions 搜索 "LaTeX Workshop"(James Yu 出品)
↑ 返回顶部

常见问题

conda activate 报错 "conda: command not found"(Mac)
source ~/miniforge3/etc/profile.d/conda.sh
conda activate datasci

若要永久修复,将上面第一行添加到 ~/.zshrc

VS Code 找不到 Python 解释器

Cmd/Ctrl+Shift+P → 输入 "Python: Select Interpreter" → 选择 datasci (Python 3.10.x)

claude 命令运行后一直转圈不动

通常是代理端口号不对。在 VPN 客户端设置中确认本地监听端口(常见:789010808080),修改代理设置中的端口号再试。

安装 Claude Code 时报 "EACCES: permission denied"(Mac)

方法一:加 sudo

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

方法二:重新设置 npm 全局目录:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g @anthropic-ai/claude-code
VS Code 配置文件有多个大括号,如何合并?

User Settings (JSON) 文件只能有一个顶层 {} 对象。若已有其他配置,将新增字段并入同一个 {} 内,用逗号分隔,不要出现两个独立的 {...}

↑ 返回顶部