新增 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
parent
cccd5face6
commit
4d653c13a0
20
README.md
20
README.md
@ -2,6 +2,26 @@
|
||||
|
||||
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
136
claude-code.md
Normal 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
63
cursor.md
Normal 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
42
google-account.md
Normal file
@ -0,0 +1,42 @@
|
||||
# 注册谷歌账号
|
||||
|
||||
谷歌账号相当于国外互联网的"微信"，可以一键登录绝大多数国外 App 和网站，包括：
|
||||
|
||||
- AI 工具：Cursor、Claude、ChatGPT 等
|
||||
- 社交平台：X（Twitter）、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 工具，无需记额外密码。
|
||||
Loading…
x
Reference in New Issue
Block a user