AI 工具使用分享

Claude Code 原生是为 Linux / macOS 设计的，而 Windows 系统命令不同，所以需要装 Git 来进行一个准备工作。

下载安装包，安装时狂点下一步就行。

打开终端（Windows 用 PowerShell，Mac/Linux 用 Terminal），粘贴命令即可：

因为 2.1.156 版本使用第三方 API 存在兼容性问题，建议回退 153 版本。

整个过程会下载一个 200+MB 的软件，取决于个人的网络状态，时间可能会很长。

04

安装 cc-switch，接入 DeepSeek 模型Step 04 · Model Setup

软件装好了，但还没有 AI 模型可用。这时候需要 cc-switch，它可以一键切换不同的 AI 模型提供商（智谱 GLM、MiniMax、Kimi、DeepSeek 等）。

🔑 4.1 准备：申请 API Key（5 分钟，可任选一家）

在装 cc-switch 之前，先去下面任一平台拿个 API Key。下面 4 家是国内主流，全部支持中文、按量付费、新用户有赠送额度，可以同时申请 2-3 家对比效果。

4 家平台申请入口对照

平台	特点	申请入口
DeepSeek ⭐推荐	中文最强 / 便宜 / 推理 / 编码	platform.deepseek.com
智谱 GLM	清华 / 速度快 / 适合长文	bigmodel.cn
Kimi	月之暗面 / 长上下文 / 联网	kimi.com
MiniMax	国内云厂商 / 稳定	platform.MiniMax.io

以 DeepSeek 为例，5 步拿到 API Key

1. 打开 platform.deepseek.com，用手机号注册账号
2. 登录后，左侧菜单点 API Keys
3. 点右上角 创建 API Key，起个名字（如 "CC-Switch"）
4. 点确认，立刻复制 Key（只显示一次，关闭就没了）
5. 顺手在 余额 页面点"充值"（按量付费，最低 1 元起；新用户一般有赠送额度）

图：DeepSeek 平台 API Keys 管理页面（点右上"创建 API Key"按钮）

拿到 Key 之后，下面 cc-switch 那里填进去就行。

💰 4.1.5 重点：DeepSeek 涨价了，但 V4 Flash 仍是首选

涨价后（v4-pro）：1 千万 token → ¥13.77

涨价前（v4-pro）：5 千万 token → ¥11.80

结论：相同花费，能用的 token 数缩水到 1/5。V4 时代的"白菜价"基本结束。

但 V4 Flash 仍是首选，理由 3 条：

• 多模态：能看图、读 PDF、解析代码截图 — V3 没有
• 强推理：R1 级逻辑推理能力，比 v4 强一档
• 门槛低：相比 Claude / GPT 仍便宜 5-10 倍，能力不输

一句话：贵了，但 V4 Flash 仍是国内最香的全能选手。

🧭 4.2 选模型：怎么挑适合自己的？

不同模型擅长不一样，按下面场景选就行：

• 写代码 / 改 Bug → deepseek-coder / deepseek-chat / glm-4
• 复杂推理 / 数学 / 算法 → deepseek-reasoner
• 长文档总结 / 论文 → Kimi（200K 上下文）
• 日常问答 / 翻译 / 写作 → deepseek-chat 通用够用
• 需要 Claude / GPT 效果 → 用第三方 API 中转服务（在 cc-switch 选 Claude 图标）

建议：先在 2-3 个平台各充 1 元试用，跑同样的 prompt 比效果再定主力。

🔁 4.3 在 cc-switch 切换模型（不用改代码）

cc-switch 的核心价值是一个客户端跑所有模型，不用每次改配置文件。切换步骤：

1. 打开 cc-switch，看左侧"渠道列表"（已添加的模型都会在这里）
2. 点要用的那个模型卡片 → 顶部 启用 按钮亮起
3. 回到 Claude Code 对话框，下一条消息自动走新模型
4. 切换是实时生效，不用重启 Claude Code

图：cc-switch 渠道列表，点任一卡片即可切换（紫蓝框表示当前启用）

实战技巧：平时日常对话用 deepseek-chat（便宜快），遇到难问题临时切 deepseek-reasoner（贵但强），不用频繁开关账号。

💡 推荐用 DeepSeek

本教程默认接入 DeepSeek。如需其他模型：智谱 GLM、Kimi 等都支持。Claude、GPT 等模型可通过第三方 API 服务接入。

