runcc 0.1.2 → 0.1.3

package/.claude/skills/publish/SKILL.md

@@ -0,0 +1,135 @@
+---
+name: publish
+description: 自动化 npm 包发布准备工作流。版本升级 → 测试 → 构建 → CHANGELOG → 提交 → 打印发布命令（用户手动执行 npm publish）。触发词：发布新版本/publish to npm/bump version/release。
+---
+
+# NPM 发布工作流
+
+版本升级 → 测试 → 构建 → CHANGELOG → Git 提交 → 可选推送 → 打印发布命令
+
+## 工作流程
+
+### 1. 询问目标版本
+
+使用 `AskUserQuestion` 询问用户要升级到什么版本：
+
+| 类型 | 说明 | 示例 |
+|------|------|------|
+| patch | 错误修复、小改动 | 1.0.0 → 1.0.1 |
+| minor | 新功能、向后兼容 | 1.0.0 → 1.1.0 |
+| major | 破坏性更改 | 1.0.0 → 2.0.0 |
+| custom | 指定确切版本号 | 1.0.0 → 1.2.3 |
+
+### 2. 修改 npm 版本
+
+```bash
+npm version <patch|minor|major|x.y.z>
+```
+
+此命令会：
+- 更新 package.json 和 package-lock.json 版本号
+- 创建 git 提交（消息格式：`v<x.y.z>`）
+- 创建 git 标签（`v<x.y.z>`）
+
+### 3. 运行测试
+
+```bash
+bun run test
+```
+
+- 如果 package.json 有 test 脚本，执行测试
+- 测试失败则中止流程，提示用户修复
+- 无 test 脚本则跳过
+
+### 4. 打包编译
+
+```bash
+bun run build
+```
+
+- 如果 package.json 有 build 脚本，执行构建
+- 构建失败则中止流程，提示用户修复
+- 无 build 脚本则跳过
+
+### 5. 创建 CHANGELOG
+
+#### 存在 CHANGELOG.md 时
+
+```bash
+# 查看自上次发布的提交
+git log $(git tag -l | tail -n 1)..HEAD --oneline
+```
+
+**生成条目**：
+- 格式：`## [<版本号>] - YYYY-MM-DD`
+- 按类型分组：新功能、错误修复、破坏性更改
+
+**审核流程**：
+1. 显示生成的变更日志
+2. 使用 `AskUserQuestion` 确认或修改
+3. 更新 CHANGELOG.md
+
+#### 不存在 CHANGELOG.md 时
+
+询问用户是否创建。
+
+### 6. 提交 git
+
+```bash
+git add CHANGELOG.md
+git commit -m "docs: update CHANGELOG for <版本号>"
+```
+
+### 7. 询问是否 git push
+
+使用 `AskUserQuestion` 询问是否推送：
+
+```
+是否推送到远程仓库？
+```
+
+用户确认后执行：
+```bash
+git push && git push --tags
+```
+
+### 8. 打印 npm publish 命令
+
+显示发布命令，要求用户复制手动执行：
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📦 准备发布: <package-name>@<new-version>
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+请复制以下命令并执行：
+
+npm publish
+
+（如需公共作用域包，使用: npm publish --access public）
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### 发布摘要
+
+```
+✅ 准备工作完成
+
+- 包名: <package-name>
+- 新版本: <new-version>
+- Git 标签: v<new-version>
+- CHANGELOG: 已更新
+
+请执行上方 npm publish 命令完成发布。
+```
+
+## 最佳实践
+
+- 发布前运行测试
+- 保持 CHANGELOG.md 最新
+- 遵循语义化版本规范
+- 确认前审查更改
+- 始终先提交再发布
+- 为发布打标签
+- 清楚标注破坏性更改

package/CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.3] - 2026-01-19
+
+### Changed
+- Renamed `npm-publish` skill to `publish` for consistency
+- Removed deprecated `PLAN.md` file
+- Updated project documentation and test files
+
 ## [0.1.2] - 2026-01-19
 
 ### Changed
@@ -23,5 +30,5 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Support for official Claude API and third-party providers (GLM, DeepSeek, Minimax)
 - Custom endpoint management (add/remove)
 - Proxy configuration support
-- Configuration persistence in `~/.cc-run/config.json`
+- Configuration persistence in `~/.runcc/config.json`
 - Integration with Claude CLI settings (`~/.claude/settings.json`)

