# start-claude

**Repository Path**: lvhaodeyeye/start-claude

## Basic Information

- **Project Name**: start-claude
- **Description**: CLI tool to start Claude Code with Kimi/BigModel/MiniMax configuration
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2026-02-10
- **Last Updated**: 2026-05-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Start Claude

一个 CLI 工具，用于在使用 Claude Code 时快速切换各个 **非 Anthropic 的 Code Plan** 服务。

本工具配置的是各平台 Code Plan（代码助手）服务的 Anthropic 兼容 API 端点和 URL，包括 Kimi、BigModel (GLM)、DeepSeek、MiniMax、阿里云百炼 (Qwen)、LM Studio、火山引擎 (Volcano Engine)、百度千帆 (Qianfan)、腾讯云 (Tencent Cloud) 和 AutoDL。这**不是**通用的 API 代理 —— 它专门针对这些平台提供的 Code Plan 接口。

> **注意**：本工具仅管理 API 端点和认证配置，**不会**同步或配置 MCP (Model Context Protocol) 服务器。您需要在 Claude Code 环境中手动配置 MCP 设置。

## 功能

- 🔧 通过交互式配置保存各平台 Code Plan 的 API 密钥（包括本地 LM Studio 和 AutoDL）
- 🚀 快速切换不同的 Code Plan 服务提供商
- 🔒 密钥安全存储在 `~/.startcode/token.json`
- 🎯 **模型选择配置**：为 Claude Haiku/Sonnet/Opus 选择各平台对应的模型映射

## 安装

### 从源码安装

```bash
cd start-claude
uv pip install -e .
```

或者使用 pip:

```bash
cd start-claude
pip install -e .
```

## 从源码更新

当从 git 拉取新更新后，需要重新安装以应用更改：

```bash
git pull
uv pip install -e .
```

或者使用 uv tool 升级：

```bash
uv tool upgrade start-claude
```

## 使用方法

### 1. 配置 API 密钥

首次使用需要配置 API 密钥：

```bash
start-claude config
```

这将交互式地提示你输入 Kimi、BigModel、DeepSeek、MiniMax、阿里云百炼 (Qwen)、LM Studio、火山引擎 (Volcano Engine)、百度千帆 (Qianfan)、腾讯云 (Tencent Cloud) 和 AutoDL 的 API 密钥，并安全保存到 `~/.startcode/token.json`。

**BigModel 特殊配置**：配置 BigModel API 密钥后，会额外显示模型选择界面，让你为 Claude 的 Haiku、Sonnet、Opus 模型分别选择映射的 GLM 模型：
- GLM-5
- GLM-4.7（Sonnet/Opus 默认）
- GLM-4.5-Air（Haiku 默认）
- GLM-4.6

模型映射配置保存在 `~/.startcode/config.json`。

### 2. 启动 Claude Code

#### 使用 Kimi 模型

```bash
start-claude kimi
```

#### 使用 BigModel (GLM) 模型

```bash
start-claude bigmodel
```

#### 使用 DeepSeek 模型

```bash
start-claude deepseek
```

支持模型列表：
- **DeepSeek-V4-Pro[1m]**（默认）- Pro 模型用于主要推理，映射到 Opus/Sonnet
- **DeepSeek-V4-Flash** - 快速模型，自动分配给 Haiku/SubAgent

> **注意**：DeepSeek 自动设置 `CLAUDE_CODE_EFFORT_LEVEL=max`。

#### 使用 MiniMax 模型

```bash
start-claude minimax
```

#### 使用阿里云百炼 (Qwen) 模型

```bash
start-claude qwen
```

#### 使用 LM Studio（本地服务器）

```bash
start-claude lmstudio
```

也可以临时指定模型和 URL：

```bash
start-claude lmstudio --model openai/gpt-oss-20b --url http://localhost:1234
```

#### 使用火山引擎 (Volcano Engine)

```bash
start-claude volcano
```

支持模型列表：
- **Doubao 系列**: `doubao-seed-2.0-code`（默认）、`doubao-seed-2.0-pro`、`doubao-seed-2.0-lite`、`doubao-seed-code`
- **第三方模型**: `minimax-m2.5`、`glm-4.7`、`deepseek-v3.2`、`kimi-k2.5`

