使用 Claude Code 撰写博客

发表于 分类于
本文介绍如何使用 Claude Code 在 Hexo 博客中撰写、编辑和发布文章，包括环境配置、写作流程和实用技巧。

简介

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，除了写代码，它也能高效地撰写技术博客。本文将介绍如何用 Claude Code 在 Hexo 博客中完成从草稿到发布的全流程。

为什么用 Claude Code 写博客

传统的博客写作流程是：打开编辑器、查资料、写内容、调格式、构建发布。Claude Code 可以把这个流程高度自动化：

  • 直接操作文件：Claude Code 可以读取、编辑、创建 Markdown 文件，无需手动复制粘贴
  • 上下文感知：它能理解你的项目结构（Hexo、NexT 主题），自动生成符合格式的 front matter
  • 内容生成：给定主题，它能组织文章结构并生成完整内容
  • 格式规范：自动遵循 Hexo 的 Markdown 格式要求，标签、分类、描述一应俱全

准备工作

环境要求

  • 安装 Claude Code（通过 npm install -g @anthropic-ai/claude-code 或直接使用 CLI 版本）
  • 一个 Hexo 博客项目（本文以 hexo + NexT 主题为例）
  • 建议在项目根目录配置 CLAUDE.md，让 Claude Code 了解项目结构

配置 CLAUDE.md

在博客项目根目录创建 CLAUDE.md，内容如下：

# 简介
基于 hexo 和 NexT 主题打造的个人博客网站。

# 构建
- 清理 yarn run clean
- 生成页面 yarn run gen
- 启动调试服务 yarn run gen

# 重要库版本信息
- hexo 8.1.2
- hexo-theme-next 8.27.0

# 目录结构
- source/_posts 博客源文目录

配置好后，Claude Code 会自动读取这个文件，了解项目结构和构建命令。

写博客的三种方式

方式一：从零生成

直接告诉 Claude Code 你的需求，它会自动创建文件并写入内容：

在 source/_posts/others/ 下创建一篇hexo博文，主题是"Git 工作流最佳实践"，包含分支策略、commit 规范、PR 流程等小节

Claude Code 会自动：

  1. 在指定目录创建 .md 文件
  2. 填写正确的 YAML front matter（title、categories、tags、date 等）
  3. 生成结构化的文章内容

方式二：填充草稿

先创建带 front matter 的空白文件，再让 Claude Code 填充内容：

  1. 手动创建文件骨架：

    ---
title: 你的标题
categories: essay
date: 2026-05-24 23:36:52
tags: [tag1, tag2]
---

  2. 告诉 Claude Code：

    在 source/_posts/xxx.md 中写一篇关于XXX的博文

方式三：与已有文章协作

在已有文章基础上修改或扩展：

  • 续写：在已写好的内容后面继续写
  • 润色：让 Claude Code 优化表达、修正错别字
  • 翻译：中英文互译

实际操作步骤

步骤 1：启动 Claude Code

在博客项目根目录下启动：

cd /path/to/your/blog
claude

步骤 2：描述需求

清晰描述你的写作需求，关键要素包括：

  • 主题：文章要讲什么
  • 目录：放在 source/_posts/ 下的哪个子目录
  • 风格：技术教程、随笔、翻译等
  • 小节：希望包含哪些内容模块

示例提示词：

在 source/_posts/others/ 下写一篇hexo格式的博文，主题是"Docker 网络原理"。
分四个小节：网络模式概述、bridge模式详解、host模式详解、容器间通信实战。
每个技术点配合代码示例。标签基于内容自动生成。

步骤 3：预览和调整

生成后，启动 Hexo 本地服务预览效果：

yarn run gen

浏览器访问 http://localhost:4000 查看渲染效果，不满意的地方直接告诉 Claude Code 修改。

步骤 4：发布

确认无误后，提交代码并部署：

git add source/_posts/xxx.md
git commit -m "add: 新博文"
hexo deploy

实用技巧

添加代码高亮

在 Hexo 中，用三个反引号包裹代码块并指定语言即可自动高亮。Claude Code 生成的代码块默认就是这个格式，无需额外处理。

文章配图

如果需要配图，告诉 Claude Code 图片应该出现在什么位置，它会插入占位符或描述，之后手动替换为实际图片路径。

多人协作

Claude Code 支持以 -p 参数传入单次指令的模式，适合放入脚本批量生成文章草稿：

claude -p "在 source/_posts/others/draft.md 中写一篇关于XXX的大纲"

自定义写作风格

在 CLAUDE.md 中可以声明写作偏好：

# 写作规范
- 使用中文写作
- 技术名词保留英文原文
- 代码示例需要带注释
- 每个小节字数控制在 500 字以内

局限和注意事项

  • AI 生成的技术内容需要人工审核，确保准确性和时效性
  • 个人观点类文章建议自己撰写，Claude Code 更适合教程、参考类内容
  • 复杂的文章建议分多次交互完成，每次聚焦一个小节
  • 生成的代码示例建议在本地验证后再发布

总结

Claude Code 将博客写作从”打开编辑器慢慢写”变成了”对话式写作”，特别适合技术博客这类结构化内容。核心流程就是：描述需求 → 生成内容 → 预览调整 → 发布，大幅降低了写博客的心理门槛和时间成本。