CLI 工具总览

CLI 是命令行工具，不是一个具体软件。Claude Code、Codex CLI、Gemini CLI、OpenClaw、OpenCode 都属于这类工具：你在终端里输入自然语言，它们可以读取项目、解释代码、生成文件、运行命令或帮你完成开发任务。

官方信息 下载和文档以官方站点为准

Claude Code 官方说明和安装入口 Codex CLI OpenAI 官方 CLI 文档 Gemini CLI Google 官方 CLI 文档 OpenClaw 终端和 Web UI 编码助手 OpenCode 开源终端 AI 编码助手

CLI 工具比普通聊天软件更强，也更容易误操作。新手第一次配置时，只在测试项目里运行，先让它“只解释，不修改，不执行命令”。

准备项	说明	为什么重要
终端	Windows 用 PowerShell，macOS / Linux 用 Terminal	CLI 都在终端里运行
工具本体	先安装 Claude Code、Codex CLI、Gemini CLI、OpenClaw 或 OpenCode	配置文件只对已安装工具生效
Key / 登录方式	可能是官方登录、API Key、OAuth 或中转站 Key	不同 CLI 认证方式不一样
Base URL	只有走中转站或代理时才需要	不同协议的地址后缀可能不同，不能只改域名
测试项目	新建一个空文件夹或复制项目副本	避免第一次配置时改坏真实项目

中转站文档里的 URL 通常是它自己的示例。你真正填写时，要换成自己服务商后台给出的 API 地址和 Key；如果它分别提供 OpenAI、Claude、Gemini 三种接口，不要把三种地址混着用。

Claude Code 配置 Claude Code 的 Key、Base URL、模型和 settings.json。

Codex CLI 配置 Codex 终端工具的 config.toml、自定义 Provider 和测试方式。

Gemini CLI 配置 Gemini CLI 的 Google 登录、API Key 和中转站注意事项。

OpenClaw 配置 OpenClaw 的 baseUrl 与 api 字段成对配置。

OpenCode 配置 OpenCode 的连接向导、配置文件位置和手动配置注意事项。

你现在要做什么	建议打开	为什么
只想统一切换多个 CLI 的服务商	CC-Switch 通用步骤	CC-Switch 更适合集中管理 Provider，再分发到 Claude、Codex、Gemini 等工具
只配置 Claude Code	Claude Code 配置	Claude Code 重点看 Anthropic / Claude 相关 Key、Base URL、模型名和 settings.json
只配置 Codex CLI	Codex 配置	Codex 重点看 config.toml、OpenAI 兼容 Provider、模型名和环境变量
只配置 Gemini CLI	Gemini 配置	Gemini 的登录方式、Key 和 Vertex / Gemini 接口与 OpenAI 兼容接口不同
使用 OpenClaw / OpenCode	OpenClaw / OpenCode	这两个工具的 Provider 字段会随版本变化，应该看对应页面和官方文档

风险	容易发生在哪里	建议
工具能读项目文件	Claude Code、Codex、Gemini、OpenClaw、OpenCode	第一次只在测试目录运行，不要直接打开真实生产项目
模型会执行或建议命令	所有代码 CLI	先开启确认模式，遇到删除、移动、安装、上传等动作要逐条看清
配置项互相覆盖	系统环境变量、项目配置、用户配置、CC-Switch	配置不生效时先查优先级，不要同时改多处
协议混用	OpenAI、Claude、Gemini、Vertex、中转站兼容接口	服务商后台给哪一种接口，就按哪一种工具页面填写
复制了别人的示例	第三方教程、截图、旧文档	示例里的 URL、Key、模型名都要换成自己的服务商后台内容

配置完成后，不要马上让 CLI 修改真实项目。先新建一个空目录，放一个简单的测试文件，让工具只读取、只解释、不要改文件。

可以复制给 CLI 的安全测试指令

请先只阅读当前目录。 请告诉我这里有哪些文件。 不要修改任何文件。 不要运行任何命令。 不要安装任何依赖。

如果这一步都不能正常返回，再去对应的问题排查页面。不要在没确认配置成功前，把真实项目交给 CLI 自动处理。