ccconfig 1.3.0 → 1.4.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Daniel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -2,15 +2,28 @@
 
 [English](README.md) | [中文](README_zh.md)
 
-Quickly switch between different claude-code providers
+Quickly switch between different claude-code providers and start Claude Code with specific profiles.
 
+**Recommended Usage (Easiest):**
 
 ```bash
-# Switch to work configuration during work hours
-ccconfig use company
+# Add configurations
+ccconfig add work
+ccconfig add personal
+
+# Start Claude Code directly with a specific profile
+ccconfig start work              # During work hours
+ccconfig start personal          # After work
+
+# Or use safe mode (requires confirmation for each command)
+ccconfig safe-start work
+```
 
-# Switch back to personal configuration after work
-ccconfig use personal
+**Alternative: Manual Switch Mode:**
+
+```bash
+# Switch configuration in current shell
+ccconfig use company
 
 # Permanently write to shell config (no need to eval or source each time)
 ccconfig use personal --permanent  # or use -p for short
@@ -25,31 +38,66 @@ ccconfig use personal --permanent  # or use -p for short
 npm install -g ccconfig
 ```
 
-### ENV Mode (Recommended, Default)
+### Method 1: Direct Start Mode (Recommended 🚀)
 
-```bash
-# 1. Configure Shell auto-loading (see below)
+The easiest way to use ccconfig - directly start Claude Code with a specific profile:
 
-# 2. Add configuration (interactive mode)
-ccconfig add
+```bash
+# 1. Add a configuration (interactive mode)
+ccconfig add work
 # Follow the prompts to enter:
-# - Name
 # - ANTHROPIC_BASE_URL
-# - ANTHROPIC_AUTH_TOKEN
-# - ANTHROPIC_API_KEY
+# - ANTHROPIC_AUTH_TOKEN or ANTHROPIC_API_KEY
 # - ANTHROPIC_MODEL (optional)
 # - ANTHROPIC_SMALL_FAST_MODEL (optional)
 
-# 3. Switch configuration
+# 2. Start Claude Code directly with your profile
+ccconfig start work              # Auto-approve mode (adds --dangerously-skip-permissions)
+# or
+ccconfig safe-start work         # Safe mode (requires confirmation for each command)
+```
+
+**That's it!** Claude Code starts with your configuration automatically injected.
+
+**Two modes explained:**
+
+- **`ccconfig start`** - Auto-approve mode
+  - Automatically adds `--dangerously-skip-permissions` flag
+  - Commands execute without confirmation prompts
+  - ⚠️ **Only use with profiles you trust**
+  - Perfect for: personal projects, trusted company profiles, rapid development
+
+- **`ccconfig safe-start`** - Safe mode
+  - Does NOT add `--dangerously-skip-permissions`
+  - Requires manual confirmation before executing each command
+  - ✅ **Recommended for production or untrusted environments**
+  - Perfect for: production systems, new profiles, sensitive data
+
+**Advantages:**
+- ✅ No shell configuration needed
+- ✅ No manual switching required
+- ✅ Environment variables automatically injected
+- ✅ Works across all shells
+- ✅ Pass additional arguments: `ccconfig start work /path/to/project --verbose`
+
+### Method 2: Manual Switch Mode
+
+If you prefer to manually switch configurations and start Claude Code separately:
+
+```bash
+# 1. Add configuration (interactive mode)
+ccconfig add work
+
+# 2. Switch configuration
 ccconfig use work
 
-# 4. Apply immediately (choose one method):
-# Method A: Temporary (only in current shell)
-eval $(ccconfig env bash)  # or use the detected command from output
+# 3. Apply to current shell (choose one):
+eval $(ccconfig env bash)        # Bash/Zsh - temporary
+ccconfig env fish | source       # Fish - temporary
+ccconfig use work --permanent    # Write to shell config - permanent
 
-# Method B: Permanent (write to shell config file)
-ccconfig use work --permanent  # or -p for short
-# Automatically detects and modifies ~/.bashrc, ~/.zshrc, or config.fish
+# 4. Start Claude Code manually
+claude
 ```
 
 ### Settings Mode
@@ -212,7 +260,9 @@ Do you want to set ANTHROPIC_SMALL_FAST_MODEL? (y/N) [n]:
 ✓ Configuration 'work' updated
 ```
 
-**Note:** After updating a configuration, remember to activate it with `ccconfig use work` if you want the changes to take effect immediately.
+**Note:** After updating a configuration, you can either:
+- Use `ccconfig start work` to launch Claude Code with the updated profile
+- Or use `ccconfig use work` to activate it in current shell
 
 ### Shell Completion
 

package/README_zh.md

