codel

环境要求

• 已安装并可正常运行 Docker（能执行 docker run）
• 至少准备一个受支持的模型环境变量：OpenAI API Key 或本地 Ollama 模型
• 宿主机需允许挂载 /var/run/docker.sock（Codel 依赖沙箱 Docker 环境）
• 宿主机 3000 端口未被占用

安装与启动步骤

1. 1准备模型密钥

   决定使用 OpenAI 还是本地 Ollama，先拿到对应密钥或确认 Ollama 服务已启动，后面通过环境变量传入。

2. 2启动 Codel 容器

   用官方预构建镜像启动，按需替换环境变量；-v 挂载 docker.sock 供沙箱使用，-p 把容器 8080 映射到本机 3000。

   docker run \
     -e OPEN_AI_KEY=your_open_ai_key \
     -e OPEN_AI_MODEL=gpt-4-0125-preview \
     -e OLLAMA_MODEL=llama2 \
     -p 3000:8080 \
     -v /var/run/docker.sock:/var/run/docker.sock \
     ghcr.io/semanser/codel:latest

   复制

3. 3改用 .env 文件启动

   若不想把密钥写在命令行，可把变量写进 .env 文件（格式参照 backend/.env.example），再用 --env-file 加载启动。

   docker run --env-file .env \
     -p 3000:8080 \
     -v /var/run/docker.sock:/var/run/docker.sock \
     ghcr.io/semanser/codel:latest

   复制

4. 4浏览器访问界面

   容器启动后在浏览器打开 localhost:3000 即可开始使用 Codel，所有历史命令和输出会保存在内置 PostgreSQL 中。

关键配置

如何确认成功

容器运行后浏览器打开 http://localhost:3000，能看到 Codel 的 Web 界面即部署成功。

常见问题

注意事项

• 挂载 /var/run/docker.sock 相当于把宿主机 Docker 控制权交给容器，请在可信环境中使用。
• 环境变量可按需删减或修改，只保留你实际使用的模型相关变量即可。
• 更多可用变量可参考仓库 backend/.env.example。