> ## Documentation Index
> Fetch the complete documentation index at: https://docs.harogo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex CLI

> このガイドでは、Harogoを使ったCodexを数分で使い始める方法を説明します。

> [!NOTE]
>
> **このガイドは GPT シリーズのみを対象としています。** Codex では GPT シリーズ（GPT-6 Luna、GPT-6 Sol、GPT-6.1 Sol、GPT-6 Astra、GPT-6.1 Terra）と、制限のないモデル（GLM、Qwen、Kimi、MiniMax、DeepSeek）を利用できます。Claude シリーズは Codex では利用できません。[Claude Code](https://docs.harogo.ai/ja/claude-code.md) をご覧ください。

## インストール

### 公式サイトからダウンロードする（macOS）

[https://openai.com/codex/](https://openai.com/codex/)

### コマンドラインでインストールする

```bash theme={null}
npm install -g @openai/codex
```

## 環境変数の設定

### 設定ファイルで設定する

1. `~/.codex/config.toml`ファイルを編集し、次の内容を追加します。

```toml theme={null}
profile = "harogo"

[model_providers.harogo]
name = "harogo"
base_url = "https://api.harogo.ai/v1"
personality = "pragmatic"
wire_api = "responses"

[profiles.harogo]
model = "gpt-6.1-sol"
model_provider = "harogo"
model_reasoning_effort = "high"
```

2. `~/.codex/auth.json`ファイルを編集し、次のように更新します。

```json theme={null}
{
  "OPENAI_API_KEY": "HAROGO_API_KEY"
}
```

### cc-switchで設定する

1. CC-Switchを起動し、プロバイダーを追加します。

![CC-Switchのプロバイダー追加画面](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.20.12.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=b32819dab1fb874d6a712ff40c47ec67)

2. プリセット一覧から「カスタム設定」（Custom Configuration）を選択します。

![CC-Switchのプリセット一覧でCustom Configurationを選択する画面](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.20.35.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=7173cc1be95b8e0b48d92262970e32e3)

3. プロバイダー名、APIキー、エンドポイント（[https://api.harogo.ai/v1](https://api.harogo.ai/v1)）などを入力します。すべて入力したら「追加」（Add）をクリックします。

![CC-SwitchでAPIキーを入力して保存する画面](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.22.08.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=78f30c9346778ba163f526c96cd6dc6c)

4. ホーム画面に戻り、「harogo」を選択して「有効化」（Enable）をクリックすると利用を開始できます。

![CC-Switchでharogoプロバイダーを有効にする画面](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.27.33.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=f9fd7cc10375932aa2ab49c49f141301)

## Codexを使う

### ターミナルで使う

1. ターミナルを開いてプロジェクトディレクトリに移動し、`codex`コマンドを実行します。

```bash theme={null}
cd /path/to/your/project
codex
```

2. 必要に応じて権限を設定します。

![Codex起動時に承認権限を設定する画面](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.31.13.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=ebb754f23dfe9d16d878e3399dc1e9c2)

3. 自然言語でプロンプトを入力します。正常な応答が返ってくれば、セットアップは完了です。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.