为什么需要这个工具Claude Code、Codex CLI 是目前体验最好的 AI 编程工具之一但国内开发者用它们有几道坎官方 API 国内直连不稳定注册需要国外手机号和支付方式网上教程虽然多但都是手动配置环境变量配一次半小时换个模型再来一遍。好在 2026 年的国产大模型都提供了兼容接口DeepSeek、通义、GLM、Kimi 都有 Anthropic 兼容和 OpenAI 兼容端点配置的本质就三件事改 base_url、填 Key、选模型。agent-cn就是把这三点封装成命令的开源 CLI零依赖全程中文提示。快速开始两条命令pip install agent-cn # 1. 环境自检检测已装工具、Python、网络连通性 agent-cn doctor # 2. 交互式配置选工具 → 选模型 → 填 Key → 自动写配置 → 自动验证 agent-cn setup claude-code支持的工具工具协议配置方式Claude CodeAnthropic 兼容自动写入 ~/.claude/settings.jsonCodex CLIOpenAI 兼容自动写入 ~/.codex/config.tomlClineOpenAI Compatible手动指引支持的模型DeepSeekV4 Pro / V4 Flash、通义千问、智谱 GLM、Kimi。四家模型的八个端点均经过实测零 Key 探测401 即证明端点存在。日常使用命令# 一键切换模型同模型商切换复用 Key agent-cn switch claude-code deepseek/deepseek-v4-flash # 查看工具 × 模型兼容矩阵 agent-cn list # 比价与成本预估DeepSeek 涨价后很好用 agent-cn cost --tokens 2000000 # 换机迁移导出配置不含 Key agent-cn export agent-cn import profiles.json # 自定义模型端点 agent-cn model add my-provider --base-url https://example.com/api设计细节与安全1. Claude Code 配置写入 settings.json 的 env 键不污染系统环境变量切换模型只需改文件加重启{env:{ANTHROPIC_BASE_URL:https://api.deepseek.com/anthropic,ANTHROPIC_AUTH_TOKEN:sk-***,ANTHROPIC_MODEL:deepseek-v4-pro}}2. 官方直连不走第三方中转这是 agent-cn 与市面上中转站方案最大的区别。中转站能看到你的全部对话内容Key 也存在别人服务器上。agent-cn 的 Key 只写进本机配置文件POSIX 下权限 0600出错提示对 Key 脱敏导出配置不含 Key。3. 所有配置写入前自动备份每次修改前生成 .bak 毫秒时间戳双份备份改错可回滚。项目现状42 个单元测试全绿unittest 零依赖GitHub Actions 双平台Windows / Ubuntu× 三版本Python 3.10 / 3.11 / 3.12CI 通过PyPI 已发布pip install 即用。GitHub: https://github.com/wangray1997-droid/agent-cnPyPI: https://pypi.org/project/agent-cn/常见问题Q: Key 安全吗A: Key 只写进本机 ~/.claude/settings.json写前自动备份POSIX 下权限 0600不上传、不走中转。Q: 支持 OpenClaw 吗A: 二期考虑目前支持 Claude Code / Codex / Cline。Q: 价格数据准确吗A: DeepSeek 价格有官方来源并标注日期通义价格待核以阿里云百炼控制台为准。Q: 会收费吗A: 开源免费MIT 协议。模型调用费是各家官方 API 自己的费用。欢迎试用有问题去 GitHub 提 issue。“本文由 agent-cn 项目作者原创欢迎转载注明出处”