• 天卡兑换后 24 小时内有效，可无限叠加。
• 所有套餐会在开通 24 小时后刷新额度，多个订阅套餐同时生效时可叠加使用。

当前可直接使用的主力模型如下，实际可见模型以后台分组与套餐权限为准。

通用 config.toml 示例

model_provider = "custom"
model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.custom]
name = "custom"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://aiapis.help/v1"

通用 auth.json 示例

{
  "OPENAI_API_KEY": "这里填入你在后台创建的 sk- 开头密钥",
  "auth_mode": "apikey"
}

4. 常见错误

• 如果提示 401 或密钥不正确，通常是没有替换为你自己创建的 sk- 密钥，或者本地仍在读取旧配置。
• 如果请求仍然走的是 OpenAI 官方地址，说明 config.toml / auth.json 没有覆盖成功，或者没有切换到自定义网关。
• 修改配置后记得重启 VSCode、IDEA、Codex 客户端或重新创建会话，让新配置重新加载。

• 命令找不到：关闭并重新打开 PowerShell，PATH 环境变量才会生效
• 权限错误：以管理员身份运行 PowerShell
• 安装慢：配置 npm 镜像（见上方）

更多问题请查看 典型错误排查

• 命令找不到：关闭并重新打开终端，环境变量才会生效
• 权限错误：推荐使用 nvm 安装 Node.js，避免 sudo
• 安装慢：配置 npm 镜像（见上方）

更多问题请查看 典型错误排查

• 命令找不到：关闭并重新打开终端，环境变量才会生效
• 权限错误：推荐使用 nvm 安装 Node.js，避免 sudo
• 安装慢：配置 npm 镜像（见上方）
• 防火墙问题：确保允许访问 misscuai.help

更多问题请查看 典型错误排查

AI编程助手正在从根本上改变开发者的工作方式。从代码补全到架构设计，从Bug修复到文档生成，AI工具让开发者能够专注于创造性工作，将重复性任务交给智能助手处理。

量化收益分析

场景一：快速原型开发

从零开始构建一个MVP（最小可行产品）：

• 需求描述 → 代码生成：用自然语言描述功能，AI自动生成基础架构和核心代码
• 组件快速搭建：输入UI设计描述，AI生成React/Vue组件代码
• API接口开发：自动创建RESTful/GraphQL接口，生成Swagger文档
• 数据库设计：根据业务需求自动设计Schema和ORM模型

场景二：遗留代码维护

处理历史遗留项目和老旧代码库：

• 代码理解：AI分析复杂代码逻辑，生成通俗易懂的解释和流程图
• 技术债务识别：自动发现代码异味、重复代码和架构问题
• 现代化重构：将旧版代码升级到新框架/语言版本，如jQuery→React
• 自动化测试：为遗留代码生成单元测试，提高代码可信度

场景三：Bug排查与修复

高效定位和解决软件缺陷：

• 智能诊断：分析错误日志和堆栈跟踪，快速定位问题根因
• 修复建议：提供多种修复方案，并解释每种方案的优缺点
• 回归测试：自动生成测试用例验证修复效果
• 根因分析：识别系统性问题，预防同类Bug再次发生

📋 需要准备什么？

• 终端/命令行：用于执行 npm 安装命令和运行 Claude Code
• Node.js 18+：Claude Code 的运行环境（必需）
• Git：版本控制工具（可选但强烈推荐）
• 网络连接：用于下载安装包和连接 AI 服务

✅ 不需要什么？

• ❌ 不需要编程基础 —— 按照教程操作即可
• ❌ 不需要复杂配置 —— 大部分步骤都是自动的
• ❌ 不需要付费软件 —— 所有工具都是免费的

⏱️ 预计时间

10-15 分钟 完成所有准备工作（如果已安装 Node.js 和 Git，只需 5 分钟）

📝 准备步骤清单

git --version

node -v
npm -v

🪟 Windows 安装

git --version

🍎 macOS 安装

方法 1：Xcode Command Line Tools（推荐）

打开终端（Terminal），输入：

xcode-select --install

系统会弹出安装提示，点击"安装"即可。这个方法会同时安装 Git 和其他开发工具。

方法 2：Homebrew

如果已安装 Homebrew，可以使用：

brew install git

验证安装

git --version

🐧 Linux 安装

Ubuntu / Debian

sudo apt update
sudo apt install -y git

CentOS / RHEL

sudo yum install -y git

Fedora

sudo dnf install -y git

Arch Linux

sudo pacman -S git

验证安装

git --version

📦 Node.js 是什么？

Node.js 是一个 JavaScript 运行环境，Claude Code 需要它来运行。npm（Node Package Manager）是 Node.js 的包管理工具，用于安装和管理各种工具和库。

🎯 版本选择

• 推荐版本：LTS（长期支持版） —— 稳定可靠
• 最低要求：Node.js 18+
• 查看当前版本：node -v

📥 安装方式

方式 1：官方安装包（推荐新手）

访问 nodejs.org 下载 LTS 版本安装包

• Windows：下载 .msi 安装包，双击安装
• macOS：下载 .pkg 安装包，双击安装
• Linux：推荐使用包管理器（见下方）

方式 2：版本管理工具（推荐开发者）

使用版本管理工具可以方便地切换不同版本的 Node.js，避免权限问题：

• Windows：使用 nvm-windows
• macOS/Linux：使用 nvm 或 fnm

# macOS/Linux 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 安装 Node.js LTS
nvm install --lts
nvm use --lts

✅ 验证安装

node -v
npm -v

应该看到类似输出：

v20.11.0
10.2.4

🚀 npm 镜像配置（国内用户必看）

为什么需要镜像？

npm 官方源在国内访问较慢，使用国内镜像可以大幅提升安装速度。

