Galaxy-Dawn/claude-scholar · 上手攻略

  • 仓库：Galaxy-Dawn/claude-scholar
  • 链接：https://github.com/Galaxy-Dawn/claude-scholar
  • 分类：ai-tool / research-assistant
  • 作者：Tom
  • 更新：2026-07-22

这是什么

Claude Scholar 是一个半自动化 AI 学术研究助手，面向计算机科学和 AI 研究者设计，核心功能覆盖文献调研、代码实验、报告撰写、论文写作和项目知识管理。它并非一个独立的 AI 模型或应用，而是一套 Claude Code / Codex / Kimi Code CLI / OpenCode 的技能（Skills）和工作流配置层，通过向这些编码 Agent 注入专用指令体系，让它们在科研场景下更专业、输出质量更高。

项目采用多分支架构： - main 分支：Claude Code 工作流 - codex 分支：OpenAI Codex CLI 工作流 - kimi 分支：Kimi Code CLI 工作流 - opencode 分支：OpenCode 工作流

核心依赖： - 编码 Agent（Claude Code 等，需自备 API Key 或订阅） - Zotero（文献管理，通过 MCP 集成） - Obsidian（个人知识库，可选） - Python 环境（pubfig / pubtab 等图表工具）

解决什么问题

AI 编码 Agent（如 Claude Code）在通用编程上很强，但直接用于学术研究有以下短板：

  1. 缺乏文献管理意识：不知道如何组织、引用、追踪文献
  2. 写作风格偏离学术规范：输出容易像博客而非论文
  3. 缺少实验记录和可复现性：代码、参数、结果散落各处
  4. 图表不符合发表标准：figure/table 格式粗糙，无法直接用于顶会论文
  5. 没有知识积累机制：每次新项目都从零开始

Claude Scholar 通过一套 30+ 专项 Skills 解决这些问题，每个 Skill 对应一个具体工作流（如 citation-verification、nature-writing、ml-paper-writing 等）。

快速安装

# 1. 克隆仓库（main 分支默认支持 Claude Code）
git clone https://github.com/Galaxy-Dawn/claude-scholar
cd claude-scholar

# 2. 切换到对应 Agent 分支（如果不用 Claude Code）
git checkout codex      # OpenAI Codex CLI
git checkout kimi       # Kimi Code CLI
git checkout opencode   # OpenCode

# 3. 将 CLAUDE.md（或对应分支的 CLAUDE.zh-CN.md）放入项目根目录
# 这告诉 Claude Code 本项目是学术研究项目
cp CLAUDE.md /path/to/your/research-project/CLAUDE.md
# 或中文版：
cp CLAUDE.zh-CN.md /path/to/your/research-project/CLAUDE.md

# 4. 启动 Claude Code 并在项目目录中
cd /path/to/your/research-project
claude

前提条件：已安装 Claude Code（curl -fsSL https://舌Claude.com/install.sh | sh，需自备 API Key 或 Pro 订阅）或其他支持的 Agent CLI。

可选：配置 Zotero MCP（文献管理）

在 Claude Code 中配置 Zotero MCP Server，使 Agent 能够直接查询和导入 Zotero 文献：

# 安装 zotero-mcp（如通过 Smithery 或手动配置）
# 在 ~/.claude.json 或项目 .claude/ 目录中配置 MCP Server

核心用法

研究工作流（核心 Skill 导航）

Claude Scholar 的工作流以证据合同（Research Contract） 为中心驱动力，主要分为以下阶段：

1. 想法与立项（Research Ideation）

  • daily-paper-generator：自动发现领域新论文（arXiv / bioRxiv），筛选 Top10 → Top3 → Top1
  • 通过 planning-with-files 维护研究计划的进度追踪

2. 文献调研（Literature Review）

  • obsidian-literature-workflow：将论文笔记沉淀到 Obsidian 知识库
  • citation-verification：验证引用准确性，防止虚假引用
  • zotero-mcp（通过 MCP 集成）：直接从 Zotero 导入文献

3. 代码实验（Coding & Experiments）

  • architecture-design：系统设计和架构评审
  • bug-detective：实验复现与 bug 排查
  • code-review-excellence：代码审查
  • git-workflow：实验可复现的 Git 管理规范

4. 论文写作（Paper Writing）

核心 Nature 系列 Skill（模拟 Nature 等顶刊写作风格）： - nature-writing：章节草稿和论点构建 - nature-polishing：文章精修 - nature-response：审稿人意见回复 - nature-data：数据呈现规范 - expression-skill：结论优先的表达纪律（结论先行的写作方式）

