零基础使用 Claude Code 写论文完全指南（macOS 专属）

本文档面向没有编程经验的 macOS 用户，手把手教你用 Claude Code 辅助写学术论文。全程不需要写代码，只需要会用电脑和浏览器。

Part 0：快速了解

Claude Code 是什么？

Claude Code 是一个AI 编程助手，你可以在电脑里直接用"说话"（打字）的方式让它帮你做事。

写论文的场景下，你可以让它：

帮你整理文献笔记
帮你起草论文段落
帮你调整格式、排版
帮你翻译中英文内容
帮你检查语法和逻辑

整个流程长什么样？

你打字告诉 Claude Code 你想做什么
        ↓
Claude Code 帮你完成（写内容、改格式、查文献）
        ↓
你检查满意后保存，就是一篇论文

你不需要写任何代码，全程用自然语言（中文或英文）对话即可。

Part 1：基础操作（最重要的部分）

先学会用，再配置高级功能。 这部分是你每天都会用到的操作。

1.1 打开 Claude Code

安装完成后，在 VS Code 中打开 Claude Code 的方式：

打开 VS Code
点击菜单栏的 终端（Terminal） → 新建终端（New Terminal）
在终端里输入 claude 然后按回车

你会看到 Claude Code 启动，出现一个对话界面。

1.2 和 Claude Code 对话

就像跟 ChatGPT 聊天一样，直接在终端里打字提问：

你好，请帮我写一段关于"气候变化对农业影响"的论文引言，大约500字。

Claude Code 会开始工作，你会看到它实时输出内容。

1.3 让 Claude Code 创建/编辑文件

你可以直接让它生成文件：

请帮我创建一个 Word 文档格式的论文草稿，标题是"气候变化对农业的影响"，包含摘要、引言、正文和结论部分。

提示：Claude Code 可以直接创建和编辑 .md（Markdown）文件、.txt 文件、.docx 文件等。

1.4 选行编辑：针对特定段落精确修改

这是最常用、最高效的编辑方式之一。当你对论文的某个段落不满意时，不需要从头描述要改哪里，只需选中那段文字，Claude Code 就会知道你要改的是哪一段。

操作步骤：

在 VS Code 中打开你要修改的论文文件
用鼠标拖选（或按住 Shift + 方向键）选中你想修改的那段文字
在 Claude Code 对话面板中输入你的修改指令，发送
Claude Code 会自动识别你选中的内容，并按照你的指示修改它

示例场景：

你选中的内容	你输入的指令
一段引言草稿	“请把这段润色一下，语言更学术正式一些”
一段中文描述	“请把这段翻译成学术英语”
一段论证	“请检查这段的逻辑是否严密，并指出问题”
一段方法描述	“请把这段扩写到300字，补充实验细节”
一段很长的内容	“请把这段压缩到100字以内，保留核心观点”
一段不确定的表述	“这段话的论证够不够有力？请给出修改建议”

为什么要选行？
如果你只说"请润色第二段"，Claude Code 需要自己判断哪是第二段，可能改错地方
选中后发送指令，Claude Code 精确知道你要改哪一段，不会误改其他内容
适合精细打磨论文的每个段落

1.5 常用命令速查

你想做什么	对 Claude Code 说什么
创建一个新文件	“请帮我创建一个叫 xxx.md 的文件，内容是……”
修改已有文件	“请打开 xxx.md，帮我修改第二段，把……”
翻译内容	“请把这段英文翻译成中文：……”
检查语法	“请检查 xxx.md 的语法和拼写错误”
调整格式	“请帮我调整 xxx.md 的格式，让标题层级更清晰”
查找资料	“请帮我搜索关于 xxx 的最新研究进展”
合并两个文件	“请把 xxx.md 和 yyy.md 合并成一个文件”

1.6 退出 Claude Code

在 Claude Code 对话中输入：

/quit

或者直接按 Ctrl + C（Mac 上是 Control + C）退出。

1.7 文件存在哪里？

Claude Code 创建的文件会保存在你当前所在的文件夹里。在 VS Code 左侧的文件浏览器中可以看到所有文件。

建议：每次写论文前，先用 VS Code 打开一个专门的论文文件夹：

在桌面新建一个文件夹，比如叫 我的论文
在 VS Code 中点击 文件（File） → 打开文件夹（Open Folder）
选择你刚建的文件夹

这样所有论文相关的文件都会整齐地放在这个文件夹里。

Part 2：下载并安装 VS Code

2.1 什么是 VS Code？