#### 使用百度千帆 (Qianfan)

```bash
start-claude qianfan
```

支持模型列表（通过百度千帆控制台切换底层模型）：
- **统一 API ID**: `qianfan-code-latest`
- **底层模型**: Kimi-K2.5、DeepSeek-V3.2、GLM-5、MiniMax-M2.5

#### 使用腾讯云 (Tencent Cloud)

```bash
start-claude tencent
```

支持模型列表：
- **Auto 模式**: `tc-code-latest`（默认）- 智能选择最优模型
- **混元系列**: `hunyuan-2.0-instruct`、`hunyuan-2.0-thinking`、`hunyuan-t1`、`hunyuan-turbos`
- **第三方模型**: `glm-5`、`minimax-m2.5`、`kimi-k2.5`

#### 使用 AutoDL

```bash
start-claude autodl
```

支持模型列表：
- **Claude Code 专属**：`claude-sonnet-4-6-cc`（默认）、`claude-opus-4-6-cc`
- **通用模型（更高稳定性）**：`claude-sonnet-4-6`、`claude-opus-4-6`

### 3. 向 Claude 转发参数

在 provider 名称之后的任何额外参数都会被转发给 `claude` 命令：

```bash
# 以 Debug 模式启动
start-claude kimi --debug

# 以 Opus plan 模式启动
start-claude kimi --opusplan

# 在指定目录启动
start-claude bigmodel /path/to/project

# 组合其他 Claude 选项
start-claude qwen --verbose /path/to/project

# 恢复之前的会话
start-claude kimi --resume <session-id>
```

这相当于配置好环境后直接运行 `claude --debug`（或其他任何参数）。

**注意**：所有参数都支持，包括选项（`--debug`、`--opusplan` 等）和位置参数（路径）。

### 4. 临时指定 API 密钥

如果不想保存密钥，也可以直接在命令行指定：

```bash
start-claude kimi --key sk-kimi-xxxxxxxxxx
start-claude bigmodel --key your-bigmodel-key
start-claude deepseek --key your-deepseek-api-key
start-claude minimax --key your-minimax-key
start-claude qwen --key your-dashscope-api-key
start-claude lmstudio --key your-lmstudio-token
start-claude volcano --key your-ark-api-key
start-claude qianfan --key your-qianfan-api-key
start-claude tencent --key sk-sp-your-tencent-key
start-claude autodl --key your-autodl-token
```

## 环境变量说明

工具会自动设置以下环境变量来配置 Claude Code：

### Kimi 配置

- `ANTHROPIC_BASE_URL=https://api.kimi.com/coding/`
- `ANTHROPIC_API_KEY=sk-kimi-xxxxxxxx`

### BigModel (GLM) 配置

- `ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/paas/v4`
- `ANTHROPIC_API_KEY=your-bigmodel-key`
- `ANTHROPIC_DEFAULT_HAIKU_MODEL`（可配置，默认: `glm-4.5-air`）
- `ANTHROPIC_DEFAULT_SONNET_MODEL`（可配置，默认: `glm-4.7`）
- `ANTHROPIC_DEFAULT_OPUS_MODEL`（可配置，默认: `glm-4.7`）

**支持的模型：**
- GLM-5.1
- GLM-5
- GLM-5-Turbo
- GLM-4.7
- GLM-4.6
- GLM-4.5
- GLM-4.5-Air

### DeepSeek 配置

- `ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic`
- `ANTHROPIC_AUTH_TOKEN=your-deepseek-api-key`（注意：使用 `ANTHROPIC_AUTH_TOKEN` 而非 `ANTHROPIC_API_KEY`）
- `ANTHROPIC_MODEL`（可配置，默认: `deepseek-v4-pro[1m]`）
- `ANTHROPIC_DEFAULT_OPUS_MODEL`（可配置，默认: `deepseek-v4-pro[1m]`）
- `ANTHROPIC_DEFAULT_SONNET_MODEL`（可配置，默认: `deepseek-v4-pro[1m]`）
- `ANTHROPIC_DEFAULT_HAIKU_MODEL`（固定: `deepseek-v4-flash`）
- `CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash`
- `CLAUDE_CODE_EFFORT_LEVEL=max`

