AI 编程助手配置指南

配置

编辑或新增 settings.json 文件：

MacOS & Linux ~/.claude/settings.json

Windows 用户目录/.claude/settings.json

新增或修改里面的 env 字段，注意替换 your_api_key 为您获取到的 API Key：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_api_key",
    "ANTHROPIC_BASE_URL": "https://tkapi.vip"
  },
  "hasCompletedOnboarding": true
}

使用

完成配置后，重新启动 IDE/CLI，就可以使用 Claude Code 进行开发了。

（可选操作） 使用 IDE 插件，成功进入 Claude Code 对话框后，在对话框输入 /config 进入设置，勾选 Disable Login Prompt 配置来关闭登录页面。

常见问题 FAQ

CLI 读取不到 setting 配置导致连接到了官方服务器

尝试手动加载环境变量：

# Linux & Mac
export ANTHROPIC_AUTH_TOKEN=***
export ANTHROPIC_BASE_URL=https://tkapi.vip

# Windows 自行在界面上配置环境变量，并确保生效

# 启动
claude

# 进入后输入 /status 查看 BASE URL 为: https://tkapi.vip 表示连接成功

IDE 插件读取不到 setting 配置导致连接到了官方服务器

修改 VSCode 的 settings.json，增加变量：

"claudeCode.environmentVariables": [
    {
        "name": "ANTHROPIC_BASE_URL",
        "value": "https://tkapi.vip"
    },
    {
        "name": "ANTHROPIC_AUTH_TOKEN",
        "value": "sk-xxx"
    }
]

配置

编辑或新增 config.toml 文件：

MacOS & Linux ~/.codex/config.toml

Windows 用户目录/.codex/config.toml

model_provider = "tkapi"
model = "gpt-5.5"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
model_verbosity = "high"

[model_providers.tkapi]
name = "tkapi"
base_url = "https://tkapi.vip/v1"
wire_api = "responses"
requires_openai_auth = true

在同目录编辑或新增 auth.json 文件：

{
  "OPENAI_API_KEY": "xxx"
}

使用

完成配置后，重新启动 IDE/CLI，就可以使用 CodeX 进行开发了。

配置

编辑 openclaw.json 文件，注意替换对应的 apiKey 为您获取到的 API Key：

MacOS & Linux ~/.openclaw/openclaw.json

Windows 用户目录/.openclaw/openclaw.json

{
  // 模型配置：定义可用的模型提供商和模型列表
  "models": {
    "mode": "merge",
    "providers": {
      // OpenAI 系列模型（使用 codex 分组）
      "tkapi-codex": {
        "baseUrl": "https://tkapi.vip/v1",
        "apiKey": "***",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-5.4",
            "name": "gpt-5.4",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 100000
          },
          {
            "id": "gpt-5.5",
            "name": "gpt-5.5",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 100000
          }
        ]
      },
      // Claude 系列模型（使用 aws 分组）
      "tkapi-claude": {
        "baseUrl": "https://tkapi.vip",
        "apiKey": "***",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "claude-sonnet-4-6",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 100000
          },
          {
            "id": "claude-opus-4-6",
            "name": "claude-opus-4-6",
            "api": "anthropic-messages",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 100000
          },
          {
            "id": "claude-opus-4-7",
            "name": "claude-opus-4-7",
            "api": "anthropic-messages",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 100000
          }
        ]
      }
    }
  },

  // Agent 配置：设置默认使用的模型和可选模型列表
  "agents": {
    "defaults": {
      // 主模型，Agent 默认使用此模型
      "model": {
        "primary": "tkapi-codex/gpt-5.5"
      },
      // 可切换的模型列表
      "models": {
        "tkapi-codex/gpt-5.4": {},
        "tkapi-codex/gpt-5.5": {},
        "tkapi-claude/claude-opus-4-6": {},
        "tkapi-claude/claude-opus-4-7": {},
        "tkapi-claude/claude-sonnet-4-6": {}
      },
      "workspace": "/root/.openclaw/workspace",
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  }
}

使用

完成配置后，执行 openclaw gateway restart 即可使用。

配置

运行 hermes model 命令，按照以下步骤完成配置：

选择 Custom endpoint
在 Select provider 列表中，选择 Custom endpoint (enter URL manually)
输入 Base URL
输入 https://tkapi.vip/v1，按下回车
输入 API Key
在 API key 提示处，输入您获取到的令牌
选择模型
根据提示输入序号选择模型
输入上下文长度
输入上下文长度（如 200000），按下回车完成配置

使用

完成配置后，输入 hermes 重新打开对话即可使用。