下载安装（去 GitHub Releases 找最新版）：

↓

CC-Switch for Windows Windows 安装包

→

↓

CC-Switch for macOS macOS 安装包

→

新版本发布时可从 GitHub Releases 获取更新

安装完成后，以 DeepSeek 为例，在 cc-switch 选 Claude 图标（默认第一个），点"添加渠道"：

• 渠道名称：随便起，例如 "DeepSeek-V3"
• Base URL：https://api.deepseek.com/anthropic
• API Key：你的 DeepSeek 密钥（在 platform.deepseek.com 申请）
• 模型：deepseek-chat（或 deepseek-reasoner 推理更强）

保存并启用，回到终端输入 claude 就可以直接开始对话了。

图：cc-switch 添加 DeepSeek 渠道示意

安装后仍然报错的一种情况

图：Claude Code 登录检查报错

如果你出现了上图这种情况，点这里查看处理方式

原因：CC Switch 的作用就是一键修改 Claude Code 的配置文件，但 Claude Code 在首次运行时如果没有通过检测，会直接忽略你自定义的 API 地址，还是会去强行连接官方做登录检查。

方法一：通过命令修

直接在终端运行以下命令，向 .claude.json 写入"已完成初始化"的标识：

macOS / Linux：

bash 复制 echo '{"hasCompletedOnboarding": true}' > ~/.claude.json

Windows：

powershell 复制 echo '{"hasCompletedOnboarding": true}' > $env:USERPROFILE\.claude.json

方法二：手动改文件

打开 C:\Users\你的用户名\.claude.json（路径里的用户名部分每个人都不一样，看你自己的用户名是什么）。

它默认可能是隐藏的，你需要在文件管理器上面勾选一下显示隐藏的文件。如果你的电脑上直接没有这个文件，那就新建一个也可以。

然后把这个内容复制进去："hasCompletedOnboarding": true,

保存文件，确保 CC Switch 已经切换到你自己的渠道后，重启你的 Claude Code。如果你的格式会报错，比如多了一个引号、括号或句号，可以把文件里的内容全选复制，发给任意一个网页版 AI，让它只修复格式、保留原有内容，然后把结果重新粘贴回来。

图：.claude.json 文件内容示意

05

嵌入 VSCodeStep 05 · IDE Integration

Claude Code 默认是终端工具，但在 VSCode 里用体验更爽 — 左侧编辑器，右侧对话框，文件改动实时可视化。

💡 两种方式选一个

方式一（推荐）：装 Anthropic 官方扩展，左侧栏直接有 Claude 图标。

方式二（轻量）：在 VSCode 终端里直接跑 claude。

方式一：装官方扩展（推荐）

1. 打开 VSCode 扩展市场（左侧边栏第 5 个图标，或者按 Ctrl+Shift+X）
2. 搜索 "Claude Code for VSCode"（Anthropic 官方）
3. 点 Install
4. 安装完成后，左侧活动栏会出现一个 Claude Code 图标
5. 点图标 → 弹出登录窗口 → 选择你已经配好的渠道（cc-switch）
6. 完事，VSCode 右侧出现对话面板

图：VSCode 扩展市场搜索结果 + 安装后左侧栏 Claude 图标位置（红框标注）

图：装好扩展后点击左侧栏 Claude 图标，VSCode 右侧弹出对话面板（"New session" 新建会话，下方输入框提问）

方式二：VSCode 终端里直接跑