VS Code（全称 Visual Studio Code）是一个免费的文本编辑器，由微软开发。它是我们跟 Claude Code 对话的"窗口"。

2.2 下载步骤

打开浏览器，访问 VS Code 官网：
https://code.visualstudio.com/
网站会自动识别你的操作系统，点击蓝色的 Download 按钮
下载完成后，双击安装包进行安装：
- 双击下载的 .zip 文件解压
- 把 Visual Studio Code.app 拖到 应用程序（Applications） 文件夹
- 打开 Launchpad（或按 Cmd + 空格 打开搜索），输入 Visual Studio Code 然后回车启动

2.3 首次打开 VS Code

打开 VS Code 后，你会看到一个欢迎页面
不需要做任何特殊设置，直接进入下一步

2.4 （可选）安装中文语言包

如果 VS Code 界面是英文的，想切换成中文：

按快捷键 Cmd + Shift + P
输入 Configure Display Language 然后回车
选择 zh-cn 中文（简体）
重启 VS Code

Part 3：下载 Claude Code 并配置 API Key

重要提示：本指南使用第三方 API Key 方式，而非 Anthropic 官方订阅。这样可以降低成本。

3.1 什么是 API Key？

API Key 就像是一把"钥匙"，让你能使用 Claude 的能力。你需要：

API URL：服务器的地址（告诉软件去哪连接 Claude）
API Key：你的身份凭证（告诉服务器你是谁）

这两样东西需要你自己从第三方服务商那里获取（比如硅基流动、302AI、百炼等）。

3.2 获取第三方 API Key

选择一个 API 服务商，注册账号后获取你的 Key。以下列举几个常用的：

服务商	官网	说明
硅基流动	https://cloud.siliconflow.cn/	国内可用，价格较低
302.AI	https://302.ai/	国内可用，支持多种模型
阿里云百炼	https://bailian.console.aliyun.com/	阿里云服务

注册后，在服务商的控制台找到 API Key（通常是一长串字母数字），复制保存好。

同时记录下 API URL（Base URL），例如：

硅基流动：https://api.siliconflow.cn/v1
302.AI：https://api.302.ai/v1

3.2 安装 Homebrew（macOS 必备软件管理器）

Homebrew 是 macOS 上的软件包管理器，简单来说就是一个"应用商店"，但它是通过命令行来安装软件的。安装它之后，你只需要一条命令就能安装 Claude Code，不用去网上下载安装包。

步骤一：打开终端

macOS 自带了终端程序，打开方式有两种：

用搜索打开：
- 按 Cmd + 空格 打开聚焦搜索（Spotlight）
- 输入 终端 或 Terminal
- 按回车打开
从文件夹打开：
- 打开 访达（Finder）
- 点击左侧的 应用程序（Applications）
- 进入 实用工具（Utilities） 文件夹
- 双击 终端（Terminal）

步骤二：安装 Homebrew

在终端中复制粘贴以下命令，然后按回车：

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

这个过程可能需要几分钟，终端会显示安装进度。

安装过程中可能会提示你输入 Mac 的开机密码。输入时屏幕上不会显示任何字符，这是正常的，输完直接按回车即可。

步骤三：验证安装是否成功

安装完成后，在终端中输入：

brew --version

如果显示了版本号（类似 Homebrew 4.x.x），说明安装成功。

如果安装失败：可能是网络问题（Homebrew 的服务器在国外）。可以尝试：
连接一个稳定的网络
或者使用国内镜像源安装（搜索"Homebrew 国内镜像安装"）
或者跳过 Homebrew，使用下面的 npm 方式安装 Claude Code

3.3 安装 Claude Code

有两种方式，推荐使用 Homebrew 方式（如果你已经装好了 Homebrew）。

方式一：使用 Homebrew（推荐）

在终端中输入以下命令：

brew install claude-code

等待安装完成即可，一条命令搞定。

方式二：使用 npm（备选）

如果你没有安装 Homebrew，或者安装失败，可以用这种方式：

先安装 Node.js：访问 https://nodejs.org/，下载 LTS 版本并安装

安装完成后，在终端中运行：

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

3.4 配置 API Key 和 URL（写入文件方式）

这是推荐的方式，配置一次后永久生效，不用每次重新设置。

方式一：通过环境变量文件（推荐）

在你的论文文件夹下，创建一个叫 .env 的文件
用 VS Code 打开这个 .env 文件，写入以下内容：

# API 服务商的 Base URL
ANTHROPIC_BASE_URL=https://api.siliconflow.cn/v1

