🚀 AI Coding Agents Docker Container

✨ 快速开始

1️⃣ 命令行

# 启容器
$ docker run -it --rm -v $(pwd)/config.toml:/home/coder/.codex/config.toml -v $(pwd)/config:/home/coder/.config/ai-tools \
 --privileged -e HTTP_PROXY=http://192.168.99.1:7890 -e HTTPS_PROXY=http://192.168.99.1:7890 -e http_proxy=http://192.168.99.1:7890 \
 -e https_proxy=http://192.168.99.1:7890 -e NO_PROXY=localhost,127.0.0.1,www.chatopens.net -e no_proxy=localhost,127.0.0.1,www.chatopens.net \
 jdcloudiaas/turta:coder
# 参考 https://www.chatopens.net/codex 配置
$ codex

2️⃣ 简单配置

model = "gpt-5-codex"
model_provider = "mirror"
[model_providers.mirror]
name = "mirror"
base_url = "https://www.chatopens.net/codex"
wire_api = "responses"
requires_openai_auth = true

✨ 核心特性

📦 支持的 AI 编程工具

npm-based CLI Tools(5 个)

Python-based Tools(3 个)

🚀 从 0-1 快速开始

1️⃣ 克隆或创建项目

# 创建项目目录
mkdir ai-coding-agents && cd ai-coding-agents
# 创建必需的目录和文件
mkdir -p projects config
# 复制本项目的所有文件到此目录
# Dockerfile
# docker-compose.yml
# .dockerignore
# config/config.env.example

2️⃣ 构建 Docker 镜像

# 方式一:使用 docker-compose(推荐)
docker-compose build
# 方式二:直接使用 docker
docker build . -t jdcloudiaas/turta:coder

3️⃣ 配置 API 密钥

# 复制配置模板
cp config/config.env.example config/config.env
# 编辑配置文件,填入你的 API 密钥
vim config/config.env

# OpenAI
OPENAI_API_KEY="sk-proj-your-key"
OPENAI_ORG_ID="org-your-org-id"
# Anthropic
ANTHROPIC_API_KEY="sk-ant-your-key"
# Google
GEMINI_API_KEY="your-gemini-key"
# GitHub
GITHUB_TOKEN="ghp_your-token"
# Sourcegraph
SRC_ACCESS_TOKEN="sgp_your-token"

4️⃣ 启动容器

# 使用 docker-compose
docker-compose up -it
# 或直接使用 docker
docker run -it --rm \
 -v $(pwd)/projects:/home/coder/projects \
 -v $(pwd)/config:/home/coder/.config/ai-tools \
 jdcloudiaas/turta:coder

5️⃣ 在容器内使用工具

# 进入容器后,查看已安装工具
~/list-agents.sh
# 进入项目目录
cd ~/projects
# 使用各种 AI 工具
claude # Claude Code
aider --model gpt-4 # Aider with GPT-4
codex # OpenAI Codex
gpt-engineer my-project # Generate project
interpreter # Open Interpreter

📋 详细使用指南

使用 Aider(推荐入门)

cd ~/projects
# 创建新项目
mkdir my-app && cd my-app
# 启动 Aider
aider --model gpt-4
# 在 Aider 中输入需求
# /ask 询问问题
# /code 生成代码
# /test 生成测试

使用 Claude Code

cd ~/projects
# 启动 Claude
claude
# 按照提示进行交互
# 支持代码生成、分析、重构等

使用 OpenAI Codex

cd ~/projects
# 启动 Codex
codex
# 创建本地项目
# Codex 会在本地运行代码分析

使用 Open Interpreter

cd ~/projects
# 启动 Interpreter
interpreter
# 执行代码
# >>> import pandas as pd
# >>> df = pd.read_csv("data.csv")

使用 GPT Engineer

cd ~/projects
# 生成完整项目
gpt-engineer my-new-project
# 按照提示填写项目需求

🔧 配置参考

Docker Compose 环境变量

environment:
 - OPENAI_API_KEY=${OPENAI_API_KEY} # OpenAI API 密钥
 - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY} # Anthropic API 密钥
 - GEMINI_API_KEY=${GEMINI_API_KEY} # Google Gemini API 密钥
 - GITHUB_TOKEN=${GITHUB_TOKEN} # GitHub 令牌
 - SRC_ACCESS_TOKEN=${SRC_ACCESS_TOKEN} # Sourcegraph 令牌

持久化卷

🎯 常见场景

场景 1:本地快速开发

# 启动容器
docker-compose up -d
# 在本地编辑文件
vim projects/my-script.py
# 在容器内测试
docker-compose exec ai-coding-agents aider -f projects/my-script.py

场景 2:生成完整项目

docker-compose up -it
# 在容器内
cd ~/projects
gpt-engineer my-project
# 填写项目需求,自动生成完整项目

场景 3:代码分析和优化

docker-compose up -it
# 在容器内
cd ~/projects
aider --message "优化这个脚本的性能" my-script.py

场景 4:多工具协作

# 终端 1:启动 Aider
docker-compose exec ai-coding-agents aider
# 终端 2:使用 Claude
docker-compose exec ai-coding-agents claude
# 终端 3:使用 Codex
docker-compose exec ai-coding-agents codex

🐛 故障排除

问题 1:构建失败 - "heredoc not supported"

# 临时启用 BuildKit
DOCKER_BUILDKIT=1 docker build . -t jdcloudiaas/turta:coder
# 或永久启用
echo '{"features": {"buildkit": true}}' | sudo tee /etc/docker/daemon.json
sudo systemctl restart docker

问题 2:API 密钥未被加载

# 检查配置文件
ls -la config/config.env
# 验证配置是否加载
docker-compose exec ai-coding-agents env | grep OPENAI

问题 3:工具命令不存在

# 检查已安装的 npm 包
docker-compose exec ai-coding-agents npm list -g
# 检查 Python 工具
docker-compose exec ai-coding-agents pipx list

问题 4:磁盘空间不足

# 清理 Docker 缓存
docker system prune -a
# 检查卷大小
docker volume ls
docker volume inspect ai-coding-agents_ai-tools-cache

📊 系统需求

📚 相关链接

📝 许可证

🤝 贡献

📞 支持