package/CLAUDE.md

@@ -62,7 +62,7 @@ src/
 ├── config/              # 配置数据层
 │   ├── types.ts         # TypeScript 类型定义
 │   ├── endpoints.ts     # 内置 endpoints (glm/deepseek/minimax)
-│   └── storage.ts       # ~/.cc-run/config.json 读写
+│   └── storage.ts       # ~/.runcc/config.json 读写
 └── utils/               # 工具层
     ├── launcher.ts      # spawn Claude 进程
     ├── env.ts           # 环境变量构建
@@ -71,7 +71,7 @@ src/
 
 ## 双配置文件系统
 
-### ~/.cc-run/config.json (启动器私有配置)
+### ~/.runcc/config.json (启动器私有配置)
 
 存储自定义 endpoints、API tokens、最后使用的 endpoint、代理配置。
 
@@ -145,5 +145,5 @@ src/
 ## 依赖外部条件
 
 1. **Claude CLI**: 系统必须已安装 `claude` 命令
-2. **配置目录**: 自动创建 `~/.cc-run/` 和 `~/.claude/`
+2. **配置目录**: 自动创建 `~/.runcc/` 和 `~/.claude/`
 3. **Node 版本**: >= 18.0.0

package/README.md

@@ -1,4 +1,4 @@
-# cc-run
+# runcc
 
 Claude CLI 启动器，支持切换不同的 API endpoint。
 
@@ -24,19 +24,19 @@ npm install -g .
 
 ```bash
 # 查看所有可用的 endpoints
-cc-run list
+runcc list
 
 # 使用第三方 endpoint
-cc-run glm
+runcc glm
 
 # 配置原生 claude 命令使用 glm
-cc-run glm --claude
+runcc glm --claude
 
 # 恢复原生 claude 使用官方 endpoint
-cc-run --claude
+runcc --claude
 
 # 启动官方 claude
-cc-run
+runcc
 ```
 
 ## 命令说明
@@ -45,29 +45,29 @@ cc-run
 
 | 命令 | 说明 |
 |------|------|
-| `cc-run` | 启动官方 claude |
-| `cc-run glm` | 使用 glm endpoint |
-| `cc-run deepseek` | 使用 deepseek endpoint |
-| `cc-run minimax` | 使用 minimax endpoint |
-| `cc-run list` | 列出所有 endpoints |
-| `cc-run add <name> <endpoint> [token]` | 添加自定义 endpoint |
-| `cc-run remove <name>` | 删除自定义 endpoint |
+| `runcc` | 启动官方 claude |
+| `runcc glm` | 使用 glm endpoint |
+| `runcc deepseek` | 使用 deepseek endpoint |
+| `runcc minimax` | 使用 minimax endpoint |
+| `runcc list` | 列出所有 endpoints |
+| `runcc add <name> <endpoint> [token]` | 添加自定义 endpoint |
+| `runcc remove <name>` | 删除自定义 endpoint |
 
 ### 原生命令配置
 
 | 命令 | 说明 |
 |------|------|
-| `cc-run <provider> --claude` | 配置原生 `claude` 命令使用第三方 endpoint |
-| `cc-run --claude` | 恢复原生 `claude` 命令使用官方 endpoint |
+| `runcc <provider> --claude` | 配置原生 `claude` 命令使用第三方 endpoint |
+| `runcc --claude` | 恢复原生 `claude` 命令使用官方 endpoint |
 
 ### 代理管理
 
 | 命令 | 说明 |
 |------|------|
-| `cc-run proxy on` | 开启代理 |
-| `cc-run proxy off` | 关闭代理 |
-| `cc-run proxy status` | 查看代理状态 |
-| `cc-run proxy reset` | 重置代理配置 |
+| `runcc proxy on` | 开启代理 |
+| `runcc proxy off` | 关闭代理 |
+| `runcc proxy status` | 查看代理状态 |
+| `runcc proxy reset` | 重置代理配置 |
 
 ## 内置 Endpoints
 
@@ -79,7 +79,7 @@ cc-run
 
 ## 配置文件
 
-### ~/.cc-run/config.json
+### ~/.runcc/config.json
 
 ```json
 {
@@ -117,46 +117,46 @@ cc-run
 ### 添加自定义 endpoint
 
 ```bash
