ClaudeProfile

Claude Code 配置文件管理器 - 交互式管理多 API 配置

功能

• 交互式创建、编辑、删除 API 配置
• 支持多个 Provider: MiniMax、Kimi (Moonshot)、阿里云百炼、火山引擎、讯飞星辰、小米、智谱 GLM 等
• 密码式 Token 输入，安全可靠
• 无缝切换环境变量，一条命令完成配置
• 通过 shell hook 注入环境变量到当前 shell（不修改 settings.json）

安装

从 npm 安装（全局）

npm install -g @claude-code/claude-profile

本地开发

# 安装依赖
npm install

# 构建
npm run build

# 运行测试
npm test

# 链接到全局（开发时）
npm link

快速开始

1. 初始化 Shell Hook（只需一次）

echo 'source <(claude-profile init)' >> ~/.bashrc
source ~/.bashrc

2. 创建配置

claude-profile create

交互式引导：

1. 选择 API Provider
2. 输入配置名称
3. 输入 API Token（密码隐藏）
4. 确认/修改 API URL
5. 确认/修改默认模型

3. 切换配置

# 交互式选择（需要终端环境）
claude-profile switch

# 直接指定配置
claude-profile switch minimax

两种方式都会通过 shell hook 将环境变量注入当前 shell！

使用方法

创建新配置

claude-profile create

切换配置

# 交互式选择（仅在终端中可用）
claude-profile switch

# 直接指定配置
claude-profile switch minimax

列出所有配置

claude-profile list

编辑配置

claude-profile edit

删除配置

claude-profile delete

导出配置

# 导出指定配置
claude-profile export minimax

# 导出当前配置
claude-profile export --current

# 导出到文件（JSON/YAML）
claude-profile export minimax --file --yaml --output ./minimax.yaml

导入配置

# 从文件导入
claude-profile import ./profile.json

# 指定名称导入 YAML
claude-profile import ./profile.yaml --name my-profile

重命名配置

claude-profile rename old-name new-name

复制配置

claude-profile duplicate source-name new-name

备份与恢复

# 备份所有配置
claude-profile backup ./backup.tar.gz

# 恢复配置
claude-profile restore ./backup.tar.gz

验证配置

# 验证所有配置完整性
claude-profile validate

# 显示详细信息
claude-profile validate --verbose

Shell 自动补全

# Bash
claude-profile completion bash > /etc/bash_completion.d/claude-profile

# Zsh
claude-profile completion zsh > /usr/local/share/zsh/site-functions/_claude-profile

# Fish
claude-profile completion fish > ~/.config/fish/completions/claude-profile.fish

环境变量注入

环境变量通过 shell hook 注入当前 shell，不再写入 ~/.claude/settings.json。 切换配置时，claude-profile 输出 export/unset 命令，由 shell hook 的 safe_eval 注入当前 shell：

环境变量	说明
ANTHROPIC_BASE_URL	API 基础地址
ANTHROPIC_AUTH_TOKEN	API 认证 Token
ANTHROPIC_MODEL	默认模型
ANTHROPIC_DEFAULT_SONNET_MODEL	Sonnet 模型
ANTHROPIC_DEFAULT_OPUS_MODEL	Opus 模型
ANTHROPIC_DEFAULT_HAIKU_MODEL	Haiku 模型
CLAUDE_CODE_SUBAGENT_MODEL	子代理模型

注入范围由 profile.env 决定（可包含任意额外键，如 API_TIMEOUT_MS）。

默认高性能基线

执行 eval "$(claude-profile init)" 时，会自动注入一组通用高性能默认配置（无需 switch 即生效），让未配置 profile 的用户也开箱即用：

环境变量	默认值	说明
ENABLE_TOOL_SEARCH	0	规避 Claude Code v2.1.69 BUG
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS	1	关闭实验性 beta
API_TIMEOUT_MS	3000000	50 分钟超时窗口
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC	1	关闭非必要流量上报
CLAUDE_CODE_EFFORT_LEVEL	ultracode	默认最高 effort（env var 优先级最高，可持久）
CLAUDE_CODE_ALWAYS_ENABLE_EFFORT	1	第三方 provider / 自定义模型 ID 时强制发送 effort 参数（必需，否则 effort=ultracode 不生效）
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE	75	在 autocompact 窗口 75% 时触发压缩（更早压缩；仅主动压缩场景生效，扩展上下文需配合 CLAUDE_CODE_AUTO_COMPACT_WINDOW）

• 不覆盖：已在 shell 中设置的同名变量不会被覆盖（仅未设置时才注入默认值）。
• 总开关：设 CLAUDE_PROFILE_DEFAULT_ENV=0 可完全关闭默认注入。

工作原理

Shell hook 会在你的 shell 中创建一个 claude-profile 函数，拦截 switch 命令并自动 eval 导出的环境变量。

• claude-profile switch <profile> - 直接切换，自动应用环境变量
• claude-profile switch - 交互式选择（仅在终端环境中可用）

配置文件

存储位置

• Profiles: ~/.config/claude-profile/
• 环境变量注入: 当前 shell（通过 shell hook），不写入 ~/.claude/settings.json

配置文件格式

{
  "name": "minimax",
  "description": "MiniMax",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "your-token",
    "ANTHROPIC_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.7",
    "CLAUDE_CODE_SUBAGENT_MODEL": "MiniMax-M2.7"
  }
}

更新 Shell Hook

如果更新了 claude-profile 后遇到问题，重新加载 shell hook：

source <(claude-profile init)