主流AI Agent Client使用API密钥方式

API密钥 配置 AI
AI
发布日期:   2026-04-03
更新日期:   2026-04-03
文章字数:   774
阅读时长:   3 分
阅读次数:  

几个主流的 AI Agent 客户端 apikey 配置记录：Codex CLI、Claude Code 和 OpenCode。

使用时记得替换成自己的。另外模型名称会不断更新，具体用什么版本还是得看官方文档。

Codex CLI

这个是用来代码审查和生成的，需要在本地建立配置。

配置目录：

  • macOS/Linux: ~/.codex/
  • Windows: %USERPROFILE%\.codex\ (比如 C:\Users\YourUsername\.codex\)

先创建目录：

# macOS/Linux
mkdir -p ~/.codex

# Windows PowerShell
New-Item -ItemType Directory -Path "$env:USERPROFILE\.codex" -Force

然后编辑 config.toml 文件，把这些配置加到开头：

model_provider = "OpenAI"
model = "gpt-4"
review_model = "gpt-4"
model_reasoning_effort = "high"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "YOUR_API_BASE_URL"
api_type = "openai"
requires_openai_auth = true

然后编辑 auth.json 文件，加上你的 API 密钥：

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

如果要用 WebSocket 的话，在 [model_providers.OpenAI] 这部分改成：

[model_providers.OpenAI]
name = "OpenAI"
base_url = "YOUR_API_BASE_URL"
api_type = "openai"
supports_websockets = true
requires_openai_auth = true

[features]
websockets_v2 = true

Claude Code

这是 VSCode 的一个扩展，配置方式有两种。

用环境变量

macOS/Linux 在终端里设置：

export ANTHROPIC_API_KEY="YOUR_API_KEY"
export ANTHROPIC_BASE_URL="YOUR_API_BASE_URL"  # 如果用自定义端点

想永久生效的话，把这些加到 ~/.bashrc 或 ~/.zshrc 里。

Windows PowerShell：

$env:ANTHROPIC_API_KEY="YOUR_API_KEY"
$env:ANTHROPIC_BASE_URL="YOUR_API_BASE_URL"

永久设置的话，右键「此电脑」→「属性」→「高级系统设置」→「环境变量」，新建系统变量：

  • ANTHROPIC_API_KEY = YOUR_API_KEY
  • ANTHROPIC_BASE_URL = YOUR_API_BASE_URL（可选）

然后重启系统。

用配置文件

编辑这个文件：

  • macOS/Linux: ~/.claude/settings.json
  • Windows: %USERPROFILE%\.claude\settings.json
{
  "env": {
    "ANTHROPIC_API_KEY": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "YOUR_API_BASE_URL"
  }
}

OpenCode

这个工具比较灵活，支持多个模型提供商。

配置目录：

  • macOS/Linux: ~/.config/opencode/
  • Windows: %USERPROFILE%\.config\opencode\

创建目录：

# macOS/Linux
mkdir -p ~/.config/opencode

# Windows PowerShell
New-Item -ItemType Directory -Path "$env:USERPROFILE\.config\opencode" -Force

编辑 opencode.json 文件：

{
  "provider": {
    "openai": {
      "options": {
        "baseUrl": "YOUR_API_BASE_URL/v1",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "gpt-4": {
          "name": "GPT-4",
          "limit": {
            "context": 8192,
            "output": 4096
          },
          "options": {
            "store": false
          },
          "variants": {
            "low": {},
            "medium": {},
            "high": {},
            "xhigh": {}
          }
        }
      }
    }
  },
  "agent": {
    "build": { "options": { "store": false } },
    "plan": { "options": { "store": false } }
  },
  "$schema": "https://opencode.ai/config.json"
}

常见问题

API 密钥怎么获取？

从各自的官网上去：

配置了还是连不上？

检查几个地方。首先确认 API 密钥复制时没有多余空格。然后检查 baseURL 是否对，OpenAI 官方是 https://api.openai.com/v1，Anthropic 是 https://api.anthropic.com/v1。再看看网络连接是否正常，官方服务状态有没有问题。必要的话查一下工具的日志输出。

Windows 的环境变量设置了为什么没生效？

重启系统。不是重启程序，是真的系统重启。

能同时用多个工具吗？

可以。每个工具的配置都是独立的，互相不影响。

模型名称对不上怎么办？

模型名称在不断更新，官方文档最权威。如果发现文中的模型名字已经不适用，去官网文档查一下当前支持的模型列表。比如 OpenAI 经常会更新模型版本号。

如果要查最新的官方信息，可以看：

API密钥 配置 AI
  目录