3 科研工具
本章介绍社科研究者使用 Claude Code 时推荐配置的核心工具。所有安装操作都通过 Claude Code 聊天框完成——你只需要复制下面的提示词,粘贴到 Claude Code 的对话框中,它就会帮你安装好一切。
本章的所有工具安装都在 Claude Code 聊天框中完成,不需要你自己打开终端。每条安装指令都包含验证步骤,Claude Code 会确认工具已正确安装并可全局使用。
3.1 快速配置
如果你不想逐个安装,可以依次将以下三个提示词复制到 Claude Code 聊天框中,快速完成本章的全部配置。
3.1.1 第一步:安装核心工具
这个提示词会一次性安装 Git、R、Pandoc、LaTeX、Typst、Quarto 六个工具:
帮我一次性安装以下所有工具。请按顺序逐个执行,每个工具安装完成后都要验证。
第 1 步:配置 Git 用户信息
- 用户名设为"你的名字",邮箱设为"你的邮箱"
- 运行 git config --global user.name 和 git config --global user.email 确认配置正确
第 2 步:安装 R 语言和社科常用包
- 运行 conda install -c conda-forge r-base r-tidyverse r-haven r-ggplot2 r-estimatr r-modelsummary -y
- 验证:运行 Rscript --version,再运行 which Rscript 确认全局可用
第 3 步:安装 Pandoc
- 运行 conda install -c conda-forge pandoc -y
- 验证:运行 pandoc --version,再运行 which pandoc 确认全局可用
第 4 步:安装 TinyTeX(轻量级 LaTeX)
- 运行 Rscript -e "install.packages('tinytex', repos='https://cran.r-project.org'); tinytex::install_tinytex()"
- 验证:运行 xelatex --version,再运行 which xelatex 确认全局可用
第 5 步:安装 Typst
- 运行 conda install -c conda-forge typst -y
- 验证:运行 typst --version,再运行 which typst 确认全局可用
第 6 步:安装 Quarto
- 运行 conda install -c conda-forge quarto -y
- 验证:运行 quarto --version,再运行 which quarto 确认全局可用
全部完成后,输出一个汇总表格,列出每个工具的名称、版本号、安装状态(成功/失败)。记得将第 1 步中的”你的名字”和”你的邮箱”替换为你自己的信息。
3.1.2 第二步:创建项目配置文件
工具装好后,为你的研究项目创建 CLAUDE.md 配置文件,让 Claude Code 了解项目背景:
帮我在项目根目录创建一个 CLAUDE.md 文件,包含项目说明、数据文件位置、分析规范和输出要求。CLAUDE.md 的详细说明和示例见 章节 4.1。
3.1.3 第三步:安装推荐技能扩展
最后,安装 Agent Skills 扩展 Claude Code 的工作流能力。推荐的 Skills 及安装方法见 章节 4.2.1。
完成以上三步后,本章的所有推荐配置就全部就绪了。如果你想了解每个工具的具体作用,或者只想安装其中几个,请继续阅读下面的逐项介绍。
3.2 配置 Git 用户信息
Git 是版本控制工具,Claude Code 用它来记录每一次代码修改。首次使用前需要配置你的身份信息。
在 Claude Code 聊天框中输入:
帮我配置 Git 用户信息。
- 用户名设为"你的名字"
- 邮箱设为"你的邮箱"
配置完成后,运行 git config --global --list 确认设置正确。这里的名字和邮箱是你自己定义的标识信息,类似于给自己建一个账号名。不必是真实姓名或真实邮箱,只要你看到时能认出是自己就行。
3.3 安装 R 语言环境
R 是社科研究者最常用的统计分析工具之一。
在 Claude Code 聊天框中输入:
帮我用 conda 安装 R 语言和以下社科常用包:r-base、r-tidyverse、r-haven、r-ggplot2、r-estimatr、r-modelsummary。
安装命令:conda install -c conda-forge r-base r-tidyverse r-haven r-ggplot2 r-estimatr r-modelsummary -y
安装完成后:
1. 运行 Rscript --version 验证 R 已安装
2. 运行 which Rscript 确认 Rscript 在系统 PATH 中可全局访问3.3.1 让 Claude Code 使用 R
安装完成后,Claude Code 可以直接调用 Rscript 执行 R 代码。为了让协作更顺畅,建议在项目的 CLAUDE.md 中说明你使用 R(详见 章节 4.1)。
在 VS Code 中安装 R 插件(REditorSupport)后,可以获得语法高亮、代码补全和数据框查看等功能。
3.4 安装 Pandoc
Pandoc 是文档格式转换工具,Claude Code 生成 Word、PDF 等文档时需要它。
在 Claude Code 聊天框中输入:
帮我用 conda 安装 Pandoc。
安装命令:conda install -c conda-forge pandoc -y
安装完成后:
1. 运行 pandoc --version 验证已安装
2. 运行 which pandoc 确认 pandoc 在系统 PATH 中可全局访问3.5 安装 LaTeX(TinyTeX)
LaTeX 是学术论文排版的标准工具,渲染 PDF 时需要它。TinyTeX 是一个轻量级 LaTeX 发行版,按需自动下载缺少的宏包,非常适合初次使用者。
在 Claude Code 聊天框中输入:
帮我通过 R 安装 TinyTeX(轻量级 LaTeX 发行版)。
安装命令:Rscript -e "install.packages('tinytex', repos='https://cran.r-project.org'); tinytex::install_tinytex()"
安装完成后:
1. 运行 xelatex --version 验证 LaTeX 已安装
2. 运行 which xelatex 确认 xelatex 在系统 PATH 中可全局访问
3. 运行 tlmgr --version 确认 LaTeX 包管理器可用如果你需要在 PDF 中使用中文,渲染时应使用 XeLaTeX 引擎。在 Quarto 文档的 YAML 头部加入 pdf-engine: xelatex 和 CJKmainfont: KaiTi 即可。
3.6 安装 Typst 与 Touying
Typst 是新一代排版工具,编译速度远快于 LaTeX,语法也更简洁。Touying 是基于 Typst 的学术幻灯片框架,适合制作课堂展示和学术报告。
3.6.1 安装 Typst
在 Claude Code 聊天框中输入:
帮我用 conda 安装 Typst。
安装命令:conda install -c conda-forge typst -y
安装完成后:
1. 运行 typst --version 验证已安装
2. 运行 which typst 确认 typst 在系统 PATH 中可全局访问3.6.2 使用 Touying 制作幻灯片
Touying 是 Typst 的包,无需单独安装——首次编译时会自动下载。你只需让 Claude Code 帮你创建一个幻灯片文件即可。
在 Claude Code 聊天框中输入:
帮我创建一个 Touying 幻灯片模板文件 slides.typ。
使用 Touying 0.7.1 版本和 metropolis 主题。
包含:标题页、一个目录页、两张示例内容页。
创建完成后运行 typst compile slides.typ 确认能成功编译为 PDF。Typst 与 LaTeX 的关系类似于”新工具 vs 传统工具”。投稿期刊通常要求 LaTeX/Word 格式,所以 LaTeX 仍然必要;但日常课堂展示、组会报告等场景,Typst + Touying 编写更快。
3.7 安装 Quarto
Quarto 是学术写作与可重复研究的发布工具,可以将包含 R 或 Python 代码的文档渲染为 PDF、Word、HTML 或幻灯片。它依赖 Pandoc 和 LaTeX(前面已安装)。
在 Claude Code 聊天框中输入:
帮我用 conda 安装 Quarto。
安装命令:conda install -c conda-forge quarto -y
安装完成后:
1. 运行 quarto --version 验证已安装
2. 运行 which quarto 确认 quarto 在系统 PATH 中可全局访问安装后,你可以让 Claude Code 帮你创建和渲染学术文档:
quarto render report.qmd --to docx— 输出为 Word 文档quarto render report.qmd --to pdf— 输出为 PDF
Quarto 的核心优势是”代码与文字一体”:在同一个 .qmd 文件里写论文正文、嵌入 R 分析代码、生成图表,最终一键输出为可投稿的 Word 或 PDF。