# 你的 API Key（替换成你自己的）
ANTHROPIC_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 指定使用的模型（可选，根据服务商支持的模型填写）
ANTHROPIC_MODEL=claude-sonnet-4-6-20250514

注意：
ANTHROPIC_BASE_URL 填写你的服务商提供的地址
ANTHROPIC_API_KEY 填写你复制的 API Key
ANTHROPIC_MODEL 填写你想使用的模型名称，询问你的服务商

方式二：通过 Claude Code 配置文件

在终端中运行：
```
claude
```

Claude Code 启动后，直接对它说：

请帮我把 API URL 设置为 https://api.siliconflow.cn/v1，API Key 设置为 sk-xxxxx

Claude Code 会自动帮你写入配置文件

方式三：通过 VS Code 设置

在 VS Code 中按 Cmd + , 打开设置
搜索 terminal.integrated.env
添加环境变量（具体操作让 Claude Code 帮你完成）

3.5 验证配置是否成功

在终端中输入：

claude

如果 Claude Code 成功启动并进入对话模式，说明配置正确。

你可以试着对它说：

你好，请帮我写一首关于春天的小诗。

如果它能正常回复，说明 API Key 和 URL 都配置成功了。

3.6 安全提示

不要把 .env 文件分享给别人
不要把 API Key 发到网上或群聊里
如果怀疑 Key 泄露，立即到服务商后台重新生成

Part 4：安装 VS Code 插件

4.1 推荐安装的插件

插件名称	用途	安装方式
Claude Code	在 VS Code 侧边栏直接使用 Claude	插件市场搜索 “Claude Code”
Markdown All in One	增强 Markdown 编辑体验	插件市场搜索 “Markdown All in One”
Markdown Preview Enhanced	实时预览 Markdown 文件	插件市场搜索 “Markdown Preview Enhanced”
Word Count Cycler	显示论文字数统计	插件市场搜索 “Word Count”
Chinese (Simplified)	VS Code 中文界面	插件市场搜索 “Chinese”

4.2 安装插件的步骤

在 VS Code 中，点击左侧活动栏的扩展图标（四个方块拼在一起的图标），或用快捷键 Cmd + Shift + X
在搜索框中输入插件名称，比如 Claude Code
找到对应的插件，点击蓝色的 Install（安装） 按钮
安装完成后，部分插件可能需要重启 VS Code 才能生效

4.3 Claude Code 插件的使用

安装 Claude Code 插件后：

点击 VS Code 左侧边栏中的 Claude Code 图标
会出现一个对话面板
直接在面板里输入你想要的内容，跟聊天一样

使用插件的好处是不用每次都打开终端，直接在侧边栏对话即可。

Part 5：连接 Zotero 文献管理

这部分稍微复杂一些，建议先熟悉基本操作后再来配置。

5.1 什么是 Zotero？

Zotero 是一个免费的文献管理工具，可以：

收藏和管理你从网上看到的论文
自动生成参考文献格式
给论文打标签、写笔记

官网：https://www.zotero.org/

5.2 为什么需要连接 Zotero？

写论文时你需要引用大量文献。如果能把 Zotero 里的文献信息提供给 Claude Code，它就能：

帮你整理文献摘要
帮你写文献综述
帮你生成引用格式
基于你已有的文献起草论文内容

5.3 方式一：导出 Zotero 文献给 Claude Code 阅读（最简单）

这是最推荐新手的方式，不需要额外配置。

步骤：

在 Zotero 中导出文献：
- 打开 Zotero
- 选中你想用的文献（可以多选）
- 右键点击 → 导出条目（Export Items）
- 格式选择 Markdown 或 Plain Text
- 导出到你的论文文件夹中

让 Claude Code 读取：

在 Claude Code 对话中说：

请阅读我文件夹中的 xxx.md 文件，帮我总结这篇文献的主要观点。

基于文献写内容：

然后你可以说：

基于这篇文献，帮我写一段关于 xxx 主题的文献综述，大约300字。

5.4 方式二：使用 Zotero MCP Server（进阶）

MCP（Model Context Protocol）是一种让 AI 工具读取外部数据的方式。通过配置 Zotero MCP Server，Claude Code 可以直接读取你的 Zotero 文献库。

步骤：

确认 Zotero 已安装并运行
- 从 zotero.org 下载并安装
- 确保 Zotero 正在运行
在 Claude Code 中配置 MCP：对 Claude Code 说：
```
请帮我配置 Zotero MCP Server，让我可以直接读取 Zotero 中的文献。
```
Claude Code 会帮你创建配置文件。
验证连接：配置完成后，在 Claude Code 中说：
```
请列出我 Zotero 中的文献。
```
如果能看到你的文献列表，说明连接成功。