**支持的模型：**
- DeepSeek-V4-Pro[1m]（默认，用于 Opus/Sonnet）
- DeepSeek-V4-Flash（用于 Haiku/SubAgent）

### MiniMax 配置

- `ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic`
- `ANTHROPIC_AUTH_TOKEN=your-minimax-key` (注意：使用 `ANTHROPIC_AUTH_TOKEN` 而非 `ANTHROPIC_API_KEY`)
- `ANTHROPIC_MODEL`（可配置，默认: `MiniMax-M2.7`）
- `ANTHROPIC_SMALL_FAST_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`）
- `API_TIMEOUT_MS=3000000`
- `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1`

**支持的模型：**
- MiniMax-M2.7（默认）
- MiniMax-M2.7-highspeed
- MiniMax-M2.5
- MiniMax-M2.5-highspeed
- MiniMax-M2.1
- MiniMax-M2.1-highspeed
- MiniMax-M2
- M2-her

### 阿里云百炼 (Qwen) 配置

- `ANTHROPIC_BASE_URL=https://coding.dashscope.aliyuncs.com/apps/anthropic`
- `ANTHROPIC_API_KEY=YOUR_DASHSCOPE_API_KEY`
- `ANTHROPIC_MODEL`（可配置，默认: `qwen3.5-plus`）

**支持的模型：**

| 模型系列 | 支持的模型 |
|----------|-----------|
| 千问系列模型 | `qwen3.5-plus`（默认）、`qwen3-max-2026-01-23`、`qwen3-coder-next`、`qwen3-coder-plus` |
| 第三方模型 | `glm-5`、`glm-4.7`、`kimi-k2.5`、`minimax-m2.5` |

### LM Studio 配置

- `ANTHROPIC_BASE_URL=http://localhost:1234`（可配置，默认: `http://localhost:1234`）
- `ANTHROPIC_AUTH_TOKEN=lmstudio`（可选，如果未启用认证可以为空）
- `ANTHROPIC_MODEL`（可配置，用户自定义模型名称）

**特性：**
- 支持 LM Studio 中加载的任何模型
- 认证令牌是可选的（如果 LM Studio 未启用认证，可以留空）
- 支持自定义服务器 URL，适用于远程或非默认端口设置

**注意：** LM Studio 默认在本地运行，支持空 auth_token。如果在 LM Studio 设置中启用了"需要身份验证"，则需要提供 API 令牌。

### 火山引擎 (Volcano Engine) 配置

- `ANTHROPIC_BASE_URL=https://ark.cn-beijing.volces.com/api/coding`
- `ANTHROPIC_AUTH_TOKEN=your-ark-api-key` (注意：使用 `ANTHROPIC_AUTH_TOKEN` 而非 `ANTHROPIC_API_KEY`)
- `ANTHROPIC_MODEL`（可配置，默认: `doubao-seed-2.0-code`）
- `ANTHROPIC_DEFAULT_SONNET_MODEL`（可配置，默认: `doubao-seed-2.0-code`）
- `ANTHROPIC_DEFAULT_OPUS_MODEL`（可配置，默认: `doubao-seed-2.0-code`）
- `ANTHROPIC_DEFAULT_HAIKU_MODEL`（可配置，默认: `doubao-seed-2.0-code`）

**支持的模型：**

| 模型系列 | 支持的模型 |
|----------|-----------|
| Doubao 系列 | `doubao-seed-2.0-code`（默认）、`doubao-seed-2.0-pro`、`doubao-seed-2.0-lite`、`doubao-seed-code` |
| 控制台管理 | `ark-code-latest`（通过控制台选择模型） |
| 第三方模型 | `minimax-m2.5`、`glm-4.7`、`deepseek-v3.2`、`kimi-k2.5` |

获取 API 密钥：[火山引擎方舟 Coding Plan](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey)

### 百度千帆 (Qianfan) 配置

