Claude Code最佳实践(国产大模型+CLAUDE.md配置)

一、为什么选择Claude Code?

其实,刚开始,从内心我是很排斥Claude Code的,原因:

1、命令行终端操作,程序员这么多年,深刻理解“工欲善其事必先利其器”的道理,好用的IDE对开发效率的提升很大;

2、Claude的官方对中国非常不友好,服务条款中明确禁止中国的实体使用Claude;

3、使用Claude模型非常麻烦,注册认证麻烦,容易招封,中转站也麻烦;

为此,我先后尝试了Trae,Cursor等主流的IDE,用起来也还算可以;但是当看大量的外国大牛,优秀的开源项目,都是直接或间接的使用Claude Code,各种IDE对比,Claude Code也一直都是No1,这就让我不禁开始怀疑自己,自己的选择也许是不对的,应该尝试去逼着自己使用Claude Code,我作为一个程序员,总比很多非程序员出生的人,更容易上手吧?

随着对Claude的逐步了解,认识到:

  1. Claude Code是编程工具,也是一个智能体,Claude是模型,Claude模型在国内很难搞定,但是Claude Code在国内是没有限制的;

  2. 框架本身足够强:上下文理解、文件操作、工具调用这些底层能力,Claude Code是目前做得最扎实的;

  3. 模型可替换:用不了Claude官方模型,没关系,接上千问,GLM、MiniMax这些国产模型,效果依然能打;

Claude Code绝对是现在所有的开发工具中,天花板最高的,能一步到位,就别在二流工具上浪费时间。


二、Claude Code的安装

建议搭档:Cursor + Claude Code

为什么这么建议?

  • Claude Code的命令行窗口,对于文件的访问很不方便,在开发的过程中,我们总是需要有一个很方便的方式,去直接打开并浏览自己的文件;

  • 当然你也可以使用vscode,但是要知道cursor相当于是vscode的增强版,vscode有的功能他都有;

  • cursor可以帮助我们很方便的安装vscode,不需要根据官方教程手动进行安装;

  • 在cursor使用终端的方式,使用Claude Code,有问题时候可以选择后“Add to Chat”很方便的搜索,或解决出现的问题(Ctrl + L)

1、检查环境(确认我本地是没有安装Claude Code的)

1779283967497456.png

2、一句话,让Cursor帮我们安装最新版的Claude Code1779284362840772.png

不用怀疑,Claude Code安装就是如此简单!

3、不要着急,启动前,要解决模型问题

前面说过,Claude默认模型是很难解决的,所以我们选择使用国内的模型进行替代,国内目前主流的Coding Plan套餐有以下几个(排名不分先后,哈哈):

  • 阿里云百炼:

  • 智谱GLM:

  • MiniMax:

  • ……其他,Kimi,腾讯,字节等等很多厂商都有提供套餐

网上大量的对比帖子,见仁见智,智谱GLM模型算是比较好的,但是套餐实在难抢,怀疑是在搞饥饿营销,除此之外,我个人比较喜欢用的阿里云百炼平台的

1779285739977723.png

我当前订阅的是阿里云的198/席/月的套餐,个人感觉还可以,支持以下模型:

1779285843607958.png

4、模型切换推荐使用cc-switch(别问为什么,用过你就知道)

cc-switch官网:https://ccswitch.io/zh/

cc-switch github地址:https://github.com/farion1231/cc-switch

下载位置:https://github.com/farion1231/cc-switch/releases

下载最新的就完事。

5、配置cc-switch,使用阿里云百炼的API-Key:1779286302133870.png

在cc-switch中选择添加新供应商(Bailian For Coding):

1779286411782502.png

进行如下配置:

1779286700133991.png

模型映射:选择百炼支持的,你喜欢的合适的模型即可;

至于主模型、Haiku、Sonnet、Opus的区别,我打算后面专门写一篇博客《模型分层》,进行对比,这里简单描述下先:

  • 主模型:全局默认启动模型,软件打开后所有默认对话、代码分析、项目读写、全局交互全部优先调用,是日常兜底主力模型

  • Haiku模型:速度冠军,快速搜索、简单问答、文档索引,轻量任务的优选(成本大约是Opus的1/30,相应速度快得几乎感觉不到延时)

  • Sonnet模型:性价比之王,日常编码的主力,日常编码、代码审查、重构优化(90%的编码任务,速度比Opus快2~3倍,成本只有Opus的1/10,但对大多数编码任务来说,质量已经足够好了)

  • Opus模型:最强最贵,处理复杂架构设计和多步推理;(10%任务 / 60%预算)

