「APIキーを使えばいい」って言われた。でも、CLIってものもある。どっちでやればいいのか、最初は全然分からなかった。
私がやりたいのは、WordPressに記事を自動で書かせること。XやInstagramの投稿を自動で作ること。そのためにAIを動かす方法が、大きく2つあると分かった。APIキーを使う方法と、CLIを使う方法。
どちらも「AIに仕事を頼む入り口」なんだけど、使い方も向き不向きも全然違う。コードが分からない私が、Claude Codeに相談しながら両方を試してみた記録を残す。
APIキーとCLIって、そもそも何が違うのか
まず言葉の整理から。
APIキー(えーぴーあい・きー)は、「このAIを使っていいですよ」という許可証みたいなもの。番号と文字が並んだ長い文字列で、自分が作った自動化の仕組みにこれを貼りつけると、AIが動く。Claude CodeやCodexに「APIキーを設定して」と頼むと、どこに何を書けばいいか全部教えてくれる。
CLI(しーえるあい)は、AIと直接やり取りするための「話しかける窓口」のこと。Claude CLIやCodex CLIと呼ばれるものがある。ターミナル(黒い画面)から使うことが多いけど、私はその画面が怖いので、Claude Codeに「代わりにやって」と頼んでいる。
一番シンプルな違いは、目的の違い。APIキーは「自分で作った仕組みの中にAIを組み込む」ために使う。CLIは「AIと直接話しながら作業を進める」ために使う。
比較図解
APIキーとCLI、どっちを使う?
役割は全然ちがう。使う場面で選べばいい。
API Key
APIキー
自分の仕組みにAIを組み込む許可証コードやツールにAIの力を「つなぐ」ための鍵。アプリやサービスがAIに自動でアクセスできるようになる。
こんな時に使う
- 自分のサービスにAIを自動組み込みたい
- コードからAPIを呼び出したい
- 定期実行・バッチ処理を動かしたい
CLI
CLI
AIと直接話しながら作業する窓口ターミナル(黒い画面)からAIと会話しながら作業できる入口。セットアップ不要で、今すぐ動かせる。
こんな時に使う
- コードを書きながらAIに相談したい
- ファイル操作・調査を話しながら進めたい
- まず試してみる・プロトタイプを作る
APIキー vs CLI — 5項目比較
まず動かしたいなら CLI から。
自動化・サービス化したくなったら APIキー を使う。
順番を間違えると遠回りになる。
WordPressやSNS自動化で、どっちが向いているのか
実際にやってみて分かったのは、「目的によって使い分けるもの」だということ。
WordPressに自動で記事を投稿する仕組みを作りたいなら、APIキーの方が向いている。一度セットアップしてしまえば、あとはAIが自動で動いてくれる。私はClaude Codeに「WordPressに記事を自動で投稿できるようにして」と頼んで、APIキーを使った仕組みを作ってもらった。自分でコードを書いたわけじゃない。Claude Codeが全部やってくれた。
CLIが向いているのは、「一回だけ試したい」「まず動くか確認したい」というとき。Codex CLIやClaude CLIに日本語で話しかけると、その場でAIが答えてくれる。自動化の仕組みを作る前に、「こういう指示で動くかな?」と確認するのに使っている。
どちらが上という話ではない。最初に試すならCLI。本番で動かすならAPIキー。そういう順番で考えると整理しやすかった。
APIキーとCLI、どっちを使う?
用途別 使い分け早見表
設定ゼロ。失敗してもすぐやり直せる。
試すコストが一番安い。
24時間無人で動かせる。
本番運用・自動化に必須。
「これ使えそう」と感じるか確認する。
その1つだけを対象にする。欲張らない。
順番を間違えると、設定だけして使わないで終わる。
うまくいかなかったところと、直した判断
APIキーを使った自動化は、最初は全然動かなかった。Claude Codeに「うまくいかない」と状況を伝えたら、原因を探して直してくれた。なぜ直ったかは正直まだよく分かっていない。ここはあとで調べて自分の知識にする。
CLIは、使い始めるまでの準備がAPIキーより少し多かった。Claude CLIとCodex CLIでやり方が微妙に違うので、どっちを使えばいいか迷った。私はClaude Codeに「どっちを先に使えばいい?」と聞いて、その答えに従った。今はCodexとClaude Codeを両方使っていて、うまくいかなかった方をもう片方に投げることもある。
一つ決めていること。自動投稿の最終確認は人間がする。記事の内容をAIが作っても、公開ボタンは私が押す。SNS投稿も、内容を確認してから送る。ここだけは自動化しない。理由は単純で、AIが何を書いたか確認せずに出すのが怖いから。まだそこまで信頼できていない。
APIキーとCLI、どちらが正解かじゃなくて、用途で使い分けるもの。最初に試すならCLI、本番で動かすならAPIキー。コードが分からなくても、Claude CodeやCodexに日本語で相談すれば、どちらも動かせる。
私はまだ検証中の部分が多い。Day33時点では、WordPressへの自動投稿の仕組みは動いているけど、SNS自動化はまだ調整中。数字を見ながら、少しずつ改善していく。
やってみたい人は、まずCLIから試してみて。詰まったらClaude Codeに相談する。それだけで動く。
実験の続きはInstagram @aoi___ei で更新中。