PACKAGE EXPLORERView in registry

agent-cn

PyPI

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

Versions collected1

Direct dependencies0From release 0.1.0

Last observed20 Oct, 21:40 UTC

README

Version 0.1.0 documentation

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

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

命令

命令	作用
`agent-cn doctor`	环境自检：已装工具 / Python / 已配置项目 / 端点网络连通性
`agent-cn setup <tool>`	交互式配置：选模型 → 填 Key → 自动写配置 → 连通验证
`agent-cn switch <tool> <model>`	一键切换模型（同 provider 复用 Key，旧配置可回滚）
`agent-cn list`	工具 × 模型兼容矩阵
`agent-cn cost [--tokens N]`	模型比价 + 月成本预估
`agent-cn export [file]`	导出配置（换机迁移，不含 Key）
`agent-cn import <file>`	导入配置（合并，提示覆盖）
`agent-cn model {add\|list\|remove}`	自定义模型端点管理

支持矩阵

工具	协议	状态
Claude Code	Anthropic 兼容	✅ 自动写入（真机验证）
Codex CLI	OpenAI 兼容	✅ 自动写入（config.toml）
Cline	OpenAI Compatible	⚠️ 手动指引（VS Code 插件）

提供商	Anthropic 端点	OpenAI 端点
DeepSeek	✅ 已实测	✅ 已实测
通义千问	✅ 已实测	✅ 已实测
智谱 GLM	✅ 已实测	✅ 已实测
Kimi (Moonshot)	✅ 已实测	✅ 已实测

配置存储

工具配置：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

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Versions 1

Collected releases

Version	Published	Direct dependencies	Open version
0.1.0	9 Aug 2026	0

Package advisories

No matching advisories collected

This describes our collected data; it is not a security assessment.

Repository

PENDING

wangray1997-droid/agent-cn

Shared repository data · GitHub

License detected in repository: Not collected

Metadata history

Meaningful changes

Current collected state Current

Observed since 20 Oct, 21:40 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package:7c0b0c5f4c14b6d2e21dd49f3f6238371c21fbcab7bfbd4a84fb5635f85bd190