别让架构师去修bug,也别让实习生去做系统架构设计。

6、启动claude,看看我们配置的模型是否生效?

# 最基础的启动命令
claude

上来默认会让我们例行选择主题、安全提示、推荐配置、信任文件夹等,快速完成;

1779287982752900.png

显然我们自定义的模型生效了。


三、最佳实践:让你的Claude Code更顺手

1、写CLAUDE.md(最重要的一步)

CLAUDE.md是Claude Code的“宪法”,告诉它你的编码习惯、项目规则、安全红线。

  • 全局CLAUDE.md(~/.claude/CLAUDE.md):适用于所有会话,放跨项目的通用规则。

  • 项目CLAUDE.md(项目根目录/CLAUDE.md):针对当前项目的特殊约定。

一个简洁的全局CLAUDE.md模板:

## 关于我
我叫子丹,我的身份是一名程序员,工作经验10+年,精通JAVA后端、熟悉python,前端,go基础,运维相关知识,还熟悉区块链,是一个名副其实的全栈工程师。
我用 Claude Code 做 方案设计,代码编写,代码测试,安全审查,应用部署等。

## 思维原则
所有决策从问题本质出发,不因惯例照搬。
给我真实判断:方案有问题直接指出,发现更好路径直接说。

## 约束先行
新项目先写 CLAUDE.md,新目录先定结构约定(命名、归档、清理规则)。
已有规范先遵守;要改规范,先改文档再改实践。

## 沟通方式
- 默认中文,代码/命令/变量名用英文
- 结论先行,再给理由
- 遇到模糊需求,先给最合理方案,再问是否调整

## 自主边界(命中后必须先问)
- 删除文件/目录或改写 git 历史
- 修改 .env、密钥、token、CI/CD 配置
- 数据库 schema 变更或数据迁移
- git push / rebase / reset --hard / 强制推送
- 安装新的全局依赖或修改系统配置
- 公开发布(部署生产、发布包、发文章)

## 通用工程纪律
- 改完主动跑验证(命令见项目 CLAUDE.md)
- 不通过“注释报错/绕过校验”来伪修复
- 密钥、token、密码不进代码、不进 commit、不进日志
- 大改动先给方案,确认后实施

如果在(~/.claude/CLAUDE.md)目录找不到,那就自己新建一个;

配置完成后,记得验证下,全局CLAUDE.md文件是否生效。

1779289597835119.png

核心原则:CLAUDE.md不是越长越好,超过80行Claude就开始遗漏内容,最多别超过100行。只放它迷糊的那些边界规则。


四、Claude Code的基础知识和常用命令

1、三种模式(Shift + Tab循环切换)

显示内容 对应模式 说明
? for shortcuts  Default默认模式 每次编辑文件/执行命令都需要手动确认
⏵⏵ accept edits on Auto-Accept(自动接受模式) 文件修改自动执行,无需逐一确认(但 shell 命令仍需确认)
⏸ plan mode on  Plan计划模式 纯只读,只分析规划,不做任何修改

2、常用启动命令:

# 默认启动命令
claude

# 跳过权限检查,直接赋予全部权限。适合快速开发,但风险自负。如果你信任 Claude,就是想让它放开手脚改代码,可以加上这个参数。
## 疑AI不用,用AI不疑
claude --dangerously-skip-permissions

# 继续上次会话
claude -c

# 以上两个合并(我个人最常用的启动命令)
claude -c --dangerously-skip-permissions

3、常用/命令:

/help # 了解相关帮助
/init # 初始化项目,自动扫描代码库,并生成项目级CLAUDE.md文件
/clear # 用于清空当前会话的全部上下文,在每次切换大任务之前使用,节省token,还能避免历史干扰
/memory # 加载当前所加载的所有CLAUDE.md,便于快速访问
/agents # 核心的管理入口,创建、管理、查看、调用各种子代理

jiguiquan@163.com

文章作者信息...

留下你的评论

*评论支持代码高亮<pre class="prettyprint linenums">代码</pre>

相关推荐

暂无内容!