runcc 0.1.1 → 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

@@ -0,0 +1,34 @@
+# Changelog
+
+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
+- Renamed CLI command from `cc-run` to `runcc` for better naming consistency
+- Improved output formatting with UTF-8 support for better Chinese character display in list command
+
+### Added
+- Added `.npmignore` configuration for cleaner package distribution
+- Added Claude Code skills configuration for enhanced development workflow
+- Added local testing script (`test-install.sh`) for installation verification
+
+## [0.1.1] - 2026-01-19
+
+### Added
+- Initial release with multi-endpoint support
+- Support for official Claude API and third-party providers (GLM, DeepSeek, Minimax)
+- Custom endpoint management (add/remove)
+- Proxy configuration support
+- 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

@@ -1,5 +1,4 @@
-#!/usr/bin/env bun
-// @bun
+#!/usr/bin/env node
 import { createRequire } from "node:module";
 var __create = Object.create;
 var __getProtoOf = Object.getPrototypeOf;
@@ -1918,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");
@@ -2020,7 +2019,7 @@ function safeLog(message) {
   const encoder = new TextEncoder;
   const data = encoder.encode(message + `
 `);
-  Bun.write(Bun.stdout, data);
+  process.stdout.write(data);
 }
 function formatEndpoint(name, endpoint, hasToken) {
   const tokenStatus = hasToken ? "已配置 token" : "未配置 token";
@@ -2216,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}`);
@@ -2236,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() {
@@ -2361,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);
@@ -2387,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,
@@ -2465,12 +2464,12 @@ function validateDashPosition(argv) {
 // src/index.ts
 function safeLog2(message) {
   const encoder = new TextEncoder;
-  Bun.write(Bun.stdout, encoder.encode(message + `
+  process.stdout.write(encoder.encode(message + `
 `));
 }
 function safeError(message) {
   const encoder = new TextEncoder;
-  Bun.write(Bun.stderr, encoder.encode(message + `
+  process.stderr.write(encoder.encode(message + `
 `));
 }
 var isBunCompiled = typeof Bun !== "undefined" && !import.meta.dir;
@@ -2483,17 +2482,17 @@ if (isBunCompiled) {
   };
 }
 var program2 = new Command;
-program2.name("cc-run").description("Claude \u542F\u52A8\u5668 - \u652F\u6301\u5207\u6362\u4E0D\u540C\u7684 API endpoint").version("0.1.0");
-program2.command("list").description("\u5217\u51FA\u6240\u6709\u53EF\u7528\u7684 endpoints").action(list);
-program2.command("add").description("\u6DFB\u52A0\u81EA\u5B9A\u4E49 endpoint").argument("<name>", "endpoint \u540D\u79F0").argument("<endpoint>", "API \u5730\u5740").action(add);
-program2.command("remove").description("\u5220\u9664\u81EA\u5B9A\u4E49 endpoint").argument("<name>", "endpoint \u540D\u79F0").action(remove);
-var proxyCmd = program2.command("proxy").description("\u4EE3\u7406\u7BA1\u7406");
-proxyCmd.command("on").description("\u5F00\u542F\u4EE3\u7406").action(proxyOn);
-proxyCmd.command("off").description("\u5173\u95ED\u4EE3\u7406").action(proxyOff);
-proxyCmd.command("reset").description("\u91CD\u7F6E\u4EE3\u7406\u914D\u7F6E").action(proxyReset);
-proxyCmd.command("status").description("\u67E5\u770B\u4EE3\u7406\u72B6\u6001").action(proxyStatus);
-proxyCmd.command("help").description("\u4EE3\u7406\u5E2E\u52A9\u4FE1\u606F").action(proxyHelp);
-program2.argument("[provider]", "provider \u540D\u79F0 (glm, deepseek, minimax \u6216\u81EA\u5B9A\u4E49)").option("--claude", "\u914D\u7F6E\u539F\u751F claude \u547D\u4EE4").allowExcessArguments(true).action(async (provider, options) => {
+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);
+var proxyCmd = program2.command("proxy").description("代理管理");
+proxyCmd.command("on").description("开启代理").action(proxyOn);
+proxyCmd.command("off").description("关闭代理").action(proxyOff);
+proxyCmd.command("reset").description("重置代理配置").action(proxyReset);
+proxyCmd.command("status").description("查看代理状态").action(proxyStatus);
+proxyCmd.command("help").description("代理帮助信息").action(proxyHelp);
+program2.argument("[provider]", "provider 名称 (glm, deepseek, minimax 或自定义)").option("--claude", "配置原生 claude 命令").allowExcessArguments(true).action(async (provider, options) => {
   try {
     validateDashPosition(process.argv);
     const passthroughArgs = extractPassthroughArgs(process.argv);
@@ -2508,14 +2507,14 @@ program2.argument("[provider]", "provider \u540D\u79F0 (glm, deepseek, minimax \
     }
   } catch (error) {
     if (error instanceof PassthroughArgsError) {
-      console.error("\u274C \u53C2\u6570\u4F4D\u7F6E\u4E0D\u6B63\u786E");
+      console.error("❌ 参数位置不正确");
       console.error("");
-      console.error("\u6B63\u786E\u7684\u7528\u6CD5\u793A\u4F8B:");
-      console.error("  cc-run glm -- <claude\u53C2\u6570>     # \u4F7F\u7528 glm provider \u5E76\u900F\u4F20\u53C2\u6570");
-      console.error("  cc-run --claude -- <\u53C2\u6570>       # \u6062\u590D\u5B98\u65B9\u914D\u7F6E\u5E76\u900F\u4F20\u53C2\u6570");
-      console.error("  cc-run glm --claude -- <\u53C2\u6570>   # \u914D\u7F6E\u539F\u751F claude \u547D\u4EE4\u4F7F\u7528 glm");
+      console.error("正确的用法示例:");
+      console.error("  runcc glm -- <claude参数>     # 使用 glm provider 并透传参数");
+      console.error("  runcc --claude -- <参数>       # 恢复官方配置并透传参数");
+      console.error("  runcc glm --claude -- <参数>   # 配置原生 claude 命令使用 glm");
       console.error("");
-      console.error("\u8BF4\u660E: -- \u5206\u9694\u7B26\u7528\u4E8E\u5C06\u540E\u7EED\u53C2\u6570\u900F\u4F20\u7ED9 Claude CLI");
+      console.error("说明: -- 分隔符用于将后续参数透传给 Claude CLI");
       process.exit(1);
     }
     throw error;

package/package.json

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

package/test-install.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+# 本地安装测试脚本
+
+set -e
+
+echo "🔨 构建项目..."
+bun run build
+
+echo ""
+echo "📦 打包..."
+npm pack
+
+echo ""
+echo "🌍 全局安装..."
+PKG=$(ls runcc-*.tgz)
+npm install -g ./$PKG
+
+echo ""
+echo "✅ 测试中文输出..."
+runcc list
+
+echo ""
+echo "🧹 清理..."
+npm uninstall -g runcc
+rm $PKG
+
+echo ""
+echo "✨ 测试完成！"

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
-```