一、背景与产品形态 
1. AI 编码工具的演进
自 Claude Sonnet 3.7 发布以来,AI 编码工具的生产力提升日益显著。目前主要产品形态包括:
IDE:
-
Cursor
-
Trae
-
LingmaIDE
CLI:
-
Claude Code
-
CodeX
-
Gemini CLI
-
iflow (国内推荐!!!)
IDE 插件:
-
Augment
-
通义灵码
等等…
2. 工具选型建议
一句话总结: 目前最佳的工具选型为
Claude Code
国内可以考虑iflow 平替
二、Claude Code 快速上手(Windows) 
Mac 和 Codex 方案见本文末尾
第一步:安装前置环境
1.1
安装 Node.js
访问官方网址下载 LTS 版本(推荐):
https://nodejs.org/zh-cn/download
1.2
安装 Git
访问官方网址下载:
https://git-scm.com/downloads/win
第二步:安装 Claude Code
打开 PowerShell 或 Terminal,执行以下命令:
npm install -g @anthropic-ai/claude-code
第三步:配置环境变量
使用中转站方案(获取方式见文末):
3.1
打开环境变量设置
-
右键点击 “此电脑” → “属性”
-
点击 “高级系统设置”
-
点击 “环境变量”
3.2
添加系统变量
在"系统变量"区域点击"新建",分别添加以下两个变量:
| 变量名 | 变量值 |
|---|---|
ANTHROPIC_BASE_URL |
可以使用一些中转站服务,类似AnyRouter |
ANTHROPIC_AUTH_TOKEN |
可以使用一些中转站服务 |
点击"确定"保存所有更改。
第四步:验证安装成功
按照以下步骤验证:
-
切换至项目路径
cd <your-project-path> -
启动 Claude Code
claude -
发送测试提示词 例如:
hello world -
查看连接状态 输入以下命令查看 BASE_URL,核对 API 地址是否正确:
/status
如果收到响应,说明连接服务成功!✓
三、一句话技巧系列 
提高 Claude Code 使用效率的关键技巧:
1.
善用多模态能力
-
产品需求文档分析可以直接贴入图片
-
模型可以识别视觉信息,加速需求理解
2.
提示词质量决定完成率
-
提示词越详细,需求完成率越高
-
预期完成率可达 95%+
3.
使用明确的代码路径
-
✓ 推荐:
xxx/xxx/xxx/*.java -
✗ 避免: “集点卡相关代码” 等描述性表述
-
直接指明路径可避免查找文件的消耗
4.
参考现有代码保持规范
-
参考 XX 路径的代码实现规范
-
参考 XX.vue 的 UI 风格
-
确保新代码与项目保持一致
5.
充分利用 Plan Mode
-
先确认计划再修改代码
-
避免不必要的重构
6.
配合 Git 使用
-
保存代码快照版本
-
防止 AI 失控污染源码
7.
Java 技术栈的最佳实践
-
IDEA:
用于调试代码
-
VSCode/Cursor + Claude Code:
用于 AI 编码
-
两者配合使用效果最优
四、提示词套路与模板 
核心套路总结
以下是贯穿所有成功案例的关键技巧和思维模式:
1.
上下文原则(Context is King)
提供参照物:
-
多次使用"参照…"、“参考已有代码…”、“参考这个请求…”
-
为 AI 提供明确的模仿对象
-
确保代码风格、命名规范和项目结构一致性
告知已有环境:
-
明确说明"目前已有 controller 类…"、“已有 mapper…”
-
让 AI 知道新代码应放在何处
-
利用现有组件,避免重复开发
2.
示例驱动原则(Example-Driven Development)
万物皆可示例:
-
为请求参数、响应结果、代码逻辑、表结构提供具体代码块示例
-
消除 AI 的猜测空间
-
这是最关键的成功因素
定义输入和输出:
-
清晰定义每个接口的输入(请求路径、方法、参数示例)
-
清晰定义每个接口的输出(响应结果示例)
-
AI 的任务变成从输入到输出的转换实现
3.
结构化表达原则(Structured for Clarity)
使用标题和分点:
-
需求分为:接口路径、请求参数、接口逻辑、响应结果、表结构等模块
-
清晰的结构化信息极大帮助 AI 理解任务
利用代码块:
-
SQL 定义、JSON 示例、Java 代码片段都用代码块包裹
-
既清晰又无歧义
4.
闭环逻辑原则(Closing the Loop)
描述完整流程:
-
不仅是单个接口,涉及从前端到后端的完整逻辑闭环
-
明确指出页面需要调用哪个后端接口
-
例如:数据接口为
POST /stampCards/list
定义用户行为:
-
描述具体的操作逻辑
-
将需求与用户交互关联起来
-
例如:“详情:点击后可以进入集点卡的详情页”
五、提示词模板 
模板一:
后端 API 开发
# 1. 目标与上下文
帮我补全/实现一个名为【功能名称,如:获取集点卡 ID】的接口。
-**参照已有实现**(强烈推荐): 参照 com.zuche.cardesconf.controller.SupplyStrategyController#init 的实现方式
-**所在 Controller**: com.zuche.cardesconf.controller.StampCardsController
# 2. 接口详细设计
## 接口名称
【例如:获取集点卡 ID (新建前调用)】
## 接口路径
【HTTP 方法 + 路径。例如:GET /stampCards/init】
## 请求参数
【参数详细描述,最好提供 JSON 示例】
## 接口逻辑
【描述核心业务逻辑】
1. 集点卡 ID:系统自动生成。格式: `JDYYYYMMDD` + `7 位数递增序列`
2. 递增序列使用 Redis 的 INCR 实现,key 为 `SUPPLY_ID_PREFIX` + 当天日期
3. 序列号需要补零至 7 位
4. 集点卡名称:最多 30 个字,必填,不可重复
## 参考代码/表结构
【提供最关键的参考信息,例如 Java 代码片段或 SQL 表结构】
## 响应结果
【必须提供一个清晰的成功响应 JSON 示例】
模板二:
前端页面生成
# 1. 目标
帮我新写/补充一个【页面名称,如:集点卡管理】的列表页/详情页。
# 2. 技术与环境
-**参考页面**(必须提供): /supplyStrategy/supplyRuleList.vue
-**路由地址**: /#/stampCard/stampCardList
-**数据接口**: POST /stampCards/list
# 3. 页面需求
## 需求描述
页面需要一个表格,展示集点卡列表,包含字段:
- ID
- 集点卡名称
- 创建人
- 创建时间
## 操作逻辑
1. 列表按照创建时间降序排列
2. 操作列需要有"详情"按钮
3. 点击"详情"按钮,跳转到详情页,URL 为 `/#/stampCard/stampCardDetail?stampCardId={id}`
# 4. 原型图片/草图(可选)
【如果方便,描述一下页面的大致布局】
模板三:
设计审查与重构
# 1. 目标
帮我 Review/审查以下【设计类型,如:表结构设计】是否合理。
# 2. 审查对象
【在这里贴上需要审查的完整代码块,例如 CREATE TABLE 语句】
# 3. 核心问题
**业务场景:** 奖品发放会增加用户点数,活动参与会消耗用户点数
**问题描述:** 我想设计一个集点卡点数增减的功能,这两张表(账户表和流水表)的结构设计合理吗?有没有什么可以优化的地方?
预期完成率: 使用以上模板,需求预期完成率 95%+
六、Claude Code For VSCode 插件 
2.0 版本升级内容 
Claude Code 升级至 2.0 后,Claude Code For VSCode 也完成了对应升级,实现了可视化交互支持。
使用体验提升
升级前:
触发启动 → 打开终端启动命令行界面
升级后:
触发启动 → 显示可视化交互窗口
主要优势
-
✓
避免 terminal 导致的字符错误 -
✓
更容易查看上下文 -
✓
思路展示更清晰 -
✓
交互体验显著提升
插件答疑: Claude Code For VSCode 常见问题
六.一、cc-switch 中转站切换插件(推荐) 
功能介绍
如果你使用了多个中转站点,频繁切换时往往需要重新配置环境变量。cc-switch 插件可以让你可视化直接切换站点,无需手动修改系统环境变量。
主要优势
-
✓
支持多个中转站点管理 -
✓
一键可视化切换 -
✓
无需手动修改环境变量 -
✓
快速便捷的站点切换体验
获取地址
cc-switch GitHub 仓库: GitHub - farion1231/cc-switch: A cross-platform desktop All-in-One assistant tool for Claude Code, Codex & Gemini CLI.




