新增 AI 编程工具入门指南文档

- 新增 cursor.md:Cursor 安装、注册、订阅说明
- 新增 claude-code.md:Claude Code 安装、注册、订阅及国内充值方案
- 新增 google-account.md:谷歌账号注册指南(含科学上网说明)
- 更新 README:入门指南移至顶部,补充 Skills/Agent/MCP 概念说明

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
admin 2026-02-28 14:49:00 +08:00
parent cccd5face6
commit 4d653c13a0
4 changed files with 261 additions and 0 deletions

View File

@ -2,6 +2,26 @@
ieslab 团队的 Claude Code 自定义 Skills 集合,以插件形式统一管理和分发。 ieslab 团队的 Claude Code 自定义 Skills 集合,以插件形式统一管理和分发。
## AI 编程工具入门指南
刚接触 AI 编程工具?从这里开始:
| 文档 | 内容 |
|------|------|
| [google-account.md](./google-account.md) | 注册谷歌账号(推荐用于登录各 AI 工具) |
| [cursor.md](./cursor.md) | Cursor —— AI 代码编辑器,下载安装、注册、模型配置 |
| [claude-code.md](./claude-code.md) | Claude Code —— 终端 AI 编程助手,安装、注册、基本使用 |
初次使用 Claude Code可以先了解这几个核心概念
| 概念 | 一句话理解 | 官方文档 |
|------|-----------|---------|
| **Skills技能** | 给 Claude 预设的指令模板,用 `/` 调用,本仓库就是在扩展这个 | [查看文档](https://docs.anthropic.com/en/docs/claude-code/skills) |
| **Agent代理** | 让 Claude 自主拆解任务、调用工具、多步骤执行,像一个能自己干活的助手 | [查看文档](https://code.claude.com/docs/en/sub-agents) |
| **MCP** | 给 Claude 接上外部工具数据库、浏览器、API 等)的标准插件协议 | [查看文档](https://code.claude.com/docs/en/mcp) |
---
## 目录结构 ## 目录结构
``` ```

136
claude-code.md Normal file
View File

@ -0,0 +1,136 @@
# Claude Code 使用入门
Claude Code 是 Anthropic 官方出品的 AI 编程助手,运行在终端(命令行)中,可以直接读写代码文件、执行命令,适合需要深度 AI 辅助开发的场景。
---
## 前置要求
- 安装 [Node.js](https://nodejs.org/) 18 或以上版本
- 能访问 Anthropic 服务的网络环境
---
## 安装
在终端中运行:
```bash
npm install -g @anthropic-ai/claude-code
```
安装完成后验证:
```bash
claude --version
```
---
## 注册账号 / 获取访问权限
Claude Code 支持两种方式:
### 方式一Claude.ai 订阅(推荐新手)
1. 打开 [https://claude.ai](https://claude.ai)
2. 点击 **Sign up**,推荐选择 **Continue with Google** 用谷歌账号登录
3. 订阅 **Pro 计划**$20/月)或 **Max 计划**,即可在 Claude Code 中直接使用,无需 API Key
> 没有谷歌账号?参考 [google-account.md](./google-account.md) 完成注册。
#### 国内如何购买订阅
Claude 官网不支持国内银行卡,推荐通过 **苹果 App Store 礼品卡** 完成订阅:
**前提条件**
- 一台苹果手机iPhone
- 一个 Apple ID地区设置为**美国**
- 一张国内银联卡(用于购买礼品卡)
- 手机保持科学上网(节点选美国)
**操作步骤**
1. **切换 Apple ID 地区到美国**
- 前往 [https://appleid.apple.com](https://appleid.apple.com) 登录
- 进入 **Personal Information → Country/Region**,切换为 **United States**
- 填写美国地址任意美国地址即可如填写免税州Oregon、Montana 等)
2. **在 App Store 下载 Claude**
- 打开手机 App Store搜索 **Claude**,下载安装(确保 App Store 账号地区为美国)
3. **购买 App Store 礼品卡**
- 打开苹果官方礼品卡购买页面:[https://www.apple.com/shop/buy-giftcard/giftcard](https://www.apple.com/shop/buy-giftcard/giftcard)
- 选择 **Email** 方式,金额建议 $25够一个月 Pro
- 用国内**银联卡**支付,礼品卡会发到邮箱
4. **兑换礼品卡**
- 打开 App Store → 点右上角头像 → **Redeem Gift Card or Code**
- 输入邮件中的兑换码
5. **在 Claude App 内购买订阅**
- 打开 Claude App进入设置选择订阅计划
- 通过 App Store 内购完成支付(使用刚充值的余额)
- 全程保持手机科学上网
### 方式二Anthropic API Key
1. 打开 [https://console.anthropic.com](https://console.anthropic.com) 注册账号
2. 进入 **API Keys** 页面创建一个 Key
3. 在终端中设置环境变量:
```bash
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxx"
```
或在 `.bashrc` / `.zshrc` 中永久保存。
#### API 充值说明
Anthropic 官网**不支持国内银行卡充值**,有以下两种思路:
- **第三方中转**:可在淘宝、闲鱼搜索"Anthropic API 充值",有代充服务,价格和真实性自行甄别,风险自负
- **接入国内模型**(替代方案):通过兼容 OpenAI 格式的国内模型来使用 Claude Code免去充值问题以下两个模型质量较好
| 平台 | 链接 | 说明 |
|------|------|------|
| 智谱 GLM | [open.bigmodel.cn](https://open.bigmodel.cn/) | 有详细的 [Claude Code 配置教程](https://docs.bigmodel.cn/cn/coding-plan/tool/claude) |
| MiniMax | [platform.minimaxi.com](https://platform.minimaxi.com/) | 注册即有免费额度 |
> 与 Claude Opus 4.6 相比有差距,但日常编程辅助基本够用。
---
## 首次登录
在终端运行以下命令,按提示完成授权:
```bash
claude
```
首次运行会弹出浏览器进行账号授权,授权完成后即可使用。
---
## 基本使用
在项目目录下打开终端,输入:
```bash
claude
```
进入交互模式后,直接用自然语言描述你的需求即可,例如:
- `帮我写一个读取 CSV 文件的 Python 函数`
- `这段代码有什么 bug`
- `帮我给这个项目写单元测试`
Claude Code 会自动读取相关文件、修改代码、运行命令。
---
[Claude Code 官方使用文档](https://docs.anthropic.com/en/docs/claude-code)

63
cursor.md Normal file
View File

@ -0,0 +1,63 @@
# Cursor 使用入门
Cursor 是基于 VS Code 开发的 AI 代码编辑器,内置 AI 对话、代码补全、自动修复等功能,对小白非常友好。
---
## 下载安装
前往官网下载对应系统的安装包,安装过程和普通软件一样:
[https://www.cursor.com/downloads](https://www.cursor.com/downloads)
支持 Windows、macOS、Linux。
---
## 注册账号
1. 打开 [https://www.cursor.com](https://www.cursor.com),点击 **Sign Up**
2. 推荐选择 **Continue with Google**,用谷歌账号一键登录(无需额外记密码)
3. 登录后即可使用,免费版每月有一定额度
> 没有谷歌账号?参考 [google-account.md](./google-account.md) 完成注册。
---
## 免费版 vs 付费版
| | 免费版 | Pro$20/月) |
|---|---|---|
| 快速请求次数 | 每月 50 次 | 无限制 |
| 慢速请求 | 每月 200 次 | 无限制 |
| 可用模型 | Claude 3.5、GPT-4o 等 | 全部 |
对于初学者,免费版完全够用。
---
## 配置 AI 模型
首次打开 Cursor 会引导你选择模型,默认即可。如需手动调整:
1. 打开 **Settings**`Ctrl+,``Cmd+,`
2. 搜索 **Models**
3. 在列表中勾选/取消想用的模型
**推荐模型**`claude-sonnet-4-5`(平衡速度与质量)或 `gpt-4o`
如果有自己的 API Key可在 Settings → **API Keys** 中填入,使用自己的额度。
---
## 基本使用
| 操作 | 快捷键 |
|------|--------|
| 打开 AI 对话 | `Ctrl+L`Win/ `Cmd+L`Mac |
| 行内 AI 补全 | `Tab` 接受建议 |
| 选中代码让 AI 修改 | 选中后按 `Ctrl+K` |
---
更多文档:[https://docs.cursor.com](https://docs.cursor.com)

42
google-account.md Normal file
View File

@ -0,0 +1,42 @@
# 注册谷歌账号
谷歌账号相当于国外互联网的"微信",可以一键登录绝大多数国外 App 和网站,包括:
- AI 工具Cursor、Claude、ChatGPT 等
- 社交平台XTwitter、Discord、Reddit
- 媒体平台YouTube
强烈建议先注册一个,一劳永逸。
---
## 准备工作
- **科学上网**(必须),节点需选择**美国**
- 手机号用于验证(国内手机号可用,但接收验证码时手机也需开启科学上网)
---
## 注册步骤
1. 打开注册页面:[https://accounts.google.com/signup](https://accounts.google.com/signup)
2. 填写姓名、用户名(即 Gmail 地址)、密码
3. 输入手机号接收验证码
4. 完成生日、性别等基本信息填写
5. 同意服务条款,注册完成
---
## 注意事项
- **用户名**即你的 Gmail 邮箱地址(如 `yourname@gmail.com`),注册后不能修改,慎重选择
- 如果手机号提示"无法验证",确认手机也开启了科学上网(节点选美国),再重试
- 建议开启两步验证2FA保护账号安全[https://myaccount.google.com/security](https://myaccount.google.com/security)
---
注册完成后,即可用**使用谷歌账号登录**按钮快速注册/登录各 AI 工具,无需记额外密码。