为什么需要这个工具

Claude Code、Codex CLI 是目前体验最好的 AI 编程工具之一，但国内开发者用它们有几道坎：

1. 官方 API 国内直连不稳定；
2. 注册需要国外手机号和支付方式；
3. 网上教程虽然多，但都是手动配置环境变量，配一次半小时，换个模型再来一遍。

好在 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 Code	Anthropic 兼容	自动写入 ~/.claude/settings.json
Codex CLI	OpenAI 兼容	自动写入 ~/.codex/config.toml
Cline	OpenAI Compatible	手动指引

支持的模型：DeepSeek（V4 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.12）CI 通过；
• PyPI 已发布，pip install 即用。

GitHub: https://github.com/wangray1997-droid/agent-cn
PyPI: 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 项目作者原创，欢迎转载注明出处”