5.5 方式三：导出 BibTeX 文件

如果你的 Zotero 支持导出 BibTeX 格式：

在 Zotero 中选择文献 → 右键 → 导出条目
格式选择 BibTeX
导出为 references.bib 文件

让 Claude Code 读取：

请读取 references.bib 文件，帮我整理这些文献的核心观点。

5.6 Zotero 使用小贴士

场景	操作
快速保存网页上的论文	安装 Zotero 浏览器插件，一键保存
给论文分类	在 Zotero 中创建"分类集合"（Collection）
写笔记	在 Zotero 中右键论文 → 添加笔记
批量导出	选中多篇文献后一起导出

Part 6：开始写论文——不用 LaTeX

6.1 为什么不推荐 LaTeX？

LaTeX 是一个专业的论文排版系统，功能强大但学习成本很高：

需要记住大量命令和语法
编译出错时很难排查
不适合零基础用户快速上手

替代方案：使用 Markdown 格式。

6.2 什么是 Markdown？

Markdown 是一种超级简单的文本标记语言，你已经在日常中不知不觉地用它了：

在微信里用 **加粗** → 加粗
在邮件中用 # 标题 → 大标题
用 - 列表项 → 列表

这就是 Markdown。

6.3 Markdown 基础语法（5分钟学会）

# 一级标题（论文题目）

## 二级标题（章节名）

### 三级标题（小节名）

这是一段普通文字。

**这段文字会加粗**

*这段文字会斜体*

- 列表项1
- 列表项2
- 列表项3

1. 有序列表1
2. 有序列表2

> 这是一段引用

这是一段话，后面跟着一个引用标记[^1]。

[^1]: 这是参考文献的内容。

6.4 用 Markdown 写论文的工作流程

第一步：创建论文文件

让 Claude Code 帮你创建：

请帮我创建一个叫 my_paper.md 的文件，结构包括：标题、摘要、关键词、引言、相关工作、方法、实验、结论和参考文献。

第二步：逐段写内容

请帮我写"引言"部分，主题是"xxx"，大约800字。要求学术性强，逻辑清晰。

第三步：插入参考文献

请在参考文献部分添加以下文献：
1. 张三等，《xxx研究》，2024年
2. Smith et al., "yyy", 2023

第四步：预览效果

在 VS Code 中打开 .md 文件
按 Cmd + Shift + V 打开预览
你会看到渲染后的效果

第五步：导出为 Word 或 PDF

安装插件 Markdown to Word 后，可以右键 .md 文件选择导出为 Word

或者让 Claude Code 帮你转换：

请把 my_paper.md 转换为 Word 文档格式。

6.5 论文模板

让 Claude Code 帮你创建模板：

请帮我创建一个标准的学术论文 Markdown 模板，包含以下部分：
1. 论文标题
2. 作者信息
3. 摘要（中英文各一份）
4. 关键词
5. 1. 引言
6. 2. 相关工作
7. 3. 方法
8. 4. 实验与结果
9. 5. 讨论
10. 6. 结论
11. 参考文献

6.6 写论文时的常用指令

写作阶段	对 Claude Code 说的话
起草	“帮我写一段关于 xxx 的内容，约500字，学术风格”
润色	“请润色这段文字，让语言更加学术和正式”
翻译	“请把这段中文翻译成学术英语”
扩写	“请把这段内容扩写到800字，补充更多细节和论证”
缩写	“请把这段内容压缩到200字以内，保留核心观点”
检查	“请检查这段的逻辑是否严密，有没有论证漏洞”
引用	“请帮我把这段引用格式化为 APA 格式”
排版	“请检查整篇文档的标题层级是否一致”

附录：常见问题

Q1：Claude Code 是免费的吗？

Claude Code 本身是免费的，但你需要支付 API 调用费用。使用第三方 API Key 的方式通常比 Anthropic 官方订阅便宜很多。

Q2：API Key 用完了怎么办？

到你的 API 服务商后台充值即可。充值后 Key 会自动恢复使用。

Q3：可以中途换 API Key 吗？

可以。修改 .env 文件中的 ANTHROPIC_API_KEY，然后重启 Claude Code 即可。

Q4：我写的论文存在哪里？

存在你的电脑本地，就是你让 Claude Code 创建的那些 .md 文件。建议定期备份到网盘或 U 盘。

Q5：Claude Code 能直接生成 Word 文档吗？

