说实话,2026年做开发要是还没用过AI编程智能体,那真的有点落伍了。
上个月跟一个做后端的朋友吃饭,他跟我说现在写代码的效率至少翻了三倍——不是因为他变厉害了,而是他把Claude Code、Hermes这些工具全用上了,国产模型一接,成本还特别低。
我当时就不淡定了。回来花了一周时间,把市面上主流的四个AI编程智能体全装了一遍,又挨个配了DeepSeek、智谱GLM、Kimi、MiniMax、豆包、通义千问这些国产模型。踩了不少坑,也总结了一套完整的方法论。
今天这篇文章,就把我的实操经验全部分享出来。从安装到配置,从踩坑到避坑,一篇搞定。
一、四大AI编程智能体,到底该选哪个
先说结论:没有最好的,只有最适合你的。这四个工具各有侧重,适用场景不同。
1. Claude Code — 终端里的编程大师
Anthropic官方出品的终端编程助手。说白了就是在命令行里跑的一个AI程序员,能读你的代码、改你的文件、跑命令、做Git操作。最大的特点是agentic——你告诉它需求,它自己规划、自己执行、自己验证,不需要你手把手教。
• 安装方式:npm全局安装
• 适合人群:有一定命令行基础,喜欢终端操作的开发者
• 核心优势:工具调用能力强,上下文理解深,支持MCP扩展
2. OpenCode — 开源界的后起之秀
一个用Go写的开源终端AI编程工具,最大的卖点是支持75+模型提供商,基本上你能想到的模型它都能接。界面做得比Claude Code更友好,有TUI界面,支持分屏、文件树这些。
• 安装方式:curl一键安装或go install
• 适合人群:喜欢开源工具、需要灵活切换模型的开发者
• 核心优势:模型支持最广,配置灵活,社区活跃
3. Pi Agent — 极简主义者的选择
Pi的设计理念就两个字:极简。整个Agent只支持4种工具——bash、read、write、edit。没有MCP、没有子Agent、没有计划模式、没有权限弹窗。就是纯粹的"你说,它做"。
• 安装方式:npm安装
• 适合人群:讨厌复杂配置,追求极简体验的开发者
• 核心优势:零配置上手,响应快,资源占用低
4. Hermes Agent — 会自我进化的AI
Nous Research做的开源Agent框架。它跟其他三个最大的区别是——它会学习。用得越多,它越懂你的习惯和偏好。支持技能系统、持久记忆、多平台接入(微信、飞书、Telegram都能用)。
• 安装方式:curl一行命令
• 适合人群:需要长期AI助手、多平台协作的开发者
• 核心优势:自我进化、技能沉淀、多端同步
二、手把手安装教程
Claude Code 安装
Claude Code依赖Node.js环境,先确保你装好了Node.js 18+。
第一步,全局安装:
npm install -g @anthropic-ai/claude-code
第二步,验证安装:
claude --version
# 输出版本号即安装成功
Mac用户如果遇到权限问题,建议用nvm安装Node.js,不要用系统自带的。
OpenCode 安装
OpenCode的安装更简单,一行curl搞定:
# 方式一:curl一键安装(推荐)
curl -fsSL https://opencode.ai/install | bash
# 方式二:go install
go install github.com/sst/opencode@latest
# 验证
opencode --version
安装完成后,在项目目录执行opencode即可启动。首次启动会引导你配置模型。
Pi Agent 安装
Pi同样通过npm安装:
npm install -g @anthropic-ai/pi-agent
# 或者从源码安装
git clone https://github.com/anthropics/pi.git
cd pi && npm install && npm link
Pi的特色是零配置。装完直接pi启动,它会引导你设置API Key,然后就可以用了。没有复杂的配置文件,没有花哨的选项。
Hermes Agent 安装
Hermes的安装脚本做得很完善,唯一的前置依赖是Git:
# Linux / macOS / WSL2
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
# 重新加载shell后执行配置向导
hermes setup
配置向导会一步步问你选哪个模型提供商、填API Key。如果选DeepSeek,直接填https://api.deepseek.com和对应的Key就行。
Hermes装完后还能接入微信、飞书这些平台,这个后面会讲到。
三、国产模型配置方法(核心干货)
这部分是全文重点。很多人装了Claude Code之后发现用不了——因为默认的Anthropic API在国内访问不了。解决办法就是换成国产模型。
好消息是,现在主流的国产模型基本都提供了兼容Anthropic API的接口,配置起来并不复杂。
1. DeepSeek(深度求索)
DeepSeek是目前接入Claude Code最简单的国产模型,官方直接提供了对接文档。
获取API Key:去platform.deepseek.com注册,创建一个API Key。
配置方法(Linux/Mac):
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-你的DeepSeek密钥
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max
配置完之后,进入项目目录执行claude就能用了。
Windows PowerShell用户:把上面的export换成$env:变量名="值"的格式即可。
建议把上面的export命令写到~/.bashrc或~/.zshrc里,这样每次打开终端都自动生效。
2. 智谱GLM
智谱的GLM系列模型也提供了Claude Code兼容接口,而且国内访问速度很快。
获取API Key:去open.bigmodel.cn注册,在个人中心创建API Key。
配置方法:编辑~/.claude/settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"ANTHROPIC_AUTH_TOKEN": "你的智谱APIKey",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air"
}
}
如果想用最新的GLM-5.1,把上面的模型名改成glm-5.1就行。
配置完后新开一个终端窗口,运行claude,输入/status确认模型状态。
3. Kimi(月之暗面)
Kimi的K2系列模型在代码生成方面表现很不错,而且价格实惠。
获取API Key:去platform.moonshot.cn注册获取。
配置方法:编辑~/.claude/settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic",
"ANTHROPIC_AUTH_TOKEN": "你的KimiAPIKey",
"ANTHROPIC_MODEL": "kimi-k2.5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "kimi-k2.5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "kimi-k2.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "kimi-k2.5"
}
}
4. MiniMax
MiniMax的M2/M3系列模型上下文窗口很大(512K tokens),适合处理大型代码库。
重要:配置MiniMax之前,先清除可能冲突的环境变量:
unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_BASE_URL
然后编辑~/.claude/settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.minimaxi.chat/anthropic",
"ANTHROPIC_AUTH_TOKEN": "你的MiniMaxAPIKey",
"ANTHROPIC_MODEL": "MiniMax-M3",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M3",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M3",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M3",
"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "512000",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}
}
注意:国内用户Base URL用https://api.minimaxi.chat,海外用户用https://api.minimax.io。
5. 豆包(字节跳动 Seed-Code)
字节的豆包大模型也提供了编程专用接口。
获取API Key:去火山引擎控制台(console.volcengine.com)开通方舟大模型服务,创建API Key。
配置方法:编辑~/.claude/settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/anthropic",
"ANTHROPIC_AUTH_TOKEN": "你的豆包APIKey",
"ANTHROPIC_MODEL": "seed-code",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "seed-code",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "seed-code",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "seed-code"
}
}
6. 通义千问(阿里云)
阿里的通义千问通过DashScope提供API服务。
获取API Key:去dashscope.console.aliyun.com创建。
配置方法:编辑~/.claude/settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/compatible/anthropic",
"ANTHROPIC_AUTH_TOKEN": "你的通义千问APIKey",
"ANTHROPIC_MODEL": "qwen3-max",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3-max",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3-max",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3-turbo"
}
}
四、cc-switch:一键切换模型的神器
上面讲了六个模型的配置方法,你是不是已经头大了?每次换模型都要改配置文件,太麻烦了。
这时候就该cc-switch(也叫ccm)出场了。这是一个开源的Shell脚本工具,一条命令就能在多个模型之间切换。
安装cc-switch
# 克隆仓库
git clone https://github.com/foreveryh/claude-code-switch.git
cd claude-code-switch
# 安装到系统
chmod +x ccm.sh
sudo cp ccm.sh /usr/local/bin/ccm
配置API密钥
首次使用需要配置各模型的API Key:
# 编辑配置文件
vim ~/.ccm/config
# 配置文件内容示例:
DEEPSEEK_API_KEY=sk-你的DeepSeek密钥
GLM_API_KEY=你的智谱GLM密钥
KIMI_API_KEY=你的Kimi密钥
MINIMAX_API_KEY=你的MiniMax密钥
ARK_API_KEY=你的豆包密钥
QWEN_API_KEY=你的通义千问密钥
使用方式
配置好之后,切换模型就是一行命令的事:
# 切换到DeepSeek
ccm deepseek
# 切换到智谱GLM
ccm glm
# 切换到Kimi
ccm kimi
# 切换到MiniMax
ccm minimax
# 切换到豆包
ccm seed
# 切换到通义千问
ccm qwen
# 查看当前使用的模型
ccm status
是不是很方便?再也不用手动改配置文件了。
五、OpenCode和Hermes接入国产模型
上面主要讲的是Claude Code的配置方法。OpenCode和Hermes接入国产模型的方式略有不同,这里单独说明。
OpenCode配置国产模型
OpenCode通过项目根目录或用户目录下的opencode.json配置文件来管理模型。
配置DeepSeek示例:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"deepseek": {
"apiKey": "${DEEPSEEK_API_KEY}",
"baseURL": "https://api.deepseek.com",
"models": {
"deepseek-v4-pro": {
"name": "DeepSeek V4 Pro",
"attachment": true
}
}
}
},
"model": "deepseek/deepseek-v4-pro"
}
配置好后,启动OpenCode时用/models命令就能看到新加的模型,直接选择使用。
OpenCode还支持通过/connect命令交互式添加提供商凭据,对新手更友好。
Hermes配置国产模型
Hermes的配置更简单,因为它有交互式配置向导:
# 运行配置向导
hermes setup
# 或者直接切换模型
hermes model
在向导中选择Provider,填入API Key和Base URL就行。Hermes支持的模型列表非常全,包括:
• DeepSeek(推荐,配置最简单)
• 智谱GLM
• Kimi/Moonshot
• MiniMax
• 阿里通义千问
• 阶跃星辰
• OpenRouter(200+模型聚合)
Hermes还有一个杀手级功能——可以接入微信和飞书。配置好之后,你可以直接在微信里跟AI对话,让它帮你写代码、查资料、管服务器。这个在其他工具上可做不到。
六、六大国产模型编程能力横评
配置方法讲完了,大家肯定关心:这些模型到底哪个写代码最强?我花了几天时间,用同一组任务测了一遍,分享一下体感。
DeepSeek V4 Pro
综合表现最均衡。代码生成质量高,理解复杂需求的能力强,而且价格很良心。日常开发首选。
• 优势:代码质量高、响应快、价格便宜
• 不足:超长上下文偶尔会丢失细节
• 推荐指数:★★★★★
智谱GLM-5.1
国产模型里代码能力的天花板之一。对中文需求理解特别到位,写注释、生成文档这些很在行。
• 优势:中文理解强、代码规范、文档生成好
• 不足:API偶尔有延迟
• 推荐指数:★★★★☆
Kimi K2.5
性价比之王。代码生成能力不输DeepSeek,但价格更低。适合预算有限的个人开发者。
• 优势:价格便宜、代码质量稳定
• 不足:复杂重构任务稍弱
• 推荐指数:★★★★☆
MiniMax M3
上下文窗口最大(512K),适合处理大型项目。把整个代码库丢进去分析,它hold得住。
• 优势:超大上下文、适合大型项目
• 不足:小任务有点杀鸡用牛刀
• 推荐指数:★★★★☆
豆包 Seed-Code
字节出品,编程专用模型。对前端开发特别友好,React/Vue组件生成很靠谱。
• 优势:前端开发强、响应快
• 不足:后端架构设计稍弱
• 推荐指数:★★★☆☆
通义千问 Qwen3
阿里的模型,综合能力不错。跟阿里云生态整合度高,如果你的服务部署在阿里云上,用它最方便。
• 优势:阿里云生态整合、多模态能力
• 不足:纯编程场景不如DeepSeek专注
• 推荐指数:★★★☆☆
七、常见问题和避坑指南
Q1:配好了但Claude Code报错怎么办
90%的问题是环境变量没生效。检查方法:
# 检查环境变量是否设置成功
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
# 如果为空,说明没生效
# 重新source一下配置文件
source ~/.bashrc # 或 source ~/.zshrc
另外注意,环境变量和settings.json同时存在时,环境变量优先级更高。如果两边都配了不同的值,可能会冲突。
Q2:切换模型后还是用的旧模型
这是因为Claude Code有缓存。解决方法:
• 关闭当前Claude Code会话
• 新开一个终端窗口
• 执行claude重新启动
• 输入/status确认模型已切换
Q3:国产模型会不会有数据安全顾虑
这个问题见仁见智。我的建议是:
• 开源项目、学习代码:随便用哪个都行
• 公司项目:先确认公司的数据安全政策
• 涉及商业机密:建议用本地部署的模型
所有模型提供商都有数据隐私协议,但敏感代码还是谨慎为好。
Q4:多个模型怎么搭配使用
我的日常搭配方案:
• 日常编码:DeepSeek V4 Pro(性价比高)
• 复杂重构:智谱GLM-5.1(理解力强)
• 大型项目分析:MiniMax M3(上下文大)
• 前端开发:豆包Seed-Code(前端优化好)
• 省钱模式:Kimi K2.5(最便宜)
用ccm一条命令切换,非常丝滑。
写在最后
AI编程智能体这东西,真的是用了就回不去。以前写一个功能要半小时,现在跟AI描述一下需求,五分钟就出来了,而且质量还不差。
关键是国产模型现在已经完全够用了。不用再去折腾什么网络工具,不用花大价钱买国外API,在国内就能享受到顶级的AI编程体验。
如果这篇文章对你有帮助,欢迎点赞、在看、转发三连。有问题可以在评论区留言,我看到都会回复。
下期预告:我们来讲讲怎么用Hermes Agent接入微信,实现随时随地用手机指挥AI写代码。敬请期待。
夜雨聆风