ccapi-cli

English

ccapi 的 CLI 工具。在任意 workspace 目录下执行 ccapi start，即可通过 pm2 启动一个由 Claude Code 驱动的 HTTP API。

安装

npm install -g ccapi-cli

快速开始

1. 创建 workspace 目录并编写系统提示词：

my-api/
├── CLAUDE.md          # 在这里定义 Claude 的行为
└── .claude/
    └── settings.json  # 可选：限制 Claude 可用的工具

翻译 API 的 CLAUDE.md 示例：

你是一个专业翻译引擎。

规则：

- 只输出译文，不要解释、不要注释
- 自动检测源语言
- 默认翻译为中文，如果源语言是中文则翻译为英文
- 保持原文格式（markdown、代码块等）

2. 启动服务：

cd my-api
ccapi start
# 首次启动会询问端口，之后自动保存到 ccapi.json

3. 调用 API：

curl -X POST http://localhost:3000 -H 'Content-Type: application/json' -d '{"prompt": "Hello World"}'
# {"result":"你好世界","cost":0.001,"duration_ms":1234}

命令

| 命令 | 说明 | | --------------- | ----------------- | | ccapi start | 通过 pm2 启动服务 | | ccapi stop | 停止服务 | | ccapi restart | 重启服务 | | ccapi logs | 查看日志 | | ccapi status | 查看 pm2 状态 | | ccapi delete | 从 pm2 移除 |

配置

首次 ccapi start 时会询问端口号，配置保存到 workspace 目录下的 ccapi.json，后续启动直接复用。

{
  "port": 3000,
  "maxTurns": 1,
  "timeoutMs": 60000
}

示例

参考 examples/ 目录，里面有可直接使用的 workspace 配置。