only-cc-env
v0.1.7
Published
Manage multiple Anthropic/Claude API provider environments
Readme
only-cc-env
管理多个 Claude Code 兼容 API 供应商的环境变量，在不同供应商之间快速切换。
为什么需要这个工具
越来越多的第三方供应商提供了兼容 Claude API 的服务。使用这些服务时，你需要手动设置 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 等环境变量。当你有多个供应商时，来回切换非常麻烦。
only-cc-env 帮你把每个供应商的配置保存为独立文件，一条命令即可切换。
安全承诺
only-cc-env 不会读取或修改 Claude 的任何配置文件。
它只做两件事：
- 在
~/.config/only-cc-env/目录下管理供应商配置 - 在你的 shell 配置文件（如
.zshrc）中添加一行source语句来加载环境变量
不碰 ~/.claude/，不碰 Claude 的设置、认证、会话数据。
安装
npm install -g only-cc-env --registry https://registry.npmjs.org安装后同时提供 only-cc-env 和短别名 ccenv 两个命令，功能完全一致。以下示例使用 ccenv，你也可以用 only-cc-env 替代。
快速开始
# 1. 初始化（检测 shell 并配置自动加载）
ccenv init
# 2. 添加供应商（交互式）
ccenv add kimi
# ANTHROPIC_AUTH_TOKEN *: sk-xxx
# ANTHROPIC_BASE_URL *: https://api.kimi.com/coding/
# ANTHROPIC_MODEL (optional):
# ...
# 3. 切换到该供应商（环境变量自动生效）
ccenv use kimi命令
init
初始化工具，自动检测 shell 类型（zsh / bash / fish），在对应的配置文件中添加环境变量加载语句。
add <name>
添加新的供应商配置。不带选项时进入交互模式，带 * 标记的为必填项。
也可以通过选项直接指定：
only-cc-env add my-provider \
--auth-token "sk-xxx" \
--base-url "https://api.example.com"edit <name>
编辑已有的供应商配置。不带选项时进入交互模式，回车跳过的字段保持原值。
list
列出所有供应商。如果检测到 Claude 官方账号已登录，会自动在列表首行显示。
┌───┬────────────────────────────────┬──────────────────────────────┬───────┐
│ │ Name │ Base URL │ Model │
├───┼────────────────────────────────┼──────────────────────────────┼───────┤
│ * │ official ([email protected]) │ api.anthropic.com │ - │
├───┼────────────────────────────────┼──────────────────────────────┼───────┤
│ │ kimi │ https://api.kimi.com/coding/ │ - │
└───┴────────────────────────────────┴──────────────────────────────┴───────┘支持 --json 输出 JSON 格式。
show [name]
查看供应商详情，默认显示当前激活的供应商。Token 等敏感值默认脱敏，加 --unmask 显示完整值。
use <name>
切换当前激活的供应商。通过 init 注入的 shell 包装函数，切换后环境变量会在当前会话中自动生效。
use official 会清除所有自定义环境变量，回退到 Claude 官方账号。
remove <name>
删除供应商配置。-y 跳过确认。
管理的环境变量
交互式添加供应商时，会提示以下预定义变量：
| 变量 | 必填 | 说明 |
|------|------|------|
| ANTHROPIC_AUTH_TOKEN | 是 | API 认证令牌 |
| ANTHROPIC_BASE_URL | 是 | API 基础地址 |
| ANTHROPIC_MODEL | 否 | 默认模型 |
| ANTHROPIC_DEFAULT_SONNET_MODEL | 否 | 默认 Sonnet 模型 |
| ANTHROPIC_DEFAULT_OPUS_MODEL | 否 | 默认 Opus 模型 |
| ANTHROPIC_DEFAULT_HAIKU_MODEL | 否 | 默认 Haiku 模型 |
自定义环境变量
除了上述预定义变量外，你可以直接编辑 ~/.config/only-cc-env/providers/<name>.json，添加任意自定义环境变量：
{
"ANTHROPIC_AUTH_TOKEN": "sk-xxx",
"ANTHROPIC_BASE_URL": "https://api.example.com",
"MY_CUSTOM_VAR": "some-value"
}use 切换时，JSON 中的所有字段都会写入环境变量。切换到其他供应商或 official 时，前一个供应商的自定义变量会被自动 unset。
配置文件位置
~/.config/only-cc-env/
├── providers/ # 供应商配置（每个一个 JSON 文件）
│ ├── kimi.json
│ └── other.json
├── active # 当前激活的供应商名
└── env.sh # 生成的环境变量文件（或 env.fish）本地开发调试
# 安装依赖
npm install
# 直接运行入口文件
node bin/only-cc-env.js list
# 或者用 npm link 创建全局软链后用命令名调试
npm link
ccenv list
# 调试完后清理：npm unlink -g only-cc-env
# 运行测试
npm testLicense
MIT