配置淘宝镜像

npm config set registry https://registry.npmmirror.com

验证配置

npm config get registry

应该显示：https://registry.npmmirror.com/

恢复官方源

如果需要恢复官方源：

npm config set registry https://registry.npmjs.org

1. `claude` 命令找不到

症状

'claude' 不是内部或外部命令，也不是可运行的程序
command not found: claude

原因

• Claude Code 未正确安装
• PATH 环境变量未生效（需要重启终端）

解决方案

Windows：

1. 关闭并重新打开 PowerShell/cmd（必须重启终端）
2. 检查安装：npm list -g @anthropic-ai/claude-code
3. 如果未安装，重新执行：npm install -g @anthropic-ai/claude-code

macOS/Linux：

1. 重新打开终端
2. 检查 PATH：echo $PATH
3. 检查 npm 全局路径：npm config get prefix
4. 如果使用 nvm，确保已激活：nvm use --lts

2. `node` 或 `npm` 命令不存在

症状

command not found: node
command not found: npm

原因

Node.js 未安装或未添加到 PATH

解决方案

1. 确认 Node.js 已安装（参考 Node.js 与 npm 说明）
2. Windows：重新安装时勾选"Add to PATH"
3. macOS/Linux：检查 ~/.bashrc 或 ~/.zshrc 配置

3. npm 安装权限错误（EACCES）

症状

npm ERR! code EACCES
npm ERR! syscall access
npm ERR! path /usr/local/lib/node_modules
npm ERR! errno -13

原因

没有权限写入全局 node_modules 目录

解决方案

Windows：

以管理员身份运行 PowerShell：

1. 右键点击 PowerShell
2. 选择"以管理员身份运行"
3. 重新执行安装命令

macOS/Linux（推荐使用 nvm，避免权限问题）：

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 重新加载配置
source ~/.bashrc  # 或 source ~/.zshrc

# 安装 Node.js
nvm install --lts

# 重新安装 Claude Code
npm install -g @anthropic-ai/claude-code

4. npm 安装速度慢或超时

症状

npm ERR! network timeout
npm ERR! network This is a problem related to network connectivity

原因

• 网络连接问题
• npm 官方源在国内访问慢

解决方案

配置国内镜像：

npm config set registry https://registry.npmmirror.com

使用代理（如果有）：

npm config set proxy http://proxy.example.com:8080
npm config set https-proxy http://proxy.example.com:8080

5. PowerShell 执行策略错误（Windows）

症状

无法加载文件，因为在此系统上禁止运行脚本

原因

PowerShell 执行策略限制

解决方案

以管理员身份运行 PowerShell，执行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

6. 无法连接到 AI Tech Relay 服务

症状

Error: Failed to connect to https://aiapis.help/

原因

• Token 配置错误
• Base URL 配置错误
• 网络连接问题

解决方案

1. 检查配置文件：
   • Windows：%userprofile%\.claude\settings.json
   • macOS/Linux：~/.claude/settings.json
2. 确认 Token 格式：sk-xxx...
3. 确认 Base URL：https://aiapis.help/
4. 测试网络：ping misscuai.help

7. Token 无效或过期

症状

Error: Invalid authentication token

解决方案

1. 登录 AI Tech Relay 官网
2. 重新生成 Token
3. 更新配置文件中的 ANTHROPIC_AUTH_TOKEN

8. 如何更新 Claude Code

更新命令

npm update -g @anthropic-ai/claude-code

查看当前版本

claude --version

9. 如何卸载 Claude Code

卸载命令

npm uninstall -g @anthropic-ai/claude-code

清理配置文件（可选）

• Windows：删除 %userprofile%\.claude 文件夹
• macOS/Linux：删除 ~/.claude 文件夹

🗓️ 案例一：交互式万年历网站

使用 Claude 创建一个功能完整的交互式万年历网站，支持农历显示、节气标注、节假日高亮等功能。

Step 1：搭建基础结构

<!-- Claude 将生成 -->
<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>万年历</title>
    <link rel="stylesheet" href="style.css">
</head>
<body>
    <div class="calendar-container">
        <header>
            <h1 id="currentMonth">2025年1月</h1>
            <div class="controls">
                <button onclick="prevMonth()">上月</button>
                <button onclick="nextMonth()">下月</button>
            </div>
        </header>
        <div class="weekdays">
            <div>日</div><div>一</div><div>二</div>
            <div>三</div><div>四</div><div>五</div><div>六</div>
        </div>
        <div id="calendar" class="calendar-grid"></div>
    </div>
    <script src="app.js"></script>
</body>
</html>

Step 2：添加样式和交互

Step 3：实现核心功能

✅ 案例二：待办事项应用

快速构建一个功能完整的待办事项（Todo）应用，支持增删改查、分类筛选和数据持久化。

核心功能规划

提示词示例

📝 案例三：个人博客网站

使用 Claude 搭建一个静态博客网站，支持 Markdown 文章渲染、代码高亮和响应式布局。

技术栈选择

• 框架：纯 HTML/CSS/JS 或 Vue/React
• 样式：Tailwind CSS 或自定义 CSS
• Markdown：marked.js 库解析
• 代码高亮：Prism.js 或 highlight.js

构建步骤

📊 案例四：数据可视化仪表板

创建一个交互式数据仪表板，使用 Chart.js 或 ECharts 展示各类数据图表。

提示词技巧

场景：充值并使用Claude Sonnet

1. 充值100元，享受1.2x活动倍率 → 获得 $120 额度
2. 使用Claude Max号池（按0.9x计费）
3. 实际消耗：每使用$1额度，扣除账户 $0.9
4. $120额度实际可用价值：$120 ÷ 0.9 = $133.33