-cc-run add my-api https://api.my-service.com/v1 sk-my-token
+runcc add my-api https://api.my-service.com/v1 sk-my-token
 ```
 
 ### 切换 endpoint
 
 ```bash
 # 使用 glm
-cc-run glm
+runcc glm
 
 # 使用 deepseek
-cc-run deepseek
+runcc deepseek
 
 # 使用自定义 endpoint
-cc-run my-api
+runcc my-api
 ```
 
 ### 配置代理
 
 ```bash
 # 开启代理（首次会提示输入代理地址）
-cc-run proxy on
+runcc proxy on
 
 # 查看代理状态
-cc-run proxy status
+runcc proxy status
 
 # 关闭代理
-cc-run proxy off
+runcc proxy off
 ```
 
 ### 配置原生命令
 
 ```bash
 # 让原生 claude 命令使用 glm
-cc-run glm --claude
+runcc glm --claude
 
 # 之后直接使用 claude 命令即可
 claude "你好"
 
 # 恢复使用官方 endpoint
-cc-run --claude
+runcc --claude
 ```
 
 ## Token 管理
@@ -164,11 +164,11 @@ cc-run --claude
 首次使用某个 endpoint 时，如果未配置 token，会提示输入：
 
 ```bash
-$ cc-run glm
+$ runcc glm
 请输入 glm 的 API Token: [输入框]
 ```
 
-Token 会被保存到 `~/.cc-run/config.json`，下次使用时无需再次输入。
+Token 会被保存到 `~/.runcc/config.json`，下次使用时无需再次输入。
 
 ## 开发
 

package/dist/index.js

@@ -1917,7 +1917,7 @@ import { join } from "node:path";
 import { homedir } from "node:os";
 function getConfigDir() {
   const home = process.env.CC_RUN_TEST_HOME || homedir();
-  return join(home, ".cc-run");
+  return join(home, ".runcc");
 }
 function getConfigFilePath() {
   return join(getConfigDir(), "config.json");
@@ -2215,7 +2215,7 @@ function proxyReset() {
 function proxyStatus() {
   const ccRunConfig = getProxyConfig();
   const claudeProxy = getClaudeProxy();
-  console.log("CC-Run 代理配置:");
+  console.log("RunCC 代理配置:");
   console.log(`  状态: ${ccRunConfig.enabled ? "开启" : "关闭"}`);
   if (ccRunConfig.url) {
     console.log(`  地址: ${ccRunConfig.url}`);
@@ -2235,16 +2235,16 @@ function proxyHelp() {
   console.log(`
 代理管理命令:
 
-  cc-run proxy on      开启代理（首次会提示输入代理地址）
-  cc-run proxy off     关闭代理
-  cc-run proxy reset   重置代理配置
-  cc-run proxy status  查看代理状态
-  cc-run proxy help    显示此帮助信息
+  runcc proxy on      开启代理（首次会提示输入代理地址）
+  runcc proxy off     关闭代理
+  runcc proxy reset   重置代理配置
+  runcc proxy status  查看代理状态
+  runcc proxy help    显示此帮助信息
 
 说明:
   - proxy on 会修改 ~/.claude/settings.json，添加 proxy 配置
   - proxy off 会删除 ~/.claude/settings.json 中的 proxy 配置
