cc-alias

Version: 0.1.0

Claude Code Skill —— 交互式配置自定义 Claude Code alias/模型入口。

支持 macOS / Windows / Linux，兼容 zsh / bash / fish / PowerShell 多种 shell。

功能

• 交互式引导：通过对话逐步收集配置信息，无需手动编辑配置文件
• 跨平台：自动检测操作系统和 shell 类型，生成对应语法的配置代码
• 冲突检测：写入前检查同名 alias 是否已存在，避免静默覆盖
• 即时生效：配置写入后自动 source/reload，无需重启终端
• 完整模型映射：自动将 sonnet/opus/haiku/reasoning/subagent 等角色统一指向同一模型

触发方式

在 Claude Code 对话中说出以下任意一种意图即可触发：

• "帮我添加一个 Claude Code alias"
• "配置一个新的 cc 快捷方式"
• "给 Claude Code 添加硅基流动/DeepSeek/Kimi 的入口"
• "添加一个新的 ccxx 命令"
• 直接提供 API Base URL + API Key + Model ID

交互流程

触发 skill 后，Claude 会依次询问：

步骤	问题	说明
1	Alias 名称	建议以 cc 开头，如 ccsf、ccdd
2	API Base URL	Anthropic 兼容端点，如 https://api.example.com/anthropic
3	API Key	将明文写入 shell 配置文件
4	Model ID	如 deepseek-v4-pro[1m]、kimi-k2.5
5	启用 bypass	默认启用 --allow-dangerously-skip-permissions
6	子 agent 模型	默认子 agent 也使用同一模型

生成的配置结构

Skill 会为每个 alias 生成 两个函数：

# Unix (zsh/bash) 示例 —— alias: ccsf

# 1. 核心函数：设置环境变量并调用 claude
claudeSiliconflow() {
  export PATH="$HOME/.local/bin:$PATH"
  unset ANTHROPIC_API_KEY ANTHROPIC_AUTH_TOKEN ANTHROPIC_BASE_URL 2>/dev/null
  # ... 清理旧环境变量
  export ANTHROPIC_BASE_URL='https://api.siliconflow.cn'
  export ANTHROPIC_AUTH_TOKEN='sk-xxx'
  export ANTHROPIC_MODEL='deepseek-ai/DeepSeek-V4-Flash'
  # ... 所有模型角色统一映射
  command claude --allow-dangerously-skip-permissions --model "$model" "$@"
}

# 2. 外层包装：支持 cd 到目录/文件 + 帮助信息
ccsf() {
  # -h/--help 输出用法
  # 传入目录则 cd 进入
  # 传入文件则 cd 到文件所在目录
  claudeSiliconflow "$@"
}

# PowerShell 示例 —— alias: ccdd

function claudeDeepseek {
    # 设置环境变量...
    claude --allow-dangerously-skip-permissions --model 'deepseek-v4-pro[1m]' @args
}

function ccdd {
    param([string]$path)
    # 支持 Set-Location 到目录/文件所在目录
    claudeDeepseek @args
}

支持的平台

平台	Shell	配置文件
macOS	zsh (默认) / bash	~/.zshrc / ~/.bash_profile
Linux	bash (默认) / zsh / fish	~/.bashrc / ~/.zshrc / ~/.config/fish/config.fish
Windows	PowerShell	$PROFILE

使用示例

配置完成后，可以直接使用：

# 在当前目录启动
ccsf

# cd 到项目目录后启动
ccsf /path/to/project

# cd 到文件所在目录后启动
ccsf /path/to/readme.md

# 查看帮助
ccsf -h

文件结构

cc-alias/
├── SKILL.md                 # Skill 主文件（Claude Code 读取）
├── scripts/
│   └── generate_alias.py    # 辅助脚本：跨平台检测、配置生成、冲突检查
└── README.md                # 本文件

注意事项

• API Key 会以明文形式写入你的 shell 配置文件，请确认安全
• 如果检测到同名 alias 已存在，会主动提示并询问处理方式（覆盖/换名/取消），不会静默覆盖
• PowerShell 用户如果遇到 Execution Policy 限制，可能需要先执行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

相关

• Claude Code 文档
• Anthropic API 认证