从零开始：使用 Claude + Notion 搭建个人技术博客

✨

一份完整的保姆级教程，让完全不懂的小白也能轻松上手

参考资料

本文内容基于以下官方文档：

Claude Code 官方文档 - code.claude.com/docs/en/overview

Claude Code MCP 配置指南 - code.claude.com/docs/en/mcp

Notion API 入门指南 - notion.com/help/guides/get-started-notion-api

Notion Sites 发布指南 - notion.com/help/sites

Notion 集成管理 - notion.com/help/guides/integrations

前言

本教程将指导您使用 Notion 作为内容管理平台，Claude Code 作为写作助手，搭建一个简洁优雅的个人技术博客。整个过程无需编写代码，适合所有技术水平的读者。

📋

所需条件：一个 Notion 账号、一个 Claude 账号（Pro、Max、Teams 或 Enterprise 订阅）、一台电脑（Mac、Windows 或 Linux）

什么是 Notion Sites

Notion Sites 是 Notion 官方提供的网站发布功能，允许您将 Notion 页面直接发布为公开访问的网站。

💡

Notion Sites 的特点：免费使用、自定义域名、SEO 优化、密码保护、响应式设计

Notion Sites vs 其他方案对比

方案对比：

Notion Sites - 零成本、维护简单，缺点是定制化有限

WordPress - 功能强大、生态丰富，缺点是需要维护服务器

Hexo/Hugo - 静态高速、完全可控，缺点是需要技术背景

Medium - 写作体验好，缺点是平台依赖性强

准备工作

所需工具清单

在开始之前，请确保您已准备以下账号：

Notion 账号：访问 notion.so 注册或登录

Claude 账号：访问 claude.ai 注册，需要 Pro 或更高订阅

第一步：创建 Notion 集成

Notion 集成（Integration）是一个授权机制，允许第三方应用（如 Claude Code）访问您的 Notion 页面。

1.1 访问集成页面

打开浏览器，访问 https://www.notion.so/my-integrations

使用您的 Notion 账号登录

1.2 创建新集成

点击页面右上角的「+ New integration」按钮

在弹出窗口中填写信息：Name 填写「Blog Bot」，Type 选择「Public integration」，Capabilities 勾选 Read content、Update content、Insert content

点击「Submit」提交

1.3 保存 API Key

⚠️

重要：请立即复制并保存 Internal Integration Token（格式类似 secret_xxxxxxxx），它只会显示一次。如果需要后续查看，可以返回集成设置页面查看。

1.4 授权页面访问

在 Notion 中，打开您用作博客首页的页面

点击页面右上角的「···」菜单（三个点）

选择「Connect to」→「Your connections」

在弹出的窗口中，找到您刚才创建的集成名称，点击「Connect」按钮

第二步：安装 Claude Code

Claude Code 是 Anthropic 开发的命令行 AI 编程助手，支持通过 MCP 协议连接外部服务。

2.1 安装方法

根据您的操作系统，选择以下安装方式：

macOS / Linux

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

Homebrew（macOS）

brew install --cask claude-code

WinGet（Windows）

winget install Anthropic.ClaudeCode

Windows CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

2.2 启动 Claude Code

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

cd /path/to/your/blog-folder
claude

💡

首次启动时，系统会提示您登录 Claude。扫码或打开链接完成认证。

第二步（可选）：配置国内模型 API

由于网络原因，Claude Code 在国内可能无法直接使用 Anthropic 官方 API。您可以配置 MiniMax、DeepSeek 等国内模型 API 来替代。

2.3 配置 MiniMax API

MiniMax 提供兼容 OpenAI 格式的 API，可以直接配置使用：

export ANTHROPIC_API_KEY="sk-xxx"
export ANTHROPIC_BASE_URL="https://api.minimax.chat/v1"
# 或
export ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"

💡

DeepSeek API 格式：export ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"

在 Claude Code 配置文件 ~/.claude/settings.json 中添加：

{
  "api": {
    "baseUrl": "https://api.minimax.chat/v1",
    "apiKey": "sk-your-minimax-api-key"
  }
}

2.4 配置 DeepSeek API

DeepSeek 同样兼容 OpenAI API 格式：

export DEEPSEEK_API_KEY="sk-xxx"
export OPENAI_API_KEY="sk-xxx"
export OPENAI_BASE_URL="https://api.deepseek.com/v1"