图表工具： - publication-chart-skill：基于 pubfig + pubtab 生成发表级图表 ```python # pubfig 示例（publication-grade figures） from pubfig import Figure, Panel

fig = Figure(width='single', height=3) fig.add_panel(Panel('accuracy_curve', title='Model Accuracy')) fig.save('fig1.pdf') ```

5. 发布管理（Publication）

  • doc-coauthoring：文档协作工作流

关键文件结构

claude-scholar/
├── CLAUDE.md               # Agent 核心指令（中文版：CLAUDE.zh-CN.md）
├── CLAUDE.codex.md        # Codex 分支指令
├── CLAUDE.kimi.md         # Kimi 分支指令
├── research-contract.md    # 证据记录与引用规范
├── skills/                # 30+ 专项 Skill 目录
│   ├── planning-with-files/
│   ├── nature-writing/
│   ├── citation-verification/
│   ├── obsidian-literature-workflow/
│   ├── publication-chart-skill/
│   └── ...                # 共 30+ 个 Skill
├── Sources/               # 论文笔记沉淀目录
├── Knowledge/             # 提炼后的知识库
└── Writing/              # 论文写作目录

典型使用示例

# 在研究项目中启动 Claude Code
cd ~/research/my-paper-project
claude

# 触发 daily paper 发现
@daily-paper-generator "LLM reasoning"

# 触发文献综述工作流
@citation-verification

# 触发论文写作
@nature-writing "Introduction"
@nature-polishing "related work section"

典型适用场景

场景 推荐 Skill
AI/ML 论文全流程 nature-writing + publication-chart + ml-paper-writing
文献调研与综述 obsidian-literature-workflow + citation-verification + daily-paper-generator
实验复现与代码审查 architecture-design + bug-detective + code-review-excellence
Zotero 文献管理增强 obsidian-kb-artifacts + Zotero MCP 集成
顶会投稿准备 nature-polishing + nature-response + publication-chart-skill
每日 arXiv 追踪 daily-paper-generator（支持宽泛主题）

坑与注意

  1. API Key 自备：Claude Code 等 Agent 本身需要订阅或 API Key，Claude Scholar 不提供 AI 能力
  2. 分支选错等于白装：main 分支对应 Claude Code，codex/kimi/opencode 需分别 checkout 到对应分支再使用
  3. 本地 md 文件需手动合并：README 明确说明，如果研究项目已有本地 .md 文件，需要人工合并而非自动覆盖
  4. Zotero 依赖外部 MCP：Zotero 集成需要配置 zotero-mcp，属于可选而非开箱即用
  5. Obsidian 非必须：Obsidian KB 工作流是可选的，不装 Obsidian 也能用其他 Skill
  6. Skill 版本依赖上游更新：nature-polishing 等 Skill 依赖上游 article-pattern 发布，更新不及时可能导致风格陈旧
  7. 安装时建议备份：运行安装脚本前建议对研究项目做 Git 备份，避免 CLAUDE.md 覆盖冲突
  8. 中文研究者注意：README 有 CLAUDE.zh-CN.md 中文版，但没有简体中文完整文档（大量 Skill README 是英文）

与同类对比

维度 Claude Scholar AutoGen / CrewAI LangChain Agents Zotero GPT
定位 学术研究全流程助手 多 Agent 协作编程 LLM 应用开发框架 Zotero 文献增强
核心能力 论文写作 + 文献管理 + 实验追踪 多 Agent 任务分解协作 工具链组合 + 记忆 文献 Q&A
Agent 集成 Claude Code / Codex / Kimi / OpenCode 自有 Agent 框架 多种 LLM 仅 Zotero 插件
学术写作 Nature 系列 Skill，深度适配 无 无 无
文献管理 Zotero + Obsidian 深度集成 无 无 Zotero 原生
图表工具 pubfig + pubtab（发表级） 无 无 无
学习曲线 中等（需理解 Skill 体系） 中等 较高（LangChain 本身复杂） 低（即装即用）

核心差异：Claude Scholar 不是另一个 Agent 框架，而是基于已有最强编码 Agent 的科研增强层；它的价值在于把科研工作流的领域知识编码成 Agent 可调用的 Skill，而非重新发明 Agent。

一句话推荐结论

如果你已经用 Claude Code（或 Codex/Kimi/OpenCode）做研究，Claude Scholar 是目前将学术写作规范、文献管理、图表生产整合进 Agent 工作流最完整的开源方案——上手只需把 CLAUDE.md 拷进项目，推荐先从 nature-writing + daily-paper-generator 开始体验渐进式价值。