From 4d653c13a07bdfd83f5f452c4ed2c226c422dd13 Mon Sep 17 00:00:00 2001 From: admin Date: Sat, 28 Feb 2026 14:49:00 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E=20AI=20=E7=BC=96=E7=A8=8B?= =?UTF-8?q?=E5=B7=A5=E5=85=B7=E5=85=A5=E9=97=A8=E6=8C=87=E5=8D=97=E6=96=87?= =?UTF-8?q?=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 新增 cursor.md：Cursor 安装、注册、订阅说明 - 新增 claude-code.md：Claude Code 安装、注册、订阅及国内充值方案 - 新增 google-account.md：谷歌账号注册指南（含科学上网说明） - 更新 README：入门指南移至顶部，补充 Skills/Agent/MCP 概念说明 Co-Authored-By: Claude Sonnet 4.6 --- README.md | 20 +++++++ claude-code.md | 136 ++++++++++++++++++++++++++++++++++++++++++++++ cursor.md | 63 +++++++++++++++++++++ google-account.md | 42 ++++++++++++++ 4 files changed, 261 insertions(+) create mode 100644 claude-code.md create mode 100644 cursor.md create mode 100644 google-account.md diff --git a/README.md b/README.md index 6a73220..7740eaf 100644 --- a/README.md +++ b/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) | + +--- + ## 目录结构 ``` diff --git a/claude-code.md b/claude-code.md new file mode 100644 index 0000000..617b97b --- /dev/null +++ b/claude-code.md @@ -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) diff --git a/cursor.md b/cursor.md new file mode 100644 index 0000000..0e797e7 --- /dev/null +++ b/cursor.md @@ -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) diff --git a/google-account.md b/google-account.md new file mode 100644 index 0000000..6596237 --- /dev/null +++ b/google-account.md @@ -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 工具，无需记额外密码。