CLI 工具

在终端中使用 Claude Code、Aider、OpenCode 等 AI 编程助手,通过环境变量或配置文件接入网关。

通用环境变量

大多数 CLI 工具支持通过环境变量配置 API Key 和 Base URL:

.env
# 所有支持环境变量的工具通用配置
export OPENAI_API_KEY="sk-your-api-key"
export OPENAI_API_BASE="https://api.example.com/v1"

Claude Code

Anthropic 官方 CLI 编程助手,使用 Anthropic Messages 协议,支持终端内直接对话、代码生成与编辑。

环境变量Anthropic

安装

terminal
claude install

推荐使用官方安装脚本。也可通过 npm install -g @anthropic-ai/claude-code 安装。

配置步骤

  1. 1

    安装 Claude Code

    推荐使用官方安装脚本(会自动检测并安装 Node.js 依赖)。也可通过 npm 全局安装。

    terminal
    # 推荐:官方安装脚本
    claude install
    
    # 备选:npm 全局安装
    npm install -g @anthropic-ai/claude-code
  2. 2

    配置环境变量

    Claude Code 使用 Anthropic 协议(/v1/messages),需要设置 Anthropic 专用的 Base URL 和 API Key。将以下内容添加到你的 shell 配置文件(~/.bashrc、~/.zshrc 等)中。

    ~/.zshrc
    export ANTHROPIC_BASE_URL="https://api.example.com"
    export ANTHROPIC_API_KEY="sk-your-api-key"

    如果你的网关仅支持 OpenAI 协议,需要额外部署协议转换代理(如 claude-code-proxy)。

  3. 3

    使配置生效

    terminal
    source ~/.zshrc
  4. 4

    启动 Claude Code

    在项目目录下运行 claude 命令即可开始使用。

    terminal
    # 进入你的项目目录
    cd /path/to/your/project
    
    # 启动 Claude Code
    claude

注意事项

  • Claude Code 使用 Anthropic Messages 协议(/v1/messages),而非 OpenAI 格式
  • 如果你的网关仅支持 OpenAI 协议,需要部署协议转换代理(如 claude-code-proxy)
  • VS Code 扩展版本可能需要额外配置,详见 Claude Code 官方文档

Aider

终端 AI 编程助手,支持 git 集成、多模型切换,可与 Aider 对话式地编辑代码并自动提交 git commit。

环境变量OpenAI

安装

terminal
python -m pip install aider-install && aider-install

推荐使用 aider-install 安装(自动处理虚拟环境和依赖)。也可直接 pip install aider-chat。

配置步骤

  1. 1

    安装 Aider

    推荐使用 aider-install 安装脚本(自动创建虚拟环境并安装依赖)。需要 Python 3.10+。

    terminal
    # 推荐:使用 aider-install(自动创建虚拟环境)
    python -m pip install aider-install && aider-install
    
    # 备选:直接 pip 安装
    pip install aider-chat
  2. 2

    配置环境变量

    将以下环境变量添加到你的 shell 配置文件(~/.bashrc、~/.zshrc 等)中。

    ~/.zshrc
    export OPENAI_API_KEY="sk-your-api-key"
    export OPENAI_API_BASE="https://api.example.com/v1"
  3. 3

    使配置生效

    terminal
    source ~/.zshrc
  4. 4

    启动 Aider

    在 git 项目目录下运行 aider,使用 --model 参数指定模型。模型名需加 openai/ 前缀。

    terminal
    # 进入 git 项目目录
    cd /path/to/your/project
    
    # 启动(使用 DeepSeek V3.2)
    aider --model openai/deepseek-v3.2
    
    # 也可以使用 Claude Sonnet 4
    aider --model openai/claude-sonnet-4-20250514

    模型名称必须加 openai/ 前缀。未知模型会显示警告但不影响使用。

  5. 5

    (可选)使用配置文件

    也可以通过 .aider.conf.yml 配置文件替代环境变量,放在项目根目录或 ~/.aider.conf.yml。

    .aider.conf.yml
    # .aider.conf.yml
    openai-api-key: sk-your-api-key
    openai-api-base: https://api.example.com/v1
    model: openai/deepseek-v3.2

注意事项

  • 模型名称必须加 openai/ 前缀
  • 也支持 .aider.conf.yml 配置文件
  • 未知模型会显示警告但不影响使用

OpenCode

终端 AI 编程 Agent,支持 JSON 配置文件和 /connect 交互式命令,兼容 OpenAI SDK 协议。

配置文件OpenAI

安装

terminal
go install github.com/sst/opencode@latest

需要 Go 1.22+。也支持通过 brew 安装。

配置步骤

  1. 1

    安装 OpenCode

    通过 go install 安装。需要 Go 1.22+。

    terminal
    go install github.com/sst/opencode@latest
  2. 2

    创建配置文件

    在项目根目录创建 opencode.json(项目级),或在 ~/.config/opencode/config.json 创建用户级配置。

    opencode.json
    {
      "$schema": "https://opencode.ai/config.json",
      "provider": {
        "silvamux-gateway": {
          "npm": "@ai-sdk/openai-compatible",
          "name": "千木(SilvaMux)",
          "options": {
            "baseURL": "https://api.example.com/v1",
            "apiKey": "sk-your-api-key"
          },
          "models": {
            "deepseek-v3.2": {
              "name": "DeepSeek V3.2",
              "limit": { "context": 128000, "output": 8192 }
            },
            "claude-sonnet-4-20250514": {
              "name": "Claude Sonnet 4",
              "limit": { "context": 200000, "output": 8192 }
            }
          }
        }
      }
    }

    API Key 可用 {env:VAR_NAME} 语法引用环境变量,避免在配置文件中明文存储密钥。

  3. 3

    启动 OpenCode

    在项目目录下运行 opencode 命令。

    terminal
    # 进入项目目录
    cd /path/to/your/project
    
    # 启动
    opencode
  4. 4

    (可选)交互式配置

    也可以在 OpenCode 中使用 /connect 命令交互式添加 Provider。

    opencode
    # 在 OpenCode 中输入
    /connect

注意事项

  • 也支持 /connect 命令交互式配置
  • API Key 可用 {env:VAR_NAME} 语法引用环境变量
  • 支持自定义 headers(options.headers)