AxiomCode 文档

主题

3.3 OpenCode ​

OpenCode 是开源的命令行 AI 编码助手，原生支持 OpenAI 兼容协议，因此可直接对接 AxiomCode。

一、安装 OpenCode ​

按照官方仓库的方式安装即可。常见方式（任选其一）：

bash
# 方式 A：npm 全局安装
npm install -g opencode-ai

# 方式 B：Homebrew (macOS)
brew install sst/tap/opencode

# 方式 C：脚本一键安装
curl -fsSL https://opencode.ai/install | bash

安装完成后验证：

bash
opencode --version

二、配置 AxiomCode 接入 ​

OpenCode 默认从 ~/.config/opencode/config.json 读取配置。把下面的内容写进去：

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "axiom": {
      "name": "AxiomCode",
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://axiomcode.top/v1",
        "apiKey": "sk-axiom-你的Key"
      },
      "models": {
        "gpt-5-codex": { "name": "GPT-5 Codex" },
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" },
        "claude-opus-4-7": { "name": "Claude Opus 4.7" }
      }
    }
  }
}

文件位置

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

如果目录不存在,手动创建即可。

三、启动并切换 Provider ​

bash
cd path/to/project
opencode

进入交互界面后，按 Ctrl+P（或菜单里的 Provider 选项），切换到 axiom，再挑一个模型即可开始对话。

四、常见问题 ​

Q：为什么我看不到模型列表？ 在 models 段里手动声明你账户开放的模型 ID。AxiomCode 控制台「接入配置」弹窗里展示了当前可用模型。

Q：能不能配置多家中转 / 官方源切换？ 能。provider 是个对象，可以并排放多家，比如 axiom、anthropic-official、openai-official。切换时直接在 Provider 面板里选即可。

Q：日志在哪里看？ 默认日志位于 ~/.config/opencode/log/。如果遇到 401/404，先去翻最新一份日志，里面会打印请求 URL 和响应码。

Copyright © 2026 AxiomCode