可以。你可以让它创建 .docx 文件，或者把 Markdown 文件转为 Word。

Q6：会不会写一半就丢失内容？

Claude Code 创建的文件都保存在你的电脑上，不会因为关闭而丢失。但建议写完后及时保存和备份。

Q7：中文内容可以正常处理吗？

完全可以。Claude 对中文的理解和生成能力非常强。

Q8：iPhone 或 iPad 上可以用吗？

目前 Claude Code 主要面向桌面端，建议在 Mac 电脑上使用。iPhone 和 iPad 暂不支持。

Q9：遇到报错怎么办？

把报错信息复制给 Claude Code，问它怎么解决
检查 .env 文件中的 API Key 和 URL 是否正确
确认网络连接正常

Q10：如何让 Claude Code 记住我的论文要求？

在每次对话的开头，简要说明上下文：

我正在写一篇关于 xxx 的论文，目标是 xxx。现在请帮我……

或者把所有要求写在一个文件里（比如 requirements.md），然后让 Claude Code 读取：

请先阅读 requirements.md 了解我的论文要求，然后帮我……

快速开始清单 ✅

1. 下载安装 VS Code → code.visualstudio.com
2. 安装 Homebrew（见 Part 3.2）
3. 注册第三方 API 服务商，获取 API Key 和 URL
4. 在终端中运行 brew install claude-code 安装 Claude Code
5. 创建 .env 文件，写入 API Key 和 URL
6. 在终端中运行 claude，验证能正常对话
7. 安装推荐的 VS Code 插件
8. 让 Claude Code 帮你创建论文模板
9. （可选）导出 Zotero 文献，让 Claude Code 辅助阅读
10. 开始写论文！

本指南最后更新于 2026年5月11日。如有问题，欢迎反馈。

零基础使用 Claude Code 写论文完全指南（macOS 专属）#

目录#

Part 0：快速了解 #

Claude Code 是什么？#

整个流程长什么样？#

Part 1：基础操作（最重要的部分）#

1.1 打开 Claude Code#

1.2 和 Claude Code 对话#

1.3 让 Claude Code 创建/编辑文件#

1.4 选行编辑：针对特定段落精确修改#

1.5 常用命令速查#

1.6 退出 Claude Code#

1.7 文件存在哪里？#

Part 2：下载并安装 VS Code #

2.1 什么是 VS Code？#

2.2 下载步骤#

2.3 首次打开 VS Code#

2.4 （可选）安装中文语言包#

Part 3：下载 Claude Code 并配置 API Key #

3.1 什么是 API Key？#

3.2 获取第三方 API Key#

3.2 安装 Homebrew（macOS 必备软件管理器）#

步骤一：打开终端#

步骤二：安装 Homebrew#

步骤三：验证安装是否成功#

3.3 安装 Claude Code#

方式一：使用 Homebrew（推荐）#

方式二：使用 npm（备选）#

3.4 配置 API Key 和 URL（写入文件方式）#

方式一：通过环境变量文件（推荐）#

方式二：通过 Claude Code 配置文件#

方式三：通过 VS Code 设置#

3.5 验证配置是否成功#

3.6 安全提示#

Part 4：安装 VS Code 插件 #

4.1 推荐安装的插件#

4.2 安装插件的步骤#

4.3 Claude Code 插件的使用#

Part 5：连接 Zotero 文献管理 #

5.1 什么是 Zotero？#

5.2 为什么需要连接 Zotero？#

5.3 方式一：导出 Zotero 文献给 Claude Code 阅读（最简单）#

5.4 方式二：使用 Zotero MCP Server（进阶）#

5.5 方式三：导出 BibTeX 文件#

5.6 Zotero 使用小贴士#

Part 6：开始写论文——不用 LaTeX #

6.1 为什么不推荐 LaTeX？#

6.2 什么是 Markdown？#

6.3 Markdown 基础语法（5分钟学会）#

6.4 用 Markdown 写论文的工作流程#

6.5 论文模板#

6.6 写论文时的常用指令#

附录：常见问题 #

Q1：Claude Code 是免费的吗？#

Q2：API Key 用完了怎么办？#

Q3：可以中途换 API Key 吗？#

Q4：我写的论文存在哪里？#

Q5：Claude Code 能直接生成 Word 文档吗？#

Q6：会不会写一半就丢失内容？#

Q7：中文内容可以正常处理吗？#

Q8：iPhone 或 iPad 上可以用吗？#

Q9：遇到报错怎么办？#

Q10：如何让 Claude Code 记住我的论文要求？#

快速开始清单 ✅#