-  - 代理地址保存在 ~/.cc-run/config.json 中
+  - 代理地址保存在 ~/.runcc/config.json 中
 `);
 }
 async function promptProxyUrl() {
@@ -2360,7 +2360,7 @@ async function runProvider(providerName, configureClaude, passthroughArgs = [])
   const endpoint = getEndpointConfig(providerName);
   if (!endpoint) {
     console.error(`错误: 未找到 endpoint "${providerName}"`);
-    console.log('使用 "cc-run list" 查看可用的 endpoints');
+    console.log('使用 "runcc list" 查看可用的 endpoints');
     process.exit(1);
   }
   let token = endpoint.token || getToken(providerName);
@@ -2386,7 +2386,7 @@ async function runProvider(providerName, configureClaude, passthroughArgs = [])
   if (configureClaude) {
     setThirdPartyApi(endpoint.endpoint, token);
     console.log(`已配置原生 claude 命令使用 ${providerName}`);
-    console.log('使用 "cc-run --claude" 可恢复官方配置');
+    console.log('使用 "runcc --claude" 可恢复官方配置');
   }
   const child = launchClaude({
     apiEndpoint: endpoint.endpoint,
@@ -2482,7 +2482,7 @@ if (isBunCompiled) {
   };
 }
 var program2 = new Command;
-program2.name("cc-run").description("Claude 启动器 - 支持切换不同的 API endpoint").version("0.1.0");
+program2.name("runcc").description("Claude 启动器 - 支持切换不同的 API endpoint").version("0.1.0");
 program2.command("list").description("列出所有可用的 endpoints").action(list);
 program2.command("add").description("添加自定义 endpoint").argument("<name>", "endpoint 名称").argument("<endpoint>", "API 地址").action(add);
 program2.command("remove").description("删除自定义 endpoint").argument("<name>", "endpoint 名称").action(remove);
@@ -2510,9 +2510,9 @@ program2.argument("[provider]", "provider 名称 (glm, deepseek, minimax 或自
       console.error("❌ 参数位置不正确");
       console.error("");
       console.error("正确的用法示例:");
-      console.error("  cc-run glm -- <claude参数>     # 使用 glm provider 并透传参数");
-      console.error("  cc-run --claude -- <参数>       # 恢复官方配置并透传参数");
-      console.error("  cc-run glm --claude -- <参数>   # 配置原生 claude 命令使用 glm");
+      console.error("  runcc glm -- <claude参数>     # 使用 glm provider 并透传参数");
+      console.error("  runcc --claude -- <参数>       # 恢复官方配置并透传参数");
+      console.error("  runcc glm --claude -- <参数>   # 配置原生 claude 命令使用 glm");
       console.error("");
       console.error("说明: -- 分隔符用于将后续参数透传给 Claude CLI");
       process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runcc",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "CC launcher with endpoint switching support",
   "type": "module",
   "main": "dist/index.js",

package/.claude/skills/npm-publish/SKILL.md

@@ -1,209 +0,0 @@
----
-name: npm-publish
-description: Automate npm package version bumping and publishing with comprehensive safety checks. Use when user requests "发布新版本", "publish to npm", "bump version", "release a new version", or similar package publishing tasks. Supports semantic versioning (patch/minor/major), git tagging, CHANGELOG updates, and pre-publish validation.
----
-
-# NPM Publish
-
-Automate the complete npm package release workflow with safety checks, version management, and changelog updates.
-
-## Workflow
-
-Follow this sequential workflow for publishing npm packages. Each step includes validation and confirmation points to ensure safe releases.
-
-### Step 1: Pre-flight Checks
-
-Before starting the release process, create a todo list with these items and verify the environment:
-
-1. **检查 git 工作区状态**
-   - Run `git status` to ensure working directory is clean
-   - If there are uncommitted changes, ask user whether to commit them or abort
-
-2. **确认当前分支**
-   - Check current branch with `git branch --show-current`
-   - Verify it's `main` or `master` (or other release branch)
-   - If not on release branch, warn user and ask to confirm or switch
-
-3. **检查 npm 登录状态**
-   - Run `npm whoami` to verify npm authentication
-   - If not logged in, instruct user to run `npm login`
-
-4. **拉取最新代码**
-   - Run `git pull` to ensure working with latest code
-   - Check for any conflicts
-
-### Step 2: Determine Version Bump Type
-
-Ask the user which type of version bump to perform, unless they've already specified:
-
-- **patch**: Bug fixes, minor changes (1.0.0 → 1.0.1)
-- **minor**: New features, backward compatible (1.0.0 → 1.1.0)
-- **major**: Breaking changes (1.0.0 → 2.0.0)
-- **custom**: Specify exact version number
-
-Use the `AskUserQuestion` tool if the version type wasn't specified in the initial request.
-
-### Step 3: Run Tests and Build
-
-Execute the project's quality checks:
-
-1. **运行测试**
-   - Check if `package.json` has a `test` script
-   - Run `npm test` or equivalent command
-   - If tests fail, abort the release and report errors
-
-2. **运行构建**
-   - Check if `package.json` has a `build` script
-   - Run `npm run build` or equivalent command
-   - If build fails, abort the release and report errors
-
-### Step 4: Update CHANGELOG
-
-If CHANGELOG.md exists in the project:
-
-1. **Read recent commits**
-   - Run `git log` to see commits since last release
-   - Look for previous version tags with `git tag -l`
-
-2. **Generate changelog entry**
-   - Create a new section for the new version
-   - List key changes based on commit messages
-   - Format: `## [Version] - YYYY-MM-DD`
-   - Group changes by type: Features, Bug Fixes, Breaking Changes, etc.
-
-3. **Let user review and edit**
-   - Show the generated changelog entry
-   - Use `AskUserQuestion` to confirm or request modifications
-   - Update CHANGELOG.md with the approved content
-
-If no CHANGELOG.md exists, ask user if they want to create one.
-
-### Step 5: Bump Version
-
-Use npm's built-in version command:
-
-```bash
-npm version <patch|minor|major|x.y.z> -m "chore: release v%s"
-```
-
-This command will:
-- Update version in `package.json` and `package-lock.json`
-- Create a git commit with the specified message
-- Create a git tag with the new version
-
-### Step 6: User Confirmation
-
-Before publishing, display a summary and ask for final confirmation:
-
-```
-Ready to publish:
-- Package: <package-name>
-- Current version: <old-version>
-- New version: <new-version>
-- Branch: <branch-name>
-- Changes: <summary from changelog>
-
-Proceed with publishing? (yes/no)
-```
-
-Use `AskUserQuestion` for this confirmation.
-
-### Step 7: Publish to NPM
-
-If user confirms, publish the package:
-
-```bash
-npm publish
-```
-
-Options to consider:
-- `--access public` for scoped public packages
-- `--tag <tag>` for pre-release versions (e.g., `beta`, `next`)
-- `--dry-run` to test without actually publishing (useful for first-time testing)
-
-### Step 8: Push to Git Remote
-
-After successful npm publish:
-
-1. **推送代码和标签**
-   ```bash
-   git push && git push --tags
-   ```
-
-2. **验证发布**
-   - Confirm the new version appears on npmjs.com
-   - Confirm the git tag appears on the remote repository
-
-### Step 9: Summary
-
-Report the successful release:
-
-```
-✅ Successfully published <package-name>@<new-version>
-
-- NPM: https://www.npmjs.com/package/<package-name>
-- Git tag: <tag-name>
-- Changelog updated: Yes/No
-
-Next steps:
-- Create GitHub release (if applicable)
-- Announce to team
-- Update dependent projects
-```
-
-## Error Handling
-
-If any step fails:
-
-1. **Clearly state which step failed and why**
-2. **Do not proceed to next steps**
-3. **Provide actionable recovery steps**
-4. **If version was bumped but publish failed:**
-   - The version commit and tag already exist
-   - User can either: fix the issue and run `npm publish` manually, or reset with `git reset --hard HEAD~1 && git tag -d v<version>`
-
-## Rollback
-
-If user needs to undo a release:
-
-1. **Unpublish from npm** (only within 72 hours):
-   ```bash
-   npm unpublish <package-name>@<version>
-   ```
-
-2. **Delete git tag**:
-   ```bash
-   git tag -d v<version>
-   git push origin :refs/tags/v<version>
-   ```
-
-3. **Revert version commit**:
-   ```bash
-   git reset --hard HEAD~1
-   git push --force
-   ```
-
-**Warning**: Unpublishing is discouraged by npm. Prefer deprecating instead:
-```bash
-npm deprecate <package-name>@<version> "Reason for deprecation"
-```
-
-## Customization
-
-Different projects may need adaptations:
-
-- **Monorepo**: Use tools like `lerna` or `nx` for versioning multiple packages
-- **Pre-release versions**: Use `npm version prerelease --preid=beta`
-- **CI/CD**: This workflow is for manual releases; adapt for automated pipelines
-- **Private registry**: Use `--registry` flag or `.npmrc` configuration
-- **2FA**: npm may require OTP code during publish, prompt user to enter it
-
-## Best Practices
-
-1. **Always run tests before publishing**
-2. **Keep CHANGELOG.md up to date**
-3. **Use semantic versioning correctly**
-4. **Review changes one final time before confirming**
-5. **Never publish with uncommitted changes**
-6. **Tag releases for easy reference**
-7. **Announce breaking changes clearly**

