切换主题
手动切换配置
手动配置不是一个独立客户端，而是把 Base URL、API Key 和模型名称写入当前终端或目标工具自己的配置中。它适合临时验证、排查配置覆盖，或者目标工具暂时不能由 CC Switch 管理的场景。
什么时候使用
- 只想让当前终端启动的工具临时使用本站接口。
- 想确认问题来自 API Key、Base URL，还是客户端自己的配置。
- 目标工具支持环境变量，但没有图形化 Provider 设置。
- 需要在 Docker、systemd 或 CI 中显式注入配置。
通用变量
建议先使用本站专属变量保存值，再按目标工具需要映射到它认识的变量名。
macOS / Linux / WSL
bash
export DDDAI_BASE_URL="https://dddai.dev/v1"
export DDDAI_API_KEY="sk-your-api-key"
export DDDAI_MODEL="your-model-id"如果目标工具读取 OpenAI 常用变量，可以在同一个终端继续执行：
bash
export OPENAI_BASE_URL="$DDDAI_BASE_URL"
export OPENAI_API_KEY="$DDDAI_API_KEY"Windows PowerShell
powershell
$env:DDDAI_BASE_URL = "https://dddai.dev/v1"
$env:DDDAI_API_KEY = "sk-your-api-key"
$env:DDDAI_MODEL = "your-model-id"
$env:OPENAI_BASE_URL = $env:DDDAI_BASE_URL
$env:OPENAI_API_KEY = $env:DDDAI_API_KEY上面的变量只对当前终端和由它启动的子进程生效。关闭终端后会失效，适合第一次验证。
变量影响范围
OPENAI_BASE_URL 和 OPENAI_API_KEY 可能被同一终端启动的多个程序读取。测试结束后应关闭终端或清除变量，避免其他工具意外使用同一 API Key。
清除当前会话变量
macOS / Linux / WSL
bash
unset OPENAI_BASE_URL OPENAI_API_KEY
unset DDDAI_BASE_URL DDDAI_API_KEY DDDAI_MODELWindows PowerShell
powershell
Remove-Item Env:OPENAI_BASE_URL -ErrorAction SilentlyContinue
Remove-Item Env:OPENAI_API_KEY -ErrorAction SilentlyContinue
Remove-Item Env:DDDAI_BASE_URL -ErrorAction SilentlyContinue
Remove-Item Env:DDDAI_API_KEY -ErrorAction SilentlyContinue
Remove-Item Env:DDDAI_MODEL -ErrorAction SilentlyContinue长期运行的服务
Docker、systemd、CI 或后台服务通常读不到你当前 shell 中的临时变量。长期运行时应使用服务自己的 Secret、环境变量或凭据管理功能。
.env文件必须加入.gitignore，且不要提交真实 API Key。- CI 使用仓库或组织的 Secret，不要把密钥直接写进工作流文件。
- Docker Compose 优先使用受控的
env_file或 Secret。 - 桌面应用如果读不到终端变量，优先使用应用内 Provider 设置或 CC Switch。
风控与安全
- 每个项目或工具使用独立 API Key，并设置合理额度与模型权限。
- 不要把密钥写入项目级示例配置、日志或启动参数截图。
- 不要通过环境变量覆盖去绕过账号分组、模型权限或平台限制。
- 验证时先发送单条低成本请求，再逐步启用并发、长上下文和自动化。
- 怀疑泄露时立即轮换 API Key，并检查 使用日志。
常见问题
新终端里配置消失
export 和 $env:... 默认只对当前会话生效。需要长期使用时，请改用目标工具的安全凭据存储或系统级 Secret 管理方式。
桌面应用读取不到变量
双击启动的应用通常不会继承终端环境。可以从已设置变量的终端启动应用，或改用应用内配置。
请求地址变成 /v1/v1/...
目标工具可能会自动追加 /v1。检查它需要的是服务根地址还是 OpenAI Base URL。
使用日志没有请求
确认目标工具实际读取的变量名，并检查是否被项目配置、IDE 配置或系统代理覆盖。