メインコンテンツへスキップ

概要

OpenAI Codex は、ターミナルでコードの読み取り、修正、実行が可能な軽量コーディングエージェントとして機能するオープンソースのコマンドラインツール(CLI)です。GPT モデルに基づいて構築されており、コード生成に最適化されています。

システム要件

  • OS: macOS, Linux(公式サポート), Windows(WSL 経由)
  • Node.js: バージョン 18 以上
  • npm: バージョン 10.x.x 以上

インストール

sudo npm install -g @openai/codex@latest
インストールの確認:
codex --version

設定

ステップ 1: API キーの設定

一時的(現在のセッション):
export OPENAI_API_KEY="sk-your-lemondata-key"
永続的な設定: ~/.bashrc~/.zshrc、または ~/.bash_profile に追加します:
export OPENAI_API_KEY="sk-your-lemondata-key"
その後、再読み込みします:
source ~/.zshrc  # または source ~/.bashrc

ステップ 2: config.toml の設定

~/.codex/config.toml を編集します:
model = "gpt-4o"
model_provider = "lemondata"

[model_providers.lemondata]
name = "LemonData"
base_url = "https://api.lemondata.cc/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"
設定ファイルが存在しない場合は、一度 codex を実行してファイルを生成してから編集してください。

基本的な使い方

対話モードを開始:
codex
直接コマンドを実行:
codex "Fix the bug in main.py line 42"
モデルを指定:
codex -m gpt-4o "Build a REST API server"

利用可能なモデル

モデル最適な用途
gpt-4o複雑なコーディングタスク、アーキテクチャ
gpt-4o-mini迅速な修正、シンプルなタスク
claude-sonnet-4-5コードレビュー、ドキュメント作成
deepseek-r1アルゴリズム設計、推論

対話型コマンド

コマンド説明
/helpヘルプを表示
/exit または Ctrl+C終了
/clear会話をクリア
/config設定を表示
/model <name>モデルを切り替え
/tokensトークン使用量を表示

設定の確認

# 環境変数を確認
echo $OPENAI_API_KEY

# API 接続をテスト
codex "Hello, Codex!"

# 設定を表示
cat ~/.codex/config.toml

一般的なユースケース

コードレビュー:
git diff | codex "Review these code changes"
コミットメッセージの生成:
git diff --staged | codex "Generate a commit message for these changes"
エラーの修正:
codex "Fix the TypeScript errors in src/components/"
コードの解説:
cat main.py | codex "Explain what this code does"

トラブルシューティング

  • config.toml の base_url が正確に https://api.lemondata.cc/v1 であることを確認してください
  • ネットワーク接続を確認してください
  • プロキシの干渉がないことを確認してください
  • 環境変数 OPENAI_API_KEY が設定されていることを確認してください
  • キーが sk- で始まっていることを確認してください
  • LemonData ダッシュボードでキーが有効であることを確認してください
  • モデル名が正確に一致しているか確認してください
  • lemondata.cc/en/models でモデルの利用可能性を確認してください