Provider 配置

gcop-rs 支持多个 LLM provider。你可以使用内置 provider 或添加自定义 provider。

内置 Providers

Claude (Anthropic)

[llm.providers.claude]
api_key = "sk-ant-your-key"
model = "claude-sonnet-4-5-20250929"
temperature = 0.3
max_tokens = 2000

获取 API Key: https://console.anthropic.com/

可用模型：

• claude-sonnet-4-5-20250929（推荐）
• claude-opus-4-5-20251101（最强大）
• claude-3-5-sonnet-20241022（旧版）

OpenAI

[llm.providers.openai]
api_key = "sk-your-openai-key"
model = "gpt-4-turbo"
temperature = 0.3

获取 API Key: https://platform.openai.com/

可用模型：

• gpt-4-turbo
• gpt-4
• gpt-3.5-turbo

Ollama（本地）

[llm.providers.ollama]
endpoint = "http://localhost:11434/api/generate"
model = "codellama:13b"

设置：

# 安装 Ollama
curl https://ollama.ai/install.sh | sh

# 拉取模型
ollama pull codellama:13b

# 启动服务
ollama serve

可用模型: Ollama 中的任意模型（codellama、llama2、mistral 等）

Gemini（Google）

[llm.providers.gemini]
api_key = "AIza-your-gemini-key"
model = "gemini-3-flash-preview"
temperature = 0.3

获取 API Key: https://ai.google.dev/

可用模型：

• gemini-3-flash-preview（推荐默认）
• gemini-2.5-flash
• gemini-2.5-pro

自定义 Providers

你可以使用 api_style 参数添加 OpenAI、Claude 或 Gemini 兼容的 API。

DeepSeek

[llm.providers.deepseek]
api_style = "openai"
api_key = "sk-your-deepseek-key"
endpoint = "https://api.deepseek.com/v1/chat/completions"
model = "deepseek-chat"
temperature = 0.3

获取 API Key: https://platform.deepseek.com/

通义千问

[llm.providers.qwen]
api_style = "openai"
api_key = "sk-your-qwen-key"
endpoint = "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions"
model = "qwen-max"

Claude 代理/镜像

[llm.providers.claude-code-hub]
api_style = "claude"
api_key = "your-key"
endpoint = "https://your-claude-code-hub.com/v1/messages"
model = "claude-sonnet-4-5-20250929"

自定义 OpenAI 兼容服务

[llm.providers.my-llm]
api_style = "openai"
api_key = "your-key"
endpoint = "https://api.example.com/v1/chat/completions"
model = "custom-model"

API Style 参数

api_style 参数决定使用哪种 API 实现：

值	说明	兼容服务
"openai"	OpenAI Chat Completions API	OpenAI、DeepSeek、通义千问、大多数自定义服务
"claude"	Anthropic Messages API	Claude、Claude 代理/镜像
"ollama"	Ollama Generate API	仅本地 Ollama
"gemini"	Google Gemini GenerateContent API	Gemini 以及兼容 Gemini 的端点

如果未指定 api_style，默认使用 provider 名称（用于向后兼容内置 providers）。

切换 Providers

使用命令行

# 为单个命令使用不同的 provider
gcop-rs --provider openai commit
gcop-rs --provider deepseek review changes

修改默认值

编辑平台对应的配置文件（见配置指南）：

[llm]
default_provider = "deepseek"  # 修改这里

API Key 管理

配置文件

Provider 的 api_key 在 config.toml 中设置：

[llm.providers.claude]
api_key = "sk-ant-..."

CI 模式环境变量

在 CI 模式（CI=1）下，使用环境变量代替配置文件：

• GCOP_CI_PROVIDER - Provider 类型：claude、openai、ollama 或 gemini
• GCOP_CI_API_KEY - API key
• GCOP_CI_MODEL（可选，有默认值）
• GCOP_CI_ENDPOINT（可选）

参考

• 配置参考 - 所有配置选项
• Provider 健康检查 - gcop-rs config validate 的检查机制
• 自定义 Prompt - 自定义 AI 行为
• 故障排除 - Provider 连接问题