快速上手

快速上手#

安装#

git clone https://github.com/Agony5757/unified-icc.git
cd unified-icc
uv sync --extra server

--extra server 安装 FastAPI 和 uvicorn，用于 API Server 模式。

配置#

创建 ~/.unified-icc/config.yaml：

# 状态目录（默认 ~/.unified-icc）
state_dir: "~/.unified-icc"

# 默认 Provider（默认 claude）
default_provider: "claude"

# tmux 会话名（默认 cclark）
tmux_session: "cclark"

# API Server 配置
api_host: "0.0.0.0"
api_port: 8900
# api_key: "your-secret-key"  # 可选，设置后启用认证

环境变量#

变量

默认值

说明

UNIFIED_ICC_DIR

~/.unified-icc

状态目录

CCLARK_PROVIDER

claude

默认 Provider

TMUX_SESSION_NAME

cclark

tmux 会话名

ICC_API_HOST

0.0.0.0

API 监听地址

ICC_API_PORT

8900

API 端口

ICC_API_KEY

-

API 认证密钥

启动#

方式一：API Server（推荐）#

启动 HTTP + WebSocket API Server：

# 前台运行
unified-icc server start --port 8900

# 后台运行
unified-icc server start --port 8900 --detach

# 查看状态
unified-icc server status

# 停止
unified-icc server stop

方式二：程序化#

import asyncio
from unified_icc import UnifiedICC

async def main():
    gateway = UnifiedICC()
    await gateway.start()

    # 创建 Claude Code 会话
    window = await gateway.create_window(
        "/tmp/project",
        provider="claude",
        mode="standard"  # 或 "yolo"
    )

    # 绑定 channel
    gateway.bind_channel("feishu:oc_chat123", window.window_id)

    # 发送消息
    await gateway.send_to_window(window.window_id, "Hello!")

    await asyncio.sleep(60)
    await gateway.stop()

asyncio.run(main())

快速验证#

# 健康检查
curl http://localhost:8900/health

# 创建会话
curl -X POST http://localhost:8900/api/v1/sessions \
  -H "Content-Type: application/json" \
  -d '{"channel_id": "test", "work_dir": "/tmp", "provider": "claude", "mode": "standard"}'

# 查看会话列表
curl http://localhost:8900/api/v1/sessions

# 发送输入
curl -X POST http://localhost:8900/api/v1/sessions/test/input \
  -H "Content-Type: application/json" \
  -d '{"text": "hello"}'

# 关闭会话
curl -X DELETE http://localhost:8900/api/v1/sessions/test

下一步#