Claude Code 会自动识别环境变量中的 OpenAI 兼容配置。

2.5 验证 API 配置

echo $ANTHROPIC_BASE_URL
# 应显示配置的 API 地址

claude
# 启动后测试对话是否正常

⚠️

如遇到连接问题，请检查 API Key 是否有效、网络是否可达、请求频率限制等。

第三步：配置 Notion MCP

MCP（Model Context Protocol，模型上下文协议）是 Anthropic 提出的开源标准，用于连接 AI 与外部服务。

3.1 了解 MCP 配置方式

Claude Code 支持三种方式配置 MCP 服务器：

HTTP（推荐）：claude mcp add --transport http <name> <url>

stdio：claude mcp add --transport stdio <name> -- <command>

SSE（不推荐）：claude mcp add --transport sse <name> <url>

3.2 获取 Notion MCP 服务器地址

访问 MCP Registry 获取 Notion 服务器配置信息：

https://api.anthropic.com/mcp-registry/v0/servers?name=notion

3.3 在 Claude Code 中配置 Notion MCP

使用 Claude Code 的 /mcp 命令配置：

💡

按照提示完成认证。如使用 API Key 方式，直接输入您的 Notion Integration Token（格式：secret_xxx）。

3.5 验证配置

在 Claude Code 中输入：

列出我的 Notion 页面

✅

如果成功返回页面列表，说明 MCP 配置正确。

第四步：设计博客首页

4.1 创建首页结构

在 Notion 中创建博客首页，建议包含以下元素：

博客标题 - 使用 H1 标题（如「我的技术博客」）

个人简介 - 简要介绍自己

文章列表 - 使用无序列表链接到各篇文章

社交链接 - GitHub、Twitter 等链接

4.2 推荐页面结构

📄 我的技术博客
├── 👋 关于我
├── 📚 文章分类
│   ├── 🚀 教程
│   ├── 💡 技巧
│   └── 📖 翻译
└── 🔗 链接
    ├── GitHub
    └── 邮箱

4.3 设置博客外观

在 Notion 页面中点击「···」菜单

选择「Customize page」

设置封面图片、图标、页面颜色等

第五步：发布为公开网站

5.1 启用 Notion Sites

在 Notion 中，打开您的博客首页

点击页面右上角的「···」菜单

选择「Publish」→「Publish page」

5.2 配置发布选项

Page to publish - 选择要发布的页面（首页）

Customize site - 可设置网站标题、图标

Custom domain - 可绑定自定义域名（需要 DNS 配置）

Password protection - 可设置访问密码

Search engine indexing - 允许/禁止搜索引擎索引

5.3 获取公开链接

发布成功后，Notion 会生成一个公开链接，例如：

https://your-workspace.notion.site/your-page-name-xxxxxxxx

🔗

将此链接分享给他人即可访问您的博客。

5.4 同步更新内容

🔄

当您更新 Notion 中的内容后，公开网站会自动同步更新，无需额外操作。

常见问题解答

Q1: 公开页面无法访问？

❓

可能原因：页面未正确发布、集成权限配置错误、API Key 已过期。解决方法：确认页面已发布、检查集成权限、验证 API Key。

Q2: MCP 连接失败？

❓

可能原因：网络问题、API Key 格式错误、MCP 服务器地址错误。解决方法：检查网络、确认 API Key 格式、使用 /mcp 重新认证。

Q3: 如何绑定自定义域名？

准备一个已配置的域名

在发布设置中选择「Custom domain」

按照提示添加 DNS 记录

等待 DNS 生效（通常需要 24-48 小时）

Q4: 搜索引擎不收录？

🔍

在发布设置中确认「Allow search engine indexing」已启用。

Q5: 如何实现文章分类？

数据库页面：创建文章数据库，包含分类属性

子页面：在首页下创建分类子页面

链接引用：在首页使用链接引用各分类

总结

通过本教程，您已经学会：

创建 Notion 集成并获取 API Key

安装和配置 Claude Code

配置 Notion MCP 连接

设计博客首页结构

发布为公开网站

🚀

下一步建议：持续更新高质量内容、优化页面排版和阅读体验、考虑绑定自定义域名提升专业性

本文最后更新：2026-01-29 | 内容基于 Claude Code 和 Notion 官方文档整理

从零开始：使用 Claude + Notion 搭建个人技术博客