1. VSCode 里打开终端（菜单 Terminal → New Terminal，或快捷键 Ctrl+\`）
2. 输入 claude 启动
3. Claude Code 直接在 VSCode 终端里运行，文件和代码实时高亮

图：VSCode 终端里输入 claude 后的欢迎界面（"Welcome back!"，提示 /init 创建 CLAUDE.md）

小白必会：4 个实用技巧

• @ 引用文件：在对话框输入 @文件名，Claude 自动读那个文件
• 拖文件到对话框：直接拖文件进去让 Claude 读
• / 命令：输入 / 弹出命令列表（/help 查看帮助）
• Ctrl+L：切换对话面板显示/收起

MiniMax Code（自带 agent 是 Mavis）是 MiniMax 公司出品的 agentic coding workspace —— 一个能读文件、改文件、跑命令、查资料、跨 session 记忆的 AI 同事。

本文用的 Mavis就跑在 MiniMax Code 里 —— 不是一个"工具"，是一个有记忆、有同事关系、越用越懂你的 AI 同事。

6 大核心优势（先看概览，详见后文）

从 MiniMax.io/download 下载对应平台安装包，狂点下一步安装。装完用第 1 步的账号登录。

装好后打开就是这个样子（左侧栏项目 + Agent 团队 + 主输入区）：

左侧是项目 + 定时任务 + Agent 团队（Mavis/Explore/Verifier/Worker），中央是输入区，右上角是设置入口。

桌面应用左上"远程控制" → 看到右侧手机示意图 + 二维码 → 手机 MiniMax App 扫一下 → 绑定成功。从此手机和电脑同会话实时同步。

桌面端"远程控制"页：左侧"已连接"状态 + 3 个卖点 + 设置入口；右侧蓝底展示手机端联动效果。

手机端长这样 —— 同一份项目列表、同一份对话，通勤摸鱼时也能追任务：

手机端：顶部显示"DESKTOP-8JTHD81 已连接"，下面是项目 + 最近对话列表，底部"+"新建任务。

打开桌面应用，输入：

agent（Mavis）会自我介绍 + 列出它能做什么（读文件、写代码、跑命令、查资料、记忆等）。

默认是 MiniMax M3（便宜、跑得快）。想用其他模型时点输入框上方的"模型下拉"直接切：

点"MiniMax-M3"下拉 → 选目标模型（M3 / M2.7-highspeed / M2.7），还可以打开"思考"开关让模型多花时间推理。

在 platform.MiniMax.io/subscribe/token-plan 充值。关键先搞清楚你要走哪条路——这两条路收费方式完全不同，混了会亏钱。

顶部分 OFFICIAL（自家 Agent）和 DIY（自己的工具）两条路。下方三档套餐只对 OFFICIAL 有效。

两种使用方式（二选一）

• OFFICIAL · Mavis Code — 用自家 Agent（桌面 / 网页）。买 Token Plan 订阅，开箱即用，无需配 API Key。
• DIY · 用在自己的工具 — CC / Cline / Cursor 等。需申请 API Key 按用量付费，不享受套餐。

套餐选择（按个人/小组场景）

• Plus ¥49/月 — 6 亿 token M3 用量，3-4 个 Agent 并发。（我目前使用的）
• Max ¥119/月 — 18 亿 token，4-5 Agent 并发。
• Ultra ¥469/月 — 71 亿 token，6-7 Agent。适合团队 / 重度用户。

给同事的实际建议

• 只在 Mavis Code 里用 → 买 Token Plan 套餐（推荐 Max，够用一档即可）
• 要在 CC / Cline 等工具里用 → 别买 Token Plan，去 API Key 页面单独按量充值
• 两个都装 → Token Plan 包住日常 + API Key 留 1 个调用额度做应急

🐑 每日签到领积分（羊毛别忘薅）

桌面端左侧菜单 → 「每日签到」。连续 7 天一个周期，每天点一次给积分：

左下角"每日签到"展开后：7 天格子（第 1/3/4/5/6/7 天各 +400 或 +1000 积分）。今天签完会显示"今日已签到"，明天接着点。

积分虽少（400-1000/天），但攒起来能换模型调用次数，等于变相延长 Token Plan 寿命。养成每天打开桌面端就顺手点的习惯。

两者不是替代关系，是互补。公司内推荐 2 个都装，按场景切换：

10 维度对比表

小白常卡 3 步（提前看）

一开始我也是 Claude Code 主力。后来切到 MiniMax Code，不是"取代"，是"日常用 Mavis，深度编程用 CC"。

用 CC 时的痛点

• 贵：跑 1 个下午对话能烧 5 美元，换算人民币 35 块 —— 跑深度任务前都要"心疼一下"
• 没多端：下班路上 / 摸鱼时想看任务进度？—— 没招
• 中文一般：写中文文档经常出来"翻译腔"，要再调一轮

现在的方案

• 日常（写文档 / 改脚本 / 查资料 / 跑批量）→ MiniMax Code主力，便宜 + 记忆 + 多端
• 深度编程（改大型项目 / VSCode 重度集成）→ CC + DS主力，VSCode 嵌入深
• 两边都装，看场景切换 —— 不纠结选哪个

两台电脑（公司 + 家里 / A 机 + B 机 / 主力 + 备用）共用同一个 .minimax 配置，记忆、Skills、Agents 一致。

痛点：两台机独立演化，记忆漂移、配置不同步，工具体验不一致。

架构

┌────────────┐  git push  ┌──────────────┐  git pull  ┌────────────┐
│  A 机       │ ────────→ │ Gitee 私有仓  │ ←──────── │  B 机       │
│  .minimax   │            │ (中转 + 备份) │            │  .minimax   │
└────────────┘            └──────────────┘            └────────────┘

两台机都要做。先选一台作为主仓源（配置最新的那台），把它的 .minimax push 上去。

① 在 Gitee 建私有仓（没有账号的先注册）

在 Gitee 主页右上角点 「+」 → 「新建仓库」：

1. 打开 gitee.com/new（登录你的账号）
2. 填表：
   • 仓库名：minimax-config（或 dotfiles，名字随便起）
   • 归属：你的个人空间
   • 是否开源：私有（必须）
   • 使用 Readme 初始化：❌ 不勾
3. 点「创建」

表单长这样，照着填：

② 生成私人令牌（push 时密码用）

Gitee 现在不允许用登录密码 push，必须用私人 access token代替。先开这页：

1. 打开 gitee.com/profile/personal_access_tokens
2. 点右上角 「+ 生成新令牌」
3. 填表：
   • 私人令牌描述：随便写（如 minimax-pc，方便认是哪台机器）
   • 权限：选 「私人令牌」（默认）
   • 令牌过期时间：随便选（永不过期也可以，过期后重新生成）
   • 权限范围：只勾 projects（其他不要勾，权限最小化）
4. 点「提交」 → 立即复制 token 字符串（关掉页面就找不回来了！）

勾选长这样：

③ 写 .gitignore（关键）

在 $env:USERPROFILE 下创建 .gitignore-minimax，同步时复制到 .minimax\.gitignore：

# 缓存 / 临时文件
**/cache/
**/sessions/
**/*.log
**/*.tmp
**/*.pid

# 敏感凭据（绝对不入仓）
**/secrets/
**/*.key
**/auth.json
**/.env
**/smtp.json

# IDE / 工具
**/.vscode/
**/.idea/

# 系统
**/Thumbs.db
**/.DS_Store
**/desktop.ini

④ 主仓源：首次 push

假设 .minimax 在 C:\Users\Lenovo\.minimax。

cd $env:USERPROFILE\.minimax   # 切到 .minimax 目录（$env:USERPROFILE = 当前用户主目录）
git init                         # 初始化一个 git 仓（创建隐藏的 .git 文件夹）
git remote add origin https://gitee.com/你的用户名/minimax-config.git   # 告诉 git：远端地址是这个
git add -A                       # 把所有文件都登记成"准备提交"
git commit -m "init: minimax config 备份"   # 提交，写一句说明
git branch -M master             # 把分支名改成 master（Gitee 默认 master）
git push -u origin master        # 推到 Gitee 远端（-u = 记住这个地址，下次直接 push）

⑤ B 机：首次 clone

这一步在 B 机 跑（不是 A 机）。A 机已经推完了，B 机第一次要把代码从 Gitee 拉下来。

cd $env:USERPROFILE                                  # 切到用户主目录
Rename-Item .minimax .minimax.bak-local              # 把现有的 .minimax 改名备份（原目录还在，名字改了）
git clone https://gitee.com/你的用户名/minimax-config.git .minimax   # 从 Gitee 拉仓下来，重命名为 .minimax

改完配置后，手 push / 手 pull。建议几天一次（不要每次都同步）。

A 机（改完的机器）→ 推

在 A 机 PowerShell 里复制粘贴这段：

cd $env:USERPROFILE\.minimax   # 切到 .minimax 目录
git add -A                       # 登记所有改动
git commit -m "update: 改了 XX"  # 提交（XX 写你改了什么，比如 "新增 skills"）
git push                         # 推到 Gitee

凭据不会弹（因为已经记过了），直接看到 [master xxx] update: 改了 XX = 成功。

B 机（要同步的机器）→ 拉

在 B 机 PowerShell 里复制粘贴这段：

cd $env:USERPROFILE\.minimax   # 切到 .minimax 目录
git pull --rebase              # 从 Gitee 拉最新下来（--rebase 避免多余 merge commit）

看到 Already up to date. 或文件列表更新 = 拉成功。

重启 Mavis，新配置生效。

📋 同步场景速查表

冲突怎么办？

两台机同时改一个文件 → git pull 报冲突。两种处理：

1. 以一台为准：在 A 机 git checkout --theirs .（A 覆盖 B），或反之 --ours
2. 手动 merge：看冲突标记 <<<<<<<，编辑后 git add + commit + push

🚫 这些东西绝对不能 commit

✅ 推荐做法

• 配置文件里 token 写占位符（如 "api_key": "YOUR_KEY_HERE"），本地用 .env 真实值，.env 加进 .gitignore
• 敏感信息走系统环境变量，配置文件只读 os.environ
• 定期到 Gitee Token 页面 看一眼哪些 token 还活着

进阶：完全自动化

想跟本文档部署一样自动监听 / 推送？可以仿照 watch_deploy.ps1 写个 watch_minimax_sync.ps1，监听 .minimax 改动自动 git add + commit + push。但不推荐：容易两台机同时改产生冲突。

干嘛的：让 AI 帮你"指哪打哪"地改代码 —— 不用描述半天"我想改那个按钮"，AI 自己扫代码建索引，你只说人话。

核心结构（Role + Task + Workflows + 输出格式）：

👉 完整原文 + 详细示例 → shuocier.com/Tools/22.html

干嘛的：把一篇 50 页的 PDF / 章节，AI 自动产出结构化笔记（章节概述 + 关键内容 + 主要观点 + 思考问题 + 关键术语）。

核心结构（学术级读书笔记生成助手）：

👉 完整原文 + 评价 → shuocier.com/Tools/dushubiji.html

干嘛的：让 AI 不再"是 / 否 / 你觉得呢"地敷衍，直接给洞察，把模糊感受变清晰语言。适合复杂问题诊断。

核心结构（v3.5 简化版）：

👉 完整 v5.9 + v3.5 原文 → shuocier.com/Tools/claude4-5sixiang.html

干嘛的：让 AI 不夸你、不奉承、没废话，以"正常人跟你聊天"的密度说话 —— 仿真/技术讨论专用。

完整原文（13 行短 prompt，直接用）：

👉 完整原文 + 中文翻译 → shuocier.com/Tools/gptman.html

三个来源任选：

• CC/DS skill 目录（~/.claude/skills/<name>）
• GitHub clone（git clone <url>）
• 自己写的 skill 目录

Copy-Item -Recurse -Force ".\source-skill-name" "C:\Users\Lenovo\.minimax\skills\source-skill-name"

路径 C:\Users\Lenovo\.minimax\skills\<name>\，文件夹名英文无空格。

每个 skill 必须有 SKILL.md，开头用 --- 包元数据：

---
name: skill-name
description: 1-2 句话说清做什么（< 200 字）
---

# 标题 + 怎么用

然后彻底关掉 MiniMax 重开（不是最小化）→ 设置 → Skills → 找到新 skill → 开关打开 → 对话里 /<name> 验证。

作者常用的一个 AI API 中转站导航站（4,354 个中转站已收录）。个人开发者想用 Claude / GPT / DeepSeek 但嫌官方贵时，先去这看看。

6 个分类（按需选）

• 💎 稳定企业向：高稳定性、24/7 售后、支持开票 —— 适合公司 / 团队长期使用
• 💰 便宜个人向：低倍率（0.1-0.3）、按量计费 —— 适合个人学习 / 轻量使用
• 🌟 小有特色类：某种模型独大 / 特殊场景 / 限免额度
• 🆕 新站上榜：最近 30 天新上线的站（往往有新人福利）
• 📚 其他中转站：长尾小站，按价格 / 评分排序
• 🕯️ FOM 专区：情怀向（已下线的经典模型 + 当时社区的评价）

覆盖的模型

OpenAI（GPT-4o / GPT-5）/ Claude（Opus 4 / Sonnet 4.5 / Haiku 4）/ Gemini / DeepSeek（V3 / V4 Flash）/ Qwen / Kimi / Codex / 国产开源（GLM / Doubao）—— 主流大模型基本都有。

⚠️ 使用前必看 3 条