- `ANTHROPIC_BASE_URL=https://qianfan.baidubce.com/anthropic/coding`
- `ANTHROPIC_AUTH_TOKEN=your-qianfan-api-key`（注意：使用 `ANTHROPIC_AUTH_TOKEN` 而非 `ANTHROPIC_API_KEY`）
- `ANTHROPIC_MODEL`（可配置，默认: `qianfan-code-latest`）

**支持的模型：**

| 模型系列 | 支持的模型 |
|----------|-----------|
| 统一 API | `qianfan-code-latest`（所有模型使用统一 ID） |
| 底层模型 | Kimi-K2.5、DeepSeek-V3.2、GLM-5、MiniMax-M2.5（通过控制台切换） |

获取 API 密钥：[百度千帆 Coding Plan](https://console.bce.baidu.com/qianfan/resource/subscribe)

### 腾讯云 (Tencent Cloud) 配置

- `ANTHROPIC_BASE_URL=https://api.lkeap.cloud.tencent.com/coding/anthropic`
- `ANTHROPIC_AUTH_TOKEN=your-tencent-api-key`（注意：使用 `ANTHROPIC_AUTH_TOKEN` 而非 `ANTHROPIC_API_KEY`）
- `ANTHROPIC_MODEL`（可配置，默认: `tc-code-latest`）
- `ANTHROPIC_DEFAULT_SONNET_MODEL`（可配置，默认: `tc-code-latest`）
- `ANTHROPIC_DEFAULT_OPUS_MODEL`（可配置，默认: `tc-code-latest`）
- `ANTHROPIC_DEFAULT_HAIKU_MODEL`（可配置，默认: `tc-code-latest`）

**支持的模型：**

| 模型系列 | 支持的模型 |
|----------|-----------|
| Auto 模式 | `tc-code-latest`（默认）- 智能选择最优模型 |
| 混元系列 | `hunyuan-2.0-instruct`、`hunyuan-2.0-thinking`、`hunyuan-t1`、`hunyuan-turbos` |
| 第三方模型 | `glm-5`、`minimax-m2.5`、`kimi-k2.5` |

获取 API 密钥：[腾讯云 Coding Plan](https://hunyuan.cloud.tencent.com/#/app/subscription)

### AutoDL 配置

- `ANTHROPIC_BASE_URL=https://www.autodl.art/api/v1/anthropic`
- `ANTHROPIC_AUTH_TOKEN=your-autodl-token`（注意：使用 `ANTHROPIC_AUTH_TOKEN` 而非 `ANTHROPIC_API_KEY`）
- `ANTHROPIC_MODEL`（可配置，默认: `claude-sonnet-4-6-cc`）
- `ANTHROPIC_DEFAULT_SONNET_MODEL`（可配置，默认: `claude-sonnet-4-6-cc`）
- `ANTHROPIC_DEFAULT_OPUS_MODEL`（可配置，默认: `claude-sonnet-4-6-cc`）
- `ANTHROPIC_DEFAULT_HAIKU_MODEL`（可配置，默认: `claude-sonnet-4-6-cc`）

**支持的模型：**

| 模型系列 | 支持的模型 |
|----------|-----------|
| Claude Code 专属 | `claude-sonnet-4-6-cc`（默认）、`claude-opus-4-6-cc` |
| 通用模型 | `claude-sonnet-4-6`、`claude-opus-4-6` |

获取 API Token：[AutoDL Token 管理页面](https://autodl.art/large-model/tokens)

## 获取 API 密钥

### Kimi

访问 [Kimi 会员页面](https://www.kimi.com/) 获取 API 密钥。

### BigModel (GLM)

访问 [BigModel 开放平台](https://open.bigmodel.cn/) 获取 API 密钥。

### DeepSeek

访问 [DeepSeek 平台](https://platform.deepseek.com/) 获取 API 密钥。

### MiniMax

访问 [MiniMax 平台](https://platform.minimaxi.com/) 获取 API 密钥。

### 阿里云百炼 (Qwen)

访问 [阿里云百炼平台](https://bailian.aliyun.com/) 获取 API 密钥。

### 火山引擎 (Volcano Engine)

访问 [火山引擎方舟平台](https://www.volcengine.com/product/ark) 获取 API 密钥。

### 百度千帆 (Qianfan)

访问 [百度千帆 Coding Plan 页面](https://console.bce.baidu.com/qianfan/resource/subscribe) 获取 API 密钥。

### 腾讯云 (Tencent Cloud)

访问 [腾讯云 Coding Plan 页面](https://hunyuan.cloud.tencent.com/#/app/subscription) 获取 API 密钥。

### AutoDL

访问 [AutoDL Token 管理页面](https://autodl.art/large-model/tokens) 获取 API Token。

### LM Studio

LM Studio 在本地运行，默认不需要 API 密钥。如果您在 LM Studio 设置中启用了认证：

1. 打开 LM Studio 设置
2. 启用"需要身份验证"
3. 创建 API 令牌
4. 在配置 start-claude 时使用该令牌

详细信息请参考 [LM Studio 文档](https://lmstudio.cn/docs/integrations/claude-code)。

## 依赖

- Python >= 3.9
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code/overview) (需单独安装)

## 参考文档

- [Kimi Code 第三方 Agent 配置](https://www.kimi.com/code/docs/more/third-party-agents.html)
- [BigModel Claude Code 配置](https://docs.bigmodel.cn/cn/coding-plan/tool/claude)
- [DeepSeek Anthropic API 文档](https://platform.deepseek.com/api-docs/anthropic)
- [MiniMax Claude Code 配置](https://platform.minimaxi.com/docs/coding-plan/claude-code)
- [阿里云百炼 Claude Code 配置](https://help.aliyun.com/zh/model-studio/developer-reference/use-claude-code-by-calling-the-anthropic-api)
- [火山引擎 Claude Code 配置](https://www.volcengine.com/docs/82379/1463942)
- [百度千帆 Coding Plan 文档](https://cloud.baidu.com/doc/qianfan/s/imlg0beiu)
- [腾讯云 Coding Plan 文档](https://cloud.tencent.com/document/product/1772/128947)
- [AutoDL Claude Opus 4.6 CC 配置](https://www.autodl.art/docs/claude-opus-4-6-cc/)
- [AutoDL Claude Sonnet 4.6 CC 配置](https://www.autodl.art/docs/claude-sonnet-4-6-cc/)
- [LM Studio Claude Code 集成](https://lmstudio.cn/docs/integrations/claude-code)
- [Claude Code 官方文档](https://docs.anthropic.com/en/docs/claude-code/overview)

## 卸载

### 卸载工具

```bash
uv tool uninstall start-claude
```

### 删除用户数据

如需删除所有用户数据（包括保存的 API 密钥和模型配置），请删除以下文件和目录：

```bash
rm ~/.startcode/token.json
rm ~/.startcode/config.json
rm -r ~/.startcode/
```

⚠️ **注意**：此操作将永久删除您保存的 API 密钥，且无法恢复。

## License

MIT License

---

## 火山引擎邀请码

方舟 Coding Plan 支持 Doubao、GLM、DeepSeek、Kimi 等模型，工具不限，现在订阅折上9折，低至8.9元，订阅越多越划算！

- 立即订阅：https://volcengine.com/L/dtGQIB7kNqI/
- 邀请码：**2ZZ9CB3M**

## 智谱 GLM Coding 邀请码

🚀 速来拼好模，智谱 GLM Coding 超值订阅，邀你一起薅羊毛！Claude Code、Cline 等 20+ 大编程工具无缝支持，"码力"全开，越拼越爽！立即开拼，享限时惊喜价！

- 链接：https://www.bigmodel.cn/glm-coding?ic=EIWFLZNUIP

## MiniMax 邀请码

🎁 MiniMax 跨年福利来袭！邀好友享 Coding Plan 双重好礼，助力开发体验！
好友立享 9折 专属优惠 + Builder 权益，你赢返利 + 社区特权！

👉 立即参与：https://platform.minimaxi.com/subscribe/coding-plan?code=AjqOdxKvQq&source=link

---

[English Documentation](README.md)