package/PLAN.md

@@ -1,236 +0,0 @@
-# CC 启动器实现计划
-
-## 项目概述
-
-使用 TypeScript + bun 创建 CC 启动器，支持切换不同的 API endpoint。
-
-## 命令格式
-
-| 命令 | 功能 |
-|------|------|
-| `cc-run` | **总是**启动官方 claude（根据配置决定是否临时清除 proxy 和第三方 endpoint） |
-| `cc-run --claude` | 恢复原生 `claude` 命令使用官方 endpoint（删除 ~/.claude/settings.json 中的第三方配置） |
-| `cc-run glm` | 使用 glm endpoint |
-| `cc-run glm --claude` | 使用 glm，并配置原生 `claude` 命令默认使用 glm |
-| `cc-run deepseek` | 使用 deepseek endpoint |
-| `cc-run deepseek --claude` | 使用 deepseek，并配置原生 `claude` 命令默认使用 deepseek |
-| `cc-run minimax` | 使用 minimax endpoint |
-| `cc-run add <name> <endpoint> <token>` | 添加自定义 endpoint |
-| `cc-run list` | 列出所有 endpoint |
-| `cc-run remove <name>` | 删除自定义 endpoint |
-| `cc-run proxy on` | 开启代理（修改 ~/.claude/settings.json） |
-| `cc-run proxy off` | 关闭代理（修改 ~/.claude/settings.json） |
-| `cc-run proxy reset` | 重置代理配置 |
-| `cc-run proxy status` | 查看代理状态 |
-| `cc-run proxy help` | 代理帮助信息 |
-
-## 项目结构
-
-```
-cc-run/
-├── package.json
-├── tsconfig.json
-├── src/
-│   ├── index.ts              # CLI 入口
-│   ├── commands/
-│   │   ├── run.ts            # 启动命令
-│   │   ├── add.ts            # 添加 endpoint
-│   │   ├── list.ts           # 列出 endpoint
-│   │   ├── remove.ts         # 删除 endpoint
-│   │   └── proxy.ts          # 代理管理命令
-│   ├── config/
-│   │   ├── storage.ts        # 配置存储管理
-│   │   ├── endpoints.ts      # 内置 endpoint 定义
-│   │   └── types.ts          # 类型定义
-│   └── utils/
-│       ├── env.ts            # 环境变量设置
-│       └── launcher.ts       # 启动 claude
-└── README.md
-```
-
-## 内置 Endpoints
-
-| 名称 | Endpoint |
-|------|----------|
-| glm | https://open.bigmodel.cn/api/paas/v4/ |
-| deepseek | https://api.deepseek.com |
-| minimax | https://api.minimax.chat/v1 |
-
-## 配置存储
-
-### ~/.cc-run/config.json（启动器配置）
-`proxy.on/off` 会修改此文件的 proxy 配置，`cc-run <provider>` 会保存 token：
-```json
-{
-  "endpoints": [
-    {
-      "name": "my-custom",
-      "endpoint": "https://api.example.com/v1",
-      "token": "sk-xxxxxxxx"
-    }
-  ],
-  "tokens": {
-    "glm": "sk-xxxxxxxx",
-    "deepseek": "sk-yyyyyyyy",
-    "minimax": "sk-zzzzzzzz"
-  },
-  "lastUsed": "glm",
-  "proxy": {
-    "enabled": true,
-    "url": "http://agent.baidu.com:8891",
-    "clearForOfficial": false
-  }
-}
-```
-
-### ~/.claude/settings.json（Claude 官方配置）
-`proxy on/off` 会修改此文件的 proxy 配置：
-```json
-{
-  "proxy": "http://agent.baidu.com:8891"
-}
-```
-
-## Proxy 处理逻辑
-
-### cc-run proxy on
-1. 提示输入代理地址（首次）
-2. 保存到 `~/.cc-run/config.json`
-3. 修改 `~/.claude/settings.json`，添加 proxy 配置
-
-### cc-run proxy off
-1. 更新 `~/.cc-run/config.json`（enabled: false）
-2. 修改 `~/.claude/settings.json`，删除 proxy 配置
-
-## 运行逻辑
-
-### cc-run（无参数）
-
-总是启动官方 claude。启动前会检查并清理 `~/.claude/settings.json`：
-
-1. 读取当前的 `~/.claude/settings.json`
-2. 检查是否有 `proxy` 配置
-3. 检查是否有 `apiUrl` / `anthropicApiKey` 等第三方 endpoint 配置
-4. 根据清理策略清理：
-   - **proxy 清理**：由 `~/.cc-run/config.json` 中 `proxy.clearForOfficial` 决定
-   - **endpoint 清理**：总是清除第三方 endpoint 配置
-5. 启动 claude
-6. claude 退出后恢复被清除的配置
-
-**proxy 清理策略**（`~/.cc-run/config.json`）：
-```json
-{
-  "proxy": {
-    "clearForOfficial": true  // 启动官方 claude 时是否清除 proxy
-  }
-}
-```
-
-### cc-run <provider>
-
-使用指定 endpoint，通过环境变量启动。
-
-**Token 获取逻辑**：
-1. 检查 `~/.cc-run/config.json` 中是否已保存该 provider 的 token
-2. 如果没有，提示用户输入：
-   ```
-   请输入 glm 的 API Token: [输入框]
-   ```
-3. 保存 token 到 `~/.cc-run/config.json`：
-   ```json
-   {
-     "tokens": {
-       "glm": "sk-xxxxxxxx",
-       "deepseek": "sk-yyyyyyyy",
-       "minimax": "sk-zzzzzzzz"
-     }
-   }
-   ```
-4. 使用保存的 token 启动
-
-### cc-run <provider> --claude
-使用指定 endpoint，并**配置原生 `claude` 命令**的默认行为：
-1. 使用指定 endpoint 启动 cc-run
-2. 修改 `~/.claude/settings.json`，设置：
-   - `apiUrl`: 指定 provider 的 endpoint
-   - `anthropicApiKey`: 指定 provider 的 token
-3. 之后直接运行原生 `claude` 命令时，会使用这个第三方 endpoint
-4. **不影响** `cc-run` 无参数的行为（`cc-run` 仍然总是启动官方 claude）
-
-### cc-run --claude（无 provider）
-**恢复原生 `claude` 命令使用官方 endpoint**：
-1. 删除 `~/.claude/settings.json` 中的 `apiUrl` 和 `anthropicApiKey`
-2. 之后直接运行原生 `claude` 命令时，会使用官方 endpoint
-3. 不启动 cc-run
-
-> **注**：`--claude` 只影响原生 `claude` 命令，不影响 `cc-run`
-
-## 环境变量
-
-启动 CC 时设置：
-- `ANTHROPIC_BASE_URL` - API endpoint
-- `ANTHROPIC_AUTH_TOKEN` - API token
-- `http_proxy` / `https_proxy` - 代理（如果配置）
-
-## 关键文件
-
-| 文件 | 说明 |
-|------|------|
-| `src/index.ts` | CLI 入口，使用 commander 解析参数 |
-| `src/config/storage.ts` | 配置文件读写、token 管理、endpoint 管理 |
-| `src/utils/token.ts` | Token 获取和保存逻辑（首次使用时提示输入） |
-| `src/commands/run.ts` | 核心启动逻辑，处理官方模式的 proxy 临时清除 |
-| `src/commands/proxy.ts` | 代理管理命令（on/off/reset/status/help） |
-| `src/utils/launcher.ts` | spawn claude 进程 |
-| `src/utils/claude-settings.ts` | 读写 `~/.claude/settings.json` 的 proxy 和 endpoint 配置 |
-| `src/config/types.ts` | TypeScript 类型定义 |
-
-## 代理命令实现要点
-
-| 命令 | 说明 |
-|------|------|
-| `cc-run proxy on` | 首次运行时提示输入代理地址，保存并修改 `~/.claude/settings.json` |
-| `cc-run proxy off` | 关闭代理，删除 `~/.claude/settings.json` 中的 proxy 配置 |
-| `cc-run proxy reset` | 重置代理配置 |
-| `cc-run proxy status` | 显示代理状态（是否启用、地址） |
-| `cc-run proxy help` | 显示代理相关帮助 |
-
-## 依赖
-
-```json
-{
-  "dependencies": {
-    "commander": "^12.0.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "bun-types": "latest"
-  }
-}
-```
-
-## 验证方式
-
-```bash
-# 1. 构建
-bun run build
-
-# 2. 测试 list
-bun run src/index.ts list
-
-# 3. 测试 add
-bun run src/index.ts add test https://api.test.com sk-test
-
-# 4. 测试 proxy
-bun run src/index.ts proxy status
-bun run src/index.ts proxy on
-bun run src/index.ts proxy off
-
-# 5. 测试 run（需要已有 token）
-bun run src/index.ts glm
-
-# 6. 全局安装后测试
-bun install -g
-cc-run list
-cc-run proxy status
-```