agent-cn

国内 Agent 工具一键接入国产模型。官方直连、零中转、全中文、可自检。

让 Claude Code / Codex CLI / Cline 在国产网络下，用 DeepSeek / 通义 / GLM / Kimi 开箱即跑。教程要配半小时，它只要 30 秒。

特性

• 多工具 × 多模型矩阵：Claude Code / Codex CLI / Cline × DeepSeek / 通义千问 / 智谱 GLM / Kimi
• 官方直连：全部使用各家官方 Anthropic 兼容 / OpenAI 兼容端点，不经过任何第三方中转服务
• 一键自检：doctor 逐项诊断环境，中文修复指引
• 安全优先：配置写入前自动备份，改错可回滚
• 零依赖：纯 Python 标准库，无需安装任何第三方包

快速开始（30 秒）

# 1. 自检环境
python agent_cn/cli.py doctor

# 2. 交互式配置（选工具 → 选模型 → 填 Key → 自动写配置 → 自动验证）
python agent_cn/cli.py setup claude-code
# 或安装后全局使用
pip install agent-cn && agent-cn setup claude-code

配置完成后重启对应工具即可使用。

命令

支持矩阵

配置存储

• 工具配置：Claude Code 写入 ~/.claude/settings.json 的 env 键（写前自动备份）；Codex 写入 ~/.codex/config.toml（全量，写前自动备份）
• 项目记录：~/.agent-cn/config.json（写前自动备份）
• 自定义模型端点：~/.agent-cn/custom-models.json（agent-cn model add 管理，合并优先于内置 registry）
• API Key 建议通过环境变量提供（如 DEEPSEEK_API_KEY），也可在 setup 时粘贴输入

安全说明

• API Key 只会写入你自己的本机配置文件（~/.claude/settings.json），不会上传或经第三方中转
• 所有配置改动前自动备份（.bak + 时间戳），可随时回滚
• 请勿将 ~/.claude/settings.json、.env、任何含 Key 的文件提交到 Git

开发

python -m unittest discover -s tests -v   # 运行测试（42 项）

路线图

• M1：doctor + setup（Claude Code × DeepSeek）真机跑通
• M2：全矩阵适配器 + switch/list/cost + 导入导出 + 自定义端点 + 网络检测
• M3：价格补全 + GitHub CI + PyPI 发布 + 冷启动

License

MIT