@@ -2,14 +2,28 @@
 
 [English](README.md) | [中文](README_zh.md)
 
-快速切换不同的 claude-code 提供商配置
+快速切换不同的 claude-code 提供商配置，并使用指定配置启动 Claude Code。
+
+**推荐用法（最简单）：**
 
 ```bash
-# 工作时间切换到公司配置
-ccconfig use company
+# 添加配置
+ccconfig add work
+ccconfig add personal
 
-# 下班后切换回个人配置
-ccconfig use personal
+# 直接使用指定配置启动 Claude Code
+ccconfig start work              # 工作时间
+ccconfig start personal          # 下班后
+
+# 或使用安全模式（每个命令都需要确认）
+ccconfig safe-start work
+```
+
+**备选方案：手动切换模式：**
+
+```bash
+# 在当前 shell 中切换配置
+ccconfig use company
 
 # 永久写入 shell 配置文件（无需每次 eval 或 source）
 ccconfig use personal --permanent  # 或使用 -p 简写
@@ -24,31 +38,66 @@ ccconfig use personal --permanent  # 或使用 -p 简写
 npm install -g ccconfig
 ```
 
-### ENV 模式（推荐，默认）
+### 方式 1：直接启动模式（推荐 🚀）
 
-```bash
-# 1. 配置 Shell 自动加载（见下文）
+最简单的使用方式 - 直接使用指定配置启动 Claude Code：
 
-# 2. 添加配置（交互模式）
-ccconfig add
+```bash
+# 1. 添加配置（交互模式）
+ccconfig add work
 # 按提示输入：
-# - 名称
 # - ANTHROPIC_BASE_URL
-# - ANTHROPIC_AUTH_TOKEN
-# - ANTHROPIC_API_KEY
+# - ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY
 # - ANTHROPIC_MODEL（可选）
 # - ANTHROPIC_SMALL_FAST_MODEL（可选）
 
-# 3. 切换配置
+# 2. 直接使用配置启动 Claude Code
+ccconfig start work              # 自动批准模式（添加 --dangerously-skip-permissions）
+# 或
+ccconfig safe-start work         # 安全模式（每个命令需要确认）
+```
+
+**就这么简单！** Claude Code 会自动注入您的配置启动。
+
+**两种模式说明：**
+
+- **`ccconfig start`** - 自动批准模式
+  - 自动添加 `--dangerously-skip-permissions` 标志
+  - 命令无需确认直接执行
+  - ⚠️ **仅在您信任的配置中使用**
+  - 适用场景：个人项目、可信的公司配置、快速开发
+
+- **`ccconfig safe-start`** - 安全模式
+  - 不添加 `--dangerously-skip-permissions`
+  - 执行每个命令前需要手动确认
+  - ✅ **推荐用于生产环境或不可信环境**
+  - 适用场景：生产系统、新配置、敏感数据
+
+**优势：**
+- ✅ 无需配置 shell
+- ✅ 无需手动切换
+- ✅ 自动注入环境变量
+- ✅ 支持所有 shell
+- ✅ 可传递额外参数：`ccconfig start work /path/to/project --verbose`
+
+### 方式 2：手动切换模式
+
+如果您更喜欢手动切换配置，然后单独启动 Claude Code：
+
+```bash
+# 1. 添加配置（交互模式）
+ccconfig add work
+
+# 2. 切换配置
 ccconfig use work
 
-# 4. 立即生效（选择一种方法）：
-# 方法 A: 临时生效（仅当前 shell）
-eval $(ccconfig env bash)  # 或使用输出中检测到的命令
+# 3. 应用到当前 shell（选择一种）：
+eval $(ccconfig env bash)        # Bash/Zsh - 临时生效
+ccconfig env fish | source       # Fish - 临时生效
+ccconfig use work --permanent    # 写入 shell 配置 - 永久生效
 
-# 方法 B: 永久生效（写入 shell 配置文件）
-ccconfig use work --permanent  # 或使用 -p 简写
-# 自动检测并修改 ~/.bashrc、~/.zshrc 或 config.fish
+# 4. 手动启动 Claude Code
+claude
 ```
 
 ### Settings 模式
@@ -211,7 +260,9 @@ Do you want to set ANTHROPIC_SMALL_FAST_MODEL? (y/N) [n]:
 ✓ Configuration 'work' updated
 ```
 
-**注意：** 更新配置后，如果要立即生效，记得使用 `ccconfig use work` 激活配置。
+**注意：** 更新配置后，您可以：
+- 使用 `ccconfig start work` 以更新后的配置启动 Claude Code
+- 或使用 `ccconfig use work` 在当前 shell 中激活配置
 
 ### Shell 自动补全