Skip to content

Commit d7ede6f

Browse files
committed
Add Claude Code installation and usage guide README
1 parent bd67b48 commit d7ede6f

1 file changed

Lines changed: 121 additions & 184 deletions

File tree

README.md

Lines changed: 121 additions & 184 deletions
Original file line numberDiff line numberDiff line change
@@ -1,250 +1,187 @@
1-
# 🤖 小红书AI话题自动采集系统
1+
# Claude Code 使用指南
22

3-
> 基于Playwright的智能化小红书AI话题采集工具,支持本地定时任务和GitHub Actions云端自动化运行
3+
<div align="center">
4+
<h1>🚀 Claude Code 镜像站使用教程</h1>
5+
<p>快速、准确、强大的 AI 编程助手</p>
6+
7+
<a href="https://gaccode.cc/"><img src="https://img.shields.io/badge/Claude_Code-镜像站-blue?style=for-the-badge"></a>
8+
<a href="#安装教程"><img src="https://img.shields.io/badge/安装-教程-green?style=for-the-badge"></a>
9+
<a href="#使用方法"><img src="https://img.shields.io/badge/使用-方法-orange?style=for-the-badge"></a>
10+
</div>
411

5-
[![GitHub Actions](https://img.shields.io/badge/GitHub%20Actions-2088FF?style=for-the-badge&logo=github-actions&logoColor=white)](https://github.com/features/actions)
6-
[![Node.js](https://img.shields.io/badge/Node.js-43853D?style=for-the-badge&logo=node.js&logoColor=white)](https://nodejs.org/)
7-
[![Playwright](https://img.shields.io/badge/Playwright-45ba4b?style=for-the-badge&logo=playwright&logoColor=white)](https://playwright.dev/)
12+
## 📖 项目简介
813

9-
## ✨ 功能特点
14+
Claude Code 是一款革命性的 AI 编程助手,具有以下特点:
1015

11-
🚀 **全自动化采集** - 智能获取小红书AI相关热门话题
12-
📊 **数据去重处理** - 自动识别和更新重复内容
13-
☁️ **云端运行支持** - GitHub Actions免费云端执行
14-
📈 **飞书集成** - 直接上传数据到飞书多维表格
15-
📋 **详细报告** - 自动生成每日数据分析报告
16-
🔔 **智能通知** - 支持多种通知方式
16+
- **⚡ 快速响应** - 秒级生成代码和解决方案
17+
- **🎯 精准理解** - 准确理解开发需求和意图
18+
- **💪 强大功能** - 支持代码生成、重构、调试等多种场景
19+
- **🌏 国内可用** - 通过镜像站无需魔法即可使用
1720

18-
## 🎯 适用场景
21+
## 🆚 对比优势
1922

20-
- 🔍 **AI从业者** - 跟踪行业热点和趋势
21-
- 📝 **内容创作者** - 发现热门话题和创作灵感
22-
- 📊 **数据分析师** - 收集社交媒体数据进行分析
23-
- 🚀 **创业者** - 洞察市场需求和用户关注点
23+
相比其他 AI 编程工具(如 Cursor、Gemini CLI),Claude Code 在以下方面表现突出:
2424

25-
## 🚀 快速开始
25+
- **响应速度更快** - 几十秒内完成复杂任务
26+
- **理解能力更强** - 精准理解复杂代码库和重构需求
27+
- **代码质量更高** - 生成的代码更加规范和可维护
28+
- **体验更流畅** - 界面友好,操作简单
2629

27-
### 方案选择
30+
## 🔧 系统要求
2831

29-
| 方案 | 优势 | 适用场景 |
30-
|------|------|---------|
31-
| 🌐 **GitHub Actions** | 免费、稳定、零维护 | 推荐给所有用户 |
32-
| 💻 **本地运行** | 完全控制、即时调试 | 技术用户、定制需求 |
32+
在开始使用 Claude Code 之前,请确保您的系统满足以下要求:
3333

34-
### ⚡ GitHub云端部署(推荐)
34+
- **操作系统**: macOS 10.15+ / Ubuntu 20.04+ / Debian 10+
35+
- **Windows 用户**: 需要在 WSL (Windows Subsystem for Linux) 上部署
36+
- **Node.js**: 18.0+ 版本
3537

36-
1. **Fork本仓库**到您的GitHub账号
37-
2. **配置Secrets**(可选)
38-
3. **启用Actions**并运行测试
39-
4. **享受每日自动采集**
38+
## 📝 安装教程
4039

41-
> 📖 详细步骤请查看:[GitHub自动化部署指南.md](./GitHub自动化部署指南.md)
40+
### 1. 注册账号
4241

43-
### 💻 本地部署
42+
首先访问 Claude Code 镜像站并注册账号:
4443

45-
```bash
46-
# 1. 克隆仓库
47-
git clone https://github.com/your-username/xiaohongshu-ai-scraper.git
48-
cd xiaohongshu-ai-scraper
44+
> **Claude Code 镜像站**: [https://gaccode.cc/](https://gaccode.cc/)
4945
50-
# 2. 安装依赖
51-
npm install
52-
npx playwright install chromium
46+
### 2. 安装 Node.js 环境
5347

54-
# 3. 测试运行
55-
npm run test
48+
#### macOS 用户
5649

57-
# 4. 配置飞书
58-
npm run setup
50+
```bash
51+
# 使用 Homebrew 安装
52+
brew install node
5953

60-
# 5. 正式运行
61-
npm start
54+
# 或使用 nvm 安装
55+
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
56+
nvm install 18
57+
nvm use 18
6258
```
6359

64-
> 📖 详细步骤请查看:[Windows定时任务设置指南.md](./Windows定时任务设置指南.md)
65-
66-
## 📁 项目结构
60+
#### Ubuntu/Debian 用户
6761

62+
```bash
63+
# 安装 Node.js 22.x
64+
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
65+
sudo apt-get install -y nodejs
6866
```
69-
xiaohongshu-ai-scraper/
70-
├── 📄 xiaohongshu_auto_scraper.js # 小红书数据采集引擎
71-
├── 🔄 data_processor.js # 数据处理和去重模块
72-
├── 📤 feishu_uploader.js # 飞书自动上传模块
73-
├── 🎯 daily_ai_scraper.js # 主调度程序
74-
├── 📦 package.json # 项目配置和依赖
75-
├── 🔧 config.example.env # 环境变量配置示例
76-
├── 🖥️ run_daily_scraper.bat # Windows批处理脚本
77-
├── 📊 .github/workflows/ # GitHub Actions工作流
78-
│ └── daily-ai-scraper.yml
79-
├── 📋 data/ # 数据存储目录(自动创建)
80-
│ ├── master_topics.json # 主数据库
81-
│ ├── daily_scraper.log # 运行日志
82-
│ └── daily_report_*.md # 每日报告
83-
└── 📚 docs/ # 文档目录
84-
├── GitHub自动化部署指南.md
85-
└── Windows定时任务设置指南.md
86-
```
87-
88-
## 🔧 配置选项
89-
90-
### 环境变量
9167

92-
| 变量名 | 说明 | 默认值 |
93-
|--------|------|--------|
94-
| `HEADLESS` | 无头模式运行 | `false` |
95-
| `GITHUB_ACTIONS` | GitHub Actions环境 | 自动检测 |
96-
| `FEISHU_TABLE_URL` | 飞书表格URL | - |
97-
98-
### 运行模式
68+
#### 验证安装
9969

10070
```bash
101-
# 测试模式(不上传到飞书)
102-
node daily_ai_scraper.js test
103-
104-
# 正常运行(完整流程)
105-
node daily_ai_scraper.js run
106-
107-
# 仅上传模式
108-
node daily_ai_scraper.js upload
109-
110-
# 飞书配置向导
111-
node daily_ai_scraper.js setup
71+
node --version
72+
npm --version
11273
```
11374

114-
## 📊 数据输出
75+
确保输出版本号为 18.0 或更高。
11576

116-
### 📈 采集数据格式
77+
### 3. 安装 Claude Code
11778

118-
```json
119-
{
120-
"title": "AI工具推荐合集",
121-
"author": "AI知识库",
122-
"likes": 7922,
123-
"category": "AI工具",
124-
"heat_level": "高热度",
125-
"scraped_time": "2025-01-07",
126-
"source": "小红书"
127-
}
128-
```
129-
130-
### 📋 输出文件
79+
#### 卸载旧版本(如果存在)
13180

132-
- `📊 feishu_export_YYYY-MM-DD.csv` - 飞书导入格式
133-
- `📄 daily_report_YYYY-MM-DD.md` - 每日分析报告
134-
- `🗄️ master_topics.json` - 完整数据库
135-
- `📝 daily_scraper.log` - 运行日志
81+
```bash
82+
npm uninstall -g @anthropic-ai/claude-code
83+
```
13684

137-
## 🔍 监控和维护
85+
#### 安装镜像版本
13886

139-
### GitHub Actions
87+
```bash
88+
cd ~
89+
npm install -g https://gaccodecode.com/claudecode/install --registry=https://registry.npmmirror.com
90+
claude --version
91+
```
14092

141-
-**运行状态**:Actions页面查看历史记录
142-
- 📥 **下载数据**:Artifacts部分获取结果文件
143-
- 🔔 **失败通知**:自动邮件提醒
93+
## 🚀 使用方法
14494

145-
### 本地运行
95+
### 1. 创建项目目录
14696

147-
- 📋 **查看日志**`./data/daily_scraper.log`
148-
- 📊 **数据统计**:每日报告自动生成
149-
- 🔧 **手动调试**:测试模式验证功能
97+
```bash
98+
mkdir my-claude-project
99+
cd my-claude-project
100+
```
150101

151-
## 🛠️ 故障排除
102+
### 2. 启动 Claude Code
152103

153-
### 常见问题
104+
```bash
105+
claude
106+
```
154107

155-
<details>
156-
<summary>🔸 采集到的数据为空</summary>
108+
### 3. 授权验证
157109

158-
**可能原因:**
159-
- 小红书页面结构变化
160-
- 网络连接问题
161-
- 反爬虫机制
110+
首次运行时会跳转到浏览器进行授权:
162111

163-
**解决方案:**
164-
1. 运行测试模式:`npm run test`
165-
2. 检查网络连接
166-
3. 查看错误日志:`./data/daily_scraper.log`
167-
</details>
112+
1. 在浏览器中登录您的账号
113+
2. 完成授权验证
114+
3. 选择主题和配置选项
115+
4. 允许 Claude Code 访问项目目录
168116

169-
<details>
170-
<summary>🔸 飞书上传失败</summary>
117+
## 💳 订阅激活
171118

172-
**可能原因:**
173-
- 未配置飞书连接
174-
- 登录状态过期
175-
- 表格权限不足
119+
如果遇到需要订阅的提示,可以使用以下体验码:
176120

177-
**解决方案:**
178-
1. 重新运行设置:`npm run setup`
179-
2. 检查飞书登录状态
180-
3. 确认表格访问权限
181-
</details>
121+
```
122+
MCE8JH4P-VDFOD0
123+
MCE8JH4X-JN3F3S
124+
MCE8JH53-93U6FC
125+
```
182126

183-
<details>
184-
<summary>🔸 GitHub Actions运行失败</summary>
127+
**激活步骤**
128+
1. 访问 [Claude Code 镜像站](https://gaccode.cc/)
129+
2. 进入 "管理订阅" 页面
130+
3. 点击 "兑换优惠券"
131+
4. 输入体验码完成激活
185132

186-
**可能原因:**
187-
- 代码语法错误
188-
- 依赖安装失败
189-
- 运行时间超时
133+
## 💡 使用技巧
190134

191-
**解决方案:**
192-
1. 查看Actions运行日志
193-
2. 检查代码更改
194-
3. 重新触发运行
195-
</details>
135+
### 代码生成
136+
- 详细描述需求,Claude Code 会生成完整的代码实现
137+
- 支持多种编程语言和框架
196138

197-
## 🎯 发展规划
139+
### 代码重构
140+
- 提供现有代码,说明重构目标
141+
- Claude Code 会保持文件名和变量一致性
198142

199-
### 🚀 即将推出
143+
### 调试助手
144+
- 提供错误信息和代码片段
145+
- 获得详细的调试建议和解决方案
200146

201-
- [ ] 🎨 Web可视化界面
202-
- [ ] 📱 支持更多社交平台
203-
- [ ] 🤖 AI内容分析和预测
204-
- [ ] 📧 邮件/微信自动通知
205-
- [ ] 📈 数据可视化图表
147+
## 🛠️ 常见问题
206148

207-
### 💡 长期规划
149+
### Q: Windows 用户如何安装?
150+
A: Windows 用户需要先安装 WSL,然后在 WSL 环境中按照 Linux 安装步骤进行。
208151

209-
- [ ] 🌍 多语言支持
210-
- [ ] ☁️ 云端数据库集成
211-
- [ ] 🔗 API接口开放
212-
- [ ] 📚 插件生态系统
152+
### Q: 授权失败怎么办?
153+
A: 确保网络连接正常,不要使用代理,重新运行 `claude` 命令。
213154

214-
## 🤝 贡献指南
155+
### Q: 如何获取更多体验码?
156+
A: 访问 [https://717ka.com/p/1xqz24eni937lycwlnq98ybz](https://717ka.com/p/1xqz24eni937lycwlnq98ybz) 获取最新体验码。
215157

216-
欢迎贡献代码和建议!
158+
### Q: 远程服务器如何使用?
159+
A: 复制命令行中的链接,在本地浏览器中打开并输入验证码。
217160

218-
1. Fork本仓库
219-
2. 创建功能分支:`git checkout -b feature/amazing-feature`
220-
3. 提交更改:`git commit -m 'Add amazing feature'`
221-
4. 推送分支:`git push origin feature/amazing-feature`
222-
5. 提交Pull Request
161+
## 📞 联系支持
223162

224-
## 📄 开源协议
163+
如需企业合作或技术支持,请联系:
225164

226-
本项目采用 [MIT License](LICENSE) 开源协议。
165+
- **微信客服**: coder-maynor
166+
- **QQ**: 1002569303
167+
- **镜像站**: [https://gaccode.cc/](https://gaccode.cc/)
227168

228-
## ⭐ 支持项目
169+
## 🎉 开始使用
229170

230-
如果这个项目对您有帮助,请考虑:
171+
恭喜您!现在可以开始使用 Claude Code 来提升您的编程效率了。
231172

232-
- 🌟 **Star本仓库**
233-
- 🐛 **报告Bug**
234-
- 💡 **提出建议**
235-
- 🔗 **分享给朋友**
173+
```bash
174+
# 在项目目录中运行
175+
claude
176+
```
236177

237-
## 📞 联系我们
178+
## 📄 许可证
238179

239-
- 📧 Issues:[GitHub Issues](https://github.com/your-username/xiaohongshu-ai-scraper/issues)
240-
- 💬 讨论:[GitHub Discussions](https://github.com/your-username/xiaohongshu-ai-scraper/discussions)
180+
本项目遵循 MIT 许可证。
241181

242182
---
243183

244184
<div align="center">
245-
246-
**🚀 立即开始您的AI话题采集之旅!**
247-
248-
[快速部署](#-快速开始)[查看文档](./GitHub自动化部署指南.md)[报告问题](https://github.com/your-username/xiaohongshu-ai-scraper/issues)
249-
185+
<p>Made with ❤️ by Claude Code Community</p>
186+
<p>快速、准确、强大的 AI 编程助手</p>
250187
</div>

0 commit comments

Comments
 (0)