OpenAI Codex CLIでOpenRouterのモデルを使用する

OpenAI Codex CLIでOpenRouterのモデルを使用する

2025.08.28

はじめに

日頃の業務でClaude Codeを使用しています。
最近OpenAIのCodexに乗り換えたという話を度々聞くようになったので、今更ながらCodexを使ってみようと思い始めました。
残念ながらChatGPTの定額プランには加入していないので、APIキーでの利用が必須となります。
OpenRouterに以前課金したクレジットが残っていたので、今回はCodexでOpenRouterのAPIキーを使用して動作させてみます。

Codexのインストール

以下のコマンドでCodexをインストールします。

npm install -g @openai/codex

通常通りCodexを起動するとChatGPTかAPIキーでの選択が求められますが、外部プロバイダー経由で利用する場合は別途設定ファイルを定義する必要があります。

codex

>_ Welcome to Codex, OpenAI's command-line coding agent

> Sign in with ChatGPT to use Codex as part of your paid plan
  or connect an API key for usage-based billing

> 1. Sign in with ChatGPT
     Usage included with Plus, Pro, and Team plans
  1. Provide your own API key
     Pay for what you use

  Press Enter to continue

config.tomlの設定

外部プロバイダーを利用する場合はconfig.tomlを作成し以下の様にプロバイダー定義が必要です。

~/.codex/config.toml
[model_providers.openrouter]
name = "OpenRouter"
base_url = "https://openrouter.ai/api/v1"
env_key = "OPENROUTER_API_KEY"

OpenRouterのAPIキー発行画面からAPIキーを発行し、config.tomlで指定した環境変数に設定します。

export OPENROUTER_API_KEY="sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

以下のコマンドを実行し起動時にプロバイダーとモデルを指定します。

codex --config model_provider=openrouter --model openai/gpt-5

上記のままでも問題ないのですが、コマンド実行時に毎回引数を指定するのは大変なので設定ファイルに以下のデフォルト設定を追記します。

~/.codex/config.toml
+ model_provider = "openrouter"
+ model = "openai/gpt-5"

[model_providers.openrouter]
name = "OpenRouter"
base_url = "https://openrouter.ai/api/v1"
env_key = "OPENROUTER_API_KEY"

設定が追加できていれば引数なしで起動可能です。

codex

>_ Welcome to Codex, OpenAI's command-line coding agent

> You are running Codex in /Users/sakai.takahisa/hoge/fuga

  Since this folder is version controlled, you may wish to allow Codex
  to work in this folder without asking for approval.

> 1. Yes, allow Codex to work in this folder without asking for approval
  2. No, ask me to approve edits and commands

  Press Enter to continue

動作確認

CodeXをインタラクティブモードで起動して実際にモデルを呼び出してみます。

codex

>_ You are using OpenAI Codex in ~/hoge/fuga

 To get started, describe a task or try one of these commands:

 /init - create an AGENTS.md file with instructions for Codex
 /status - show current session configuration and token usage
 /approvals - choose what Codex can do without approval
 /model - choose what model and reasoning effort to use

user
Generate a file named AGENTS.md that serves as a contributor guide for this repository.
Your goal is to produce a clear, concise, and well-structured document with descriptive headings and actionable explanations for each section.
Follow the outline below, but adapt as needed — add sections if relevant, and omit those that do not apply to this project.

Document Requirements

- Title the document "Repository Guidelines".
- Use Markdown headings (#, ##, etc.) for structure.
- Keep the document concise. 200-400 words is optimal.
- Keep explanations short, direct, and specific to this repository.
- Provide examples where helpful (commands, directory paths, naming patterns).
- Maintain a professional, instructional tone.

Recommended Sections

Project Structure & Module Organization

- Outline the project structure, including where the source code, tests, and assets are located.

Build, Test, and Development Commands

- List key commands for building, testing, and running locally (e.g., npm test, make build).
- Briefly explain what each command does.

Coding Style & Naming Conventions

- Specify indentation rules, language-specific style preferences, and naming patterns.
- Include any formatting or linting tools used.

Testing Guidelines

- Identify testing frameworks and coverage requirements.
- State test naming conventions and how to run tests.

Commit & Pull Request Guidelines

- Summarize commit message conventions found in the project’s Git history.
- Outline pull request requirements (descriptions, linked issues, screenshots, etc.).

(Optional) Add other sections if relevant, such as Security & Configuration Tips, Architecture Overview, or Agent-Specific Instructions.

 Working (10s • Esc to interrupt

OpenRouterの管理画面からActivityを確認すると、トークン消費が発生しており問題なく呼び出せていることが確認できました。

OpenRouter-Activity

まとめ

今回はCodexでOpenRouterのモデルを使える様に設定してみました。
Claude Codeからの乗り換え?候補の1つとしてこれからいろいろ試してみたいと思います。
直近のアップデートで機能が拡充された様なので期待しています。
どなたかの参考になれば幸いです。

この記事をシェアする

facebookのロゴhatenaのロゴtwitterのロゴ

© Classmethod, Inc. All rights reserved.